コマンドは、データソースとの接続に基づいて、チェーン内で実行されるタスクである。より複雑なチェーンの場合は、さまざまな条件によってトリガーされるコマンドを含むことができる。
注： チェーンを追加する前に、組織がデータソースでコマンドを有効にするために必要な接続を設定していることを確認してください。
特定のコマンドを、前のコマンドが完了するのを待って1つずつ順番に実行する、同時に並行して実行する、または、単一か複数のコマンドが失敗した場合にチェーンが失敗するように設定するには、コマンドをグループ化します。
チェーンにコマンドを追加する
- チェーンで、実行するコマンドを選択します。
- 新しいコマンドをチェーンに追加するには、Available Connectors 、その接続をクリックし、コマンドをチェーン内の必要な位置に移動する。
- 既存のコマンドを複製するには、そのノードを選択し、[コピー]file_copyをクリックして、新しいノードをチェーン内の必要な場所に移動させます。
ヒント： チェーンの最初のノードとしてコマンドを追加するには、コマンドを開始に移動します。
- コマンドをチェーンの前後のノードにリンクするには、そのノードのポート間をクリックしてドラッグします。
注: チェーン内のノードの位置を変更するには、他のノードからのリンクを解除してから、ノードの位置を変更する場所に移動します。複数のノードを一度に移動するには、SHIFT を押しながら選択します。
- 新しいノードを選択し、[編集]をクリックします。
- コマンドのパラメータを入力します。
- [保存]をクリックします。
単一のコマンドまたはグループのみを実行する
チェーンを構築する際のテストと迅速な反復を容易にするために、チェーン内で単一のコマンドまたはコマンドグループを実行する事ができます。
- チェーンビルダー で、チェーン タブから、実行 をチェーンのメニューから選択します。
- 実行するコマンドまたはグループについては、[このコマンドを実行する]play_circle_outlineをクリックします。
- [チェーンを実行]をクリックします。
コマンドをスキップする
分岐ロジックを開発する場合、あるいはチェーン開発の一部として、特定の結果を強制するためにコマンドをスキップする必要があるかもしれません。また、条件付きロジックを設定して、設定したルールに基づいて自動的に特定の結果を返却することもできます。
- チェーンでは、コマンドのノードを選択して[作成を編集]をクリックし、[スキップ]skip_nextを選択します。
- スキップした際に、コマンドの情報check_circle、警告warning、またはエラーerrorの結果を自動的に返すかどうかを選択します。
- 特定の条件を満たした場合のみコマンドをスキップするには、いつ実行されるかを指定します。条件付きロジックを、ルールを追加するグループおよびルールのその他のグループとして作成し、それぞれを AND または OR ブーリアン型 (Boolean)で結合します。
- スキップするためにすべての条件を満たす必要がある場合は、AND を選択します。
- スキップするために満たすべき条件が1つのみの場合は、OR を選択します。
様々なデータタイプに基づいてルールを追加する事ができます。
データタイプ 説明 文字列 2文字以上 整数 任意の数値全体（小数の桁数以外） 日付 任意の日付文字列または日付変数 フロート 任意の数値 JSON JavaScriptオブジェクト表記法。[変数変換]を使用してオブジェクトを解析する データがコマンドをスキップする条件を満たしているかどうかを確認するには、データを演算子と値とペアにします。
- Is blank または Is not blank
含む- 正規表現の場合は Matches RegExp
- Starts withまたは Ends with
- = または !=
-
<または> - <= または >=
- [保存]をクリックします。
コマンドのエラー処理を管理する
コマンドのエラーを検出または無視するには、次の手順に従います。
- チェーンでは、コマンドのノードを選択して[作成を編集]をクリックし、[警告のエラー処理]を選択します。
- [エラーアクション]repeatから、コマンドが失敗した場合にどうするかを選択します。
- チェーン分岐ロジックに従うには、[チェーンを続行]を選択します。
- 問題の改善など、一時的にチェーンを停止するには、チェーンの一時停止 を選択する。問題解決後にチェーンを再開するには、チェーン内のコマンドを選択し、再開 をクリックします。
- 完全にチェーンを停止するには[チェーンを閉じる]を選択します。
- 必要以上に時間がかかっている場合にコマンドを停止するには、[タイムアウトの条件]alarmから、最大期間を秒単位で入力します。
- データソースが断続的または使用できない場合にコマンドを再試行するには、実行する再試行の回数と、試行の間に待機する秒数を入力します。
- [エラー条件]priority_high、既存のフォルダを作成する際など、無視するエラー内容を選択します。
- 出力に基づいてコマンドのステータスを設定するには、出力解釈で追加 をクリックし、そのステータスを解釈するルールまたはルールグループを定義する。例えば、コマンドの詳細 出力のステータス 変数を使用して、コマンドが成功したときに警告が表示されるルールを設定できます。
- [ログの解釈]で、特定の出力になるかどうかに基づいて、コマンドを失敗させるかどうかを選択します。
- 特定の出力に基づいてコマンドを 失敗させない ようにするには、[解釈しない]を選択します。
- 特定の出力が検出された際にコマンドを失敗させるには、[出力が検出された場合に失敗する]を選択し、検出する出力を入力します。
- 特定の出力が検出されない際にコマンドを失敗させるには、[出力が検出されない場合に失敗する]を選択し、検出する出力を入力します。
- 複数行のテキストは
で区切ってください。
- 「保存」をクリックします。
コマンドの出力を表示
監視 から、CloudRunner経由で実行されたコマンドの出力をプレビューできます。
- チェーンビルダーで、[モニター]からプレビューする出力で実行を開き、コマンドを選択します。
- [出力] タブでは、表示する出力の出力をプレビュー可視性をクリックします。
注：GroundRunnerではなくCloudRunner経由で実行されたコマンドの出力のみをプレビューできます。
チェーンからコマンドを削除する
チェーンからコマンドを削除するには、そのノードをクリックして、[削除]delete、さらに[削除]をクリックします。