n8nの.itemが失敗する：先頭を選ぶ前に元データとの対応を決める
Missing pairedItemやMultiple matching itemsなら、.first()へ置き換える前に「どの入力の結果か」を決めます。先頭を選べば式が通っても、別の顧客や添付ファイルを結び付ける原因になります。
公式資料確認日：。
リンクが切れた場合と、候補が複数ある場合
.itemは前のノードとの対応をたどります。対応情報がない場合と、集約・結合によって候補が複数ある場合は別のエラーです。Code nodeで新しいitemを返した箇所や、集約前後の関係を見ます。
一対一・一対多・集約を表にする
複数入力から新しいitemを返す場合、pairedItemで入力との関係を明示する方法があります。複数から一つの成果を作る仕事で、入力の一番目だけへ結び付ける設計を一対一と扱いません。
| 観測するもの | 分かること | 次の行動 |
|---|---|---|
| 入力Aから出力A | 一対一の対応 | 実際に使った入力のindexを残す |
| 入力Aから複数出力 | 一対多の対応 | どれも元Aへ戻れるか照合 |
| 入力A・Bから一成果 | 集約の対応 | どの情報をどのキーで選ぶか決める |
| 位置だけで選ぶ | 順序に依存する選択 | 順序が変わっても正しいか確認 |
入力を並べ替えて、偶然の先頭一致を見つける
試験用の顧客A・Bと、それぞれ別名の添付ファイルを想定します。入力の並びを逆にしても各成果が正しい相手へ戻るかを照合します。これは読者が作る非機密試験の案で、Selparoが実行した報告ではありません。
.first()を使ってよいのは、先頭が業務上の答えになるとき
公式は.first()・.last()・.all()[index]で位置を指定する方法も説明しています。先頭を使う仕事なら候補ですが、エラーが消えるという理由だけでは選びません。対応が曖昧なら本番送信を止め、対象キーを照合します。
正しく結べた後に、送信先と成果を受け入れる
元入力との対応と、外部への送信許可は別です。無関係な顧客へ添付を送る試験は行わず、非機密の試験先で件数・キー・保存先を確かめます。購入やVPS移行で対応情報が戻るとは扱いません。
公式資料と、判断例の境界
仕様の根拠は以下の公式資料です。本文の記入例は実測値ではありません。購入・設定変更時は、対象の型番・版・契約条件を照合します。
- n8n：item linking errors
リンク欠落と複数候補で.itemは失敗します。.first等は位置を決める意味があり、業務上の正しさを保証しません。
- n8n：Code nodeでリンクを維持する
複数入力から新しいitemを返す場合、pairedItemで入力との関係を明示できます。一入力の自動処理とは区別します。