このレッスンのロックを解除するには、まず「Lesson 1: How n8n Structures Data — Items, JSON, and the Execution Model」を完了してください。前のレッスンに戻る

はじめに

Set ノードは、n8n ワークフローを通じてデータを再形成するための主なツールです。外部データを取得するノードとは異なり、Set は既に手元にあるデータの変換に完全に焦点を当て、新しいフィールドを追加したり、既存のものを上書きしたり、不要なフィールドを削除したりします。これにより、API、データベース、その他のサービスへ送信する前のペイロードを準備する際に欠かせないものになります。

n8n のすべてのアイテムは JSON オブジェクトです。Set ノードは、各アイテムが含むべきフィールドと値を正確に定義できるようにします。値をハードコードしたり、他のフィールドからデータをコピーしたり、上流データに基づいて新しい値を計算する式を使用したりできます。

基本的なフィールド操作

Set ノードは次のいずれかのモードで動作します。Keep Only Set(定義したフィールドのみでアイテム全体を置換)または Add/Overwrite(新しいフィールドを既存のアイテムにマージ)。ほとんどの変換タスクには Add/Overwrite の方が柔軟性を提供します。

フィールドを追加するには、Add Field をクリックし、適切なタイプを選択します。文字列、数字、ブーリアン、その他があります。各フィールドには名前と値が必要です。名前は JSON のキーとなり、値は静的テキスト、数値、または式であることがあります。

javascript
// Example: Transforming API response items
// Input item from HTTP Request node:
{
"user_id": 42,
"full_name": "Alice Smith",
"created_at": "2024-01-15T10:30:00Z"
}
// Set node configuration (Add/Overwrite mode):
// Field 1: id (Number) = {{$json.user_id}}
// Field 2: name (String) = {{$json.full_name}}
// Field 3: isActive (Boolean) = true
// Output item:
{
"user_id": 42,
"full_name": "Alice Smith",
"created_at": "2024-01-15T10:30:00Z",
"id": 42,
"name": "Alice Smith",
"isActive": true
}

元のフィールドはそのまま残ります。Keep Only Set モードに切り替えると、出力には id、name、isActive のみが含まれることになります。

フローチャートは、Add/Overwrite モードで新しいフィールドを既存のアイテムにマージする場合と、Keep Only Set モードがアイテム全体を置換する場合を示しています

式を用いた上流データの参照

データを前のノードから取得するには、式を使用します。最も一般的なパターンは {{$json.fieldName}} で、現在のアイテムからフィールドを読み取ります。式の中で JavaScript を使って値を即時変換することもできます。

javascript
// Input item:
{
"email": "alice@example.com",
"score": 85
}
// Set node fields using expressions:
// Field 1: username (String) = {{$json.email.split('@')[0]}}
// Field 2: domain (String) = {{$json.email.split('@')[1]}}
// Field 3: passed (Boolean) = {{$json.score >= 70}}
// Field 4: grade (String) = {{$json.score >= 90 ? 'A' : $json.score >= 70 ? 'B' : 'C'}}
// Output item:
{
"email": "alice@example.com",
"score": 85,
"username": "alice",
"domain": "example.com",
"passed": true,
"grade": "B"
}

他のノードのフィールドを {{$node.NodeName.json.fieldName}} を使って参照できます。複数のソースからデータを結合したり、ワークフローステップ間で値を比較する必要がある場合に便利です。

javascript
// Example: Combining data from two nodes
// Webhook node output: {"orderId": "ORD-123"}
// HTTP Request node output: {"status": "shipped", "trackingCode": "TRK-456"}
// Set node fields:
// Field 1: order (String) = {{$node.Webhook.json.orderId}}
// Field 2: status (String) = {{$json.status}}
// Field 3: tracking (String) = {{$json.trackingCode}}
// Output:
{
"order": "ORD-123",
"status": "shipped",
"tracking": "TRK-456"
}

不要なフィールドを削除する

データを下流へ送る前に、機微な情報や不要なフィールドを取り除く必要があることがあります。Keep Only Set モードでは、保持したいフィールドを定義するだけで、それ以外はすべて消えます。Add/Overwrite モードでは、Remove Other Fields のトグルを使うか、フィールドを null に設定して削除します。

javascript
// Input item with sensitive data:
{
"userId": 42,
"email": "alice@example.com",
"password_hash": "$2b$10$abcd...",
"internal_notes": "VIP customer",
"created_at": "2024-01-15T10:30:00Z"
}
// Set node in Keep Only Set mode:
// Field 1: userId (Number) = {{$json.userId}}
// Field 2: email (String) = {{$json.email}}
// Output (password and notes removed):
{
"userId": 42,
"email": "alice@example.com"
}

このアプローチは、事前にすべてのフィールド名を把握していないダイナミックなデータ構造を扱う場合に特に、個別にフィールドを削除しようとするより安全です。

よくあるパターンと落とし穴

複雑な変換を構築するときは、段階的に作業します。1つまたは2つのフィールドを追加してノードを実行し、出力を検証してからさらに追加します。これにより、10のフィールドを同時に設定してエラーをデバッグするよりも、デバッグがはるかに容易になります。

式エラーはよくあることです。式の評価が失敗した場合、n8n は通常フィールドを空にするか、エラーバッジを表示します。構文を再確認してください:式はダブルカールブラケットで囲む必要があり、中の JavaScript コードは有効でなければなりません。コミットする前に式エディター パネルで式をテストしてください。

型の不一致は下流の問題を引き起こす可能性があります。フィールドが数値を期待しているのに文字列を受け取った場合、式の中で Number や parseInt を使って明示的に変換します。同様に、必要に応じて Number を文字列へ変換するには String を使用します。

javascript
// Type conversion examples:
// Field 1: age (Number) = {{Number($json.age_string)}}
// Field 2: id (String) = {{String($json.numeric_id)}}
// Field 3: price (Number) = {{parseFloat($json.price_with_currency.replace('$', ''))}}

Set ノードは各アイテムを独立して処理します。ノードに50件入る場合、それぞれフィールド定義に従って変換されます。つまり {{$json.fieldName}} のような式は、常に処理中の現在のアイテムを参照し、配列全体を参照するわけではありません。

Summary

Set ノードは n8n におけるデータ変換のメスです。既存データを補強したい場合は Add/Overwrite モードを、特定のフィールドだけでクリーンな状態を作りたい場合は Keep Only Set を使用します。式を使えばワークフロー内のどこからでもデータを参照し、インラインで JavaScript 変換を適用できます。Set ノードを使いこなせば、データ形式に振り回される時間が減り、機能的なワークフローを構築する時間が増えます。

レッスンの練習

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

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

0/1
回答済み · 0/1
レッスン 2: Set ノードでペイロードを成形する