ワークフロー
ビルダーが利用可能な場合、再利用可能なプロジェクトワークフローを作成、テスト、デプロイ、レビューします。
ワークフローは反復可能なプロセスを、Runnerが同じ入力とルールで再度実行できる接続されたステップに変えます。
条件付き: ワークフローインターフェースは存在しますが、現在の標準プロジェクトナビゲーションはワークフローエントリを公開していません。Runnerがワークスペースの承認されたワークフローエントリを表示するか、Runnerサポートが承認されたパスを提供する場合にのみ使用してください。推測したり、URLを編集したりしてアクセスしないでください。プランがプレビューのみを許可する場合、Runnerはページを表示しながらコントロールをブロックしたままにすることができます。
エントリパス
Runnerがワークスペースにワークフローエントリを表示する場合にのみ開いてください。ページには現在のプロジェクトのワークフローが一覧表示されます。エントリがない場合は、直接URLを試す代わりに機能の利用可能性を使用するか、サポートに連絡してください。
開始する前に
- ワークフローアクセスは、現在の機能ロールアウトとプランに依存します。
- ワークフローをテストまたはデプロイする前に、プロジェクトと接続されたサービスを確認してください。
- プレビューまたは保存されたドラフトはアクティブではありません。デプロイとアクティベーションは別の重要なアクションです。
ワークフロー一覧
ワークフローがない場合は、ワークフローを作成を選択します。リストに既にアイテムがある場合は、新しいワークフローを使用します。
| コントロール | 選択後の動作 |
|---|---|
| ワークフローを作成または新しいワークフロー | ワークフローを作成を開きます。 |
| 空白 | タイトルなしワークフローを作成し、ビルダーを開きます。 |
| テンプレートカード | そのテンプレートからワークフローを作成し、ビルダーを開きます。テンプレートの読み込みに失敗した場合、再試行でそれらを再度リクエストします。 |
| ワークフロー名 | そのワークフローをビルダーで開きます。 |
| 名前変更 | 名前を編集可能にします。入力またはクリックで保存されます。Escapeでキャンセルします。 |
| トップにピン留め / ピン留め解除 | ワークフローをピン留めグループに移動するか、グループから削除します。ワークフローは実行されません。 |
| 複製 | コピーを作成し、ビルダーでコピーを開きます。 |
| エクスポート | ワークフローをJSONファイルとしてダウンロードします。デプロイまたは実行されません。 |
| 削除 | 確認を開きます。確認するとそのワークフローが永久に削除され、元に戻すことはできません。 |
各行の「その他」メニューを使用して、名前変更、トップにピン留めまたはピン留め解除、複製、エクスポート、削除を見つけます。
行ラベルは、バージョンがライブか、ドラフトが先行しているか、エンドポイントを公開しているか、スケジュールまたはイベントにバインドされているかを示すこともできます。一時停止またはプランブロックラベルは、自動トリガーが現在アクティブでないことを意味します。
複数のワークフローを操作する
1つ以上の行の横にあるチェックボックスを選択します。選択バーは選択数を表示し、以下を提供します:
- エクスポートで選択したワークフローをダウンロードします。
- 削除で一括確認を開きます。確認するとすべての選択されたワークフローが永久に削除されます。
- クリアで選択を削除し、ワークフローは変更しません。
すべて選択は現在のリストに表示されているワークフローを選択します。一括削除の前に常に数を再確認してください。
ビルドと保存
ビルダーキャンバスは、ステップを追加し、接続し、各ステップが受け取るものと実行することを構成する場所です。コンポーネントを追加は検索可能なコンポーネントライブラリを開きます。キャンバスコントロールはズームイン、ズームアウト、ワークフローを画面に合わせる、接続されたステップを自動的に配置します。
変更は自動的に保存されます。別の保存ボタンはありません。戻る矢印は保留中の保存を完了してからワークフロー一覧に戻ります。
| 保存状態 | 実行すること |
|---|---|
| 保存中… | ページを閉じるかデプロイする前に待機してください。 |
| 保存済み | 最新のキャンバス変更が保存されています。 |
| 保存失敗 | 接続を確認した後、再試行を選択してください。 |
| 競合 — 変更が保存されませんでした | より新しい保存バージョンがあります。再読み込みで競合するローカル編集を破棄し、保存されたバージョンを読み込みます。 |
下部パネルにはプレイグラウンドと履歴が含まれています。プレイグラウンドで、実行する前に必要なテキスト、製品、またはメディア入力を完成させます。必要な入力がない場合、実行コントロールは利用不可のままです。結果は出力エリアに表示されます。
ビルダーの「その他」メニューはJSONをエクスポートと**JSONをインポート…**も提供します。エクスポートは現在のキャンバスをダウンロードします。インポートは現在のキャンバスを直ちに置き換え、確認なしで自動保存をトリガーするため、バックアップをエクスポートし、インポート前に選択したファイルを確認してください。
適切なテストを選択する
テストは非常に異なる結果をもたらす可能性があります。
| コントロール | 選択後の動作 |
|---|---|
| APIを呼び出さずにシミュレート | シミュレーションダイアログを開きます。生成されたサンプルデータを使用するか、JSONを貼り付けて、シミュレーションを実行を選択します。メール、Slackポスト、ストア変更などの書き込み側アクションはスタブされます。 |
| ライブテスト — 実際の副作用、isTestとしてマーク | ライブテストダイアログを開きます。生成されたデータ、貼り付けたJSON、または利用可能な最近のイベントを使用します。ライブテストを実行は実際のAPI呼び出しを行い、メッセージを送信するか接続されたサービスを変更できます。実行は履歴でテストとしてマークされます。 |
| 待機をスキップ | ライブテスト中に、構成された待機期間をスキップして、テストをより早く続行できます。他の実際の効果は削除されません。 |
| ワークフローを実行 | 構成されたワークフローを直ちに開始し、履歴を開きます。そのステップは実際の効果を持つ可能性があります。すべてのステップと入力を最初にレビューしてください。 |
| 実行を停止 | 現在の実行を停止するようリクエストします。既に完了した作業は元に戻されません。 |
| キャッシュ | 再実行時に、入力が変更されていない適格なノードをスキップして、変更されたダウンストリーム作業に焦点を当てることができます。 |
シミュレーションを使用して分岐とデータフローを確認します。ライブテストは、接続されたアカウントで実際の副作用が許容される場合にのみ使用してください。
実行履歴をレビューする
下部パネルで履歴を開いて、以前の実行を確認します。ライブ、テスト、またはすべてでリストをフィルタリングし、実行を選択してそのノード結果、出力、タイミング、エラーを検査します。ステータスには完了、失敗、実行中、キャンセルが含まれます。
リストがまだ実行がありませんと表示される場合、現在のワークフローには記録された実行がありません。別の実行を開始することは、失敗したものの修正ではありません。最初に失敗した実行を開き、そのエラーを読んでください。
一部の適格な失敗したノードは**「ノード」から再試行**を提供します。これは別の確認なしに直ちに新しい試行を開始します。ダウンストリームアクションは再度実行できるため、失敗した実行によって既に生成されたメッセージまたはストア変更を最初に確認してください。
デプロイとアクティベート
デプロイを選択してワークフローをデプロイを開きます。続行する前に、変更サマリー、APIコントラクト互換性、検証結果、オプションのチェンジログをレビューしてください。
デプロイされたワークフローをスケジュールまたはイベントにオプションでバインドできます。これらのトリガータイプの1つだけを一度に選択できます。
- デプロイは選択された設定でバージョンを公開します。
- アクティベートしてデプロイは、新しいスケジュールまたはイベントバインディングがオートメーションをアクティブにする場合に表示されます。確認するとバージョンを公開し、将来のトリガーが実際の効果で自動的に実行されることを許可します。
保存エラー、未解決の競合、または検証問題がデプロイをブロックできます。繰り返しデプロイを選択する代わりに、それを解決してください。
デプロイ後、本番ステータスはデプロイされていない、ドラフトが先行、またはライブ、およびバインディングのトリガーなし、アクティブ、または一時停止を表示できます。既存のバインディングを開くと、重要なコントロールが提供されます:
- 一時停止は自動トリガーを停止しますが、ワークフローとバインディングを保持します。
- 再開は保持されたバインディングが再度トリガーされることを許可します。
- 削除はバインディングを永久に削除しますが、ワークフローは削除しません。
各アクションは確認を開き、理由を含めることができます。デプロイ中に既存のバインディングからチェックを削除すると、そのバインディングを永久に削除するのではなく一時停止します。
バージョン履歴とロールバック
バージョン履歴を選択してバージョン履歴パネルを開きます。
| アクション | 結果 |
|---|---|
| ロールバック | **このバージョンにロールバックしますか?**を開きます。確認で選択されたデプロイされたバージョンが現在のデプロイされたバージョンに取って代わります。これは将来の実行が何をするかを変更できますが、現在のドラフトキャンバスは置き換えません。 |
| ドラフト履歴で復元 | 確認後、現在のキャンバスを選択された保存されたドラフトで置き換えます。保存されていないまたはより新しいキャンバス変更が失われる可能性があります。 |
ロールバック理由をオプションで追加して、他のワークスペースメンバーが変更を理解できるようにしてください。復元されたキャンバスとデプロイメント状態をレビューしてから、別の実行を開始してください。
安全な操作チェックリスト
- 正しいプロジェクトとワークフローにいることを確認してください。
- テストまたはデプロイの前に保存済みを待ってください。
- すべての必要な入力を完成させてレビューしてください。
- 可能な場合はシミュレーションを実行で開始してください。
- ライブテストまたはワークフローを実行するのは、接続されたサービスの効果が許容される場合のみです。
- デプロイする前に履歴と出力を検査してください。
- アクティベートしてデプロイ、ロールバック、復元、削除を最終レビューが必要な重要なアクションとして扱ってください。
トラブルシューティング
| 問題 | 次のステップ |
|---|---|
| ワークフローエントリが表示されない | これは標準ナビゲーションでは予想されます。URLを推測しないでください。機能の利用可能性を参照するか、Runnerサポートにワークスペースが承認されたエントリを持っているかどうかを確認してください。 |
| コントロールがプランプレビューでブロックされている | 画面上のプランメッセージに従うか、ワークスペース所有者にアクセスについて確認してください。 |
| テンプレートリストが失敗する | 再試行を選択するか、空白ワークフローを作成してください。 |
| 実行ボタンが利用不可 | すべての必要な入力を完成させ、無効な値を修正してください。 |
| 保存競合が表示される | 再読み込みを選択する前に、保存されたバージョンが勝つべきかどうかを決定してください。ローカルの競合する編集は破棄されるためです。 |
| 実行が失敗する | 履歴で開き、表示されたエラーと入力を保持し、同じ実行を繰り返し開始しないでください。 |
| デプロイがブロックされている | デプロイダイアログに表示されている保存、競合、コントラクト、または検証メッセージを解決してください。 |