はじめに
Set ノードは、n8n ワークフローを通じてデータを再形成するための主なツールです。外部データを取得するノードとは異なり、Set は既に手元にあるデータの変換に完全に焦点を当て、新しいフィールドを追加したり、既存のものを上書きしたり、不要なフィールドを削除したりします。これにより、API、データベース、その他のサービスへ送信する前のペイロードを準備する際に欠かせないものになります。
n8n のすべてのアイテムは JSON オブジェクトです。Set ノードは、各アイテムが含むべきフィールドと値を正確に定義できるようにします。値をハードコードしたり、他のフィールドからデータをコピーしたり、上流データに基づいて新しい値を計算する式を使用したりできます。
基本的なフィールド操作
Set ノードは次のいずれかのモードで動作します。Keep Only Set(定義したフィールドのみでアイテム全体を置換)または Add/Overwrite(新しいフィールドを既存のアイテムにマージ)。ほとんどの変換タスクには Add/Overwrite の方が柔軟性を提供します。
フィールドを追加するには、Add Field をクリックし、適切なタイプを選択します。文字列、数字、ブーリアン、その他があります。各フィールドには名前と値が必要です。名前は JSON のキーとなり、値は静的テキスト、数値、または式であることがあります。
元のフィールドはそのまま残ります。Keep Only Set モードに切り替えると、出力には id、name、isActive のみが含まれることになります。
式を用いた上流データの参照
データを前のノードから取得するには、式を使用します。最も一般的なパターンは {{$json.fieldName}} で、現在のアイテムからフィールドを読み取ります。式の中で JavaScript を使って値を即時変換することもできます。
他のノードのフィールドを {{$node.NodeName.json.fieldName}} を使って参照できます。複数のソースからデータを結合したり、ワークフローステップ間で値を比較する必要がある場合に便利です。
不要なフィールドを削除する
データを下流へ送る前に、機微な情報や不要なフィールドを取り除く必要があることがあります。Keep Only Set モードでは、保持したいフィールドを定義するだけで、それ以外はすべて消えます。Add/Overwrite モードでは、Remove Other Fields のトグルを使うか、フィールドを null に設定して削除します。
このアプローチは、事前にすべてのフィールド名を把握していないダイナミックなデータ構造を扱う場合に特に、個別にフィールドを削除しようとするより安全です。
よくあるパターンと落とし穴
複雑な変換を構築するときは、段階的に作業します。1つまたは2つのフィールドを追加してノードを実行し、出力を検証してからさらに追加します。これにより、10のフィールドを同時に設定してエラーをデバッグするよりも、デバッグがはるかに容易になります。
式エラーはよくあることです。式の評価が失敗した場合、n8n は通常フィールドを空にするか、エラーバッジを表示します。構文を再確認してください:式はダブルカールブラケットで囲む必要があり、中の JavaScript コードは有効でなければなりません。コミットする前に式エディター パネルで式をテストしてください。
型の不一致は下流の問題を引き起こす可能性があります。フィールドが数値を期待しているのに文字列を受け取った場合、式の中で Number や parseInt を使って明示的に変換します。同様に、必要に応じて Number を文字列へ変換するには String を使用します。
Set ノードは各アイテムを独立して処理します。ノードに50件入る場合、それぞれフィールド定義に従って変換されます。つまり {{$json.fieldName}} のような式は、常に処理中の現在のアイテムを参照し、配列全体を参照するわけではありません。
Summary
Set ノードは n8n におけるデータ変換のメスです。既存データを補強したい場合は Add/Overwrite モードを、特定のフィールドだけでクリーンな状態を作りたい場合は Keep Only Set を使用します。式を使えばワークフロー内のどこからでもデータを参照し、インラインで JavaScript 変換を適用できます。Set ノードを使いこなせば、データ形式に振り回される時間が減り、機能的なワークフローを構築する時間が増えます。
レッスンのチェックポイント
学んだ内容を復習し、回答へのフィードバックを受けましょう。