MethodInstances の Association 要素 (BDCMetadata スキーマ)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
名前空間: http://schemas.microsoft.com/windows/2007/BusinessDataCatalog
スキーマ: BDCMetadata
関連付け要素は、システム内の関連する外部コンテンツ タイプにリンクします。 たとえば、顧客が注文を行う状況であれば、顧客は AdventureWorks システムの販売注文に関連付けられます。 関連付けは接続元および接続先の外部コンテンツ タイプへのポインターと、クライアントが接続先の外部コンテンツタイプを接続元の外部コンテンツ タイプから取得できるようにするビジネス ロジック (MethodInstance オブジェクト) へのポインターを保持します。 関連付けのトラバーサルは、外部システム上のメソッドの呼び出しです。
BDC モデルでは、関連付けロジック (MethodInstance) は、接続元または接続先の外部コンテンツタイプ、あるいは関連しない外部コンテンツ タイプなど、どの外部コンテンツ タイプにも設定できます。ただし接続先の外部コンテンツタイプが、関連付けメソッド インスタンスを含む LobSystem に属している場合に限ります。
警告
SharePoint Designer 2010 を使用する場合は、移行先の外部コンテンツ タイプに対して関連付け操作を作成する必要があることに注意してください。 これは SharePoint デザイナーの要件であり、(ソースまたは別の外部コンテンツ タイプで) 他の方法でモデル化することはできません。
BDC では、複数の接続元外部コンテンツ タイプのシナリオと 1 つの接続先外部コンテンツ タイプのシナリオもサポートします。
関連付けメソッド インスタンスには、SourceEntity インスタンスの識別子値に対応するスロットと、DestinationEntity インスタンスの識別子値に対応するスロットが含まれています。 このため、関連付けメソッドでは、関連付けの接続元である各外部コンテンツ タイプのそれぞれに識別子に対応する識別子で、十分な数の入力用の TypeDescriptor オブジェクトをタグ付けする必要があります。
入力用の TypeDescriptor オブジェクトの IdentifierName 属性は、メソッドを実行する前に関連する EntityInstance の識別子値を挿入するように BDC に通知します。 たとえば、ある AssociationMethodInstance で、取得しようとしている接続元の EntityInstance の識別子値をユーザーが指定済みである可能性があります。 BDC は、すべての既定値を使用してこのパラメーターを完全にインスタンス化した後で、その値をこのスロットに挿入します。
BDC では、外部キー擬似アソシエーションもサポートされています。 外部キー擬似関連付けは、優先的に使う関連付けではありません。 Customer を返し、Customer のフィールドの 1 つが、Customer の Address へのキーである Web メソッドがあるとします。 また、キーを指定して Address を返す別の Web メソッドも検討してください。 メタデータ モデラーは、このメソッドを Customer-Address Association メソッド (場合によっては特定のアドレスの検索) として使用できます。 外部キー擬似関連付けは、このメソッドのターゲットが Address であることを確認し、返された顧客から Address のキーを取得し、この関連付けメソッドを呼び出して Address を自動的に返します。
警告
BDC モデルでは外部キー擬似関連付けがサポートされていますが、SharePoint Designer 2010 ではサポートされていないことに注意してください。 したがって、SharePoint Designer を使用して外部キー疑似関連付けをモデル化することはできません。
関連付け要素では、以下のプロパティがサポートされています。
重要
プロパティでは大文字と小文字が区別されます。
プロパティ
プロパティ |
型 |
説明 |
必須 |
既定値 |
制限/使用する値 |
|---|---|---|---|---|---|
HideOnProfilePage |
System.Boolean |
関連する外部コンテンツ タイプが、マスター外部コンテンツ タイプのプロファイル ページに追加されるかどうかを指定します。 |
省略可能 |
<Association Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>
以下のセクションで、属性、子要素、親要素について説明します。
要素と属性
属性
属性 |
説明 |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
**型** |
必須です。 関連付けの型を指定する MethodInstanceType。 次の表に、この属性で使用できる値を示します。
|
||||||||||||
**既定** |
オプション。 含まれる外部コンテンツ タイプ内で型を共有するすべての関連付けで、関連付けが既定値かどうかを指定します。 true に設定されている場合、含まれる外部コンテンツ タイプ内で型を共有するすべての関連付けで、関連付けが既定値になります。 falｓe に設定されている場合は、関連付けは既定値ではありません。 既定値: **false** 属性の種類: **Boolean** |
||||||||||||
**ReturnParameterName** |
オプション。 関連付けの ReturnTypeDescriptor を含むパラメーターの名前。 パラメーターの Direction 属性には、**Out**、**InOut**、または **Return** のいずれかの値を含む必要があります。 属性の種類: **String** |
||||||||||||
**ReturnTypeDescriptorName** |
オプション。 これは非推奨になっています。 代わりに ReturnTypeDescriptorPath を使用します。 属性の種類: **String** |
||||||||||||
**ReturnTypeDescriptorLevel** |
オプション。 これは非推奨になっています。 代わりに ReturnTypeDescriptorPath を使用します。 属性の種類: **Integer** |
||||||||||||
**ReturnTypeDescriptorPath** |
オプション。 関連付けの TypeDescriptor のドット パス。 属性の種類: **String** |
||||||||||||
**名前** |
必須です。 関連付けの名前。 属性の種類: **String** |
||||||||||||
**DefaultDisplayName** |
オプション。 関連付けの既定の表示名。 属性の種類: **String** |
||||||||||||
**IsCached** |
オプション。 この関連付けが頻繁に使用されるかどうかを指定します。 既定値: **true** 属性の種類: **Boolean** |
子要素
| 要素 | 説明 |
|---|---|
| MetadataObject の LocalizedDisplayNames 要素 (BDCMetadata スキーマ) | LocalizedDisplayNames 要素は、Association のローカライズされた名前の一覧を指定します |
| MetadataObject の Properties 要素 (BDCMetadata スキーマ) | Properties 要素は、関連付けのプロパティを指定します。 |
| AccessControlList 要素 (BDCMetadata スキーマ) | AccessControlList 要素は、関連付けへのアクセス権のセットを指定します。 |
| Association (BDCMetadata スキーマ) の SourceEntity 要素 | SourceEntity 要素は、関連付けにおける接続元外部コンテンツ タイプを指定します。 |
| Association の DestinationEntity 要素 (BDCMetadata スキーマ) | DestinationEntity 要素は、関連付けにおける接続先外部コンテンツ タイプを指定します。 |
親要素
| 要素 | 説明 |
|---|---|
| メソッドの MethodInstances 要素 (BDCMetadata スキーマ) | 関連付けを含む MethodInstances 要素。 |