Windows SharePoint Services アダプタのプロパティに関するリファレンス
次の Windows SharePoint Services アダプタのプロパティは、BizTalk Server に昇格されるか、送信メッセージの送信ポート構成オプションを指定するために使用されます。 これらのプロパティを使用すると、メッセージに関する Windows SharePoint Services の情報にアクセスしたり、オーケストレーション内部から Windows SharePoint Services アダプタに情報を提供することができます。
メッセージ プロパティの優先順位
オーケストレーションおよび送信ポートで定義されたメッセージ プロパティをオーバーライドする際、優先順位の規則があります。
優先順位の規則は次のとおりです。
PropertiesXML 内部のオーケストレーションで定義されたプロパティ
オーケストレーションで定義されたプロパティ
Property Name または Property Source コレクションの内部に送信ポート レベルで定義されたプロパティ
送信ポート レベルで定義されたプロパティ
考慮事項と既知の問題
Windows SharePoint Services アダプタのプロパティに関する考慮事項は次のとおりです。
- オーケストレーション内のプロパティの一覧は、プロパティの位置に基づいてポートで定義されているプロパティとマージされます。 競合が発生した場合、オーケストレーション プロパティが送信ポート プロパティをオーバーライドします。
プロパティの型
プロパティの種類 | 説明 |
---|---|
IN | IN プロパティは、Windows SharePoint Services から値を取得する BizTalk Server のプロパティです。 メモ: これらのプロパティは、オーケストレーション内から変更しないでください。 |
CONFIG | CONFIG プロパティは、BizTalk オーケストレーションまたはカスタム パイプラインから値を取得するプロパティです。 この値は、送信メッセージの送信先を判断する際に Windows SharePoint Services アダプタで使用されます。 CONFIG プロパティを使用すると、オーケストレーションやカスタム パイプライン内の一部のプロパティの値を指定できます。このプロパティを使用しない場合は、送信ポートで定義する必要があります。 URL プロパティを除き、IN または CONFIG で始まらないプロパティは、IN および CONFIG の両方になります。 |
昇格 | PROMOTED プロパティは、コンテンツ ベースのルーティング (CBR) で使用できます。 PROMOTED に設定されていないプロパティは、CBR で使用できません。 メモ: すべてのアダプター プロパティは CBR フィルター エディターに表示されますが、CBR には昇格されたプロパティのみを使用できます。 |
特別 | 該当なし |
Note
すべてのプロパティは名前空間の下に http://schemas.microsoft.com/BizTalk/2006/WindowsSharePointServices-properties
存在し、 構文を使用して WSS.<WSS_Property_Name>
オーケストレーションまたは送信ポート フィルターからアクセスできます。
プロパティの一覧
Windows SharePoint Services の標準の列 | Windows SharePoint Services のプロパティ名 | Type | 説明 | プロパティの種類 |
---|---|---|---|---|
名前 | ファイル名 | xs:string | Windows SharePoint Services ファイルの拡張子の付いたファイル名。 ファイル名 (拡張子を含む) は、ドキュメント ライブラリ内で一意です。 | IN/CONFIG/PROMOTED |
該当なし | url | xs:string | ファイルの URL。 | IN/PROMOTED |
該当なし | TransmittedFileLocation | 該当なし | このプロパティは、統合の目的でビジネス アクティビティ監視 (BAM) で使用されます。オーケストレーションでは使用できません。 | SPECIAL |
該当なし | InArchivedMsgUrl | xs:string | アーカイブ ドキュメント ライブラリ内のファイルの URL。 このプロパティは、受信場所でメッセージをアーカイブしていない場合、使用できません。 | IN/PROMOTED |
Type | InIconUrl | xs:string | ドキュメントを表す際に使用される Windows SharePoint Services アイコンの URL。 | IN |
タイトル | InTitle | xs:string | Windows SharePoint Service ファイルのタイトル。 ファイル名とは異なります。 タイトルについては、必ずしもドキュメント ライブラリ内で一意にする必要はありません。 | IN/PROMOTED |
修正済み | InLastModified | xs:dateTime | Windows SharePoint Service の最終更新日時。 | IN/PROMOTED |
[変更者] | InLastModifiedBy | xs:string | ファイルを最後に変更したユーザーの名前。 | IN/PROMOTED |
id | InItemId | xs:int | ファイルの ID。 ファイルへのアクセスに使用できる、ドキュメント ライブラリ内で一意な整数です。 | IN |
編集 | InEditUrl | xs:string | ファイルのプロパティを編集する際にアクセスできる URL。 | IN |
作成済み | InCreated | xs:dateTime | Windows SharePoint Service ファイルが作成された日時。 | IN/PROMOTED |
作成者 | InCreatedBy | xs:string | ファイルを作成したユーザー。 | IN/PROMOTED |
ファイル サイズ | InFileSize | xs:int | Windows SharePoint Services ファイルのサイズ。 | IN |
該当なし | InListName | xs:string | このファイルが存在するドキュメント ライブラリの名前。 | IN/PROMOTED |
該当なし | InListUrl | xs:string | ドキュメント ライブラリの URL、つまり、このファイルが存在するドキュメント ライブラリ フォルダ。 | IN |
該当なし | InPropertiesXml | xs:string | 標準およびユーザー定義の Windows SharePoint Services 列をすべて含むフラット XML ドキュメント。 このドキュメントにより、オーケストレーションから任意の Windows SharePoint Services 列の値 (ユーザー定義列の値など) にアクセスできます。 メモ: 16 列の制限はありません。 メモ: このトピックの次のセクションのサンプル InPropertiesXml 値を参照してください。 | IN |
該当なし | InOfficeIntegration | xs:string | 受信場所の値に基づきます。 これは、、no 、または のいずれかoptional yes です。 |
IN |
該当なし | ConfigOverwrite | xs:string | "Yes" を指定すると、同じ名前を持つ既存のファイルが上書きされます。 "No" を指定すると、同じ名前のファイルが存在する場合にエラーが生成されます。 "Rename" を指定すると、一意なシーケンスをファイル名に追加することにより、ファイルが一意な名前に変更されます。 メモ: これは、物理送信ポートの [上書き] フィールドに似ています。 メモ: 'Orchestration' はこのフィールドに対して有効な値ではありません。 | CONFIG |
該当なし | ConfigNamespaceAliases | xs:string | XPATH のエイリアス定義。 | CONFIG |
該当なし | ConfigOfficeIntegration | xs:string | OfficeImporters を呼び出す必要がある場合は 'Yes' を指定します。 メッセージをそのまま処理する場合は 'No' を指定します。 'Optional' を指定すると、IP ソリューションが見つかる場合は 'Yes'、それ以外の場合は 'No' になります。 メモ: これは、物理送信ポートの "Microsoft Office 統合" フィールドに似ています。 メモ: 'Orchestration' はこのフィールドに対して有効な値ではありません。 | CONFIG |
該当なし | ConfigTemplatesDocLib | xs:string | フォールバック ドキュメント ライブラリの名前。 2 番目に検索される場所です。 メモ: これは、物理送信ポートの [テンプレート フォールバック ドキュメント ライブラリ] フィールドに似ています。 | CONFIG |
該当なし | ConfigTemplatesNamespaceCol | xs:string | フォールバック ドキュメント ライブラリの名前空間列名。 メモ: これは、物理送信ポートの [テンプレート フォールバック名前空間列] フィールドに似ています。 | CONFIG |
該当なし | ConfigCustomTemplatesDocLib | xs:string | プライマリ ドキュメント ライブラリの名前。 最初に検索される場所です。 メモ: これは、物理送信ポートの [テンプレート ドキュメント ライブラリ] フィールドに似ています。 | CONFIG |
該当なし | ConfigCustomTemplatesNamespaceCol | xs:string | プライマリ ドキュメント ライブラリの名前空間列名。 メモ: これは、物理送信ポートの [テンプレート名前空間列] フィールドに似ています。 | CONFIG |
該当なし | ConfigPropertiesXml | xs:string | 後から Windows SharePoint Services で更新される Windows SharePoint Services 列の名前と値をすべて含むフラット XML ドキュメント。 このドキュメントにより、オーケストレーションの開発者は、SharePoint で後続のメッセージが作成されるように SharePoint 列の値を設定できます。 メモ: これは、物理送信ポートの [列 n] フィールドと [列 n 値] フィールドで使用できる機能に似ています。 メモ: 16 列の制限があります。 メモ: このトピックで後述するサンプルの ConfigPropertiesXml 値を参照してください。 | CONFIG |
該当なし | ConfigTimeout | xs:int | Web サービス呼び出しのタイムアウト (ミリ秒単位)。 | CONFIG |
該当なし | ConfigAdapterWSPort | xs:int | アダプタがインストールおよび構成されているポートまたは IIS Web サイト。 メモ: 物理送信ポート値がオーケストレーション定義値をオーバーライドした場合でも、オーケストレーション内の無効なポート構成値はメッセージを中断します。 | CONFIG |
InPropertiesXml のサンプル
InPropertiesXml のサンプル XML を次に示します。
<InPropertiesXml>
<Property name="InItemId">2</Property>
<Property name="Created">12/14/2004 1:30:31 PM</Property>
<Property name="Author">3;#John Doe</Property>
<Property name="Modified">12/14/2004 1:30:31 PM</Property>
<Property name="Editor">3;#John Doe</Property>
<Property name="_ModerationStatus">0</Property>
<Property name="_ModerationComments" />
<Property name="FileRef">/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="FileDirRef">2;#sites/BASSite/SourceLibrary</Property>
<Property name="InLastModified">2004-12-14 13:30:31</Property>
<Property name="InCreated">2004-12-14 13:30:31</Property>
<Property name="InFileSize">7338</Property>
<Property name="FSObjType">0</Property>
<Property name="CheckedOutUserId">2;#3</Property>
<Property name="Filename">PO1.xml</Property>
<Property name="VirusStatus">2;#7338</Property>
<Property name="CheckedOutTitle">2;#John Doe</Property>
<Property name="LinkCheckedOutTitle">John Doe</Property>
<Property name="InLastModifiedBy">MyDomain\jdoe</Property>
<Property name="InCreatedBy">MyDomain\jdoe</Property>
<Property name="owshiddenversion">1</Property>
<Property name="File_x0020_Type">xml</Property>
<Property name="HTML_x0020_File_x0020_Type" />
<Property name="_SourceUrl" />
<Property name="_SharedFileIndex" />
<Property name="LinkFilenameNoMenu">PO1.xml</Property>
<Property name="LinkFilename">PO1.xml</Property>
<Property name="SelectTitle">2</Property>
<Property name="SelectFilename">2</Property>
<Property name="Edit">xml</Property>
<Property name="InIconUrl">/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="Url">http://localhost:80/sites/BASSite/SourceLibrary/PO1.xml</Property>
<Property name="EncodedAbsUrl">PO1</Property>
<Property name="BaseName">7338</Property>
<Property name="FileSizeDisplay" />
<Property name="InstanceID">200</Property>
<Property name="Order" />
<Property name="InTitle" />
<Property name="ColumnOne" />
<Property name="ColumnTwo" />
<Property name="ColumnThree" />
<Property name="ColumnFour" />
<Property name="InListName">SourceLibrary</Property>
<Property name="InListUrl">http://localhost:80/sites/BASSite/SourceLibrary</Property>
<Property name="InEditUrl">http://localhost:80/sites/BASSite/SourceLibrary/Forms/EditForm.aspx?ID=2</Property>
<Property name="InOfficeIntegration">yes</Property>
</InPropertiesXml>
ConfigPropertiesXml のサンプル
ConfigPropertiesXml のサンプル XML を次に示します。
<ConfigPropertiesXml>
<PropertyName1>PO number</PropertyName1>
<PropertySource1>%XPATH=//orchns:PurchaseOrder/orchns:Header/orchns:ID%</PropertySource1>
<PropertyName2>Charge To</PropertyName2>
<PropertySource2>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:chargeTo%</PropertySource2>
<PropertyName3>PO Priority</PropertyName3>
<PropertySource3>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:priority%</PropertySource3>
<PropertyName4>Order Date</PropertyName4>
<PropertySource4>%XPATH=//orchns:PurchaseOrder/orchns:orderBody/orchns:dateOrdered%</PropertySource4>
</ConfigPropertiesXml>
参照
Windows SharePoint Services の受信場所を構成する方法
Windows SharePoint Services 送信ハンドラを構成する方法
Windows SharePoint Services 送信ポートを構成する方法
送信ポートを作成する方法
Windows SharePoint Services アダプターの式
サポートされている Windows SharePoint Services 列の型