ワークフロー

ビルダーが利用可能な場合、再利用可能なプロジェクトワークフローを作成、テスト、デプロイ、レビューします。

ワークフローは反復可能なプロセスを、Runnerが同じ入力とルールで再度実行できる接続されたステップに変えます。

条件付き: ワークフローインターフェースは存在しますが、現在の標準プロジェクトナビゲーションはワークフローエントリを公開していません。Runnerがワークスペースの承認されたワークフローエントリを表示するか、Runnerサポートが承認されたパスを提供する場合にのみ使用してください。推測したり、URLを編集したりしてアクセスしないでください。プランがプレビューのみを許可する場合、Runnerはページを表示しながらコントロールをブロックしたままにすることができます。

エントリパス

Runnerがワークスペースにワークフローエントリを表示する場合にのみ開いてください。ページには現在のプロジェクトのワークフローが一覧表示されます。エントリがない場合は、直接URLを試す代わりに機能の利用可能性を使用するか、サポートに連絡してください。

開始する前に

ワークフローアクセスは、現在の機能ロールアウトとプランに依存します。
ワークフローをテストまたはデプロイする前に、プロジェクトと接続されたサービスを確認してください。
プレビューまたは保存されたドラフトはアクティブではありません。デプロイとアクティベーションは別の重要なアクションです。

ワークフロー一覧

ワークフローがない場合は、ワークフローを作成を選択します。リストに既にアイテムがある場合は、新しいワークフローを使用します。

コントロール	選択後の動作
ワークフローを作成または新しいワークフロー	ワークフローを作成を開きます。
空のワークフロー	無題のワークフローを作成し、ビルダーを開きます。
テンプレートカード	そのテンプレートからワークフローを作成し、ビルダーを開きます。テンプレートの読み込みに失敗した場合、再試行でそれらを再度リクエストします。
ワークフロー名	そのワークフローをビルダーで開きます。
名前を変更	名前を編集可能にします。入力またはクリックで保存されます。Escapeでキャンセルします。
上部に固定 / 固定を解除	ワークフローをピン留めグループに移動するか、グループから削除します。ワークフローは実行されません。
複製	コピーを作成し、ビルダーでコピーを開きます。
エクスポート	ワークフローをJSONファイルとしてダウンロードします。デプロイまたは実行されません。
削除	確認を開きます。確認するとそのワークフローが永久に削除され、元に戻すことはできません。

各行の「その他」メニューを使用して、名前を変更、上部に固定または固定を解除、複製、エクスポート、削除を見つけます。

行ラベルは、バージョンが稼働中か、新しい下書きありか、エンドポイントを公開しているか、スケジュールまたはイベントにバインドされているかを示すこともできます。一時停止またはプランブロックラベルは、自動トリガーが現在アクティブでないことを意味します。

複数のワークフローを操作する

1つ以上の行の横にあるチェックボックスを選択します。選択バーは選択数を表示し、以下を提供します:

エクスポートで選択したワークフローをダウンロードします。
削除で一括確認を開きます。確認するとすべての選択されたワークフローが永久に削除されます。
クリアで選択を削除し、ワークフローは変更しません。

すべて選択は現在のリストに表示されているワークフローを選択します。一括削除の前に常に数を再確認してください。

ビルドと保存

ビルダーキャンバスは、ステップを追加し、接続し、各ステップが受け取るものと実行することを構成する場所です。コンポーネントを追加は検索可能なコンポーネントライブラリを開きます。キャンバスコントロールはズームイン、ズームアウト、ワークフローを画面に合わせる、接続されたステップを自動的に配置します。

変更は自動的に保存されます。別の保存ボタンはありません。戻る矢印は保留中の保存を完了してからワークフロー一覧に戻ります。

