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

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

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

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

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

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

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

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

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

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

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

   1. [データ ソース フィールド] を選択します。データ ソース フィールドは、データ ファイル内のオブジェクトの場所を指定します。属性マッピングは、マッピングされた各属性にデータ ソース フィールドを指定するまで無効になります。

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

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

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

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

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

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

7. 識別子として属性の 1 つを選択します。識別子は各オブジェクトを一意に識別し、オブジェクトが作成されるときにそのオブジェクトの新しいラベルになります。インポートを実行するには、識別子を 1 つのみ含める必要があります。識別子は、データの更新時にも重要です。ターゲット スキーマに同じ識別子がある場合はオブジェクトが更新され、ターゲット スキーマに識別子が見つからない場合はオブジェクトが作成されます。

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

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

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

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

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

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

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

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

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

   1. [データ ソース フィールド] を選択します。データ ソース フィールドは、データ ファイル内のオブジェクトの場所を指定します。属性マッピングは、マッピングされた各属性にデータ ソース フィールドを指定するまで無効になります。

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

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

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

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

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

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

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

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

7. 識別子として属性の 1 つを選択します。識別子は各オブジェクトを一意に識別し、オブジェクトが作成されるときにそのオブジェクトの新しいラベルになります。インポートを実行するには、識別子を 1 つのみ含める必要があります。識別子は、データの更新時にも重要です。ターゲット スキーマに同じ識別子がある場合はオブジェクトが更新され、ターゲット スキーマに識別子が見つからない場合はオブジェクトが作成されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   2. データ ソース フィールドにマッピングする移動先属性を選択します。この属性は、[移動先属性タイプ] 列の [オブジェクト] で示されるオブジェクト参照タイプである必要があります。

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

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

         1. たとえば、[ファースト ネーム] 属性を選択すると、それがデータ ソース フィールドにマッピングされます。したがって、AQL (アセット クエリ言語) は "First name" = ${Name} となり、Name はデータ ソース フィールドに置き換えられます。

      2. [詳細] モード - 参照の属性をデータ ソース フィールドのプレースホルダーにマッピングする AQL を入力します。この例では、参照の Label 属性をマッピングしています。

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

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

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