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

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.

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

以下の手順は、サードパーティのスケジューリングアプリと 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 ジョブを作成するには、次の手順を実行します。

Mac の Finder アプリ ([アプリケーション] > [ユーティリティ] > [ターミナル]) に移動して、コマンドラインインターフェイスを開きます。
Cleanse and Import クライアントの場所に移動します。データマネージャークライアントの設定によっては、別の場所にある場合があります。Cleanse and Import クライアントは次のようなファイル名になっています。
dm-cleanseimport.app
Create a new script to run the Cleanse and Import client. Make a new .sh file using a text editor like Nano. The example below creates a file named test-script.sh:
nano test-script.sh
次に、Cleanse and Import クライアントを実行するコマンドを入力します。ワークスペース ID と Cleanse and Import クライアントトークンの両方が必要です。サンプルスクリプトを次に示します。
#!/bin/bash echo "This is an sample Bash script that runs the Importers client." ./dm-cleanseimport --workspace-id <workspaceId> --token <your-token> –-run "import"

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

スクリプトを保存します。
chmod コマンドを使用してスクリプトを実行可能にします。
chmod +x test-script.sh
次に、以下のように入力して Crontab ファイルを開きます。ファイルは vi エディターで開きます。既存の crontab がない場合は新しいファイルが作成されます。
crontab -e

To schedule a job for a different user, add the -u option: crontab -u [username] -e

Cron 式とスクリプトパスを含む行を追加します。
[cron-expression] [path-to-script]
Cron 式は、対応する数値を入力する次の 5 つのフィールドで構成されています。
[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 にすると「月曜日と水曜日」ということになります。

i を押すと挿入モードがオンになります。
crontab ファイルに次の行を追加して、毎週火曜日と木曜日の午後 6 時にテストスクリプトを実行します。
0 18 * * 2,4 /Users/[username]/test-script.sh
挿入モードを終了するには ESC を押します。
コロン :、x の順に押してファイルを保存して終了し、編集内容を crontab に保存します。
You can view your list of existing cron jobs using the crontab command. The output displays all the previously added Cron expressions.
crontab -l

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

前提条件

インポートするオブジェクトクラスにリンクされているすべてのデータソースをマッピングしてクレンジングする必要があります。
Cleanse and Import クライアントもインストールする必要があります。「Cleanse and Import クライアントをインストールする」をご確認ください。

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

Windows タスクスケジューラを開く
「データマネージャー」というサブフォルダーを作成します。
右側のペインから [タスクの作成] を選択すると、[タスクの作成] ボックスが表示されます。
タスクの名前を入力します。実行する内容がわかる名前にしてください。この例では「テスト」を使用しますが、より適切な名前として「JSM アセットをインポート」などが考えられます。
ラジオボタン [ユーザーがログオンしているかどうかにかかわらず実行する] を選択します。
[Change User or Group (ユーザーまたはグループの変更)] を選択し、サービスアカウントの詳細を入力します。

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

[トリガー] タブ、[新規…] の順に選択します。
ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
[OK] を選択します。
[アクション] タブ、[新規…] の順に選択します。
[操作:] が [プログラムの開始] に設定されていることをご確認ください。
Enter the Program/script as dm-cleanseimport.exe.
[引数の追加 (オプション)] フィールドには以下を入力する必要があります。
1. [トリガー] タブをクリックし、[新規…] をクリックします。
2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
3. OK をクリックします。
4. [アクション] タブをクリックし、[新規…] をクリックします。
5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。
6. Enter the Program/script as dm-cleanseimport.exe.
7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります。
  1. [トリガー] タブをクリックし、[新規…] をクリックします。
  2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
  3. OK をクリックします。
  4. [アクション] タブをクリックし、[新規…] をクリックします。
  5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。
  6. Enter the Program/script as dm-cleanseimport.exe.
  7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります。
    1. [トリガー] タブをクリックし、[新規…] をクリックします。
    2. ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
    3. OK をクリックします。
    4. [アクション] タブをクリックし、[新規…] をクリックします。
    5. [操作:] が [プログラムの開始] に設定されていることをご確認ください。
    6. Enter the Program/script as dm-cleanseimport.exe.
    7. [引数の追加 (オプション)] フィールドには以下を入力する必要があります。
      1. 次のようにワークスペース ID を指定する必要があります。
        --workspaceid e44regc98-8d2r-3af7-011t-209p44716366
      2. 次のように Cleanse and Import クライアントトークンを指定する必要があります。
        --token ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52
      3. クレンジングとインポートのいずれかのみ、または両方の操作を同時に実行するかを指定する必要があります。
        --run import --run cleanse --run full

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

The Start in (optional): field is where the Data Manager client executable resides in the server (refer to the prerequisites). Specify the destination folder where the Data Manager client resides.
[設定] タブ内をクリックします。
[タスクを停止するまでの時間] を [3 日間] から [1 時間] に変更します。
OK をクリックします。
サービスアカウントを使用してタスクを開始すると、サービスアカウントのパスワードを入力するよう求められます。対応するパスワードを入力して、[保存] ボタンをクリックします。

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

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

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

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

コミュニティに質問