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

属性をオブジェクト識別子の一部と見なすかどうかを指定します。複数の属性が識別子として使用される場合は、結合された値を使用してオブジェクトと重複を識別します。これは、オブジェクトを識別する内部 AQL を構築するために使用されます。

たとえば、アセット属性の「名」と「姓」の 2 つのインポート属性が設定され、識別子として指定されている場合は、次の AQL を使用してアセット内のオブジェクトを識別します。

"First Name" == <first name value from source> AND "Last Name" == <last name value from source>

すべての属性は識別子にできます。ただし、最高のパフォーマンスを得るには、できる限り既定の属性タイプを使用するようにしてください。たとえば「ユーザー」属性を識別子として使用する場合は、設定したデータ ロケーターのデータ ソースからユーザーを見つけるために Jira API をクエリする必要があります。これは、ユーザー ディレクトリが大きい場合に Jira がボトル ネックになる可能性があることを意味します。この場合は、別の属性 (デフォルト/テキスト) をユーザー キーに追加してみると、インポートがはるかに高速になります。

CSV ファイルからアセットにオブジェクトをインポートする場合は、名前やキーではなく、ラベルとして割り当てられた属性でオブジェクトを識別する必要があります。オブジェクト キーは、オブジェクトが手動またはインポートによって作成されたときに自動的に生成されます。オブジェクト キーがソース ファイル (CSV や JSON など) にあっても、特にオブジェクト キーが識別子である場合は、ソース ファイル内のオブジェクトを使用するのではなく、新しいオブジェクトとそのキーが生成されます。その結果、複数の重複が発生する可能性があります。

すべてのインポート タイプにはデータ ロケーターを用意する必要があります。これは、アセットがデータを保持するカテゴリーとして認識しているものです。たとえば、CSV インポートではすべての列がデータ ロケーターです。

データ ロケーターをマッピングして、そのデータをインポートするアセット属性です。

オブジェクト タイプのアセット属性 (オブジェクト間の参照) にのみ使用されます。

この場合は、データ ロケーターから提供されたデータに応じて、設定するオブジェクトを取得するための AQL を提供する必要があります。次の例では、名前は参照されるオブジェクトの "名前" という属性に含まれるアセット内の値への参照です。

AQL では次のようにプレースホルダーを使用できます。

• 単一属性 (最大カーディナリティが 1 に等しい) の場合は、プレースホルダーを持つ AQL は次のようになります。

  Name = ${DATA LOCATOR}

• 複数属性 (最大カーディナリティが 1 より大きい) の場合は、プレースホルダーを持つ AQL は次のようになります。

  Name IN (${DATA LOCATOR${0}})

  「0」(ゼロ) はすべての値を意味して、1 は最初の値、2 は 2 番目の値と続きます。

詳細は「インポートのコンセプトを理解する」をご参照ください。

属性マッピングの説明 (念のため用意しました)。

属性マッピングの横にある歯車アイコンを選択することによって、他の構成にアクセスできます。

連結子

複数のデータ ロケーターを 1 つのアセット属性に結合する場合は、これが既定の連結子として機能します。

正規表現

正規表現によって、インポート ソースからの値を編集できます。

正規表現には Java 構文 https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html を使用します。正規表現で一致するものが見つからない場合、属性は空のままになります。抽出する内容を正規表現の最初のグループにすることで、データ ロケーターで指定された値から抽出できます。たとえば値「Blue Whale」で正規表現「(\ w*)\ W」(括弧は除く) を使用すると「Blue」が対応する属性に出力されます。グループがなく正規表現にマッチするものがある場合は、値全体が与えられます。

いくつかの例を使用してご説明します。