一部の RegulatoryOne レジストレーションおよびドシエ管理機能では、設定プロセスの一部として、特定のコンポーネントタイプのコンポーネントを作成する必要があります。コンポーネントタイプは、Vault の機能的動作を拡張する構成要素です。コンポーネントは、特定の設定詳細を含むコンポーネントタイプのインスタンスです。一部のコンポーネントは、サブコンポーネントに追加データを保存します。コンポーネントは、そのサブコンポーネントと親子関係を持ち、サブコンポーネントは常に親コンポーネントに属します。
レジストレーションおよびドシエ管理 Vault 内の一部のコンポーネントを表示、作成、および編集できます。ただし、一部のコンポーネントには MDL でのみアクセスできます。MDL を使用して、この記事に含まれるコンポーネントタイプのいずれかを無効化、再有効化、および削除する必要があります。MDL でコンポーネントへのアクセス、作成、および変更を行う方法について、詳しくは Vault コンポーネントについてを参照してください。
注: この記事で説明するコンポーネントタイプは、RegulatoryOne レジストレーションおよびドシエ管理 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_label | Object.field | 解決時にトークンのラベルとして使用されるオブジェクトフィールドの API 名。この属性は、ユーザが要件の生成アクションを実行した場合にのみ参照されます。 |
VQL 条件 | vql_criteria | 文字列 (最大長 1500) | このトークンが解決を行う際にオブジェクトレコードに適用する VQL 条件 (任意)。 |
親トークン参照フィールドタイプ | parent_token_object | Enum | 親トークンがこのトークンに対してどのように処理されるかを決定します:
|
親トークン | parent_token | Relationaltoken | 親トークンのトークンラベル。self タイプの親トークン参照フィールドタイプの場合、この属性を空白のままにします。 |
親トークン参照フィールド | parent_token_reference_field | Object.field | 親トークンのフィールドラベル。 |
親トークンオブジェクト | parent_token_object | オブジェクト | 親トークンのオブジェクトの API 名。 |
親トークン子フィールド | parent_token_child_field | Object.field | 親トークンのフィールドラベルの API 名。 |
リクエスト要件オブジェクトマッピング | request_requirement_object_mapping | Objectmapping | 選択したオブジェクトマッピングのターゲットは、request_requirement__v オブジェクトです。 |
EDL オブジェクトマッピング | edl_object_mapping | Objectmapping | 選択したオブジェクトマッピングのターゲットは、edl__v オブジェクトです。 |
EDL アイテムオブジェクトマッピング | edl_item_object_mapping | Objectmapping | 選択したオブジェクトマッピングのターゲットは、edl_item__v オブジェクトです。 |
リクエストオブジェクトマッピング | request_object_mapping | Objectmapping | 選択したオブジェクトマッピングのターゲットは、request__v オブジェクトです。 |
反復タイプ | recursion_type | Enum | この関連トークンに適用する反復のタイプを指定します:
|
反復オブジェクト | recursion_object | オブジェクト | 受信オブジェクトの API 名。組成反復タイプの場合、これはこのトークンの受信関係のオブジェクトを指定します。 |
反復参照フィールド | recursion_reference_field | Object.field | 反復が適用されるフィールドの API 名。 |
反復子フィールド | recursion_child_field | Object.field | 受信オブジェクトフィールドの API 名。組成反復タイプの場合、これはこのトークンの受信関係のオブジェクトフィールドを指定します。 |
反復後の VQL 条件の使用 | use_vql_criteria_post_recursion | ブーリアン | レコード作成後またはレコード作成時に VQL 条件を適用するかどうかを指定します。 |
関連トークン設定の定義
関連トークン設定コンポーネントタイプは、関連トークンをサポートするオブジェクトアクションの設定を定義します。サポートされる各アクションを適切なルート関連トークンにリンクして、関連トークンの解決時に各アクションが参照するルートトークンを指定する必要があります。これにより、オブジェクトを間接的に参照する関連トークンを定義できます。関連トークン設定コンポーネントで参照される関連トークンは、必要に応じて他の目的で使用することができます。
関連トークン設定へのアクセス、作成、変更には MDL を使用する必要があります。
サポートされるアクションにリンクするルートトークンとして使用するには、以下の 2 つの関連トークンコンポーネント (親と子) を使用することをお勧めします。これらのコンポーネントが Vault にまだ存在しない場合は、コンポーネントを作成する必要があるかもしれません:
属性 | 親トークン | 子トークン |
トークンラベル | registration_objective__c | registration_item__c |
API 名 | registration_objective__c | registration_item__c |
オブジェクト | registration__v | request__v |
親トークン参照フィールドタイプ | なし | self |
親トークン参照フィールド | id__v | registration_objctive__v |
親トークン | null | registration_objective__c |
関連トークン設定コンポーネント属性
関連トークン設定コンポーネントには、以下の属性が含まれます:
属性 | API 名 | フィールドタイプ | 説明 |
名前 | name | 文字列 (最大長 128) | API 名. |
ラベル | ラベル | 文字列 (最大長 60) | UI に適した文字列。 |
有効 | 有効 | ブーリアン | コンポーネントが有効かどうかを示します。 |
アクション | action | Enum | この設定が適用される、サポートされるアクション:
|
ルートトークン | root_token | Relationaltoken | 指定されたアクションのルート関連トークン。 |
関連オブジェクトタイプ RIR | associated_object_type_rir | Objecttype | 指定されたアクションによって生成されたレジストレーション項目要件レコードに割り当てられるオブジェクトタイプ。この属性は、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_requirement | generate_requirement_for_ro | split_registration |
名前 | generate_requirement__c | generate_requirement_for_ro__c | split_registration__c |
アクション | GENERATE_REQUIREMENT | GENERATE_REQUIREMENT_FOR_RO | SPLIT_REGISTRATION |
ルートトークン | registration_item__c | registration_objective__c | registration_item__c |
関連オブジェクトタイプ RIR | 有効なレジストレーション項目要件オブジェクトタイプの名前 | 有効なレジストレーション項目要件オブジェクトタイプの名前 | 該当しない |
関連トークンで参照されるオブジェクトは、アクションの実行時に関連トークンが解決を実行するように、サポートされるアクションのルート関連トークンによって定義されるオブジェクトに直接的または間接的に関連している必要があります。たとえば、要件の生成アクションが、レジストレーション項目レコード上で実行され、関連する要件が名前フィールド内の packaging__c
関連トークンを使用する場合、packaging__c
関連トークンは、registration_item__c
関連トークンの直接的または間接的な子である必要があります。
重要: GENERATE_REQUIREMENT
および GENERATE_REQUIREMENT_FOR_RO
アクションの関連トークン設定コンポーネントは、関連オブジェクトタイプ RIR 属性で異なるレジストレーション項目要件オブジェクトタイプを参照する必要があります。関連付けられたオブジェクトタイプの RIR 値を入力した後で、変更することはできません。
レジストレーション属性の定義
レジストレーション属性コンポーネントタイプは、レジストレーション項目フィールド属性を定義し、それらをオブジェクトフィールドにマッピングします。次のアクションを正常に実行するには、関連するレジストレーション属性を定義する必要があります:
- ローカルインパクトアセスメント: 各コンポーネントにリンクする規制カテゴリ属性インパクトに基づいて、レジストレーションとレジストレーション目的の一致を識別します。
- レジストレーションデータの生成: コンポーネントに指定した関連トークンにリンクされたオブジェクトマッピングに基づいて、元となるレジストレーション項目レコードの指定されたフィールドに値を設定します。
- グローバルインパクトアセスメントの実行: 各コンポーネントに指定した定義済みのグローバル操作変更フィールドに基づいて、グローバル操作変更の影響を受ける可能性のあるレジストレーション項目を特定します。
レジストレーション属性コンポーネントは、レジストレーション項目フィールドごとに 1 つだけ作成できます。
レジストレーション属性コンポーネントの属性
レジストレーション属性コンポーネントには、以下の属性が含まれます:
属性 | API 名 | フィールドタイプ | 説明 |
名前 | name | 文字列 (最大長 128) | API 名. |
ラベル | ラベル | 文字列 (最大長 60) | UI に適した文字列。 |
有効 | 有効 | ブーリアン | コンポーネントが有効かどうかを示します。 |
オブジェクト | オブジェクト | オブジェクト | レジストレーション項目オブジェクトの参照。この値は常に Object.request__v である必要があります。 |
フィールド | field | object.field | 属性として使用されるレジストレーション項目フィールドの名前 (Field.made_in__c など) 。この属性は、特定のフィールドタイプにのみ対応しています。ルックアップフィールドを入力する場合は、関連トークン属性を空白にする必要があります。 |
関連トークン | relational_token | object.field | 有効な関連トークンの名前。この属性はオプションです。この属性を設定する場合、関連トークンのリクエストオブジェクトマッピングフィールドに、有効なオブジェクトマッピングが入力されていることを確認します。オブジェクトマッピングは、トークンの解決に基づいて、レジストレーション項目の指定されたフィールドに入力される方法を決定します。ユーザによって実行されるアクションに応じて、関係トークンが適用されます:
|
グローバル操作変更オブジェクト | global_operational_change_object | オブジェクト | グローバル操作変更オブジェクトを参照します。この値は常に Object.global_operational_change__v である必要があります。この属性は、ユーザがグローバルインパクトアセスメントの実行アクションを実行した場合にのみ参照されます。グローバルインパクトアセスメントを設定しない場合、この属性は空白のままにします。 |
グローバル操作変更フィールド | global_operational_change_field | object.field | 有効なカスタムグローバル操作変更オブジェクトフィールドの名前 (Field.made_in__c など)。この属性は特定のフィールドタイプにのみ対応ており、コンポーネントのフィールド属性として入力するレジストレーション項目フィールドと同一のタイプである必要があります。この属性は、ユーザがグローバルインパクトアセスメントの実行アクションを実行した場合にのみ参照されます。グローバルインパクトアセスメントを設定しない場合、この属性は空白のままにします。 |
サポートされているフィールドタイプ
Vault では、レジストレーションレーション属性コンポーネント属性について、特定のタイプのオブジェクトフィールドのみサポートしています。
Vault は、このフィールド属性について、以下のタイプのオブジェクトフィールドをサポートしています:
- 日付
- 数字
- オブジェクト(ユーザオブジェクトへの参照を除く)
- 選択リスト(1 つの値)
- テキスト(ロングテキスト、リッチテキストを含む)
- ルックアップ (タイプが上記のサポートされるフィールドである場合)
Vault は、グローバル操作変更フィールド属性について、以下のタイプのオブジェクトフィールドをサポートしています:
- 数字
- オブジェクト (親オブジェクトとユーザオブジェクトへの参照を除く)
- 選択リスト (1 つの値)
- テキスト(ロングテキスト、リッチテキストを含む)
グローバル操作変更フィールド属性をコンポーネントに含める場合、コンポーネントに追加したフィールド属性と同じタイプである必要があります。