一部の RegulatoryOne レジストレーションおよびドシエ管理機能では、設定プロセスの一部として、特定のコンポーネントタイプのコンポーネントを作成する必要があります。コンポーネントタイプは、Vault の機能的動作を拡張する構成要素です。コンポーネントは、特定の設定詳細を含むコンポーネントタイプのインスタンスです。一部のコンポーネントは、サブコンポーネントに追加データを保存します。コンポーネントは、そのサブコンポーネントと親子関係を持ち、サブコンポーネントは常に親コンポーネントに属します。

レジストレーションおよびドシエ管理 Vault 内の一部のコンポーネントを表示、作成、および編集できます。ただし、一部のコンポーネントには MDL でのみアクセスできます。MDL を使用して、この記事に含まれるコンポーネントタイプのいずれかを無効化、再有効化、および削除する必要があります。MDL でコンポーネントへのアクセス、作成、および変更を行う方法について、詳しくは Vault コンポーネントについてを参照してください。

コンポーネントタイプ

以下のコンポーネントタイプは、レジストレーションおよびドシエ管理 Vault で使用できます:

ラベルAPI 名詳細アクセシビリティ
オブジェクトマッピングObjectmappingソースオブジェクトとターゲットオブジェクトをマッピングします。Vault と MDL でアクセスできます。
フィールドマッピングFieldmappingオブジェクトマッピングのこのサブコンポーネントは、関連するオブジェクトマッピングで定義されたオブジェクトに 2 つのフィールドをマップします。Vault と MDL でアクセスできます。
関連トークンRelationaltokenサポートされているアクションの実行時に、Vault がオブジェクトレコードを作成または入力する方法を特定します。Vault で部分的にアクセス可能で、一部の機能は MDL でのみアクセス可能です。
関連トークン設定Relationatokensettingサポートされるアクションのルート関連トークンを定義します。MDL でのみアクセスできます。
レジストレーション属性Registrationattributeローカルインスペクションアセスメントおよびグローバル変更インスペクションアセスメントレジストレーション項目フィールド属性を定義します。MDL でのみアクセスできます。

オブジェクトマッピングとフィールドマッピングの定義

オブジェクトマッピングコンポーネントは、ソースオブジェクトとターゲットオブジェクトを定義します。フィールドマッピングは、関連するオブジェクトマッピングで定義されたソースオブジェクトとターゲットオブジェクト間のフィールドをマッピングするオブジェクトマッピングのサブコンポーネントです。まずオブジェクトマッピングを作成し、そのオブジェクトマッピングにフィールドマッピングサブコンポーネントを追加する必要があります。

レジストレーションおよびドシエ管理 Vault 内と MDL 内で、オブジェクトマッピングとフィールドマッピングへのアクセス、作成、変更ができます。MDL を使用して、オブジェクトマッピングとフィールドマッピングを削除または無効にする必要があります。Vault でフィールドマッピングを使用してオブジェクトマッピングを作成する方法の詳細については、オブジェクトマッピングとフィールドマッピングの定義を参照してください。

関連トークンの定義

関連トークンコンポーネントはオブジェクト間の階層関係を活用しており、サポートされているアクションが実行されると、、ユーザはトークン解決に基づいてレコードを自動的に生成および入力できます。反復的な関連トークンを作成する際、Vault は、これ以上追加レコードが作成できなくなるまで、トークンが指定されたオブジェクトの階層経由で解決すると作成される、すべての生成済みレコードにトークンを適用します。新規レコードの作成時に、または反復的なレコードの作成後に、関連トークンのVQL 条件が適用されるかどうかを指定することもできます。

反復的でない関連トークンは、レジストレーションおよびドシエ管理 Vault で作成できます。MDL で関連トークンを作成することもできます。MDL を使用して、作成後に関連トークンにアクセスおよび変更したり、反復的な関連トークンを作成したりする必要があります。Vault で非反復的な関連トークンを作成する方法の詳細については、関連トークンの定義を参照してください。

関連トークンコンポーネント属性

