オブジェクト タイプ マッピングを使用してデータからアセット オブジェクトを作成する

Assets is included with Service Collection Paid plans (Standard, Premium, and Enterprise). What Assets is and how it works.

情報をアセットにインポートするには、インポート構造を作成してデータをマッピングしてから、インポートを実行する必要があります。

データをアセットに手動でマッピングする場合は、オブジェクト タイプ マッピングによってデータからオブジェクトを作成する必要があります。

 

はじめる前に

  1. You must prepare your data for importing into Assets.

  2. You must create an import structure.

  3. For each type of object that you want to import into Assets, create an object type.

 オブジェクト タイプ マッピングを使用してデータからオブジェクトを作成する

アセットから次の手順を実行します。

  1. From the app switcher, select Assets

  2. From your sidebar, select Schemas.

  3. オブジェクト スキーマを選択します。

  4. Select Configure, then choose the Import tab.

  5. In the Import tab, select on Edit mapping on your import structure to expand it.

  6. データから作成するオブジェクト タイプごとに、個別のオブジェクト タイプ マッピングを作成する必要があります。新しいオブジェクト タイプ マッピングを作成するには、[マッピングを作成] ボタンを選択します。[新しいオブジェクト タイプ マッピングを作成] 画面で、次の情報を入力します。

    1. オブジェクト - データから作成するオブジェクト タイプを選択します。上記のステップ (2) に従って、データをインポートするオブジェクト タイプを作成しておく必要があります。

    2. AQL によるデータ ソースのフィルタリング - ソースから取得したオブジェクトをクエリするためのオプションの AQL。データからオブジェクトをフィルタリングする場合は、ここで実行できます。

    3. 識別子の大小文字の区別 - 次のいずれかを選択します。

      1. 大文字と小文字を区別 - ID は大文字と小文字を区別して比較されるため、「Data Value」は「data value」と同じ ID とはみなされません。

      2. 大文字と小文字を区別しない: ID は大文字と小文字を無視して比較されるため、「Data Value」と「data value」は同じ ID としてみなされます。

    4. 欠落しているオブジェクト - 以下から選択します。

      1. 削除 - 現在のインポート構造には見つからないが、以前にこのインポート構造を使用して作成されたオブジェクトを削除します。このオプションを使用すると、前回のインポートに見つからなかったオブジェクトを削除することでデータをクレンジングできます。

      2. 更新 - インポート構造には見つからないが、以前にこのインポート構造を使用して作成または更新されたオブジェクトの属性を更新します。前回のインポートに見つからなかったオブジェクトをマークする場合は、このオプションを使用します。たとえば、[In Source (ソース内)] フィールドを [No (いいえ)] に設定して、前回のインポートの実行時にこのオブジェクトが見つからなかったことを示します。

      3. 無視 - 何もしません。何も変更を加えない場合は、このオプションを選択します。

    5. しきい値番号 - しきい値番号は、上記の [欠落しているオブジェクト] 設定フィールドで選択したルールが適用される前に、インポート元から欠落しているオブジェクトが無視される回数です。これは、インポート元のデータにオブジェクトが見つからなかった場合、すぐに削除されないようにするための安全機能です。

    6. 欠落しているアウトバウンド参照のオブジェクト - この設定は、上記で [欠落しているオブジェクト] の [更新] または [無視] を選択した場合にのみ表示されます。次の項目から選択します。

      1. 削除 - 指定された属性のすべての参照オブジェクトがまだインポート内にある場合に、見つからないオブジェクトのアウトバウンド参照を削除します。

      2. 無視 - インポートに見つからないアセットのアウトバウンド参照を無視します。アウトバウンド参照は削除も更新もされません。

    7. 空の値 - オブジェクトが更新される際に、外部ソースからの空の値で既存の値を削除するかどうかを選択します。次の項目から選択します。

      1. デフォルトを使用 - 該当するオブジェクト タイプに対して [インポート構造を定義] 画面で指定されたオプションを使用します。

      2. 削除 - 現在の値を削除します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が削除されます。

      3. 無視 - 該当するオブジェクト タイプに対して現在の値を保持します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が保持されます。

    8. 不明な値 - [ステータス] 属性または [Select] 属性がファイルから新しく不明な値を受け取った場合に、インポートでそれらの値をその属性のオプションに追加するか無視するかを選択します。次の項目から選択します。

      1. デフォルトを使用 - 該当するオブジェクト タイプに対して [インポート構造を定義] 画面で指定されたオプションを使用します。

      2. 追加 - この [ステータス] 属性または [Select] 属性の既存のオプション リストに新しいオプションを追加します。

      3. 無視 - 現在のオプション セットを保持します。

  7. [作成] を選択します。

[欠落しているオブジェクト][欠落しているアウトバウンド参照のオブジェクト]、[空の値][不明な値] の設定は、以前に同じインポート構造を使用してインポートされたオブジェクトにのみ影響します。

異なるインポート構造を使用してインポートされたオブジェクトは、これらのフィールドの変更が反映されません。両方の場合で同じオブジェクトが参照されていても同様です。

 

データをアセットにインポートする方法

  1. アセットにデータをインポートするには、次の 5 つのステップに従います。

    1. Prepare your data.

    2. Create an import structure. There are four different types of import available:

      1. Discovery. Learn more about how to bring data from Discovery into Assets.

      2. CSV. Learn more about how to configure your CSV for importing.

      3. JSON import. Learn more about importing data from a JSON file.

      4. External import. Learn more about how to develop an app to import data into Assets.

    3. データをマッピングします。次の 2 つのオプションがあります。

      1. Map your data automatically by automatically creating object types and attributes, or;

      2. 次の方法でデータを手動でマッピングします。

        1. Using object type mapping to create Assets object types

        2. Using object type attribute mapping to create Assets attributes and references

        3. Using child object type mapping to create hierarchical parent and child structures.

    4. オブジェクト タイプ マッピングを作成したら、それらを有効にする必要があります。すべてのオブジェクト タイプ マッピングが [有効化] に設定されるまで、インポート構造は実行されません。オブジェクト タイプ マッピングが有効にされていない場合は、オブジェクト タイプ マッピングを右クリックして [有効化] をクリックして有効にします。

    5. Execute the import.

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。