ジョブのスケジュール

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

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

インポートする データ ソース ごとに 1 つのスケジュール済みタスクが存在する必要があります。

使用するためにファイルをサーバーに配置するプロセスがある場合は、アダプター・クライアントが 使用する適切な場所にファイルをコピーするために、追加のスケジュールされたタスクが必要になる場合があります。

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

MacOS と Linux で cron ジョブを含むアダプター クライアントを使用してジョブをスケジュールする

アダプター・クライアントを実行するための Cron ジョブを作成するには、次のようにします。

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

2. アダプター・クライアントの場所にナビゲートします。

   cd ~/jsm-data-manager-clients/Assets.Adapters.Client.app

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

   nano test-script.sh

4. 次に、アダプター クライアントを実行するコマンドを入力します。ワークスペース ID とアダプター トークンの両方が必要です。サンプル スクリプトを次に示します。

   #!/bin/bash echo "This is an sample Bash script that runs the Adapters client." ./Assets.Adapters.Client.app --workspace-id <workspaceId> --token <your-token> –-run <full>

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

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

   chmod +x test-script.sh

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

   crontab -e

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

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

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

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

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

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

   0 18 * * 2,4 /Users/[username]/test-script.sh

3. 挿入モードを終了するには ESC を押します。

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

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

   crontab -l

Windows/DOS の Windows スケジューラでアダプター クライアントを使用してジョブをスケジュールする

Windows タスク スケジューラでタスクを作成してアダプター クライアントを実行するには、次のようにします。

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

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

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

4. タスクの名前を入力します。仕事が成し遂げられるべき意味のある名前をつけます。この例では Test を使用しますが、"JSM アセットのジョッブを実行" など、より適切な名前を付けることもできます。

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

6. 「ユーザーまたはグループの変更」をクリックし、入力し、サービスアカウントの詳細を選択します。 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

            2. アダプター・クライアント・トークンを指定する必要があります。例:

               --token ATCTT3xFrTN0U64VR99p1VfpQtLlpar7R4hq6PSkiNNaNOyk37P_7URVmROOp1Orez-ijlluMRwJA7Cw1LsgMFqFnvhJapdniv4ewDc0twt7vPBhrbDts1fyPOW6Tw3S-Gzg6rRaEULWl2_JqQNvictFu_hK6wGxpGRvPTpyaQXzr9MtQ_8yKDms=0433HC52

            3. ジョブの名前を指定してください。

               --run myJobName

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

   c:\users\public\assets_data_manager\data_manager_clients\win-x64\assets-adapters-client\

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

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

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

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

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