すべてのプロダクト
Search
ドキュメントセンター

Dataphin:ルートアイテムの作成と管理

最終更新日:Mar 06, 2025

ルートアイテムは、ビジネス用語、物理テーブル、フィールド標準命名、およびそれらの標準化された翻訳を管理する上で重要な役割を果たします。一元化されたルートアイテムライブラリは、一貫した資産管理と明確なデータフローに不可欠です。このトピックでは、ルートアイテムの作成と管理のプロセスについて説明します。

権限の説明

すべてのメンバーがルートアイテムを一括エクスポートできます。

シナリオ

データ開発 > テーブル管理 でフィールドに名前を付ける場合は、ルートアイテムを作成できます。システムは、作成されたフィールドと、データ標準 > ルートアイテム 内のフィールド(金額、アカウントなど)を自動的に照合して、フィールドの名前を標準化します。

ルートアイテムリスト

[ビジネス用語] リストページでは、構成済みのルートアイテム情報を表示し、ルートアイテムの検索、編集、削除などの操作を実行できます。

image.png

領域

説明

[検索エリア]

ルートアイテム名、フルネーム、および略語による検索をサポートしています。

[ルートアイテムリスト]

ルートアイテムの名前、フルネーム、略語、説明、最終更新者、および最終更新日時が表示されます。ルートアイテムを編集または削除することもできます。

  • [編集]: ルートアイテムの情報を変更します。

  • [削除]: 削除は元に戻せません。 慎重に行ってください。

新しいルートアイテムの作成

  1. Dataphin ホームページの上部メニューバーから、[管理] > [標準] を選択します。

  2. 左側のナビゲーションウィンドウで、[参照データ] > [ビジネス用語] を選択します。[ビジネス用語] ページで、[+ 新しいルートアイテム] ボタンをクリックします。

  3. [新しいルートアイテム] ダイアログボックスで、必須パラメーターを入力します。

    パラメーター

    説明

    [ルートアイテム名]

    ルートアイテムの名前(例:金額)。128 文字以内。

    [フルネーム]

    ルートアイテムのフルネーム(例:金額)。64 文字以内。

    [略語]

    ルートアイテムの略語(例:amt)。64 文字以内。

    [説明]

    ルートアイテムの意味と使用シナリオの説明を追加できます。256 文字以内。

  4. [OK] をクリックして、ルートアイテムの作成を完了します。

