公開一意IDの概要

ユーザーがデータベースにレコードを作成すると、アプリケーションではビジネス・オブジェクト・レコードごとに一意のIDが生成されるため、文書連番が使用されます。これらのIDは、公開一意IDまたはPUIDと呼ばれます。当然ながら、これらの数値は、長く複雑であるため、読みやすくも、使いやすくもありません。長いIDの問題を解決するために、設定時に、これらのIDをわかりやすく読みやすくすることができます。

これらのPUIDは、次で使用されます。

データ・モデル
拡張設定を使用する場合の一意の連番生成
PUID属性によるグローバル検索

営業アプリケーションと他の外部アプリケーションを統合する場合、営業アプリケーションは他のアプリケーションからPUIDをコールできます。コールするアプリケーションは、外部アプリケーションのアプリケーションが営業アプリケーションをコールしているかどうか、または個人がPUIDを使用しているかどうかによって異なります。

PUIDは、オブジェクトの作成時に指定します。たとえば、Party_Numberはアカウントおよび担当者のPUIDです。新しいアカウントを作成するときに、PUID値を中央ルーチンで自動作成させることもできますが、エンド・ユーザーが指定することもできます。

このドキュメントでは、PUIDの拡張設定について説明します。これは、特定のプリフィクスおよび基数構成であるPUIDの一意の連番生成を設定することを意味します。これらは、ビジネス・オブジェクトごとに設定します。また、PUIDの仕様では、サポートされているすべてのビジネス・オブジェクトをユーザーがPUIDおよびパーティ番号で検索できる必要があることに注意してください。

次の表に示すように、多くのビジネス・オブジェクトは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	サポート対象	サポート対象	サポート対象

設定オプション

設定には、次のオプションがあります。

デフォルトの設定を使用します。実装ステップは必要ありません。
ある程度構成可能な基本設定を使用します。この設定を使用する場合、デフォルト設定は使用されません。
より複雑かつ構成可能な拡張設定を使用します。デフォルト設定と基本設定は、すべてのオブジェクトに適用されます。拡張設定はオブジェクトごとに行います。

次に、設定オプションのリストと、設定に関する詳細情報の参照先を示します。

設定オプション	説明	詳細の参照先
デフォルト設定	この設定では、実装ステップは不要です。レコードごとに一意の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