関連トークンコンポーネントには、以下の属性が含まれます:

属性API 名フィールドタイプ説明
名前name文字列 (最大長 128)API 名.
トークンラベルラベル文字列 (最大長 60)UI に適した文字列。
有効有効ブーリアンコンポーネントが有効かどうかを示します。
説明description文字列 (最大長 1500)このトークンの説明 (任意)。
オブジェクトオブジェクトオブジェクトこのトークンが参照するオブジェクトの API 名。
フィールドラベルfield_labelObject.field解決時にトークンのラベルとして使用されるオブジェクトフィールドの API 名。この属性は、ユーザが要件の生成アクションを実行した場合にのみ参照されます。
VQL 条件vql_criteria文字列 (最大長 1500)このトークンが解決を行う際にオブジェクトレコードに適用する VQL 条件 (任意)。
親トークン参照フィールドタイプparent_token_objectEnum親トークンがこのトークンに対してどのように処理されるかを決定します:
  • self: 親トークン参照フィールドは、このトークンの同じオブジェクト上にあります。
  • parent: 親トークン参照フィールドは、親トークンのオブジェクト上にあります。
  • composition: 親トークン参照フィールドは、このトークンのオブジェクトに関連するジョインオブジェクトまたは組成オブジェクト上にあります。
  • none: このトークンには親がなく、親トークン参照フィールドは「ID」です。
親トークンparent_tokenRelationaltoken親トークンのトークンラベル。self タイプの親トークン参照フィールドタイプの場合、この属性を空白のままにします。
親トークン参照フィールドparent_token_reference_fieldObject.field親トークンのフィールドラベル。
親トークンオブジェクトparent_token_objectオブジェクト親トークンのオブジェクトの API 名。
親トークン子フィールドparent_token_child_fieldObject.field親トークンのフィールドラベルの API 名。
リクエスト要件オブジェクトマッピングrequest_requirement_object_mappingObjectmapping選択したオブジェクトマッピングのターゲットは、request_requirement__v オブジェクトです。
EDL オブジェクトマッピングedl_object_mappingObjectmapping選択したオブジェクトマッピングのターゲットは、edl__v オブジェクトです。
EDL アイテムオブジェクトマッピングedl_item_object_mappingObjectmapping選択したオブジェクトマッピングのターゲットは、edl_item__v オブジェクトです。
リクエストオブジェクトマッピングrequest_object_mappingObjectmapping選択したオブジェクトマッピングのターゲットは、request__v オブジェクトです。
反復タイプrecursion_typeEnumこの関連トークンに適用する反復のタイプを指定します:
  • self: 反復参照フィールドは、トークンのオブジェクト上にあります。
  • composition: 反復参照フィールドは、このトークンのオブジェクトに関連するジョインオブジェクトまたは組成オブジェクト上にあります。
反復オブジェクトrecursion_objectオブジェクト受信オブジェクトの API 名。組成反復タイプの場合、これはこのトークンの受信関係のオブジェクトを指定します。
反復参照フィールドrecursion_reference_fieldObject.field反復が適用されるフィールドの API 名。
反復子フィールドrecursion_child_fieldObject.field受信オブジェクトフィールドの API 名。組成反復タイプの場合、これはこのトークンの受信関係のオブジェクトフィールドを指定します。
反復後の VQL 条件の使用use_vql_criteria_post_recursionブーリアンレコード作成後またはレコード作成時に VQL 条件を適用するかどうかを指定します。

関連トークン設定の定義

関連トークン設定コンポーネントタイプは、関連トークンをサポートするオブジェクトアクションの設定を定義します。サポートされる各アクションを適切なルート関連トークンにリンクして、関連トークンの解決時に各アクションが参照するルートトークンを指定する必要があります。これにより、オブジェクトを間接的に参照する関連トークンを定義できます。関連トークン設定コンポーネントで参照される関連トークンは、必要に応じて他の目的で使用することができます。

関連トークン設定へのアクセス、作成、変更には MDL を使用する必要があります。

