セット内の参照データ値は、通常、固有のコードによって識別されます。 ただし、複数の列を使用してデータを識別する必要がある場合があります。 複合キー は、参照データ・セット内のコード列と最大 5 つのカスタム列の組み合わせです。 複合キーは、各参照データ値を一意的に識別するために使用されます。

必要な許可 リファレンス・データ・セットを作成、編集、または削除するには、以下の ユーザー許可が必要です。

• ガバナンス成果物へのアクセス

また、参照データ・セットの 1 次カテゴリーに以下のいずれかのカテゴリー・コラボレーター役割が必要です。

• 管理者
• 所有者
• エディター
• 参照データ・セットを作成する権限を持つカスタム役割。

複合キー は、各参照データ値を一意的に識別するために使用されます。 複合キーを使用すると、コード列の値が固有である必要がなくなります。 固有性は、指定されたすべての列の値が結合されている場合にのみ保証されます。個々の列の値が固有である必要はありません。

セットの複合キーを定義すると、そのようなセット内の各参照データ値は、複合キーの物理表現によってシステム内で識別されます。複合キーは、コード列と複合キー・カスタム列を、セットが最初に作成されたときに指定された順序で連結したものです。 値は | で区切られます (例: CODE|CC1|CC2|CC3)。 この物理表現は、システム内の参照データ値を識別するために (例えば、関係を追跡するために) 使用され、変更することはできません。

複合キーの作成に使用されるカスタム列には、以下の制約事項が適用されます。

• 複合キー列は、新規または空の参照データ・セットにのみ追加できます。 セットに参照データ値が既に追加されている場合は、複合キーを定義できません。
• 検証するカスタム列のタイプはテキストでなければなりません。
• 複合キーを構成するために、最大 5 つのカスタム列を「コード」列に追加できます。 コード列は常に最初に表示されます。
• カスタム列が複合キーの一部である場合は、必須として設定する必要があります。
• 参照データ値がセットに追加されると、複合キーは変更できなくなります。 変更が必要な場合は、新しい参照データ・セットを作成する必要があります。
• 複合キー列の長さは、最大 200 文字です。 複合キーの一部ではないカスタム列には、2000 に設定された制限があります。
• 文字 | および UNIT SEPARATOR (ASCII コード 0x31) を、複合キーの作成に使用されるコード列またはカスタム列で使用してはなりません。 この文字は、データベース内に複合キーの物理表現を作成するときに、複合キー値を区切るために使用されます。 この制限は、API v4にのみ適用されます。

値を持つ CSV ファイルを使用して複合キーで参照データ・セットを作成するには、以下のようにします。

1. 「ガバナンス」>「参照データ」を選択し、 「参照データ・セットの追加」をクリックします。

2. 「新規参照データ・セット」 をクリックし、「詳細」パネルで以下を指定します。

   1. その CSV ファイルをアップロードします。
   2. 参照データ・セットの名前を指定してください。
   3. 値のタイプ (テキスト、数値、または日付) を指定します。
   4. 参照データ・セットを作成するカテゴリーを選択します。
   5. オプションで、説明を入力します。

3. 「列のマップ」 パネルで、CSV ファイルの列をターゲット列にマップします。

   1. CSV ファイルの最初の行を、最初の参照データ値の代わりに列ヘッダーとして使用するかどうかを指定します。

   2. ファイルの列を 1 つずつマップします。 アップロードされた列のプレビューが表示されます。 事前定義列がニーズに合わない場合は、 「新規カスタム列」を選択します。

   3. カスタム列ごとに、以下を指定します。

      • 名前: 列名は、指定された参照データ・セット内で固有でなければなりません。
      • タイプ: テキスト、数値、または日付。
      • 説明: オプション。
      • 列内のレコードに使用する文字の最大数。 複合キー列の制限は 200 です。 その他の列の場合、制限は 2000 です。 この制限は、参照データ・セットが空の場合にのみ変更できます。 セットに値を追加する場合は、制限を増やすことしかできません。
      • オプションで、検証に使用する参照データ・セットを選択します。列の値は、選択した参照データ・セットの CODE 列に照らして検証されます。 何らかの理由でカスタム列値が無効な場合、参照データ値は作成またはインポートされず、警告がレポートに追加されます。

      注。

      • バリデーターとして選択した参照データ・セットは、このセットに対する検証が削除されない限り、削除できなくなります。
      • 列のバリデーターを設定または変更できるのは、参照データ・セットが空の場合のみです。
      • 検証対象の CODE 列は常にこのタイプであるため、検証できるのはテキスト・タイプの列のみです。

   4. カスタム列を複合キーの一部にする場合は、 「複合キーの一部」を選択します。 列は自動的に 「必須」としてマークされます。これは、値を空にすることができないことを意味します。

4. すべての列がマップされたら、 「レビュー」 パネルの情報を確認します。 この時点で、要件に合わせて複合キー列を再配列することができます。 このパネルで設定される列の順序は、複合キーの物理表現がシステム内でどのように形成されるかに影響します。 例えば、このパネルの列が以下の順序でリストされているとします。

   • カスタム列 1
   • カスタム列 2
   • カスタム列 3

   次に、この参照データ値の複合キーの物理表現が CODE|CC1|CC2|CC3として形成されます。 参照データ・セットに値を追加すると、この順序は変更できなくなります。 セットを表示するときに UI で列を再配置できますが、複合キーの実際の構成には影響しません。 列の順序を CSV ファイルで指定された順序と比較し、必要に応じて変更します。

5. 「作成」 をクリックします。 参照データ・セットはドラフトとして保存されます。

注: 参照データ値を持つ CSV ファイルを処理する場合は、値の間の親関係が、| で区切られた CODE と複合キーのカスタム列値の連結として表されていることを確認してください。コードが常に最初に表示され、次に複合キーの列値が表示されます。 CSV ファイルおよび作成ウィザードまたはインポート・ウィザードの要約パネルで、これらの列の順序が同じであることを確認してください。

終了したら、以下を決定します。

• ドラフト状態の新規参照データ・セットを閉じます。
• ドラフトの削除 をクリックして、新規参照データ・セットを削除します。
• ワークフロー 定義に応じて、 「公開」 または 「承認のために送信」 をクリックして、参照データ・セットを処理します。