パブリック一意ID (PUID)を設定するにはどうすればよいですか。
Oracle CXアプリケーションのパブリック一意ID (PUID)を構成する場合、3つの設定オプションがあります。
公開一意ID (PUID)の設定オプション
PUIDには、次の3つのレベルの設定オプションがあります:
- デフォルトの設定を使用します。実装ステップは必要ありません。
- ある程度構成可能な基本設定を使用します。 この設定を使用する場合、デフォルト設定は使用されません。
- より複雑かつ構成可能な拡張設定を使用します。 デフォルト設定と基本設定は、すべてのオブジェクトに適用されます。 拡張設定はオブジェクトごとに行います。
このトピックでは、PUIDの「拡張設定」について説明します。 これは、特定のプリフィクスおよび基数構成であるPUIDの一意の連番生成を設定することを意味します。 これらは、ビジネス・オブジェクトごとに設定します。 また、PUIDの仕様では、サポートされているすべてのビジネス・オブジェクトをユーザーがPUIDおよびパーティ番号で検索できる必要があることに注意してください。
次に、設定オプションのリストと、設定に関する詳細情報の参照先を示します。
| 設定オプション | 摘要 | 詳細の参照先 |
|---|---|---|
| デフォルト設定 | この設定では、実装ステップは不要です。 レコードごとに一意の15桁の数値IDが自動的に生成されます。 文書連番は1から始まります。 | この紹介以外の追加のドキュメントはありません |
| 基本設定 | この設定では、使用する基数(またはベース数と文字)とプリフィクスを構成する2つのプロファイル・オプションを設定します。 アプリケーションでは、各レコードごとにデフォルトの数値の公開一意IDではなく、英数字の公開一意IDが生成されます。 | 「公開一意ID基本設定」セクション |
| 拡張設定 | この設定では、オブジェクトごとに基数とプリフィクスを定義します。 基数とプリフィクスは、オブジェクトごとに異なる必要はありません。 | 公開一意IDの拡張設定 |
公開一意IDの基本設定
基本設定では、実装内のすべてのビジネス・オブジェクトで共有される単一のプリフィクスを定義します。 さらに、使用可能な複数の異なる基数値が用意されています。 これらの値を組み合せてPUIDを形成します。
基本設定を実行するには、次のプロファイル・オプションを設定します。
- 「CRM公開一意ID文字列エンコーディング」プロファイル・オプション: 基数またはベース数に基づいて、公開一意IDのエンコーディングに使用される文字を制御します。
- 「CRM公開一意IDプリフィクス」プロファイル・オプション(ZCA_PUID_PREFIX): 公開一意IDのオプションのプリフィクス値を定義します。 このプロファイル・オプションを使用する場合は、サイト・レベルで公開一意IDのプリフィクスを定義します。 このプロファイル・オプションを目的のプリフィクスに設定すると、公開一意IDベースでエンコードされた文書連番値の前にプリフィクスが挿入されます。 たとえば、企業の製薬部門のレコードを、公開一意IDとプレフィクス
PharmaまたはPharma1、Pharma2などで示すことができます。 デフォルトでは、プリフィクスに値はありません。 - 「CRM公開一意ID文字列エンコーディング」プロファイル・オプション(ZCA_PUID_RADIX): このプロファイル・オプションは、公開一意IDの作成に使用される数字と文字のセットを決定します。 デフォルト値はnullです。 基数を設定すると、アプリケーションは、数字のかわりに英数字を使用して、公開一意IDをわかりやすいIDに変換します。
PUIDの構築時には、次のベース値を使用できます。
- 数字0-9、文字A-F
- 文字A-Z、大文字
- 数字2-9、文字BCDFGHJKLMNPQRSTVWXYZ
- 数字0-9、文字ABCDEFGHJKLMNPQRTUWXY
- 数字0-9、文字A-Z、大文字
- 数字0-9、文字A-Z、文字a-z
- 英数字変換なし
基数の値は、参照タイプZCA_PUID_ENCODINGに格納されます。 この参照タイプには、「設定と保守」の「標準参照の管理」タスクを使用してアクセスできます。
次の点に注意してください。
- プリフィクス値を入力する場合は、基数値を設定する必要があります。 プリフィクス値の長さは5です。 プリフィクス設定は単独では使用できません。
- デリミタが必要な場合は、プリフィクスの一部として含めます。
- 連結された公開一意IDとプリフィクスは、定義されたフィールド長(通常は30文字)を超えないようにしてください。
プロファイル・オプションの設定方法は次のとおりです。
- 設定ユーザーとしてサインインし、「設定およびメンテナンス」で次の場所に移動: .
- 「公開一意識別子プロファイル・オプションの管理」ページで、「ZCA_PUID_RADIX」オプションをクリックします。
- ページの「ZCA_PUID_RADIX: プロファイル値」セクションで、「プロファイル・オプション値」値リストをクリックし、ベース採番値を選択します。
- 「保存して閉じる」をクリックします
- 必要に応じて、「ZCA_PUID_PREFIX」オプションをクリックします。
- ページの「ZCA_PUID_PREFIX: プロファイル値」セクションの「プロファイル値」ボックスに、必要なプリフィクスとデリミタ(ある場合)を入力します。 たとえば、
CDRM_と入力します。 - 「保存して閉じる」をクリックします
公開一意IDの拡張設定
拡張設定では、ビジネス・オブジェクト(アカウント、担当者、商談など)ごとに異なるプリフィクスおよび採番基数を定義できます。 インポートを介してオブジェクト・レコードを移入するのと同時にUIやRESTでもレコードを作成する場合は、PUIDの競合を回避するため、これを実施することをお薦めします。
次の点に注意してください。
- プリフィクス値を入力する場合は、基数値を設定する必要があります。 プリフィクス設定は単独では使用できません。 プリフィクス値の長さは5です。
- デリミタが必要な場合は、プリフィクスの一部として含めます。
- 連結された公開一意IDとプリフィクスは、定義されたフィールド長(通常は30文字)を超えないようにしてください。
次のステップを使用して、拡張設定で基数およびオプションでプリフィクスを構成します。
- 設定ユーザーとしてサインインし、「設定およびメンテナンス」で次の場所に移動: .
- 「公開一意識別子連番生成の管理」ページで、これらの値を初めて構成する場合は、表に行を追加します。
- 「オブジェクト」値リストで、公開一意IDを構成するオブジェクトを選択します。
- 「基数」値リストで、使用するベース採番を選択します。 使用可能な基数値のこのリストは、ZCA_PUID_RADIXプロファイル・オプションで提供される値のリストと同じです。
- 「プリフィクス」ボックスに、オブジェクトと一意IDに使用するプリフィクスを入力します。
- 5文字以下で入力します。
- 使用可能な文字は、0-9、A-Z、a-zおよび特殊文字(ピリオド、ハイフン、カンマおよびアンダースコア)です。
- 他のオブジェクトについて繰り返します。
- 「保存して閉じる」をクリックします
この表は、「公開一意識別子順序生成の管理」タスクのRADIXのオプションをリストしています。 たとえば、リード番号の形式が"LeadNumber"の場合、連番は次のようになります。
- リード・オブジェクトの拡張設定が設定されていない場合は"CDRM_2452"です。
- リード・オブジェクトの拡張設定が設定されている場合、LeadNumberは"LeadNumber" = "LEAD_106065"の形式で作成されます。
- PREFIXはLEAD_で、RADIXは"106065" (英数値変換なしの形式)です。
- RADIXの形式は、文字A-Z、大文字です。 "LeadNumber": "LEAD_GAXM"。
| プリフィクス | 基数 |
|---|---|
|
NULL |
NULL |
|
NULL |
数字0-9、文字A-F |
|
NULL |
数字0-9、文字A-F |
|
A- |
数字0-9、文字A-F |
|
A- |
数字0-9、文字A-F |
|
Null |
英数字変換なし |
|
A- |
数字0-9、文字A-Z、文字a-z |
|
A- |
数字0-9、文字A-Zの大文字 |
|
A- |
数字0-9、文字ABCDEFGHJKLMNPQRTUWXY |
|
A- |
数字2-9、文字BCDFGHJKLMNPQRSTVWXYZ |
|
A- |
文字A-Z、大文字 |
|
A- |
数字0-9、文字A-F |
PUIDをサポートするOracle CXビジネス・オブジェクト
Oracle CXビジネス・オブジェクトの多くは、次の表に示すようにPUIDをサポートしています:
| トップレベル・オブジェクト名 | モデル・サポート(PUID属性名) | オブジェクトPUIDの生成 | PUIDによるグローバル検索 | リスト管理で公開されるPUID |
|---|---|---|---|---|
|
アカウント |
PartyNumber (RegistryID) |
サポート対象 |
サポート対象 |
サポート対象 |
|
処理 |
ActionNumber |
サポート対象 |
NA |
NA |
|
処理プラン |
ActionPlanNumber |
サポート対象 |
NA |
NA |
|
アクティビティ |
Activity_Number |
サポート対象 |
サポート対象 |
サポート対象 |
|
資産 |
AssetNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
ビジネス・プラン |
BusinessPlanNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
キャンペーン |
CampaignNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
競合相手(アプリケーション・コンポーザでは競合相手と呼ばれます) |
PartyNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
担当者 |
PartyNumber (RegistryID) |
サポート対象 |
サポート対象 |
サポート対象 |
|
カスタム・オブジェクト |
カスタム属性 |
サポート対象 |
サポート対象 |
サポート対象 |
|
ディール登録 |
ディール番号 |
サポート対象 |
サポート対象 |
サポート対象 |
|
顧客対応 |
InteractionNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
リード(アプリケーション・コンポーザでは営業リードと呼ばれます) |
Lead_Number |
サポート対象 |
サポート対象 |
サポート対象 |
|
MDF予算、MDF請求、MDF請求決済、MDF要求 |
MDF請求: コード(ClaimCode) MDF要求: コード(FundRequestCode) MDF予算: コード(BudgetCode) MDF請求決済: コード(ClaimSettlementCode) |
サポート対象 |
サポート対象 |
サポート対象 |
|
目的 |
ObjectiveNumber |
サポート対象 |
NA |
NA |
|
商談 |
Opty_Number |
サポート対象 |
サポート対象 |
サポート対象 |
|
パートナ |
Company_Number |
サポート対象 |
サポート対象 |
サポート対象 |
|
見積(アプリケーション・コンポーザでは販売オーダーと呼ばれます) |
OrderHeaderNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
価格台帳 |
PriceBook_Code |
サポート対象 |
サポート対象 |
サポート対象 |
|
製品 |
ItemNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
製品グループ |
Reference_Number |
サポート対象 |
サポート対象 |
NA |
|
プログラム登録 |
登録番号 |
サポート対象 |
NA |
サポート対象 |
|
プロモーション |
販売プロモーション・コード |
サポート対象 |
NA |
サポート対象 |
|
リソース |
パーティ番号 |
サポート対象 |
サポート対象 |
サポート対象 |
|
サービス・リクエスト |
SRNumber |
サポート対象 |
サポート対象 |
サポート対象 |
|
テンプレート処理プラン |
TemplateNumber |
サポート対象 |
NA |
NA |
|
テリトリ(アプリケーション・コンポーザでは営業テリトリと呼ばれます) |
サポート対象(一意のテリトリ番号) |
サポート対象 |
NA |
サポート対象 |
|
テリトリ提案(アプリケーション・コンポーザでは営業テリトリ提案と呼ばれます) |
サポート対象(提案番号) |
サポート対象 |
NA |
サポート対象 |
|
作業オーダー |
WO_NUMBER |
サポート対象 |
サポート対象 |
サポート対象 |