サポートされるアクションにリンクするルートトークンとして使用するには、以下の 2 つの関連トークンコンポーネント (親と子) を使用することをお勧めします。これらのコンポーネントが Vault にまだ存在しない場合は、コンポーネントを作成する必要があるかもしれません:

属性親トークン子トークン
トークンラベルregistration_objective__cregistration_item__c
API 名registration_objective__cregistration_item__c
オブジェクトregistration__vrequest__v
親トークン参照フィールドタイプなしself
親トークン参照フィールドid__vregistration_objctive__v
親トークンnull registration_objective__c

関連トークン設定コンポーネント属性

関連トークン設定コンポーネントには、以下の属性が含まれます:

属性API 名フィールドタイプ説明
名前name文字列 (最大長 128)API 名.
ラベルラベル文字列 (最大長 60)UI に適した文字列。
有効有効ブーリアンコンポーネントが有効かどうかを示します。
アクションactionEnumこの設定が適用される、サポートされるアクション:
  • GENERATE_REQUIREMENT
  • GENERATE_REQUIREMENT_FOR_RO
  • SPLIT_REGISTRATION
ルートトークンroot_tokenRelationaltoken指定されたアクションのルート関連トークン。
関連オブジェクトタイプ RIRassociated_object_type_rirObjecttype指定されたアクションによって生成されたレジストレーション項目要件レコードに割り当てられるオブジェクトタイプ。この属性は、GENERATE_REQUIREMENT および GENERATE_REQUIREMENT_FOR_RO アクションにのみ適用され、これらのアクションの関連トークン設定コンポーネントに一意の値を設定する必要があります。一度入力すると、この値は変更できません。

ルートトークンへのアクションのリンク

関連トークン設定を作成し、以下のサポートされるアクションのアクション (action) およびルートトークン (root_token) 属性を設定する必要があります:

  • レジストレーション項目要件の生成 (GENERATE_REQUIREMENT): レジストレーション項目 (request__v) オブジェクトに対する要件の生成アクション。ルートトークン (registration_item__c など) は、request__v オブジェクトを参照する必要があります。
  • レジストレーション目的要件の生成 (GENERATE_REQUIREMENT_FOR_RO): レジストレーション (registration__v) オブジェクトレコードに対する要件生成アクション。ルートトークン (registration_objective__c など) は、registration__vオブジェクトを参照する必要があります。
  • レジストレーション項目の分割 (SPLIT_REGISTRATION): レジストレーション項目 (request__v) オブジェクトに対するレジストレーション項目の分割アクション。ルートトークン (registration_item__c など) は、request__v オブジェクトを参照する必要があります。

推奨される関連トークン (registration_objective__c および registration_item__c) を使用している場合、以下の関連トークン設定コンポーネントも使用して、サポートされるアクションをルートトークンにリンクすることをお勧めします。これらのコンポーネントが Vault にまだ存在しない場合は、コンポーネントを作成する必要があるかもしれません:

属性レジストレーションの項目要件の生成レジストレーションの目的要件の生成レジストレーション項目の分割
ラベルgenerate_requirementgenerate_requirement_for_rosplit_registration
名前generate_requirement__cgenerate_requirement_for_ro__csplit_registration__c
アクションGENERATE_REQUIREMENTGENERATE_REQUIREMENT_FOR_ROSPLIT_REGISTRATION
ルートトークンregistration_item__cregistration_objective__cregistration_item__c
関連オブジェクトタイプ RIR有効なレジストレーション項目要件オブジェクトタイプの名前有効なレジストレーション項目要件オブジェクトタイプの名前該当しない

関連トークンで参照されるオブジェクトは、アクションの実行時に関連トークンが解決を実行するように、サポートされるアクションのルート関連トークンによって定義されるオブジェクトに直接的または間接的に関連している必要があります。たとえば、要件の生成アクションが、レジストレーション項目レコード上で実行され、関連する要件名前フィールド内の packaging__c 関連トークンを使用する場合、packaging__c 関連トークンは、registration_item__c 関連トークンの直接的または間接的な子である必要があります。

