Bulk API 2.0 および Bulk API 開発者ガイド
jヘッダー行のリレーション項目
別のオブジェクトではなく、同じオブジェクトに関連付けられるというケースもあります。たとえば、取引先責任者の ReportsTo 項目は、別の取引先責任者を参照します。このような場合、列ヘッダーで「ReportsTo.Email」と記述すると、Email 項目の値に基づいて、各取引先責任者の ReportsTo 項目を一意に識別できます。列ヘッダーの ReportsTo の部分は、ReportsTo 項目の relationshipName プロパティの値です。リレーションを使用した CSV ファイルの例を次に示します。
1FirstName,LastName,ReportsTo.Email
2Tom,Jones,buyer@salesforcesample.comCSV ファイルのヘッダー行でリレーションを参照する場合は、次の点に注意します。
- 子から親へのリレーションを使用できます。親から子へのリレーションは使用できません。
- 子から親へのリレーションを拡張して使用することはできません。つまり、子から親へのリレーションを参照し、さらに親からその親へのリレーションを参照することはできません。
- 親の識別では、インデックス化された項目のみを使用できます。カスタム項目は、外部 ID 属性が選択されている [外部 ID] 項目である場合、インデックス化されています。標準項目は、idLookup プロパティの値が true に設定されている場合、インデックス化されています。詳細は、「標準オブジェクト」で、各オブジェクトの項目リストの「項目のプロパティ」列を参照してください。
カスタムオブジェクトのリレーション項目
カスタムオブジェクトでは、カスタム項目を使用してオブジェクト間のリレーションを追跡します。2 つのカスタムオブジェクト間のリレーションを示すには、__r (アンダースコア 2 つと「r」) で終わるリレーション名を使用します。列ヘッダーでこのリレーションを指定して、関連オブジェクトへの参照を追加できます。
たとえば、子オブジェクトに、あるカスタムオブジェクトを親として参照する Mother_Of_Child__c という [API 参照名] を持つカスタム項目があり、親となるオブジェクトに External_ID__c という [API 参照名] を持つ項目がある場合は、Mother_Of_Child__r.External_ID__c という列ヘッダーを記述することにより、親オブジェクトの [外部 ID] 項目を使用して、[Mother Of Child] 項目を一意に識別できます。列ヘッダー内のリレーション名では、子オブジェクトのカスタム項目の __c を __r で置き換えた値を入力します。リレーションについての詳細は、www.salesforce.com/us/developer/docs/soql_sosl/index.htm にある『Salesforce SOQL および SOSL リファレンスガイド』の「リレーション名について」を参照してください。
リレーションを使用した CSV ファイルの例を次に示します。
1Name,Mother_Of_Child__r.External_ID__c
2CustomObject1,123456多態的な項目でのリレーション
多態的な項目では、2 種類以上のオブジェクトを親として参照できます。たとえば、取引先責任者またはリードを ToDo の親にすることができます。つまり、ToDo の WhoId 項目に取引先責任者またはリードの ID を含めることができます。多態的な項目は柔軟性が高く、列ヘッダーの構文に、親オブジェクトの種別を定義する要素を追加できるようになっています。構文は次のとおりです。
ObjectType:RelationshipName.IndexedFieldName.
後続のサンプルには、次の 2 つの参照項目が含まれています。
- WhoId: これは多態的な項目であり、Who という relationshipName が使用されています。ここでは、リードを参照し、インデックス化された [メール] 項目を使用して親レコードを一意に識別します。
- OwnerId: この項目は多態性を持たず、Owner という relationshipName が使用されています。ユーザを参照し、インデックス化された Id 項目を使用して親レコードを一意に識別します。
1Subject,Priority,Status,Lead:Who.Email,Owner.Id
2Test Bulk API polymorphic reference field,Normal,Not Started,lead@salesforcesample.com,005D0000001AXYz