保存状態	実行すること
保存中…	ページを閉じるかデプロイする前に待機してください。
たった今に保存（時刻は変わります）	最新のキャンバス変更が保存されています。
保存に失敗しました	接続を確認した後、再試行を選択してください。
競合 - 変更は保存されませんでした	より新しい保存バージョンがあります。再読み込みで競合するローカル編集を破棄し、保存されたバージョンを読み込みます。

下部パネルにはプレイグラウンドと実行履歴が含まれています。プレイグラウンドで、実行する前に必要なテキスト、製品、またはメディア入力を完成させます。必要な入力がない場合、実行コントロールは利用不可のままです。結果は出力エリアに表示されます。

ビルダーの「その他」メニューはJSONのエクスポートとJSONをインポート… も提供します。エクスポートは現在のキャンバスをダウンロードします。インポートは現在のキャンバスを直ちに置き換え、確認なしで自動保存をトリガーするため、バックアップをエクスポートし、インポート前に選択したファイルを確認してください。

適切なテストを選択する

テストは非常に異なる結果をもたらす可能性があります。

コントロール	選択後の動作
シミュレート	シミュレーションダイアログを開きます。生成されたサンプルデータを使用するか、JSONを貼り付けて、シミュレーションを実行するを選択します。メール、Slackポスト、ストア変更などの書き込み側アクションはスタブされます。
ライブテスト	ライブテストダイアログを開きます。生成されたデータ、貼り付けたJSON、または利用可能な最近のイベントを使用します。ライブテストを実行するは実際のAPI呼び出しを行い、メッセージを送信するか接続されたサービスを変更できます。実行は履歴でテストとしてマークされます。
待機をスキップ	ライブテスト中に、構成された待機期間をスキップして、テストをより早く続行できます。他の実際の効果は削除されません。
ワークフローの実行	構成されたワークフローを直ちに開始し、実行履歴を開きます。そのステップは実際の効果を持つ可能性があります。すべてのステップと入力を最初にレビューしてください。
停止	現在の実行を停止するようリクエストします。既に完了した作業は元に戻されません。
キャッシュ	再実行時に、入力が変更されていない適格なノードをスキップして、変更されたダウンストリーム作業に焦点を当てることができます。

シミュレーションを使用して分岐とデータフローを確認します。ライブテストは、接続されたアカウントで実際の副作用が許容される場合にのみ使用してください。

どちらのテストも、デプロイ前でも選択したトリガーを使用します。スケジュールまたは1 回限りのトリガーでは、その時点でトリガーが発火したものとして実行が開始されるため、1 回限りのワークフローを予定日より前にテストできます。

実行履歴をレビューする

下部パネルで実行履歴を開いて、以前の実行を確認します。本番、テスト、またはすべての実行でリストをフィルタリングし、実行を選択してそのノード結果、出力、タイミング、エラーを検査します。ステータスには「完了」「失敗」「実行中」「キャンセルされました」が含まれます。

リストがまだ実行されていませんと表示される場合、現在のワークフローには記録された実行がありません。別の実行を開始することは、失敗したものの修正ではありません。最初に失敗した実行を開き、そのエラーを読んでください。

一部の適格な失敗したノードは 「ノード」から再試行を提供します。これは別の確認なしに直ちに新しい試行を開始します。ダウンストリームアクションは再度実行できるため、失敗した実行によって既に生成されたメッセージまたはストア変更を最初に確認してください。

デプロイとアクティベート

デプロイを選択してデプロイワークフローを開きます。続行する前に、変更サマリー、APIコントラクト互換性、検証結果、オプションのチェンジログをレビューしてください。

デプロイされたワークフローは、オプションでイベント、繰り返しのスケジュール、または 1 回限りの実行にバインドできます。これらのトリガータイプの1つだけを一度に選択できます。1 回限りの実行には、ご自身のタイムゾーンで入力した将来の日時が必要です。

