We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

フラット ファイル ジョブを作成して構成する

Jira Service Management Cloud のアセット データ マネージャーは Premium と Enterprise のみの機能であり、現在はオープン ベータ版を開発中です。公開予定の機能のリストを見て、投票してください。

バグを発見した場合、ご質問がある場合は、アトラシアン サポートまたはアトラシアン コミュニティにご連絡ください。

このタスクを完了するには、データ マネージャー管理者の権限が必要です。データ マネージャーの権限とロールの仕組みをご確認ください。

フラット ファイルからデータ マネージャーにデータを取り込むには、フラット ファイル ジョブを作成および構成してから、データ マネージャー アダプター クライアントを使用してジョブを実行する必要があります。

フラット・ファイル・ジョブの作成

CSV や TXT ファイルなどのフラット・ファイルをデータ・ソースとして使用して新規ジョブを作成するには、次のようにします。

  1. 上部のナビゲーション バーで [Assets] を選択します。

  2. [アセットと構成管理] のタイトルで [データ マネージャー] を選択します。

  3. 左側のメニュー バーで [アダプター] を選択します。 これにより、[ アダプター] 画面の新しいタブが開きます。

  4. 左側のメニュー バーで [ Create a job (ジョブを作成 )] を選択します。

  5. 「一般」で、「フラット・ファイル」を選択します。

新しいジョブを作成したら、ジョブを正常に保存するために、必須 (*) フィールドへの入力をすべて完了する必要があります。

フラット・ファイル・ジョブの構成

[Flat File Configuration (フラット ファイル設定)] 画面でデータ ソースの詳細を設定します。

  1. [名前] フィールドにジョブの名前を入力します。この名前は、アダプター クライアントを実行する際にジョブを識別するために使用されます。

  2. [有効] トグルが有効 (濃い青) に設定されていることを確認します。無効になっているジョブは実行できません。

  3. [オブジェクト クラス] フィールドで、このデータの [オブジェクト クラス] 宛先を選択します。データ マネージャーで現在使用可能なオブジェクト クラス

  4. [ データ ソース タイプ ] フィールドで、既存の データ ソース タイプ を選択するか、以下で新しいデータ ソース タイプを作成します。

  5. [ データ ソース名 ] フィールドに、このジョブの実行時に作成されるデータ ソースの名前を入力します。これは通常、上記の 名前と同じです。

  6. ファイル パス フィールドに、フラット ファイルがあるファイル パスを入力します。ファイル名とファイル拡張子を含む正しいファイル パスを使用する必要があります。MacOS システムで表示されるファイル パスの例を次に示します。

    /data-manager-files/CMDBComputers.csv

    そして、次の例は、Windows PC システムで見られるファイル パスです。

    C:\data-manager-files\CMDBComputers.csv
  7. データ ファイルのヘッダーがファイルの先頭行にない場合は、[Skip line (スキップ行)] フィールドに整数値を入力します。既定では、このフィールドは 0 に設定されています。

  8. [区切り文字] フィールドには、テキスト ファイル内で値を区切るために使用される区切り文字を入力できます。既定値はコンマ , です。

  9. [修飾子] フィールドには、文字列を折り返して単一値としてマークする Unicode 文字を入力できます。最も一般的な修飾子は、二重引用符の " です。

  10. [ 区切り文字で終わる ] トグルは、フラット ファイルの各行が区切り文字で終了している場合にのみ有効にする必要があります。

  11. 複数のフラット ファイルが同じ列構造でグループ化されている場合は、 ワイルドカード トグルを有効にする必要があります。 たとえば、data-file-*.csv は、 data-file-1.csv、data-file-2.csv、 というように消費していきます。 ワイルドカードを使用する場合、このフィールド パス フィールドにはファイル名と拡張子が除外されます。

  12. [列マッピング] セクションでは、ファイルの各列の列マッピングを設定できます。各列マッピングはさらに細かく設定できます。

    1. [Source Column Name (ソース列名)] フィールドは、データ ファイルのソース列の名前です。

    2. [ソース列型] では、その列のデータに使用するデータ型を選択できます。

    3. ソース列タイプが日付の場合、[日付形式] フィールドが表示され、日付と時刻の情報をマスクする日付形式を選択できます。このフィールドに日付または時刻の情報が含まれていない場合は、空のままにすることができます。

    4. [Destination Column Name (ターゲット列名)] フィールドは、データ マネージャーでこのフィールドに割り当てられた名前です。

新しいジョブの作成時に新しいデータ ソース タイプを作成する

データ・ソース・タイプには、データ・ソースのグループに関する情報が含まれており、ジョブの作成時にデータ・ソース・タイプを選択する 必要があります

データ ソース タイプが作成されていない場合:

  • フラット ファイル構成に移動

  • 「データ・ソース・タイプ」を選択し、新しいタイプの名前を入力します。

  • 表示されるドロップダウン ボックスで [アイテムを追加] を選択します

列マッピングを自動的に作成する

[Auto Generate (自動生成)] ボタンを使用すると、列マッピングを自動的に生成できます。フラット ファイルのヘッダー (コンマなどの区切り文字で区切ったもの) をデータ ソースからフィールドにコピー & ペーストして、[Auto Generate (自動生成)] を選択します。

列マッピングを手動で作成する

[列マッピング] セクションでは、ファイルの各列の列マッピングを設定できます。各列マッピングはさらに細かく設定できます。

  1. 追加する各列の [ マッピングを追加 ] を選択します。

  2. [Source Column Name (ソース列名)] フィールドは、データ ファイルのソース列の名前です。

  3. [ソース列型] では、その列のデータに使用するデータ型を選択できます。

  4. ソース列タイプが日付の場合、[日付形式] フィールドが表示され、日付と時刻の情報をマスクする日付形式を選択できます。このフィールドに日付または時刻の情報が含まれていない場合は、空のままにすることができます。データの日付形式がリストにない場合は、設定で作成できます。

  5. [Destination Column Name (ターゲット列名)] フィールドは、データ マネージャーでこのフィールドに割り当てられた名前です。

フラット ファイルの CSV/TXT では、データを NULL 列にマップできません。 これは、列マッピングを手動で作成した場合でも同様です。

その列のデータ タイプは既定で 文字列 に設定されるため、マッピングは実行できません。 この状況でデータをマップするには、変換 (Transform) 関数を使用して 文字列 を別のデータ型に変換します。

ジョブを保存する

必須フィールドへの入力がすべて完了し、データ ソースのすべての列をマッピングしたら、このジョブを保存できます。新しいジョブは [All Jobs (すべてのジョブ)] 画面に表示されるはずです。

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

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