.NET 用 SDK を使用したテーブル行の関連付けと関連付け解除

  • [アーティクル]

テーブル行は、関連するテーブル行のルックアップ列を使用して相互に関連付けられます。 一対多の関係にある 2 つの行を関連付ける最も簡単な方法は、EntityReference を使用して、関連する行のルックアップ列の値を設定することです。

一対多の関係にある 2 つの行の関連付けを解除する最も簡単な方法は、ルックアップ列の値を null に設定することです。

多対多の関係を使用する関連付けも、多対多の関係をサポートする 交差エンティティ のルックアップ列に依存します。 これらの関係は、その交差エンティティの行の存在によって定義されます。 交差エンティティを直接操作することはできますが、API を使用する方がはるかに簡単です。

Associate メソッドまたは AssociateRequest の使用

IOrganizationService.Associate メソッド、または または AssociateRequest を IOrganizationService.Execute メソッド で使用する際の主な価値は、次のことができることです。

  • 1 回の操作で複数の行を関連付ける
  • 交差エンティティを意識することなく、多対多の関係を使用して行を簡単に関連付ける。

テーブル行をこれらの API に関連付けるには、次の 3 つが必要です:

  • 関連付ける行へのエンティティ参照
  • 関連付けの名前
  • テーブル行を関連付ける 1 つ以上の参照

関係が 1 対多であるか多対多であるかは関係ありません。 パラメータまたはプロパティは同等です。

メタデータ ブラウザを使用してカスタマイズ UI またはメタデータを表示することによって、関係の名前を見つけることができます。

詳細:

次の例では、Redmond にあるすべてのアカウントの取引先責任者として特定の連絡先 (jimGlynn) を設定します。


// Retrieve the accounts
var query = new QueryByAttribute("account")
{
ColumnSet = new ColumnSet("name")
};
query.AddAttributeValue("address1_city", "Redmond");

EntityCollection accounts = svc.RetrieveMultiple(query);

//Convert the EntityCollection to a EntityReferenceCollection
var accountReferences = new EntityReferenceCollection();

accounts.Entities.ToList().ForEach(x => {
accountReferences.Add(x.ToEntityReference());
});

// The contact to associate to the accounts
var jimGlynn = new EntityReference("contact", 
new Guid("cf76763a-ba1c-e811-a954-000d3af451d6"));

// The relationship to use
var relationship = new Relationship("account_primary_contact");

// Use the Associate method
svc.Associate(jimGlynn.LogicalName, jimGlynn.Id, relationship, accountReferences);

それによって特別な利点はありませんが、AssociateRequest を使用する場合は、最後の行を次のように置き換えることができます。

// Use AssociateRequest
AssociateRequest request = new AssociateRequest()
{
RelatedEntities = accountReferences,
Relationship = relationship,
Target = jimGlynn
};

svc.Execute(request);

この操作は、Account.PrimaryContactId ルックアップ列に対する 3 つの個別の更新操作と同じですが、取引先企業に対する多対一のエンティティの関係と、取引先担当者に対する一対多のエンティティの関係である account_primary_contact の関連付けを使用しています。

関係列のプロパティを調べると、ReferencingEntity 値が account で、ReferencingAttribute 値が primarycontactid であることがわかります。

Disassociate メソッドまたは DisassociateRequest の使用

IOrganizationService.Disassociate メソッドまたは DisassociateRequest と IOrganizationService.Execute メソッドは メソッドは、テーブル行を関連付ける方法の逆です。

次のコードは、上記のサンプルで作成された関連付けを元に戻します。

// Retrieve the accounts
var query = new QueryByAttribute("account")
{
ColumnSet = new ColumnSet("name")
};
query.AddAttributeValue("address1_city", "Redmond");

EntityCollection accounts = svc.RetrieveMultiple(query);

//Convert the EntityCollection to a EntityReferenceCollection
var accountReferences = new EntityReferenceCollection();

accounts.Entities.ToList().ForEach(x => {
accountReferences.Add(x.ToEntityReference());
});

// The contact to associate to the accounts
var jimGlynn = new EntityReference("contact", 
new Guid("cf76763a-ba1c-e811-a954-000d3af451d6"));

// The relationship to use
var relationship = new Relationship("account_primary_contact");

// Use the Disassociate method
svc.Disassociate(jimGlynn.LogicalName, jimGlynn.Id, relationship, accountReferences);

それによって特別な利点はありませんが、DisassociateRequest を使用する場合は、最後の行を次のように置き換えることができます。

// Use DisassociateRequest
DisassociateRequest request = new DisassociateRequest()
{
RelatedEntities = accountReferences,
Relationship = relationship,
Target = jimGlynn
};

svc.Execute(request);

参照

.NET 用 SDK を使用したテーブル行の作成
SDK for .NET を使用してテーブルの行を取得する
SDK for .NET を使用したテーブル行の更新と削除

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。