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

データのインポートをスケジュールする

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.

以下の手順は、サードパーティのスケジューリング アプリと Cleanse and Import クライアントを使用してデータ マネージャーにデータをインポートするためのスケジュールされたタスクを設定するためのものです。

デモンストレーションに使用される 2 つのアプリは Cron (MacOS/Linux 用) と Windows Scheduler (Windows/DOS 用) ですが、Cleanse and Import クライアントを実行するコマンドが正しく構成されている限り、任意のスケジューリング アプリを使用できます。

ファイルをサーバーに配置して使用するプロセスがある場合、ファイルを適切な場所にコピーしてクレンジングとインポート クライアントが使用できるようにするために、追加のスケジュール タスクが必要になる場合があります。

スケジュールされたタスク間の適切な時間 (1 時間) を確保して、スケジュールされたタスクを完了できるようにする必要があります。

MacOS と Linux で Cleanse and Import クライアントと Cron ジョブを使用してデータをインポートする

前提条件

  • インポートするオブジェクト クラスにリンクされているすべてのデータ ソースをマッピングしてクレンジングする必要があります。

  • Cleanse and Import クライアントもインストールする必要があります。「Cleanse and Import クライアントをインストールする」をご確認ください。

Cleanse and Import クライアントを実行するための Cron ジョブを作成するには、次の手順を実行します。

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

  2. Cleanse and Import クライアントの場所に移動します。データ マネージャー クライアントの設定によっては、別の場所にある場合があります。Cleanse and Import クライアントは次のようなファイル名になっています。

    1 dm-cleanseimport.app
  3. Cleanse and Import クライアントを実行するための新しいスクリプトを作成します。新しい .sh ファイルを作成します。Nano などのテキスト エディターを使用します。次の例では、test-script.sh という名前のファイルを作成します。

    1 nano test-script.sh
  4. 次に、Cleanse and Import クライアントを実行するコマンドを入力します。ワークスペース IDCleanse and Import クライアント トークンの両方が必要です。サンプル スクリプトを次に示します。

    1 2 3 #!/bin/bash echo "This is an sample Bash script that runs the Importers client." ./dm-cleanseimport --workspace-id <workspaceId> --token <your-token> –-run "import"

