レコードのインポートに代替キーを使用する方法
代替キーは、関係を作成、更新、削除および管理できるように、オブジェクト・レコードを一意に識別するのに役立ちます。 これにより、各レコードのシステム生成主キーを把握しなくても、他のオブジェクトとの関係をインポートして構築できます。
また、既知の代替キーを使用すると、データを再問合せおよび再マップする必要がなくなります。
代替キーの例を次に示します:
-
パブリック一意識別子 (
PUID
) - 、自動生成順序番号を定義する機能をサポートしています。 -
オリジナル・システム/オリジナル・システム参照(OS/OSR) - 次の2つのフィールドで構成されます:
-
元のシステム - レコードがソース化されたソース・システムを参照します。 管理者がこのフィールドを構成する必要があります。
-
当初システム参照 - ソース・システム内のレコードの一意の識別子を参照します。
-
-
電子メール・アドレス - レコードの電子メール・アドレス値は、一部のオブジェクト(従業員リソースなど)でレコードを識別するために使用できます。
キーは、次の順序で解決されます:
-
主キー(PK)
-
パブリック一意識別子 (
PUID
) -
OS/OSR (該当する場合)
-
他の任意の代替キー(複数の代替キーがサポートされている場合は、
PUID
が優先順の最初の代替キーである必要があります)
インポート管理、大量インポート・モードおよび外部データ・ローダー・クライアントでサポートされるユースケースを次に示します:
何をしようとしているのか |
実行方法 |
---|---|
レコードの値の更新 |
|
インポート管理を使用して更新を実行する際に、ソースCSVファイルに複数の行があり、それぞれが同じPKまたはPUID値を使用している場合、ソース・ファイル内のレコードはリストされている順序で処理されない可能性があります。
レコードの作成、更新および削除のシナリオ
シナリオAは、キーと勘定科目オブジェクトの様々な組合せを使用してレコードを作成、更新および削除する様々な方法の例を示しています。 次の図と表は、このシナリオのユースケースを示しています:

列 |
意味 |
---|---|
PartyId |
主キー。 値は、システム生成の文書連番から取得されます。 nullは指定しないでください。 |
PartyNumber |
PUID レコードが作成されると、値が渡されるか、またはシステム生成になります。 nullは指定しないでください。 |
SourceSystem |
ソース・システム名。 nullにできます。 (OS/OSR構成をサポートしているオブジェクトは限られた数のみ) |
SourceSystemReferenceValue |
ソース・システム参照。 nullにできます。 (OS/OSR構成をサポートしているオブジェクトは限られた数のみ) |
CEOName |
これは、オブジェクトの非キー・データ属性です。 nullにできます。 |
ユース・ケース |
ソース・ファイルの内容 |
摘要 |
PK |
PUID |
OS |
OSR |
非キー・データ |
---|---|---|---|---|---|---|---|
レコードを作成し、プライマリ・オブジェクトにPUIDを渡します |
PartyNumber: CA4139 CEOName: John Smyth |
レコードが作成されました |
98769 (system-generated) |
CA4139 |
N/A |
N/A |
John Smyth |
プライマリ・オブジェクトのPUID値を渡さずに、レコードを作成 |
CEOName: John Smyth |
レコードが作成されました |
98770 (system-generated) |
CA4140 (system-generated) |
N/A |
N/A |
John Smyth |
レコードを作成し、プライマリ・オブジェクトにOS/OSRを渡します |
SourceSystem: Siebel CRM SourceSystemReferenceValue: 3-0007 CEOName: John Smyth |
レコードが作成されました |
98771 (システム生成) |
CF380A (システム生成) |
Siebel CRM |
3-0007 |
John Smyth |
PKを使用してレコードを識別し、既存のレコードのデータ属性を更新 |
PartyId : 98769 CEOName: Soloman |
レコードが更新されました |
98769 |
N/A |
N/A |
N/A |
Soloman |
OS/OSRを使用してレコードを識別し、既存のレコードのデータ属性を更新 |
SourceSystem: Siebel CRM SourceSystemReferenceValue: 3-0007 CEOName: Soloman |
レコードが更新されました |
98771 |
N/A |
Siebel CRM |
3-0007 |
Soloman |
PKを使用してレコードを識別し、既存のレコードを削除 |
PartyId : 98769 |
レコードが削除されました |
98769 |
N/A |
N/A |
N/A |
N/A |
PUIDを使用してレコードを識別し、既存のレコードを削除 |
PartyNumber : CA4140 |
レコードが削除されました |
98770 |
CA4140 |
N/A |
N/A |
N/A |
OS/OSRを使用してレコードを識別し、既存のレコードを削除 |
SourceSystem: Siebel CRM SourceSystemReferenceValue: 3-0007 |
レコードが削除されました |
98771 |
N/A |
Siebel CRM |
3-0007 |
N/A |
シナリオBは、子レコードを作成し、親レコードとの関係を更新および削除する様々な方法を示しています。 ここでアカウントは親であり、住所は子オブジェクトです。 次の図と表は、このシナリオのユースケースを示しています:

列 |
意味 |
---|---|
PartyId |
主キー。 値は、システム生成の文書連番から取得されます。 nullは指定しないでください。 |
PartyNumber |
PUID レコードが作成されると、値が渡されるか、またはシステム生成になります。 nullは指定しないでください。 |
SourceSystem |
ソース・システム名。 nullにできます。 |
SourceSystemReferenceValue |
ソース・システム参照識別子。 nullにできます。 |
CEOName |
これは、オブジェクトの非キー・データ属性です。 nullにできます。 |
PartyId |
親レコードへの外部キー。 この値には、親オブジェクトのレコードのPKが含まれます。 |
PartyNumber |
親レコードへの外部キー。 この値には、親オブジェクト内のレコードのPUIDが含まれます。 |
AddressNumber |
この値には、子オブジェクト内のレコードのPUIDが含まれます。 |
PartySourceSystem |
親オブジェクトのソース・システム値。 |
PartySourceSystemReferenceValue |
親オブジェクトのソース・システム参照値。 |
ユース・ケース |
ソース・ファイルの内容 |
摘要 |
PK |
PUID |
親PUID |
親OS |
親OSR |
OS |
OSR |
非キー・データ |
外部キー |
---|---|---|---|---|---|---|---|---|---|---|---|
子レコードを作成し、カスタムPUIDおよび親オブジェクトのPK値を渡します |
PartyNumber: CA2700 CEOName: ロード PartyId: 98770 |
子レコードが作成され、親との関係はPKを介して確立されます |
5001 (システム生成) |
CA2700 |
N/A |
N/A |
N/A |
N/A |
N/A |
ロード |
98770 |
子レコードを作成し、親オブジェクトのPUID値を渡します |
CEOName: ロード PartyNumber: CA2700 |
子レコードが作成され、親との関係はPUIDを介して確立されます |
5002 (システム生成) |
システム生成 |
CA2700 |
N/A |
N/A |
N/A |
N/A |
ロード |
N/A |
子のPUIDをキーとして使用して、別の親を指すように関係を更新 |
PartyNumber: CA2700 AddressNumber: CF383 |
PUIDを介して設定された新規親への既存の子レコード更新関係 |
5001 |
CA2700 |
N/A |
N/A |
N/A |
N/A |
N/A |
ロード |
98772 |
親との関係の削除 |
PartyId: 5002 |
エラー - 子レコードは単独では存在できません。 親との関係が必要です。 (アドレス・オブジェクトは例外です。) |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
子レコードを作成し、親オブジェクトのOS/OSR値を渡します |
PartySourceSystem: Siebel CRM PartySourceSystemReferenceValue: 3-0001 SourceSystem: Siebel CRM SourceSystemReferenceValue: 3-9001 |
子レコードが作成され、親との関係はOS/OSRを介して確立されます |
system-generated |
CA2701 |
N/A |
Siebel CRM |
3-0001 |
Siebel CRM |
3-9001 |
N/A |
N/A |
子レコードを作成し、親オブジェクトのPUID値を渡します |
PartyNumber: CDRM-2001 |
子レコードが作成され、親との関係は親PUIDを介して確立されます |
system-generated |
CA2702 |
CDRM-2001 |
N/A |
N/A |
Siebel CRM |
3-9002 |
N/A |
N/A |
子レコードを作成し、親オブジェクトの外部キー値を渡します |
PartyId: 1234 |
子レコードが作成され、親との関係は外部キーを介して確立されます |
system-generated |
CA2703 |
N/A |
N/A |
N/A |
Siebel CRM |
3-9003 |
N/A |
1234 |
PUIDを使用した子レコードの削除によるレコードの識別 |
AddressNumber: CDRM-9001 |
レコードのPUIDを使用した子レコードの削除 |
N/A |
CDRM-9001 |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
OS/OSRを使用してレコードを識別する子レコードの削除 |
SourceSystem: Siebel CRM SourceSystemReferenceValue: 3-0007 |
OSおよびOSRを使用した子レコードの削除 |
N/A |
N/A |
N/A |
N/A |
N/A |
Siebel CRM |
3-0007 |
N/A |
N/A |
主キーを使用した子レコードの削除 |
AddressId: 9898989 |
主キーを使用した子レコードの削除 |
9898989 |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |
N/A |