このトピックでは、BizTalk オーケストレーションの Windows Sharepoint Services コンテキスト プロパティを使用して、実行時に Windows SharePoint Services 送信ポートを構成する方法について説明します。 同じメカニズムを使用して、Windows SharePoint Services の動的送信ポートと遅延バインド送信ポートを構成できます。 動的送信ポートの構成プロパティは、実行時にオーケストレーションで設定されます。 [Windows SharePoint Services トランスポートのプロパティ] ダイアログ ボックスで公開されるアダプター プロパティは、動的または遅延バインドの送信ポートにも適用できます。 Windows Sharepoint Services アダプター コンテキスト プロパティを使用して動的または遅延バインド送信ポートの構成プロパティを設定するには、次の手順に従います。
Windows Sharepoint Services アダプターのコンテキスト プロパティを使用して送信ポートの構成プロパティを設定するには
動的送信ポートの場合、動的一方向送信ポートを作成するには、「送信ポートを 作成する方法」のトピックの手順に従います。
オーケストレーションのメッセージ構築図形内のメッセージ割り当て図形を使用して、送信メッセージの構成プロパティを設定します。 送信メッセージの構成プロパティを設定する方法の例については、「 チュートリアル: モジュール 3 - オーケストレーションから SharePoint プロパティにアクセスする」を参照してください。 このトピックの 「新しいメッセージの作成」 セクションでは、送信メッセージの構成プロパティを設定する方法について説明します。 Windows SharePoint Services の [トランスポートのプロパティ] ダイアログ ボックスで設定できるプロパティに関連付けられているアダプター コンテキスト プロパティを次の表に示します。
輸送特性 アダプター コンテキスト プロパティ データ型 コメント アダプター Web サービス ポート WSS.ConfigAdapterWSPort 整数 有効な値は 1 ~ 65535 です
既定値は 80 です時間切れ WSS.ConfigTimeout 整数 有効な値は 1000 ~ 2147483647
既定値は 100000 です。
無限タイムアウトを示すには、値 0 を指定します。宛先フォルダーの URL NA NA 動的ポートの場合、これはオーケストレーション内の式図形を使用して動的ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定することによって間接的に設定されます。 遅延バインディング ポートの場合、このプロパティは常に物理送信ポートの値によってオーバーライドされるため、実行時に設定できません。 ファイル名 WSS。ファイル名 糸 %Filename% マクロと%Extension%マクロを除き、トランスポート プロパティで使用できるすべてのファイル名マクロの使用をサポートします。 名前空間のエイリアス WSS.ConfigNamespaceAliases 糸 実行時にメッセージに設定された名前空間エイリアスが、メッセージがルーティングされる送信ポートの名前空間エイリアス セットと完全に一致する場合、名前空間がマージされ、ルーティング エラーが発生します。 この問題を回避するには、指定した名前空間のエイリアスが同じではないことを確認します。 たとえば、オーケストレーションで次の式を使用して、メッセージの名前空間エイリアスを設定する場合などです。
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";
このメッセージが 、Namespace Aliases プロパティの次の値を指定する送信ポートにルーティングされる場合:
orchns='http://OrderProcess.PurchaseOrder'
BizTalk Server がこの送信ポートにメッセージをルーティングしようとすると、エラーが発生します。 この問題を解決するには、送信ポートの 名前空間エイリアス プロパティに次の値を指定します。
orchns2='http://OrderProcess.PurchaseOrder'上書き WSS.ConfigOverwrite 糸 有効な値は次のとおりです。
はい
- "no"
名前を変更SharePoint サイトの URL WSS.InListUrl 糸 動的ポートの場合、これはオーケストレーション内の式図形を使用して動的ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定することによって間接的に設定されます。 遅延バインディング ポートの場合、このプロパティは常に物理送信ポートの値によってオーバーライドされるため、実行時に設定できません。 Microsoft Office 統合 WSS.ConfigOfficeIntegration 糸 有効な値は次のとおりです。
はい
- "no"
イエスフォームライブラリー
- "任意"テンプレート ドキュメント ライブラリ WSS.ConfigTemplatesDocLib 糸 無し テンプレート フォールバック ドキュメント ライブラリ WSS.ConfigCustomTemplatesDocLib 糸 無し テンプレートフォールバック名前空間列 WSS。ConfigCustomTemplatesNamespaceCol 糸 無し テンプレートの名前空間列 WSS。ConfigTemplatesNamespaceCol 糸 無し コラム nWSS.ConfigPropertiesXml
列名は、 <PropertyNamex>columnname</ PropertyNamex> フィールドに設定されます。糸 無し 列 n値WSS.ConfigPropertiesXml
列の値は、 <PropertySourcex>columnvalue</ PropertySourcex> フィールドに設定されます。糸 %Filename% マクロと%Extension%マクロを除き、トランスポート プロパティで使用できるすべてのファイル名マクロの使用をサポートします。 注
コンテキスト プロパティに指定される値では、大文字と小文字が区別されます。 コンテキスト プロパティを持つ動的ポートの構成値を設定する場合は、適切なケースを使用してください。BizTalk が指定された送信ポートにドキュメントをルーティングしようとしたときにエラーが発生します。
オーケストレーションで式の図形を使用して、動的送信ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定します。 このプロパティは、動的送信ポートがメッセージをルーティングする URI を指定するために使用されます。 動的送信ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定する方法の例については、「チュートリアル: モジュール 3 - オーケストレーションからの SharePoint プロパティへのアクセス」トピックの「式の作成」セクションを参照してください。 Windows Sharepoint Services アダプター コンテキスト プロパティの詳細については、「 Windows SharePoint Services アダプターのプロパティ リファレンス」を参照してください。
また、オーケストレーションで遅延バインドされた Windows Sharepoint Services 送信ポートの特定のプロパティを動的に設定することもできます。 この操作を行うと、Windows SharePoint Services ポートが 2 回構成されます。1 回は Windows SharePoint Services コンテキスト プロパティを使用し、1 回は Windows SharePoint Services トランスポート プロパティ ダイアログ ボックスを使用します。 既定では、[Windows SharePoint Services トランスポート プロパティ] ダイアログ ボックスで指定された構成は、コンテキスト プロパティで指定された構成プロパティよりも優先されます。 コンテキスト プロパティで指定された構成を使用するには、次の手順に従います。
静的一方向送信ポートを作成するには、「送信ポートを 作成する方法」トピックの手順に従います。
送信ポートのプロパティを設定する場合は、 Sharepoint サイトの URL プロパティと宛先フォルダー URL プロパティの適切な値を入力して、送信ポートの URI を定義します 。
コンテキスト プロパティ WSS.ConfigOverwrite で定義された値をオーケストレーションで使用する場合は、Overwrite プロパティの値を オーケストレーション に設定します。
オーケストレーションでコンテキスト プロパティ WSS.ConfigOfficeIntegration により定義された値を使用したい場合は、Microsoft Office Integration プロパティを Orchestration に設定してください。
オーケストレーションでコンテキスト プロパティを使用して値を設定する場合は、整数データ型を使用するすべての送信ポート プロパティに 値 -1 を入力します。
オーケストレーションでコンテキスト プロパティを使用してこれらの値を設定する場合は、文字列データ型を使用する送信ポート プロパティを空白のままにします。 これは、 Sharepoint サイトの URL プロパティと 移動先フォルダーの URL プロパティには適用されません。 これらのプロパティは、[ Windows Sharepoint Services トランスポートのプロパティ ] ダイアログ ボックスで指定する必要があります。
オーケストレーションのメッセージ構築図形内のメッセージ割り当て図形を使用して、送信メッセージの構成プロパティを設定します。 送信メッセージの構成プロパティを設定する方法の例については、「 チュートリアル: モジュール 3 - オーケストレーションから SharePoint プロパティにアクセスする」を参照してください。 このトピックの 「新しいメッセージの作成」 セクションでは、送信メッセージの構成プロパティを設定する方法について説明します。
値が -1 (整数データ型を使用するプロパティの場合)、"Orchestration" (ドロップダウン列挙プロパティの場合) または空白のままにされている送信ポートプロパティ (文字列データ型を使用するプロパティの場合) は、オーケストレーションで指定されたコンテキスト プロパティを使用して実行時に設定されます。
Windows SharePoint Services アダプターを使用して添付ファイルが埋め込まれた InfoPath フォームを受信し、InfoPath フォームを SharePoint ドキュメント ライブラリに送信する場合は、次の手順を実行して、フォーム内の InfoPath 処理手順を保持します。
BizTalk Server によって処理された埋め込み添付ファイルを含む InfoPath フォームの InfoPath 処理命令を保持するには
オーケストレーションでマップを使用して、ある InfoPath フォームのデータを別の InfoPath フォームにマップする場合は、マップ内の コピー処理命令 (API) プロパティが [はい] に設定されていることを確認します。 このパラメーターは、マップの [グリッドのプロパティ] ページの [カスタム ヘッダー] セクションで設定します。
オーケストレーションでマップを使用していない場合は、メッセージ割り当て図形で次の式を使用して出力メッセージを更新します。
NewMessage(XMLNORM.ProcessingInstructionOption) = 1; NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"上記の式では、 NewMessage は、処理命令を追加する出力メッセージです。