Windows Sharepoint Services のコンテキスト プロパティを使用して送信ポートを構成する方法

このトピックでは、BizTalk オーケストレーションから Windows Sharepoint Services のコンテキスト プロパティを使用して、実行時に Windows Sharepoint Services 送信ポートを構成する方法について説明します。 同じメカニズムを使用して、Windows SharePoint Services 動的送信ポートと遅延バインディング送信ポートを構成できます。 動的送信ポートの構成プロパティは、実行時にオーケストレーションで設定されます。 [Windows SharePoint Services トランスポートのプロパティ] ダイアログ ボックスで公開されるアダプター プロパティは、動的または遅延バインドされた送信ポートにも適用できます。 Windows Sharepoint Services アダプタのコンテキスト プロパティを使用して、動的送信ポートまたは遅延バインディング送信ポートの構成プロパティを設定するには、次の手順を実行します。

Windows Sharepoint Services アダプタのコンテキスト プロパティを使用して送信ポートの構成プロパティを設定するには

1. 動的送信ポートの場合、動的一方向送信ポートを作成するには、「送信ポートを 作成する方法」のトピックの手順に従います。

2. オーケストレーションのメッセージ構成図形内でメッセージ割り当て図形を使用して、送信メッセージの構成プロパティを設定します。 送信メッセージの構成プロパティを設定する方法の例については、「 チュートリアル: モジュール 3 - オーケストレーションから SharePoint プロパティにアクセスする」を参照してください。 このトピックの 「新しいメッセージの作成 」セクションでは、送信メッセージの構成プロパティを設定する方法について説明します。 [トランスポートのプロパティのWindows SharePoint Services] ダイアログ ボックスで設定できるプロパティに関連付けるアダプター コンテキスト プロパティを次の表に示します。

   トランスポート プロパティ	アダプタのコンテキスト プロパティ	データ型	説明
   アダプター Web サービス ポート	WSS.ConfigAdapterWSPort	int	有効な値は 1 ~ 65535 です 既定値は 80 です
   タイムアウト	WSS.ConfigTimeout	int	有効値は、1000 ～ 2147483647 です。 既定値は 100000 です。 値 0 を指定すると、タイムアウトしないことを表します。
   ターゲット フォルダーの URL	NA	NA	動的ポートの場合、これはオーケストレーションで式図形を持つ動的ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定することによって間接的に設定されます。 遅延バインディング ポートの場合、このプロパティは常に物理送信ポートの値でオーバーライドされるため、実行時に設定することはできません。
   ファイル名	WSS.Filename	String	%Filename% マクロと %Extension% マクロを除き、トランスポート プロパティで使用できるすべてのファイル名マクロの使用をサポートします。
   名前空間エイリアス	WSS.ConfigNamespaceAliases	String	実行時にメッセージに設定された名前空間エイリアスが、メッセージがルーティングされる送信ポートの名前空間エイリアス セットと完全に一致する場合、名前空間がマージされ、ルーティング エラーが発生します。 この問題を回避するには、指定した名前空間エイリアスが同じにならないようにします。 たとえば、メッセージの名前空間エイリアスを設定するために、オーケストレーションで次の式を使用するとします。 Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'"; このメッセージが、 名前空間エイリアス プロパティの次の値を指定する送信ポートにルーティングされる場合は 。 orchns='http://OrderProcess.PurchaseOrder' この場合、BizTalk Server がメッセージをこの送信ポートにルーティングしようとすると、エラーが発生します。 この問題を解決するには、送信ポートの 名前空間エイリアス プロパティに次の値を指定します。 orchns2='http://OrderProcess.PurchaseOrder'
   Overwrite	WSS.ConfigOverwrite	String	有効な値は次のとおりです。 - "はい" - "いいえ" - "rename"
   SharePoint サイトの URL	WSS.InListUrl	String	動的ポートの場合、これはオーケストレーションで式図形を持つ動的ポートの Microsoft.XLANGs.BaseTypes.Address プロパティを設定することによって間接的に設定されます。 遅延バインディング ポートの場合、このプロパティは常に物理送信ポートの値でオーバーライドされるため、実行時に設定することはできません。
   Microsoft Office 統合	WSS.ConfigOfficeIntegration	String	有効な値は次のとおりです。 - "はい" - "いいえ" - "yesformlibrary" - "省略可能"
   テンプレート ドキュメント ライブラリ	WSS.ConfigTemplatesDocLib	String	None
   テンプレート フォールバック ドキュメント ライブラリ	WSS.ConfigCustomTemplatesDocLib	String	None
   テンプレート フォールバック名前空間列	WSS.ConfigCustomTemplatesNamespaceCol	String	None
   テンプレート名前空間列	WSS.ConfigTemplatesNamespaceCol	String	None
   列 n	WSS.ConfigPropertiesXml 列名は、PropertyNamex>columnname</ PropertyNamex> フィールドで<設定されます。	String	None
   列 n の値	WSS.ConfigPropertiesXml 列の値は、PropertySourcex>columnvalue</ PropertySourcex> フィールドで<設定されます。	String	%Filename% マクロと %Extension% マクロを除き、トランスポート プロパティで使用できるすべてのファイル名マクロの使用をサポートします。

   Note

   コンテキスト プロパティに指定する値は、大文字と小文字が区別されます。 コンテキスト プロパティで動的ポートの構成値を設定するときは、大文字と小文字を正しく使い分けないと、指定した送信ポートにドキュメントがルーティングされるときにエラーが発生します。

