イントロダクション
これはコースの最終章です。Codeノード、Setノード、IFノード、Mergeノードの使い方と、式を用いたデータ加工の方法を学習しました。これからは、これらの要素をすべて連携させ、実務的な1つのワークフローとして実装します。2つのソースからデータを取得し、クリーン化・フィルタリングを行い、ターゲットの形に変換し、ストリームをマージして、下流での利用に適した最終出力を作成します。
本レッスン全体で扱うシナリオは、実運用を想定した実用的なものです。HTTPエンドポイント1つからの注文リストと、別のエンドポイントからの顧客リストを取得する構成で、支払済みの注文のみを含む充実した注文レポートを作成し、顧客名とメールを付与し、表示用の日付形式に整形します。
2つのソースから並列でデータを取得する
並列で実行される2つのHTTP Requestノードから開始します。いずれも同じ手動トリガーまたはスケジュールトリガーで起動します。最初は注文を取得し、2番目は顧客を取得します。n8nでは、1つのトリガーを2つのHTTP Requestノードに接続することで実行を分岐します。
注文エンドポイントでは、URLを設定し、レスポンス形式がJSONであることを確認します。生のレスポンスは通常このようになります:
顧客エンドポイントについて:
両ノードはアイテムの配列を出力します。n8nは自動的に配列を個々のアイテムに分割するため、各注文と各顧客が、それぞれワークフローの残りの部分を流れる独自のアイテムになります。
各ストリームのフィルタリングと変換
マージする前に、それぞれのストリームを独立してクリーンアップします。これによりロジックが分離され、デバッグが容易になります。
注文については、注文のHTTPリクエストの直後にIFノードを接続します。条件を、フィールドのstatusが文字列paidと等しいことをチェックするように設定します。真の分岐のみが継続します。これにより、マージに到達する前に保留、キャンセル、返金済みの注文を排除します。
次に、IFの真の出力の後にCodeノードを接続して、注文アイテムを再構成し日付を整形します。
顧客については、顧客のHTTPリクエストの直後にSetノードを接続します。必要なフィールドだけを明示的に保持し、明確さのためにリネームします。customer_keyをidフィールドを参照する式に設定し、nameとemailを保持します。ノイズを削減し、マージキーを曖昧さなくします。
2つのストリームをマージする
両方のトランスフォーム済みストリームをMergeノードに接続します。Merge by Keyモードを使用します。入力1(orders)のキーをcustomer_id、入力2(customers)のキーをcustomer_keyに設定します。n8nは各注文を対応する顧客レコードと照合し、両方のフィールドを含む結合アイテムを出力します。
この時点でのマージ済みアイテムにはorder_id、customer_id、amount、order_date、customer_key、name、emailがitem.jsonのトップレベルに含まれます。顧客キーのように結合のためだけに追加した冗長なフィールドがあるかもしれません。それらは次のステップで整理します。
最終整形と出力
Mergeノードの後にCodeノードをもう一つ追加します。これは最終変換ステップで、下流のコンシューマへ約束した正確な出力契約を作成します:
このノードは内部の結合キーを取り除き、amountを明示的にamount_usdにリネームし、強化された注文レコードのクリーンな配列を生成します。これを任意の最終ノードに接続します:Webhookへ結果をPOSTするHTTPリクエスト、Google Sheetsノードで行を追加、あるいは開発中は端末ノードとしてそのまま出力をn8nエディタで確認します。
Summary
あなたは完全な変換ライフサイクルをカバーするワークフローを構築しました:2つのHTTPソースからの並列取り込み、IFでの独立したフィルタリング、CodeおよびSetノードを用いたストリーム別の整形、キー ベースのマージ、そして最終的なクリーンアップ処理。各ノードは単一の明確な責務を持ち、ワークフローを読みやすくデバッグしやすくしています。運用環境で何かが壊れた場合、任意のノードでデータを固定してその時点から再実行でき、上流ノードには触れません。この構成の組み合わせ可能性こそが、このコースが構築してきた核心スキルです。
レッスンのチェックポイント
学んだ内容を復習し、回答へのフィードバックを受けましょう。