デプロイワークフローは選択された設定でバージョンを公開します。
有効化してデプロイは、新しいイベント、スケジュール、または 1 回限りのバインディングがオートメーションをアクティブにする場合に表示されます。確認するとバージョンを公開し、将来のトリガーが実際の効果で自動的に実行されることを許可します。

保存エラー、未解決の競合、または検証問題がデプロイをブロックできます。繰り返しデプロイを選択する代わりに、それを解決してください。

本番ステータスには、未デプロイ、新しい下書きあり、または稼働中と、トリガーが表示されます。初回デプロイ前は、選択したトリガー（イベント、スケジュール、1 回限り、または手動）か、トリガーなしが表示されます。デプロイ後は、トリガーがバインドされていない場合は手動、それ以外はバインディングの状態（有効、予約済み、完了、一時停止中など）が表示されます。既存のバインディングを開くと、重要なコントロールが提供されます:

一時停止は自動トリガーを停止しますが、ワークフローとバインディングを保持します。
トリガーを再開は保持されたバインディングが再度トリガーされることを許可します。
トリガーを削除はバインディングを永久に削除しますが、ワークフローは削除しません。

各アクションは確認を開き、理由を含めることができます。デプロイ中に既存のバインディングからチェックを削除すると、そのバインディングを永久に削除するのではなく一時停止します。

バージョン履歴とロールバック

バージョン履歴を選択してバージョン履歴パネルを開きます。

アクション	結果
ロールバックの確認	このバージョンにロールバックしますか？を開きます。ロールバックの確認で選択されたデプロイされたバージョンが現在のデプロイされたバージョンに取って代わります。これは将来の実行が何をするかを変更できますが、現在のドラフトキャンバスは置き換えません。
ドラフト履歴の復元	確認後、現在のキャンバスを選択された保存されたドラフトで置き換えます。保存されていないまたはより新しいキャンバス変更が失われる可能性があります。

ロールバック理由をオプションで追加して、他のワークスペースメンバーが変更を理解できるようにしてください。復元されたキャンバスとデプロイメント状態をレビューしてから、別の実行を開始してください。

安全な操作チェックリスト

正しいプロジェクトとワークフローにいることを確認してください。
テストまたはデプロイの前に、たった今に保存などと表示されるまで待ってください。
すべての必要な入力を完成させてレビューしてください。
可能な場合はシミュレーションを実行するで開始してください。
ライブテストまたはワークフローを実行するのは、接続されたサービスの効果が許容される場合のみです。
デプロイする前に実行履歴と出力を検査してください。
有効化してデプロイ、ロールバック、復元、削除を最終レビューが必要な重要なアクションとして扱ってください。

トラブルシューティング

問題	次のステップ
ワークフローエントリが表示されない	これは標準ナビゲーションでは予想されます。URLを推測しないでください。機能の利用可能性を参照するか、Runnerサポートにワークスペースが承認されたエントリを持っているかどうかを確認してください。
コントロールがプランプレビューでブロックされている	画面上のプランメッセージに従うか、ワークスペース所有者にアクセスについて確認してください。
テンプレートリストが失敗する	再試行を選択するか、空のワークフローを作成してください。
実行ボタンが利用不可	すべての必要な入力を完成させ、無効な値を修正してください。
保存競合が表示される	再読み込みを選択する前に、保存されたバージョンが勝つべきかどうかを決定してください。ローカルの競合する編集は破棄されるためです。
実行が失敗する	実行履歴で開き、表示されたエラーと入力を保持し、同じ実行を繰り返し開始しないでください。
デプロイがブロックされている	デプロイダイアログに表示されている保存、競合、コントラクト、または検証メッセージを解決してください。

次の段階に進む前に結果を確認する

保存後、同じワークフローを開き直し、手順と入力があることを確認します。保存は確認の準備ができた状態であり、実行済みとは限りません。テストやデプロイが利用できる場合は、実行結果と出力を確認してからデプロイへ進みます。失敗した場合は、入力や失敗した手順を修正してから再試行してください。