レジストレーション属性の定義

レジストレーション属性コンポーネントタイプは、レジストレーション項目フィールド属性を定義し、それらをオブジェクトフィールドにマッピングします。次のアクションを正常に実行するには、関連するレジストレーション属性を定義する必要があります:

レジストレーション属性コンポーネントは、レジストレーション項目フィールドごとに 1 つだけ作成できます。

レジストレーション属性コンポーネントの属性

レジストレーション属性コンポーネントには、以下の属性が含まれます:

属性API 名フィールドタイプ説明
名前name文字列 (最大長 128)API 名.
ラベルラベル文字列 (最大長 60)UI に適した文字列。
有効有効ブーリアンコンポーネントが有効かどうかを示します。
オブジェクトオブジェクトオブジェクトレジストレーション項目オブジェクトの参照。この値は常に Object.request__v である必要があります。
フィールドfieldobject.field属性として使用されるレジストレーション項目フィールドの名前 (Field.made_in__cなど) 。この属性は、特定のフィールドタイプにのみ対応しています。ルックアップフィールドを入力する場合は、関連トークン属性を空白にする必要があります。
関連トークンrelational_tokenobject.field有効な関連トークンの名前。この属性はオプションです。この属性を設定する場合、関連トークンのリクエストオブジェクトマッピングフィールドに、有効なオブジェクトマッピングが入力されていることを確認します。オブジェクトマッピングは、トークンの解決に基づいて、レジストレーション項目の指定されたフィールドに入力される方法を決定します。ユーザによって実行されるアクションに応じて、関係トークンが適用されます:
  • 要件の生成: この属性は無視されます。
  • レジストレーションデータの生成: トークンの解決に基づいて、レジストレーション項目の指定されたフィールドに、どのオブジェクトマッピング使用して値が入力されるかを決定します。
  • グローバルインパクトアセスメントの実行: 生成されたレジストレーション項目のマッピングされたフィールドは空白になります。
グローバル操作変更オブジェクトglobal_operational_change_objectオブジェクトグローバル操作変更オブジェクトを参照します。この値は常に Object.global_operational_change__v である必要があります。この属性は、ユーザがグローバルインパクトアセスメントの実行アクションを実行した場合にのみ参照されます。

グローバルインパクトアセスメントを設定しない場合、この属性は空白のままにします。

グローバル操作変更フィールドglobal_operational_change_fieldobject.field有効なカスタムグローバル操作変更オブジェクトフィールドの名前 (Field.made_in__c など)。この属性は特定のフィールドタイプにのみ対応ており、コンポーネントのフィールド属性として入力するレジストレーション項目フィールドと同一のタイプである必要があります。この属性は、ユーザがグローバルインパクトアセスメントの実行アクションを実行した場合にのみ参照されます。

グローバルインパクトアセスメントを設定しない場合、この属性は空白のままにします。

サポートされているフィールドタイプ

Vault では、レジストレーションレーション属性コンポーネント属性について、特定のタイプのオブジェクトフィールドのみサポートしています。

フィールド属性

Vault は、このフィールド属性について、以下のタイプのオブジェクトフィールドをサポートしています:

  • 日付
  • 数字
  • オブジェクト(ユーザオブジェクトへの参照を除く)
  • 選択リスト(1 つの値)
  • テキスト(ロングテキスト、リッチテキストを含む)
  • ルックアップ (タイプが上記のサポートされるフィールドである場合)

グローバル操作変更フィールド属性

Vault は、グローバル操作変更フィールド属性について、以下のタイプのオブジェクトフィールドをサポートしています:

  • 数字
  • オブジェクト (親オブジェクトとユーザオブジェクトへの参照を除く)
  • 選択リスト (1 つの値)
  • テキスト(ロングテキスト、リッチテキストを含む)

グローバル操作変更フィールド属性をコンポーネントに含める場合、コンポーネントに追加したフィールド属性と同じタイプである必要があります。