コードノードマスター：データ処理、API連携、ファイル生成 - n8n ワークフロー

n8n内でカスタムJavaScriptの活用を目指す開発者や技術者の方
標準のn8nノードでは対応できない複雑なデータ変換や集計を行いたい方
コードノードの異なる実行モード（アイテムごと vs 全アイテムまとめて）の理解を深めたい自動化スペシャリストの方
カスタムスクリプトスキル向上のためにn8nテンプレートを活用したいすべての方

n8nのコードノードは、カスタムJavaScriptロジックをワークフローに直接注入できる、プラットフォーム上で最も強力なツールと言えるでしょう。このn8nワークフローは実践的なガイドとして、コードノードの4つの重要なユースケースを実演します。

1. アイテム情報の拡充: 各アイテムに対して新しいフィールド（年齢やフルネームなど）を計算します。


2. 外部連携: 内蔵ヘルパーを使用して、外部APIへの非同期HTTPリクエストを実行します。


3. データ集計: 入力された全データを要約します（例：平均年齢の算出）。


4. ファイル生成: 集計したJSON入力を基に、バイナリデータ（CSVレポートなど）を作成します。

このn8nテンプレートに従うことで、ユーザーは基本的なフロー構築から、強力で動的な自動化スクリプトの作成へと迅速に移行できます。

この包括的なn8nワークフローは、手動トリガー（Start Tutorial）から始まり、コードノードのさまざまな側面を強調する複数の論理ステージを経て進行します。

1. データ初期化: 1. Sample Dataノードがユーザーオブジェクトのリストを初期化します。2. Split Out Usersノードは、各ユーザーが個別のアイテムになるように分割し、後続の「アイテムごと」処理の準備を整えます。


2. アイテムごとの変換（ローカル処理）: 3. Process Each Userコードノードは、各ユーザーアイテムに対して実行されます。JavaScriptのDate関数を使い、ユーザーのfullNameと正確なageを計算します。


3. アイテムごとの変換（外部API連携）: 4. Fetch External Data (Advanced)コードノードもアイテムごとに実行され続けます。this.helpers.httpRequestを使用してユーザーの名前に基づき外部API (genderize.io) を呼び出し、性別の確率データで情報を補強する方法を示します。


4. 集計処理: 5. Calculate Average Ageコードノードは実行モードを「全アイテムをまとめて実行 (Run Once for All Items)」に切り替えます。ここでは$items()関数を使って前述の全ステップの結果にアクセスし、総ユーザー数と平均年齢を含む単一のサマリー結果を計算します。これは大規模データセットを扱う際のコードノードの重要な機能です。


5. ファイル生成（エキスパート）: 最後の6. Create a Binary File (Expert)コードノードはデータを再度集計し、CSV文字列を生成した後、this.helpers.prepareBinaryDataを使用して、n8nワークフローですぐに使用できるバイナリレポートファイルに文字列を変換します。

このn8nワークフローをインストールしてテストするには、以下の手順に従ってください。

1. JSONのコピー: 提供されているn8nワークフローのJSONコードをコピーします。


2. n8nへのインポート: ご利用のn8nインスタンスで「新規作成」をクリックし、「JSONからインポート」を選択します。コードを貼り付けて「インポート」をクリックします。


3. ロジックの確認: コードノードに添付されている付箋（Sticky notes）を確認し、JavaScriptコードと実行モードに関する説明を読んでください。


4. 実行: 開始トリガーが「手動トリガー」であるため、「ワークフローを実行」をクリックしてから「チュートリアル開始」をクリックして、ワークフローをステップバイステップで実行します。


5. 出力の確認: 各コードノードの出力を確認し、データ構造が、個別のアイテムから、JSONメタデータとバイナリCSVファイルを含む単一の集計レポートへとどのように変化するかを観察してください。このn8nテンプレートでは外部認証情報は一切必要ありません。

Start Tutorial (手動トリガー): このn8nワークフローを手動で実行するための開始ポイントです。
1. Sample Data (Set n8nノード): チュートリアルの入力として機能する、ユーザーオブジェクトのサンプル配列でワークフローを初期化します。
2. Split Out Users (Split Out n8nノード): ユーザー配列を含む単一アイテムを複数の個別アイテムに変換する必須のn8nノード。後続のコードノードがそれらを一つずつ処理できるようにします。
3. Process Each User (コードn8nノード): 現在のアイテムに対して派生データ（fullName, age）を計算する機能。主要設定：モードは「各アイテムごとに実行 (Run Once for Each Item)」に設定されています。
4. Fetch External Data (Advanced) (コードn8nノード): await this.helpers.httpRequestを使用して非同期操作を実証し、現在のユーザーの外部データ（性別推測）を取得する機能。主要設定：モードは「各アイテムごとに実行 (Run Once for Each Item)」に設定されています。
5. Calculate Average Age (コードn8nノード): 前の全アイテムからデータを集計する機能。$items()とJavaScriptのreduceを使い平均年齢を算出します。主要設定：モードは「全アイテムをまとめて実行 (Run Once for All Items)」に設定されています。

• 6. Create a Binary File (Expert) (コードn8nノード): 集計データからCSVレポートを生成し、this.helpers.prepareBinaryDataを使用してバイナリファイルに変換する機能。主要設定：モードは「全アイテムをまとめて実行 (Run Once for All Items)」に設定されています。