• 使用を開始する
  • 関連ドキュメント

データから属性と参照を作成する

Jira Service Management のアセットは、Premium と Enterprise のみの機能です。アセットの詳細についてはこちらをご確認ください。

データを Jira Service Management のアセットにインポートするには、まずインポート構造を作成して、オブジェクト タイプ マッピングによってデータをアセットにマッピングする必要があります。

次に、オブジェクト タイプ属性マッピングによって属性をデータからマップできます。さらに、オブジェクト スキーマ内に参照を作成する場合は、オブジェクト タイプ属性マッピングとプレースホルダーによってこれらの参照をアセットにマッピングできます。

はじめる前に

  1. アセットにインポートするデータを準備する必要があります。

  2. インポート構造を作成する必要があります。

  3. For each type of object that you want to map in Assets, you must create an object type.

  4. For each attribute or reference that you want to map in Assets, you must create an attribute.

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

参照マッピング パネルで AQL、連結子、正規表現、または Base64 の列を表示して変更できるアセットのバージョンを使用している場合は、次の手順を使用してください。

サービス プロジェクトから、次の手順を実行します。

  1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

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

  3. [設定]、[インポート] タブの順に選択します。

  4. [インポート] タブで、インポート構造の [マッピングを編集] を選択してオブジェクト タイプ マッピングを表示します。

  5. [属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。

  6. Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know where to find objects in the data source. Learn more about the data source field.

    1. Select a Data source field. The data source field specifies the location of the objects in the data file. Your attribute mapping will be disabled until you supply a data source field for each mapped attribute.

    2. データ ソース フィールドにマッピングする移動先属性を選択します。

    3. オプションで、この属性マッピングの初期設定を変更できます。

      1. AQL - データから参照を作成するには、ここに AQL ステートメントを入力します。これは、選択した移動先属性がオブジェクトの場合にのみ可能です。

      2. 連結子 - ここに、この属性マッピングにのみ適用される代替連結子を入力します。

      3. 正規表現 - ここに、この属性マッピングにのみ適用される正規表現 (regex) を入力します。

      4. Base 64 - ここに代替の Base 64 値を入力します。

  7. Select one of the attributes as an identifier. An identifier uniquely identifies each object, and will become that object’s new label when it is created. You must have exactly one identifier to run your import. The identifier is also important when you are updating data - any object with the same identifier in the destination schema will be updated, while objects with identifiers not found in the destination schema will be created.

  8. 右側の [追加] をクリックします。

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

連結子、正規表現、Base64 の機能が [アクション] 列の [...] の中に隠れているバージョンのアセットを使用している場合は、次の手順を使用してください。

サービス プロジェクトから、次の手順を実行します。

  1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

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

  3. [設定]、[インポート] タブの順に選択します。

  4. [インポート] タブで、インポート構造の [マッピングを編集] を選択してオブジェクト タイプ マッピングを表示します。

  5. [属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。

  6. アセットにインポートされるすべてのオブジェクトには、少なくとも 1 つの情報が必要です。それは、データ ソース内のどこにオブジェクトがあるかをアセットに知らせる "データ ソース" フィールドです。データ ソース フィールドの詳細をご確認ください。

    1. Select a Data source field. The data source field specifies the location of the objects in the data file. Your attribute mapping will be disabled until you supply a data source field for each mapped attribute.

    2. データ ソース フィールドにマッピングする移動先属性を選択します。

    3. オプションで、既存の属性マッピングの初期設定を変更できます。

      1. [アクション] 列の [...] ボタンをクリックします。

      2. [高度なマッピング オプション] を選択します。

        1. 連結子 - ここに、この属性マッピングにのみ適用される代替連結子を入力します。

        2. 正規表現 - ここに、この属性マッピングにのみ適用される正規表現 (regex) を入力します。

        3. Base 64 - ここに代替の Base 64 値を入力します。

      3. [確認] をクリックします。

  7. Select one of the attributes as an identifier. An identifier uniquely identifies each object, and will become that object’s new label when it is created. You must have exactly one identifier to run your import. The identifier is also important when you are updating data - any object with the same identifier in the destination schema will be updated, while objects with identifiers not found in the destination schema will be created.

  8. 右側の [追加] をクリックします。

オブジェクト タイプ属性マッピングとプレースホルダーを使用して、データから参照を作成する

参照マッピング パネルで AQL の列を表示して変更できるアセットのバージョンを使用している場合は、次の手順を使用してください。

サービス プロジェクトから、次の手順を実行します。

  1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

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

  3. [設定]、[インポート] タブの順に選択します。

  4. [インポート] タブで、インポート構造の [マッピングを編集] を選択してオブジェクト タイプ マッピングを表示します。

  5. [属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。

  6. Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know how to differentiate objects in the data. Learn more about the data source field.

    1. "データ ソース" フィールド を選択します。[データ ソース] フィールドは、インポート設定にあるデータの場所を指定します。

    2. Select an Assets Attribute to map to the data source field.

    3. [オブジェクト マッピング (AQL (アセット クエリ言語))] 列によって、参照のラベルをデータ ロケーターのプレースホルダーにマッピングする AQL を入力します。これは、選択した移動先属性がオブジェクトの場合にのみ可能です。

      1. データから参照を 1 つだけマッピングする場合は、Label = ${Locator} と入力します。Locator はロケーターの名前に置き換わります。

      2. データから複数の参照をマッピングする場合は、「Label IN (${Locator${0}})」と入力します。「Locator」はロケーターの名前に置き換わります。

      3. 右側の [追加] をクリックします。

オブジェクト タイプ属性マッピングとプレースホルダーを使用して、データから参照を作成する

参照マッピング パネルで [シンプル] モードと [詳細] モードのいずれかを選択できるアセットのバージョンを使用している場合は、次の手順を使用してください。

サービス プロジェクトから、次の手順を実行します。

  1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

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

  3. [設定]、[インポート] タブの順に選択します。

  4. [インポート] タブで、インポート構造の [マッピングを編集] を選択してオブジェクト タイプ マッピングを表示します。

  5. [属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。

  6. アセットにインポートされるすべてのオブジェクトには、少なくとも 1 つの情報が必要です。それは、データのオブジェクトを区別する方法をアセットに通知するデータ ソース フィールドです。データ ソース フィールドの詳細をご確認ください。

    1. "データ ソース" フィールド を選択します。[データ ソース] フィールドは、インポート設定にあるデータの場所を指定します。

    2. Select a Destination attribute to map to the Data source field. The attribute needs to be of object reference type, indicated by Object in the Destination attribute type column.

    3. 参照マッピング列を使用して、[シンプル] モードまたは [詳細] モードを選択します。

      1. [シンプル] モード - 参照の属性をデータ ソース フィールドのプレースホルダーにマッピングする属性を選択します。

        1. For instance, selecting a First name attribute will map that with the Data source field. So the AQL (Assets Query Language) will be "First name" = ${Name}where Name is replaced with the Data source field.

      2. Advanced mode - enter AQL that maps the attribute of the reference to a placeholder of the Data source field. In this example, we are mapping the Label attribute of the reference:

        1. データから参照を 1 つだけマッピングする場合は、「Label = ${Locator} 」と入力します。Locatorデータ ソース フィールドの値に置き換わります。

        2. データから複数の参照をマッピングする場合は、「Label IN (${Locator${0}})」と入力します。「Locator」はデータ ソース フィールドの値に置き換わります。

        3. 右側の [追加] をクリックします。

データ ソースの 1 つのフィールドから複数の参照を作成する場合は、二重パイプ「||」(CSV または JSON 形式) またはカンマ「,」(JSON 形式のみ) によって複数の値を区切ります。

How to import data into Assets

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

    1. データを準備します

    2. インポート構造を作成します。インポートには 4 つのタイプがあります。

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

      2. CSV。インポート用に CSV を設定する方法の詳細をご確認ください。

      3. JSON インポート。JSON ファイルからのデータのインポートに関する詳細をご確認ください。

      4. 外部インポート。アセットにデータをインポートするアプリの開発方法に関する詳細をご確認ください

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

      1. オブジェクト タイプと属性を自動で作成することで、データを自動でマッピングするか、

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

        1. Using object type mapping to create Assets object types

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

        3. 子オブジェクト タイプ マッピングによって階層的な親と子の構造を作成する。

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

    5. インポートを実行します

 

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

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