• 使用を開始する
  • 関連ドキュメント

ジョブを実行する

Assets Data Manager for Jira Service Management Cloud is a Premium and Enterprise only feature that is currently in Open Beta development. View and vote on our list of upcoming features.

If you find a bug or have questions, please reach out to Atlassian Support or the Atlassian Community.

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

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

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

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

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

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

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

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

アダプター クライアント ジョブを実行していて、ジョブ名にスペースが含まれている場合は、スマート引用符ではなく標準の二重引用符 ("") を使用していることを確認してください。

UTF-8 テキストを別のアプリにコピーすると、テキストがスマート引用符に置き換えられ、斜体で表示される場合があります。

アダプタークライアントを実行するための前提条件

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

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

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

  • ワークスペース ID を記録します。ワークスペース ID の確認方法

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

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

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

  2. Adapters Clientを実行するには、次の3つの情報が必要です。

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

      1 e44regc98-8d2r-3af7-011t-209p44716366
    2. Adapters のトークン。次のように表示されます。

      1 ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52
    3. ジョブ作成時に付けた名前。ジョブ名にスペースが含まれている場合は、標準の二重引用符で囲む必要があります (Notes などのツールからコピーする場合は、スマート引用符になっているために斜体になっていないかを確認します)。

      1 "My Job Name"
  3. アダプタークライアントの場所に移動します:

    1 cd Users/Shared/assets_data_manager
  4. CPU に合ったアダプター クライアントのバージョンを選択します。次から選択します。

    1 2 cd osx-arm64/assets-adapters-client cd osx-x64/assets-adapters-client
  5. アプリを実行します ( jobName、workspaceId、トークンを置き換えます)。

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

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

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

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

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

  2. Adapters Clientを実行するには、次の3つの情報が必要です。

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

      1 e44regc98-8d2r-3af7-011t-209p44716366
    2. Adapters のトークン。次のように表示されます。

      1 ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52
    3. ジョブ作成時に付けた名前。ジョブ名にスペースが含まれている場合は、標準の二重引用符で囲む必要があります (Notes などのツールからコピーする場合は、スマート引用符になっているために斜体になっていないかを確認します)。

  3. アダプタークライアントの場所に移動します:

    1 cd c:\users\public\assets_data_manager
  4. CPU に合ったアダプター クライアントのバージョンを選択します。次から選択します。

    1 2 cd win-x64/assets-adapters-client cd win-x86/assets-adapters-client
  5. アプリを実行します ( jobName、workspaceId、トークンを置き換えます)。

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

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

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

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

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

  2. Adapters Clientを実行するには、次の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. アダプタークライアントの場所に移動します:

    1 cd Users/Shared/assets_data_manager
  4. CPU に合ったアダプター クライアントのバージョンを選択します。次から選択します。

    1 2 cd linux-arm64/assets-adapters-client cd linux-x64/assets-adapters-client
  5. アプリを実行します ( jobName、workspaceId、トークンを置き換えます)。

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

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

 

アダプタークライアントを実行しているときのコマンドラインエラー

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

  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. コマンドラインを実行すると、Adapters Clientは新しいバージョンのクライアントが使用可能かどうかを通知します。

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

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