Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
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 時間) を確保して、スケジュールされたタスクを完了できるようにする必要があります。
前提条件
インポートするオブジェクト クラスにリンクされているすべてのデータ ソースをマッピングしてクレンジングする必要があります。
Cleanse and Import クライアントもインストールする必要があります。「Cleanse and Import クライアントをインストールする」をご確認ください。
Cleanse and Import クライアントを実行するための Cron ジョブを作成するには、次の手順を実行します。
Mac の Finder アプリ ([アプリケーション] > [ユーティリティ] > [ターミナル]) に移動して、コマンド ライン インターフェイスを開きます。
Cleanse and Import クライアントの場所に移動します。データ マネージャー クライアントの設定によっては、別の場所にある場合があります。Cleanse and Import クライアントは次のようなファイル名になっています。
1
dm-cleanseimport.app
Cleanse and Import クライアントを実行するための新しいスクリプトを作成します。新しい .sh ファイルを作成します。Nano などのテキスト エディターを使用します。次の例では、test-script.sh という名前のファイルを作成します。
1
nano test-script.sh
次に、Cleanse and Import クライアントを実行するコマンドを入力します。ワークスペース ID と Cleanse 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"
タスク名にスペースが含まれている場合は特に、ジョブ名を二重引用符 (") で囲んでください。
スクリプトを保存します。
chmod コマンドを使用してスクリプトを実行可能にします。
1
chmod +x test-script.sh
次に、以下のように入力して Crontab ファイルを開きます。ファイルは vi エディターで開きます。既存の crontab がない場合は新しいファイルが作成されます。
1
crontab -e
別のユーザーのジョブをスケジュールするには、-u オプションを追加します: crontab -u [username] -e
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 にすると「月曜日と水曜日」ということになります。
i を押すと挿入モードがオンになります。
crontab ファイルに次の行を追加して、毎週火曜日と木曜日の午後 6 時にテスト スクリプトを実行します。
1
0 18 * * 2,4 /Users/[username]/test-script.sh
挿入モードを終了するには ESC を押します。
コロン :、x の順に押してファイルを保存して終了し、編集内容を crontab に保存します。
crontab コマンドを使用して、既存の cron ジョブのリストを表示できます。出力には、以前に追加されたすべての Cron 式が表示されます。
1
crontab -l
前提条件
インポートするオブジェクト クラスにリンクされているすべてのデータ ソースをマッピングしてクレンジングする必要があります。
Cleanse and Import クライアントもインストールする必要があります。「Cleanse and Import クライアントをインストールする」をご確認ください。
Windows タスク スケジューラでクレンジングとインポート クライアントを実行するタスクを作成するには、次の手順に従います。
Windows タスク スケジューラを開く
「データ マネージャー」というサブフォルダーを作成します。
右側のペインから [タスクの作成] を選択すると、[タスクの作成] ボックスが表示されます。
タスクの名前を入力します。実行する内容がわかる名前にしてください。この例では「テスト」を使用しますが、より適切な名前として「JSM アセットをインポート」などが考えられます。
ラジオ ボタン [ユーザーがログオンしているかどうかにかかわらず実行する] を選択します。
[Change User or Group (ユーザーまたはグループの変更)] を選択し、サービス アカウントの詳細を入力します。
通常、サービス アカウントはジョブの実行に使用されます。サービス アカウントには、個人に関連付けられないという利点があるため、アカウントのパスワードは静的なままであり、バッチとして実行できます。
[トリガー] タブ、[新規…] の順に選択します。
ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
[OK] を選択します。
[アクション] タブ、[新規…] の順に選択します。
[操作:] が [プログラムの開始] に設定されていることをご確認ください。
[プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。
[引数の追加 (オプション)] フィールドには以下を入力する必要があります。
[トリガー] タブをクリックし、[新規…] をクリックします。
ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
OK をクリックします。
[アクション] タブをクリックし、[新規…] をクリックします。
[操作:] が [プログラムの開始] に設定されていることをご確認ください。
[プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。
[引数の追加 (オプション)] フィールドには以下を入力する必要があります。
[トリガー] タブをクリックし、[新規…] をクリックします。
ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
OK をクリックします。
[アクション] タブをクリックし、[新規…] をクリックします。
[操作:] が [プログラムの開始] に設定されていることをご確認ください。
[プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。
[引数の追加 (オプション)] フィールドには以下を入力する必要があります。
[トリガー] タブをクリックし、[新規…] をクリックします。
ジョブを実行するタイミングの詳細 (毎日、週に 1 回、月に 1 回、開始時間など) を入力します。
OK をクリックします。
[アクション] タブをクリックし、[新規…] をクリックします。
[操作:] が [プログラムの開始] に設定されていることをご確認ください。
[プログラム/スクリプト] に「dm-cleanseimport.exe」と入力します。
[引数の追加 (オプション)] フィールドには以下を入力する必要があります。
次のようにワークスペース ID を指定する必要があります。
1
--workspaceid e44regc98-8d2r-3af7-011t-209p44716366
次のように Cleanse and Import クライアント トークンを指定する必要があります。
1
--token ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52
クレンジングとインポートのいずれかのみ、または両方の操作を同時に実行するかを指定する必要があります。
1
2
3
--run import
--run cleanse
--run full
注: タスク名にスペースが含まれている場合は特に、データ ソース名を二重引用符 (") で囲んでください。
[開始 (オプション):] フィールドは、データ マネージャー クライアントの実行可能ファイルが存在するサーバー上の場所です (前提条件を参照してください)。データ マネージャー クライアントが存在する宛先フォルダーを指定します。
[設定] タブ内をクリックします。
[タスクを停止するまでの時間] を [3 日間] から [1 時間] に変更します。
OK をクリックします。
サービス アカウントを使用してタスクを開始すると、サービス アカウントのパスワードを入力するよう求められます。対応するパスワードを入力して、[保存] ボタンをクリックします。
タスクが保存され、タスク スケジューラから実行できるようになりました。タスクは上記の手順で定義された時間に実行されます。スケジュールされたタスクは、[タスク名]、[実行] の順に選択することでテストできます。
この内容はお役に立ちましたか?