Split your import data into multiple object types

2. オブジェクト タイプと属性マッピングを作成する

このページの内容

お困りですか?

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

コミュニティに質問

アセット クエリ言語 (AQL) を使用して、インポート データをさまざまなオブジェクト タイプに分割できます。これにより、単一のデータ ソースから複数のオブジェクト タイプを読み込むことができ、オブジェクト スキーマのさまざまなオブジェクト タイプに対して個別のインポート ファイルや設定を作成する必要がなくなります。

このページの内容

テスト目的で、次の CSV ファイルのサンプルを使用できます。このファイルには、サーバーとコンピューターという 2 種類のデバイスに関する情報が含まれています。

CSV のサンプル
Name, Type
Dell Server 1, Server
HP Server 1, Server
Compaq, Computer
Mac PC, Computer
Dell Server 2, Server
Mac PC 2, Computer

このインポート データには、サーバー オブジェクトのみを表示できる Server と、コンピューター オブジェクトのみを表示できる Computer という 2 つの異なるオブジェクト タイプが必要になる場合があります。この方法でデータを分割するには、CSV ファイルの [Type] 列に従ってオブジェクトをマッピングします。

このインポートを分割すると、次のような構成が表示されます。

インポート データを 2 つのオブジェクト タイプに分割

オブジェクト タイプを準備する

データのインポート ソースを分割する前に、インポート データが正しくマッピングされるようにオブジェクト タイプを設定する必要があります。たとえば、CSV ファイルにサーバーコンピューターの両方のオブジェクト タイプが含まれている場合は、それぞれのタイプを個別に設定する必要があります。オブジェクト タイプを準備するには、次の手順に従います。

  1. オブジェクト タイプをまだ作成していない場合は作成します。オブジェクト タイプを作成する方法については、こちらをご確認ください。

  2. オブジェクト タイプの右上隅にある [属性] に移動します。

  3. [属性] タブで、インポート設定においてオブジェクト タイプを分離する属性を追加します。この例では、「Type」属性でコンピューターとサーバーを分離します。

Attributes tab in the object type settings

インポート データを分割するために使用するすべてのオブジェクト タイプに対して、属性を追加する必要があります。

これにより、アセットで、同じインポート データ ソースから複数のオブジェクト タイプを読み取り、それらを適切なオブジェクト タイプにマッピングできるようになります。オブジェクト タイプの準備ができたら、インポート設定に戻り、オブジェクト タイプと属性のマッピングを作成します。

Creating object type and attribute mapping to split your data

このステップでは、データをオブジェクト タイプとその属性にマッピングします。独自のマッピングを作成することも、定義済みの構造と設定を使用することもできます。オブジェクト タイプと属性マッピングの作成方法をご確認ください。

Import configuration window

When the object type and attribute mapping are ready, you can split your import data by using the Assets Query Language (AQL).

Splitting import data by attributes

アセット クエリ言語 (AQL) を使用してインポートするデータを分割できるようになりました。たとえば、「コンピューター」オブジェクト タイプにデータをインポートする場合は、コンピューターのみをインポートして、サーバーを除外することを選択できます。

インポート データの分割に使用するすべてのオブジェクト タイプ マッピングに対して、以下の手順を繰り返す必要があります。

To split your data:

  1. インポート設定で、オブジェクト タイプ マッピングを開きます。

  2. In the upper-right corner of your type mapping configuration, open Settings , then select Configure.
    インポート設定の [Configure (設定)] ボタン

  3. [データ ソースを AQL で絞り込む] フィールドで、AQL を使用してインポート データをフィルタリングします。
    たとえば、オブジェクト タイプ属性を「Type」として、インポート データをコンピューターのみでフィルタリングする場合、AQL フィルターは Type = Computer になります。アセット クエリ言語 (AQL) については、こちらをご確認ください。

    You can’t filter data based on the object references.

    [データ ソースを AQL で絞り込む] フィールド

  4. [オブジェクト タイプ マッピングを更新] (または、新しいマッピングである場合は [オブジェクト タイプ マッピングを作成]) を選択します。

  5. オブジェクト タイプ マッピングのロケーターを定義して、[追加] を選択します。
    たとえば、データのインポート元に Type という名前のデータ ロケーター (CSV ファイルの場合は列の名前) が含まれており、オブジェクト タイプ属性にも Type という名前が付いている場合、オブジェクト タイプ Computers は [Type] 列の情報に基づいてインポート データをフィルタリングします。

Locator field to split data

AQL フィルターを設定してデータ ロケーターをマッピングに追加すると、アセットがインポート データを整理して、指定されたオブジェクト タイプに分割します。この時点でインポートされたデータはまだ表示されませんが、インポートを検査して同期する必要があります。

次のステップ

マッピングの準備が整ったら「3. インポート設定を検査する」に移動します。

最終更新日: 2025 年 2 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.