このレッスンのロックを解除するには、まず「「Lesson 5: データストリームの結合と組み合わせ」」を完了してください。前のレッスンに戻る

イントロダクション

これはコースの最終章です。Codeノード、Setノード、IFノード、Mergeノードの使い方と、式を用いたデータ加工の方法を学習しました。これからは、これらの要素をすべて連携させ、実務的な1つのワークフローとして実装します。2つのソースからデータを取得し、クリーン化・フィルタリングを行い、ターゲットの形に変換し、ストリームをマージして、下流での利用に適した最終出力を作成します。

本レッスン全体で扱うシナリオは、実運用を想定した実用的なものです。HTTPエンドポイント1つからの注文リストと、別のエンドポイントからの顧客リストを取得する構成で、支払済みの注文のみを含む充実した注文レポートを作成し、顧客名とメールを付与し、表示用の日付形式に整形します。

6ノードが連続して並ぶエンドツーエンドのワークフローダイアグラム:HTTP Request(Orders)とHTTP Request(Customers)を並列で実行し、それぞれを別々のFilter/Transformノードへ流し、次にMergeノード、最後に最終整形用のCodeノード、そして最終出力ノードへと接続します。

2つのソースから並列でデータを取得する

並列で実行される2つのHTTP Requestノードから開始します。いずれも同じ手動トリガーまたはスケジュールトリガーで起動します。最初は注文を取得し、2番目は顧客を取得します。n8nでは、1つのトリガーを2つのHTTP Requestノードに接続することで実行を分岐します。

注文エンドポイントでは、URLを設定し、レスポンス形式がJSONであることを確認します。生のレスポンスは通常このようになります:

json
[
{"id": 101, "customer_id": 5, "status": "paid", "amount": 149.99, "created_at": "2024-03-15T10:22:00Z"},
{"id": 102, "customer_id": 8, "status": "pending", "amount": 89.00, "created_at": "2024-03-16T08:05:00Z"}
]

顧客エンドポイントについて:

json
[
{"id": 5, "name": "Alice Martin", "email": "alice@example.com"},
{"id": 8, "name": "Bob Chen", "email": "bob@example.com"}
]

両ノードはアイテムの配列を出力します。n8nは自動的に配列を個々のアイテムに分割するため、各注文と各顧客が、それぞれワークフローの残りの部分を流れる独自のアイテムになります。

各ストリームのフィルタリングと変換

マージする前に、それぞれのストリームを独立してクリーンアップします。これによりロジックが分離され、デバッグが容易になります。

注文については、注文のHTTPリクエストの直後にIFノードを接続します。条件を、フィールドのstatusが文字列paidと等しいことをチェックするように設定します。真の分岐のみが継続します。これにより、マージに到達する前に保留、キャンセル、返金済みの注文を排除します。

次に、IFの真の出力の後にCodeノードを接続して、注文アイテムを再構成し日付を整形します。

javascript
const items = $input.all();
return items.map(item => {
const d = new Date(item.json.created_at);
const formatted = d.toLocaleDateString('en-GB', { day: '2-digit', month: 'short', year: 'numeric' });
return {
json: {
order_id: item.json.id,
customer_id: item.json.customer_id,
amount: item.json.amount,
order_date: formatted
}
};
});

顧客については、顧客のHTTPリクエストの直後にSetノードを接続します。必要なフィールドだけを明示的に保持し、明確さのためにリネームします。customer_keyをidフィールドを参照する式に設定し、nameとemailを保持します。ノイズを削減し、マージキーを曖昧さなくします。

2つの並行トランスフォーメーションブランチを比較するダイアグラム: Ordersブランチ(IFフィルタ → Codeリシェイプ)とCustomersブランチ(Setノードによるクリーンアップ)、どちらもMergeノードへ接続

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ノードをもう一つ追加します。これは最終変換ステップで、下流のコンシューマへ約束した正確な出力契約を作成します:

javascript
const items = $input.all();
return items.map(item => {
return {
json: {
order_id: item.json.order_id,
order_date: item.json.order_date,
amount_usd: item.json.amount,
customer_name: item.json.name,
customer_email: item.json.email
}
};
});

このノードは内部の結合キーを取り除き、amountを明示的にamount_usdにリネームし、強化された注文レコードのクリーンな配列を生成します。これを任意の最終ノードに接続します:Webhookへ結果をPOSTするHTTPリクエスト、Google Sheetsノードで行を追加、あるいは開発中は端末ノードとしてそのまま出力をn8nエディタで確認します。

Summary

あなたは完全な変換ライフサイクルをカバーするワークフローを構築しました:2つのHTTPソースからの並列取り込み、IFでの独立したフィルタリング、CodeおよびSetノードを用いたストリーム別の整形、キー ベースのマージ、そして最終的なクリーンアップ処理。各ノードは単一の明確な責務を持ち、ワークフローを読みやすくデバッグしやすくしています。運用環境で何かが壊れた場合、任意のノードでデータを固定してその時点から再実行でき、上流ノードには触れません。この構成の組み合わせ可能性こそが、このコースが構築してきた核心スキルです。

レッスンの練習

レッスンのチェックポイント

学んだ内容を復習し、回答へのフィードバックを受けましょう。

0/1
回答済み · 0/1