• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース
製品
使用を開始する
関連ドキュメント
リソース
アトラシアン サポート
/
Jira Service Management
/
リソース
/
データをアセット データ マネージャーで接続、クレンジング、調整する
/
データをデータ マネージャーに移動して生データを作成する
クラウド

ジョブを実行する

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.

このセクションのタスクを完了するには、データ マネージャー管理者と Adapter 管理者の権限が必要です。

新しいジョブを作成する前に、データ マネージャーに少なくとも一度は移動しておく必要があります。

ジョブを設定しましたが、データをデータ マネージャーに移動するにはジョブを実行する必要があります。

ジョブの実行は、ファイアウォールの内側にあるローカル インスタンスで Adapters Client というミドルウェア クライアント アプリを使用して行われます。

Adapters Client でジョブが実行されたら、変換関数を追加して生データを変更またはクリーン アップすることもできます。

コマンドライン インターフェイスを使用してジョブを手動で実行することも、クライアント アプリを Windows タスク スケジューラなどのスケジューリング アプリで「ラップ」することもできます。

それぞれのジョブは一意であり、複数回実行できます。データに対して実行されるソース、構成オプション、変換、および関数は、新しいジョブを設定する際に選択したジョブ設定の中で指定されます。

ジョブが実行された後、データはステージングされたデータとしてデータ マネージャーに取り込まれます。ジョブの履歴は、[Adapters] > [ジョブ実行履歴] の順に選択すると表示されます。

When running your adapters client job and your jobname includes spaces, ensure you’re using standard double quotes (““), not smart quotes.

There are instances where copying UTF-8 text into another app will replace the text with smart quotes and they’ll look like they’re in italics .

Adapters クライアントを実行するための前提条件

Adapters クライアントを実行する前に、次のことを行う必要があります。

  • CSV、SQL、またはサードパーティ ツールから新しいジョブを作成します。

  • トークンを作成します。

  • Record your workspaceID. How to find your workspace ID.

MacOS で Adapters Client を使用してジョブを実行する

MacOS を使用してジョブを手動で実行するには、次の手順に従います。

  1. Mac のターミナル ([アプリケーション] > [ユーティリティ] > [ターミナル]) に移動して、コマンドライン インターフェイスを開きます。

  2. Adapters クライアントを実行するには、次の 3 つの情報が必要です。

    1. ワークスペース ID。次のように表示されます。

      1 e44regc98-8d2r-3af7-011t-209p44716366

    2. Adapters のトークン。次のように表示されます。

      1 ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52

    3. The name you gave the job when you created it. If your job name includes spaces, make sure to encase it in standard double quotes (if you’re copying it from a tool like Notes, check that it hasn’t become a smart quote and is in italics):

      1 "My Job Name"

  3. Navigate to the location of the Adapters client:

    1 cd Users/Shared/assets_data_manager

  4. Select the version of the Adapters client that matches your CPU. Pick from:

    1 2 cd osx-arm64/assets-cleanse-and-import-client cd osx-x64/assets-cleanse-and-import-client

  5. Run the app (substituting in your jobName, workspaceId, and token):

    1 ./dm-adapters --run "<myJobName>" --workspace-id <workspaceId> --token <your-Adapters-token>

成功メッセージはジョブの完了時に表示され、ジョブの実行中にエラーが発生したかどうかがわかります。

Windows で Adapters Client を使用してジョブを実行する

Windows で Adapters Client を使用してジョブを手動で実行するには、次の手順に従います。

  1. Ctrl + Shift + Enter (管理者として開く) を使用して、コマンドライン インターフェイスを開きます。

  2. Adapters クライアントを実行するには、次の 3 つの情報が必要です。

    1. ワークスペース ID。次のように表示されます。

      1 e44regc98-8d2r-3af7-011t-209p44716366

    2. Adapters のトークン。次のように表示されます。

      1 ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52

    3. The name you gave the job when you created it. If your job name includes spaces, make sure to encase it in standard double quotes (if you’re copying it from a tool like Notes, check that it hasn’t become a smart quote and is in italics):

  3. Navigate to the location of the Adapters client:

    1 cd Users/Shared/assets_data_manager

  4. Select the version of the Adapters client that matches your CPU. Pick from:

    1 2 cd win-x64/assets-cleanse-and-import-client cd win-x86/assets-cleanse-and-import-client

  5. Run the app (substituting in your jobName, workspaceId, and token):

    1 dm-adapters.app --run "<myJobName>" --workspace-id <workspaceId> --token <your-Adapters-token>

成功メッセージはジョブの完了時に表示され、ジョブの実行中にエラーが発生したかどうかがわかります。

Linux で Adapters Client を使用してジョブを実行する

Linux を使用してジョブを手動で実行するには、次の手順に従います。

  1. Linux のターミナルに移動してコマンドライン インターフェイスを開きます (Ctrl + Alt + T)

  2. Adapters クライアントを実行するには、次の 3 つの情報が必要です。

    1. ワークスペース ID。次のように表示されます。

      1 e44regc98-8d2r-3af7-011t-209p44716366

    2. Adapters のトークン。次のように表示されます。

      1 ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52

    3. 作成時に付けたジョブ名です。ジョブ名にスペースが含まれている場合は、次のように引用符で囲む必要があります。

      1 "My Job Name"

  3. Navigate to the location of the Adapters client:

    1 cd Users/Shared/assets_data_manager

  4. Select the version of the Adapters client that matches your CPU. Pick from:

    1 2 cd linux-arm64/assets-cleanse-and-import-client cd linux-x64/assets-cleanse-and-import-client

  5. Run the app (substituting in your jobName, workspaceId, and token):

    1 ./dm-adapters --run "<myJobName>" --workspace-id <workspaceId> --token <your-Adapters-token>

成功メッセージはジョブの完了時に表示され、ジョブの実行中にエラーが発生したかどうかがわかります。

 

Adapters クライアント実行時のコマンドライン エラー

データ ソースとジョブの設定方法との間に矛盾がある場合、コマンドラインはエラーを返します。可能性のあるエラー メッセージと、考えられる修正方法は次のとおりです。

  1. Error in line 1: Cannot find column ' cpu' in the Column Mappings. 列名を誤って入力したか、データソースの列名にスペースが含まれています。

  2. Line 280: The column count is not correct. 考えられる原因は次の 2 つです。

    1. ジョブの列マッピングの数は、ジョブに設定されている列マッピングの数と正確に一致する必要があります。

    2. CSV データにスペースがありますが、スペースを含んだ、テキスト値を囲む適切な修飾子文字が選択されていません。通常、CSV ファイルの修飾子は「"」です。

  3. Column ‘whenCreated', date value '20/04/2009 1:47' cannot be converted to 'd/MM/yyyy HH:mm (8/02/2006 06:30).' 列に日付マスクを使用しようとしましたが、選択した日付マスクがデータの形式と一致しません。別の日付マスクを選択してください。

  4. When run through the command line, the Adapters client will tell you if a newer version of the client is available.

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

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容MacOS で Adapters Client を使用してジョブを実行するWindows で Adapters Client を使用してジョブを実行するLinux で Adapters Client を使用してジョブを実行する
コミュニティ質問、ディスカッション、記事