ルートアイテムの一括インポート

  1. [ビジネス用語] リストページの右上隅にある [一括インポート/エクスポート] をクリックし、[ルートアイテムの一括インポート] を選択します。

  2. [ルートアイテムの一括インポート] ダイアログボックスで、必要なパラメーターを構成します。

    パラメーター

    説明

    [インポートシナリオ]

    インポートシナリオが異なると、対応する構成テンプレートも異なります。ダウンロードした更新テンプレートファイルには、ルートアイテムの情報が含まれています。変更が必要な情報のみを変更して再インポートする必要があります。[追加][更新] の 2 つのインポートシナリオをサポートしています。

    インポートシナリオは、構成テンプレートの生成にのみ影響します。実際のインポートプロセスでは、ルートアイテム名の有無に基づいて追加するか更新するかが決定されます。

    [ステップ 1 構成テンプレートのダウンロード] - 追加

    [構成テンプレート]

    テンプレートがない場合は、ファイル名をクリックするか、image.png アイコンをダウンロードして .xlsx ファイルをダウンロードできます。テンプレートがすでにある場合は、構成ファイルを直接アップロードしてインポートできます。

    説明

    ルートアイテムをインポートするには、ルートアイテムを作成または編集する権限が必要です。そうでない場合、権限検証は失敗し、インポートを実行できません。

    [ステップ 1 構成テンプレートのダウンロード] - 更新

    [更新範囲]

    更新が必要なルートアイテムを選択します。すべてを更新するか、更新が必要なルートアイテムを指定するかを選択できます。一度に選択できるルートアイテムの数は 10,000 を超えません。

    [構成テンプレート]

    選択したルートアイテムの範囲に基づいて生成されます。更新範囲がすべてとして選択されている場合は、テンプレートを直接ダウンロードできます。更新範囲が指定として選択されている場合は、[テンプレートの生成] をクリックして .xlsx 形式のテンプレートファイルを生成してからダウンロードします。

    説明
    • テンプレートがない場合は、ファイル名をクリックするか、image.png アイコンをダウンロードして .xlsx ファイルをダウンロードできます。テンプレートがすでにある場合は、構成ファイルを直接アップロードしてインポートできます。

    • ルートアイテムをインポートするには、ルートアイテムを作成または編集する権限が必要です。そうでない場合、権限検証は失敗し、インポートを実行できません。

    [ステップ 2 構成ファイルのアップロード]

    [ファイルのアップロード]

    • 単一の .xlsx ファイルに最大 10,000 個のルートアイテムをインポートします。単一ファイルのサイズは 20 MB を超えません。

    • ファイルタイプが一致しない場合、複数のワークシートがある場合、またはルートアイテムの情報が 10,000 行を超える場合は、インポートできません。フィールド名が変更された場合、またはフィールドが追加または削除された場合は、テンプレートが解析できなくなり、インポートが失敗する可能性があります。

    • テンプレートに入力する際は、テンプレートの指示に従ってください。インポートプロセス中に、ルートアイテム名に基づいて一意性と標準化の検証が実行されます。検証に失敗した場合、インポートは失敗します。

    • [ルートアイテム名]: 必須、グローバルに一意、最大 128 文字。インポート中は、ルートアイテム名に基づいてルートアイテムオブジェクトが識別されます。ルートアイテム名がすでに存在する場合は、ルートアイテムの更新操作と見なされ、競合ポリシーの構成に基づいてインポートが実行されます。ルートアイテム名が存在しない場合は、新しいルートアイテム操作と見なされます。

    • [フルネーム]: 必須、繰り返し可能。最大 64 文字。漢字、英字、数字、および特殊文字 -、_、()、space、’ の入力をサポートしています。

    • [略語]: 必須、最大 64 文字。英字、数字、および任意の半角記号の入力をサポートしています。

    • [説明]: オプション、最大 256 文字。

    [ステップ 3 競合解決ポリシー]

    [検証フィールド]

    ルートアイテム名(グローバルに一意、大文字と小文字を区別しない)。

    [処理ポリシー]

    今回インポートされたルートアイテム名が既存のルートアイテム名と同じ場合の処理ポリシー。[競合する場合はスキップ] または [競合する場合は上書きして更新] を選択できます。

    • [競合する場合はスキップ]: インポートされたルートアイテム名が既存のルートアイテム名と同じ場合は、レコードを処理せずにスキップします。

    • [競合する場合は上書きして更新]: インポートされたルートアイテム名が既存のルートアイテム名と同じ場合は、今回インポートされたコンテンツ(ルートアイテム名、説明など)に基づいて、既存のルートアイテムの他の情報をオンラインで更新します。

    説明

    ルートアイテム名はグローバルに一意です。インポートされたルートアイテム名が既存のルートアイテム名と同じ場合、または 1 回のインポートで同じルートアイテム名を持つレコードが複数ある場合は、処理ポリシーに従ってレコードがスキップされるか、元のオブジェクトが新しいレコードで上書きされます。

  3. [インポート開始] をクリックします。[ルートアイテムのインポートレコードの表示] ダイアログボックスで、インポート結果の表示、異常レコードのダウンロードなどを行うことができます。

    パラメーター

    説明

    [インポート結果]

    インポートの進捗状況、インポート結果、および実行時間を表示できます。

    [異常レコード]

    • 検証に失敗したためにインポートできないルートアイテムレコードが表示されます。これには、元のファイルの対応する行番号、ルートアイテム名、略語、異常フィールド、および異常プロンプトが含まれます。

    • [異常レコード] タブをクリックし、[異常レコードのダウンロード] をクリックして、対応する元のレコードを Excel ファイルとしてダウンロードします。

    [スキップされたレコード]

    • 競合ポリシーが競合する場合はスキップに設定されている場合、指定されたルートアイテムにすでに存在する名前を持つレコードはスキップされ、スキップされたレコードリストに表示されます。これには、元のファイルの対応する行番号、ルートアイテム名の略語、および短い名前が含まれます。

    • [スキップされたレコード] タブをクリックし、[スキップされたレコードのダウンロード] をクリックして、対応する元のレコードを Excel ファイルとしてダウンロードします。

    [実行ログ]

    インポートプロセスの実行ログを表示およびコピーできます。

    インポートが完了したら、インポート構成ダイアログボックスを閉じてインポート結果をすばやく表示できます。これにより、インポートタスクは停止しません。インポートレコードの表示 をクリックし、表示する履歴インポートレコードを選択して、ルートアイテムリストのインポートレコードを表示します。

ルートアイテムの一括エクスポート

  1. [ビジネス用語] リストページの右上隅にある [一括インポート/エクスポート] をクリックし、[ルートアイテムの一括エクスポート] を選択します。

  2. [ルートアイテムの一括エクスポート] ダイアログボックスで、指定されたエクスポート範囲に従ってルートアイテムをエクスポートできます。

    [エクスポート範囲]: エクスポートするルートアイテムの範囲を選択します。すべてのルートアイテムをエクスポートするか、選択したルートアイテムのみをエクスポートするかを選択できます。最大 10,000 個のルートアイテムをサポートしています。

  3. [OK] をクリックして、ルートアイテムのエクスポートを完了します。インポートレコードの表示 で履歴インポートレコードを表示できます。

ルートアイテムのインポートレコードの表示

  1. [ビジネス用語] リストページの右上隅にある [一括インポート/エクスポート] をクリックし、[インポートレコードの表示] を選択します。

  2. [ルート一括操作レコード] ダイアログボックスでは、ルートインポート操作のレコードを確認できます。レコードには、序数、作成者、インポートステータス、インポートシナリオ、作成時間、終了時間などの詳細が含まれます。さらに、操作列の [表示] アイコンをクリックすると、ルートの詳細なインポート情報にアクセスできます。