ワークフロートラブルシューティング

​

Debugging with Workflow Runs

Use the Workflow Runs interface to debug issues:

• Access via the Runs panel in the workflow editor
• 個別の実行をクリックして各ステップの入力/出力データを確認
• 実行ステータス、エラーメッセージ、およびステップ間のデータフローを確認

​

一般的な問題と解決策

​

ワークフローがトリガーされない

問題: ワークフローが期待通りに実行されない。 解決策:

• ワークフローがアクティブ（ドラフトモードではない）であることを確認
• トリガー設定がデータ構造と一致していることを確認
• レコードトリガーの場合、正しいオブジェクトとフィールドが選択されていることを確認
• Webhookトリガーの場合、URLと期待されるデータ形式を確認
• スケジュールドトリガーの場合、タイミング設定を確認

​

フォームがアクセスできない

問題: フォームアクションが自動化されたワークフローで見つけにくい。 回避策: フォームが必要な場合は手動トリガーを使用するか、自動フロー内でフォームを避けるようにワークフローを再構成します。

​

高クレジット消費

問題: ワークフローが予想以上のクレジットを消費します。 一般的な原因と解決策:

• 非効率なAPIコール: 可能な場合は個別のリクエストではなくバッチAPIコールを行う
• 間違った手動トリガー設定: 1回のワークフロー実行で複数のレコードを処理するにはBulk利用を使用します
• フィルタの欠如: 条件が満たされない場合にワークフローを停止するための条件付きロジックを追加
• 不要なステップ: 冗長なアクションを削除しワークフロー論理を最適化する
• リアルタイム対スケジュール: 緊急でないプロセスにはスケジュールされたワークフローを使用する

​

同時ワークフロー制限

問題: ワークスペースごとに100の同時ワークフロー制限に達する。 解決策:

• 手動トリガーのためにBulkの利用を使用して1回の実行で複数のレコードを処理
• スケジュールドトリガーを使用してワークフロー実行間に遅延を実装
• ワークフローを最適化し、実行時間を減らして同時実行を短縮
• 閑散期にバッチ処理を検討する

​

APIレートリミット

問題: 外部API呼び出しがレートリミットにより失敗する。 解決策:

• 可能な限りリアルタイムトリガーではなくスケジュールドワークフローを使用
• コードアクションでのAPIコール間に遅延を実装
• 外部サービスがサポートしている場合はAPIリクエストをバッチ処理
• レートリミットエラーを監視し、タイミングを調整

​

イテレータの問題

問題: イテレータアクションが期待通りに動作しない。 解決策:

• 注: イテレータは現在ベータ版です。 設定→リリース→ラボの下でアクティベート
• 入力が前のステップからのレコードの配列であることを確認
• イテレーター内のアクションが正しく設定されていることを確認
• 最適なパフォーマンスのためにBulk手動トリガーとイテレーターを使用する

​

権限の欠如

問題: ワークフローセクションにアクセスできない。

​

最適化のヒント

​

パフォーマンスのベストプラクティス

• シンプルに始めて徐々に複雑さを加える
• 手動トリガーにBulkの利用を使用して複数のレコードを効率的に処理
• 早めのフィルタ追加で基準が満たされていない場合にワークフローを停止
• APIコールをバッチ処理し、緊急を要さないプロセスにはスケジュールドワークフローを使用
• すべてのワークフローを表示するページからワークフロー実行を非表示にして読み込み性能を改善
• クレジット使用量を定期的に監視し、設定→請求で確認

​

エラープレベンション

• ドラフトモードでテストしてからワークフローを有効化
• API応答を検証し、フォールバックアクションを実装
• メンテナンスを容易にするための詳細なステップ名を使用
• チームメンバー向けの複雑なロジックを文書化する

​

サポートを受ける

​

セルフサービリソース

• 技術的詳細についてはワークフロー機能を参照
• 最適化のヒントについてはワークフロークレジットを確認
• 内部自動化と外部ツール統合を探索して例を確認

​

プロフェッショナルサポート

• 複雑なトラブルシューティングにはプロフェッショナルサービスに連絡
• 技術支援についてはcontact@twenty.comへお問い合わせください