Runbook の呼び出し
Runbook の呼び出しアクティビティは、指定した Runbook を起動します。 呼び出された Runbook で Initialize Data アクティビティを構成することで、Runbook にデータを転送できます。 呼び出された Runbook からデータを返すには、 Return Data アクティビティを構成します。
Runbook の呼び出しアクティビティを使用すると、Runbook の呼び出し方法に依存しない特定のアクションのみを実行する汎用 Runbook を呼び出すことができます。 たとえば、別の Runbook を呼び出してバックアップ メンテナンス手順を実行する Runbook を作成し、Runbook を呼び出してサービスをシャットダウンし、別の Runbook を呼び出してデータをバックアップし、最後の Runbook を使用してサービスを再起動することができます。
重要
Runbook のフォルダー名または場所を変更する場合は、変更された Runbook を参照する Invoke Runbook アクティビティも再構成する必要があります。
Runbook の呼び出しアクティビティを構成する
Runbook の呼び出しアクティビティを構成する前に、呼び出す Runbook を把握しておく必要があります。
Runbook の呼び出しアクティビティを構成するには、次の情報を使用します。
詳細
| 設定 | 構成の手順 |
|---|---|
| Runbook | 省略記号 (...) ボタンを選択して、呼び出す Runbook を参照します。 重要: Monitor アクティビティで始まる Runbook を呼び出さないでください。 |
| パスによる呼び出し | 特定のパスと名前で Runbook を呼び出すように Runbook の呼び出しアクティビティを強制する場合に選択します。 選択すると、同じフォルダーの場所に同じ名前の Runbook が呼び出されます。 選択されていない場合、呼び出される Runbook は環境を移動でき、Runbook の呼び出しアクティビティは自動的に新しい場所にマップされます。 |
| 実行が完了するまで待つ | [Runbook の呼び出し] アクティビティが完了するまで、呼び出された Runbook を実行し続ける場合に選択します。 重要:呼び出された Runbook の戻り値データが呼び出し元の Runbook のデータも返される場合は完了のために Wait を選択しないでください。 |
| パラメーター | Initialize Data アクティビティを含む Runbook を選択した場合、そのアクティビティを呼び出すために必要なパラメーターの一覧が表示されます。 各パラメーターの値を入力します。 |
| Runbook サーバー | この Runbook を実行する Runbook サーバーの一覧を入力します。 各名前はセミコロン (;)で区切ります。 Runbook サーバーが一覧表示される順序は、Runbook のフェールオーバーと負荷分散に使用される順序になります。 Runbook サーバー名は、Orchestrator Deployment Manager の Runbook サーバーのツリー内に表示される名前に対応している必要があります。 Runbook サーバーの割り当てに Runbook またはグローバルの既定値を使用するには、このフィールドを空白のままにします。 |
公開データ
次の表に、Runbook の呼び出しアクティビティから発行されたデータ項目を示します。
| アイテム | 説明 |
|---|---|
| 子 Runbook ジョブ ID | 呼び出された Runbook のジョブ ID。 |
| 子 Runbook の状態 | 子 Runbook によって発行された状態。 |
Runbook の呼び出しアクティビティは、呼び出された Runbook が Runbook のプロパティの [返されたデータ] タブで定義したすべてのデータを返します。 これらのプロパティの値は、そのワークフローの Return Data アクティビティを使用して設定する必要があります。 現在の Runbook が呼び出された Runbook からデータを返す必要がある場合は、これらの値を含む独自の Return Data アクティビティが必要です。
資格情報
Runbook の呼び出しアクティビティを使用し、 Security Credentials を使用する場合、正常に実行するには、使用するアカウントが Orchestrator System グループのメンバーである必要があります。