3. オーケストレーションで式図形を使用して、動的送信ポートの 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 トランスポート プロパティ] ダイアログ ボックスで指定される構成が、コンテキスト プロパティで指定される構成プロパティよりも優先されます。 コンテキスト プロパティで指定される構成を使用するために、次の手順を実行します。

   1. 静的な一方向送信ポートを作成するには、「送信ポートを 作成する方法」トピックの手順に従います。

   2. 送信ポートのプロパティを設定する場合は、 Sharepoint サイト URL プロパティと 宛先フォルダー URL プロパティに適切な値を入力して、送信ポートの URI を定義します。

   3. コンテキスト プロパティ WSS で定義された値を使用する場合は、 Overwrite プロパティの値を Orchestration に設定します 。オーケストレーション内の ConfigOverwrite 。

   4. コンテキスト プロパティ WSS で定義された値を使用する場合は、 Microsoft Office Integration プロパティを Orchestration に設定します 。オーケストレーション内の ConfigOfficeIntegration 。

   5. オーケストレーションでコンテキスト プロパティを使用して値を設定する場合は、整数データ型を使用する送信ポート プロパティに -1 の値を入力します。

   6. オーケストレーションのコンテキスト プロパティを使用して、文字列データ型を使用する送信ポート プロパティの値を設定するには、その送信ポート プロパティを空白のままにします。 これは、 Sharepoint サイトの URL プロパティと 宛先フォルダー URL プロパティには適用されません。 これらのプロパティは、[ Windows Sharepoint Services トランスポートのプロパティ ] ダイアログ ボックスで指定する必要があります。

   7. オーケストレーションのメッセージ構成図形内でメッセージ割り当て図形を使用して、送信メッセージの構成プロパティを設定します。 送信メッセージの構成プロパティを設定する方法の例については、「 チュートリアル: モジュール 3 - オーケストレーションからの SharePoint プロパティへのアクセス」を参照してください。 このトピックの「 新しいメッセージを作成 する」セクションでは、送信メッセージの構成プロパティを設定する方法について説明します。

   8. 値 -1 で構成される送信ポート プロパティ (整数データ型を使用するプロパティ)、"オーケストレーション" で構成される送信ポート プロパティ (ドロップダウン列挙プロパティ)、または空白のままの送信ポート プロパティ (文字列データ型を使用するプロパティ) は、オーケストレーションで指定されたコンテキスト プロパティを使用して実行時に設定されます。

   Windows SharePoint Services アダプターを使用して、添付ファイルが埋め込まれた InfoPath フォームを受信した後、SharePoint ドキュメント ライブラリに InfoPath フォームを送信する場合は、次の手順を実行して、フォーム内の InfoPath 処理命令を維持します。

BizTalk Server によって処理される添付ファイルが埋め込まれた InfoPath フォームの InfoPath 処理命令を維持するには

1. オーケストレーションでマップを使用して、ある InfoPath フォームのデータを別の InfoPath フォームにマップする場合は、マップ内の コピー処理命令 (API) プロパティが [はい] に設定されていることを確認します。 このパラメーターは、マップの [グリッドのプロパティ] ページの [カスタム ヘッダー] セクションで設定されます。

2. オーケストレーションでマップを使用しない場合は、メッセージの割り当て図形で次の式を使用して出力メッセージを更新します。

   NewMessage(XMLNORM.ProcessingInstructionOption) = 1;  
   NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"  
   

   上記の式では、 NewMessage は、処理命令を追加する出力メッセージです。

参照

送信ポートを作成する方法