対話型チュートリアル：データフロー、実行、デバッグの極め方 - n8n ワークフロー

• ビジュアルオートメーションプラットフォームへの移行を考えている開発者やプログラマー。


• データフローと実行について深く技術的な理解を求めているn8nの新規ユーザー。


• n8nノードが単一アイテムと複数アイテムをどのように処理するかを理解したいユーザー。


• コアロジックとデバッグ技術に焦点を当てた、堅牢なn8nテンプレートを探している方。

この包括的なn8nワークフローは、生きたドキュメント兼チュートリアルとして機能し、n8nでの自動化構築における重要かつ直感に反する場合がある側面に新規ユーザーをガイドします。データアイテムが実行フローにどのように影響を与えるか、実行パスの重要な違い、適切なデータ参照といった基本概念を取り上げます。この対話型n8nテンプレートは、受動的なドキュメントとは異なり、ユーザーが概念をライブで実行・デバッグできるため、n8nデータモデルとフロー制御の確実な理解を保証します。このコアロジックを習得することは、信頼性が高く複雑なn8nソリューションを作成するために不可欠です。

このセルフガイド型n8nワークフローは一連のFormノードを使用して一時停止しレッスンを表示します。処理を進めるにはユーザーの操作が必要で、データパスのライブ検査が可能です。

1. 開始: n8nワークフローはForm Start n8nトリガーから始まり、チュートリアルの開始を促します。


2. フロー制御: ワークフローはまず逐次実行を実演します。ノードが複数のパスに接続されている場合、上のパス (Do Thing 1) が完全に終了してから、下のパス (Do Thing 2) が開始されることが保証されます。


3. データスコープと分離: Set n8nノードによって設定されたデータは、自然にそのブランチ内に分離されること（Cant See Itは並列データを参照できないこと）を示します。


4. データ結合: Merge n8nノード（Combineに設定）を使用して、別々のブランチからのデータを単一のフローアイテムとして正常に統合する方法を示します。これにより、Can See Bothフォームからデータが参照可能になります。


5. 実行モード: 複数のCodeノードを使用して複数のデータアイテムを生成し、複数アイテムが渡された場合、特に設定しない限り下流のn8nノードはアイテムごとに1回実行されるという基本概念を実演します。


6. 集計: Aggregate Items n8nノードは、5つの別々のデータアイテムを、それら全アイテムを含む単一のデータアイテム（配列）に統合する方法を示し、続いてSplit Outノードでその逆のプロセスを実行します。


7. 高度な制御: n8nワークフローは、反復処理のためのLoop Over Items（Split In Batches）ノードと、複数アイテムの流れを意図的に単一の実行に絞り込むためにNoOp n8nノードにOnly Once設定を使用する方法を紹介します。


8. デバッグ: 最終ステップでは、ワークフローのログを確認するように案内します。これは、あらゆる複雑なn8nワークフローをデバッグする上で不可欠な手順です。

1. インポート: 上記のJSONコード全体をコピーします。


2. n8nを開く: ご利用のn8nインスタンスで、「+」をクリックして新しいワークフローを作成します。


3. JSONからインポート: 右上隅にある「Import from JSON」ボタンをクリックし、コピーしたn8nワークフローJSONを貼り付けます。


4. 実行: このn8nテンプレートはForm Start n8nトリガーを使用しているため、外部認証情報は必要ありません。「Execute Workflow」をクリックして対話型フォームを開き、チュートリアルを開始します。Sticky Noteノードや対話型フォームウィンドウに表示される指示に従ってください。指示に従い、各n8nノードの設定を確認するために、適宜実行を停止することを忘れないでください。

• Form Start (n8nトリガー): チュートリアルの対話型開始点として機能します。Webフォームを起動し、ワークフロー全体の実行ペースを制御します。


• Form (n8nノード): ワークフロー全体で広範に使用され、実行を一時停止し、説明テキストを提供し、データ操作テストの結果を表示するために使用されます。


• Sticky Note: 指示コンテンツの大部分を含み、データフローのルールや実行モードなどの各概念についてユーザーをガイドします。


• Set: データをフロー全体に渡す方法を示すため（例：myvalue1e, myvalue1f）、キーと値のペアを作成および割り当てするために使用されるコアn8nノードです。


• Merge: mode: combineに設定され、2つの並列実行ブランチからのデータを正常にまとめる方法を示すために極めて重要です。


• Code: テストデータ（例：Create Three Items, Create Five Items）を動的に生成したり、n8nノードを「全アイテムに対して1回」実行する場合と「アイテムごとに1回」実行する場合の違いを実演したりするために使用されます。


• Aggregate Items: 複数のデータアイテムの流れ（例：5アイテム）を、それら全アイテムを含む単一のデータアイテム（配列）に集約し、バッチ処理の準備を示します。


• Split Out: Aggregateの逆で、単一アイテム内の配列を受け取り、それを個別の複数アイテムに展開し、アイテムベースの実行フローを再開させます。


• NoOp: 主にレイアウトのために使用されますが、1つのインスタンスはexecuteOnce: trueに設定されており、複数アイテムからの下流の実行フローを意図的に1つに絞り込む方法（強力なn8nのフロー制御テクニック）を示すために使用されます。