• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

Create and configure a Flat File job

Assets Data Manager for Jira Service Management Cloud is currently rolling out in Open Beta and will be available to all Premium + Enterprise sites by end of October 2024.

This task requires Data Manager admin permissions to complete. How permissions and roles work in Data Manager.

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

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

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

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

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

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

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

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

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

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

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

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

  3. In the Object Class field, select the Object Class destination for this data. Object Classes currently available in Data Manager.

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

  5. In the Data Source Name field, enter a name for the Data Source that will be created when this job is run. This is typically the same as the Name, above.

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

    1 /data-manager-files/CMDBComputers.csv

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

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

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

  9. In the Qualifier field, you can enter a unicode character that wraps a string and marks it as a single value. The most common qualifier is the double-quote character ".

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

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

  12. The Column Mappings section allows you to configure Column Mappings for each column in our file. Each column mapping can be further configured:

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

    2. The Source Column Type allows you to select the data type to use for the data in that column.

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

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

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

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

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

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

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

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

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

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

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

The Column Mappings section allows you to configure Column Mappings for each column in our file. Each column mapping can be further configured:

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

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

  3. The Source Column Type allows you to select the data type to use for the data in that column.

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

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

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

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

ジョブを保存する

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

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

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