タスク名にスペースが含まれている場合は特に、ジョブ名を二重引用符 (") で囲んでください。 

  1. スクリプトを保存します。

  2. chmod コマンドを使用してスクリプトを実行可能にします。

    1 chmod +x test-script.sh
  3. 次に、以下のように入力して Crontab ファイルを開きます。ファイルは vi エディターで開きます。既存の crontab がない場合は新しいファイルが作成されます。

    1 crontab -e

別のユーザーのジョブをスケジュールするには、-u オプションを追加します: crontab -u [username] -e

  1. Cron 式とスクリプト パスを含む行を追加します。

    1 [cron-expression] [path-to-script]

    Cron 式は、対応する数値を入力する次の 5 つのフィールドで構成されています。

    1 [minute: 0-59] [hour: 0-23] [day: 1-31] [months: 1-12] [weekday: 0-6]

weekday フィールドの 0 は日曜日、1 は月曜日、2 は火曜日 (以下同様) を表しています。

この構文では次の特殊文字も使用できます。

  • (*) にはすべての値が含まれます。

  • (/) は値を複数のステップに分割します。たとえば、day フィールドを */2 とすると「2 日おき」ということになります。

  • (-) を使用すると値の範囲を作成できます。たとえば、months フィールドを 1-3 にすると、「1 月から 3 月まで」ということになります。

  • (,) は個々の値を指定します。たとえば、weekday フィールドを 1,3 にすると「月曜日と水曜日」ということになります。

  1. i を押すと挿入モードがオンになります。

  2. crontab ファイルに次の行を追加して、毎週火曜日と木曜日の午後 6 時にテスト スクリプトを実行します。

    1 0 18 * * 2,4 /Users/[username]/test-script.sh
  3. 挿入モードを終了するには ESC を押します。

  4. コロン :x の順に押してファイルを保存して終了し、編集内容を crontab に保存します。

  5. crontab コマンドを使用して、既存の cron ジョブのリストを表示できます。出力には、以前に追加されたすべての Cron 式が表示されます。

    1 crontab -l

Windows/DOS で Cleanse and Import クライアントと Windows スケジューラーを使用してデータをインポートする

前提条件

  • インポートするオブジェクト クラスにリンクされているすべてのデータ ソースをマッピングしてクレンジングする必要があります。

  • Cleanse and Import クライアントもインストールする必要があります。「Cleanse and Import クライアントをインストールする」をご確認ください。

Windows タスク スケジューラクレンジングとインポート クライアントを実行するタスクを作成するには、次の手順に従います。

  1. Windows タスク スケジューラを開く

  2. データ マネージャー」というサブフォルダーを作成します。

  3. 右側のペインから [タスクの作成] を選択すると、[タスクの作成] ボックスが表示されます。 

  4. タスクの名前を入力します。実行する内容がわかる名前にしてください。この例では「テスト」を使用しますが、より適切な名前として「JSM アセットをインポート」などが考えられます。

  5. ラジオ ボタン [ユーザーがログオンしているかどうかにかかわらず実行する] を選択します。

  6. [Change User or Group (ユーザーまたはグループの変更)] を選択し、サービス アカウントの詳細を入力します。 

通常、サービス アカウントはジョブの実行に使用されます。サービス アカウントには、個人に関連付けられないという利点があるため、アカウントのパスワードは静的なままであり、バッチとして実行できます。

  1. [トリガー] タブ、[新規…] の順に選択します。

  2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。

  3. [OK] を選択します。

  4. [アクション] タブ、[新規…] の順に選択します。 

  5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。

  6. [プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。

  7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります

    1. [トリガー] タブをクリックし、[新規…] をクリックします。

    2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。

    3. OK をクリックします。

    4. [アクション] タブをクリックし、[新規…] をクリックします。 

    5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。

    6. [プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。

    7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります

      1. [トリガー] タブをクリックし、[新規…] をクリックします。

      2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。

      3. OK をクリックします。

      4. [アクション] タブをクリックし、[新規…] をクリックします。 

      5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。

      6. [プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。

      7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります

        1. [トリガー] タブをクリックし、[新規…] をクリックします。

        2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。

        3. OK をクリックします。

        4. [アクション] タブをクリックし、[新規…] をクリックします。 

        5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。

        6. [プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。

        7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります

          1. 次のようにワークスペース ID を指定する必要があります。

            1 --workspaceid e44regc98-8d2r-3af7-011t-209p44716366
          2. 次のように Cleanse and Import クライアント トークンを指定する必要があります。

            1 --token ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52
          3. クレンジングとインポートのいずれかのみ、または両方の操作を同時に実行するかを指定する必要があります。

            1 2 3 --run import --run cleanse --run full

注: タスク名にスペースが含まれている場合は特に、データ ソース名を二重引用符 (") で囲んでください。 

  1. [開始 (オプション):] フィールドは、データ マネージャー クライアントの実行可能ファイルが存在するサーバー上の場所です (前提条件を参照してください)。データ マネージャー クライアントが存在する宛先フォルダーを指定します。

  2. [設定] タブ内をクリックします。

  3. [タスクを停止するまでの時間] を [3 日間] から [1 時間] に変更します。

  4. OK をクリックします。

  5. サービス アカウントを使用してタスクを開始すると、サービス アカウントのパスワードを入力するよう求められます。対応するパスワードを入力して、[保存] ボタンをクリックします。

タスクが保存され、タスク スケジューラから実行できるようになりました。タスクは上記の手順で定義された時間に実行されます。スケジュールされたタスクは、[タスク名]、[実行] の順に選択することでテストできます。

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

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