レッスン2:n8nエディターの操作と基本概念

このレッスンのロックを解除するには、まず「レッスン1：ワークフロー自動化とは？n8nはどこに位置するのか？」を完了してください。前のレッスンに戻る

はじめに

n8nのエディターは、自動化ワークフローの構築・テスト・デバッグに最も時間を費やす場所です。ロジックを書く前に、インターフェースに慣れる必要があります。このレッスンでは、エディターの主要なエリアをすべて案内し、すべてのn8nワークフローを構成する3つの構成要素 ― ワークフロー、ノード、接続 ― を紹介します。

エディターのインターフェース

n8nを開いて新しいワークフローを作成すると、キャンバス ― ノードをドラッグ・アンド・ドロップして接続する空のグリッド ― に移動します。インターフェースには把握しておくべきいくつかの重要なエリアがあります。

トップバーにはワークフロー名（クリックして名前変更）、Saveボタン、ワークフロー全体を手動で実行するExecute Workflowボタンがあります。右端にはワークフロー設定とアカウントメニューへのアクセスがあります。

左サイドバーはノードパネルです。プラスアイコンをクリックするかTabキーを押して開きます。ここからノードを検索してキャンバスに追加します。ノードはカテゴリ別にグループ化されています：トリガーノード（開始点）、アクションノード（実際の処理を行うノード）、ユーティリティノード（データ変換のヘルパー）です。

キャンバス自体には、早めに覚えておく価値のあるいくつかのナビゲーションショートカットがあります。スクロールでズームイン・ズームアウトできます。Spaceキーを押しながらドラッグするとパンできます。Ctrl+Shift+F（MacではCmd+Shift+F）でワークフロー全体を表示に収めることができます。

n8nエディターのレイアウト図。トップバー、左のノードパネル、各エリアにラベルが付いたメインキャンバスを表示

ワークフロー、ノード、接続

n8nのすべての自動化はワークフローです ― ノードを接続したグラフを含む保存されたドキュメントです。ワークフローは、トリガーされたときに自動実行される「アクティブ」状態と、手動実行したときのみ実行される「非アクティブ」状態があります。

ノードは単一の処理単位です。各ノードには特定の役割があります：APIからデータを取得する、値を変換する、メールを送信する、データベースに行を挿入する。ノードは自動化の「動詞」です。ノードをダブルクリックすると、右側にパラメータパネルが開き、何を行うかを設定します。

ノードには2種類があります。トリガーノードはワークフローを開始します ― イベント（Webhook呼び出し、スケジュール、スプレッドシートの新しい行など）をリッスンし、そのイベントが発生したときに起動します。すべてのワークフローには正確に1つのトリガーノードが必要で、常に左側に配置されます。通常のノードは実際の処理を行い、トリガーから連鎖します。

接続はノード間の矢印です。あるノードから次のノードへデータを運びます。接続を描くには、ノードの右端にカーソルを合わせて円が表示されるまで待ち、次のノードの入力ハンドルまでドラッグします。データは左から右へ流れます。

トリガーノードが2つの連続するアクションノードに接続されているフローチャート。矢印はデータフローの方向を示す

ノードデータの操作

n8nはノード間でデータをアイテムの配列として渡します。各アイテムはJSONオブジェクトです。ノードが実行されると、前のノードからアイテムを受け取り、処理し、次のノードに新しいアイテムを出力します。

ノードが生成したデータを確認するには、テスト実行後にノードをクリックします。出力パネルには各アイテムがフォーマットされたJSONオブジェクトとして表示されます。これが主要なデバッグツールです ― 次のステップを構築する前に、各ノードの出力を確認してデータが正しいかを検証します。

以下は出力パネルでの典型的なアイテムの例です：

json

{
  "id": 42,
  "name": "Alice",
  "email": "alice@example.com",
  "createdAt": "2024-01-15T10:30:00Z"
}

前のノードからパラメータフィールド内の値を参照するために、n8nは式を使用します。フィールド横の式トグル（フィールドの横にある等号アイコン）をクリックすることで、フィールドを静的テキストから式に切り替えます。式内では、以下の構文を使って値を取得します：

javascript

{{ $json.email }}

これは現在のアイテムのJSONから`email`フィールドを取得します。このパターンは常によく使うことになるでしょう ― ノード同士が通信する主な方法です。

保存と実行

実行する前に必ずワークフローを保存してください。Ctrl+S（またはCmd+S）を押すか、Saveボタンをクリックします。未保存の変更はワークフロー名の横のドットで表示されます。

ワークフローをテストするには、トップバーのExecute Workflowをクリックします。n8nはトリガー以降のすべてのノードを実行し、成功した各ノードに緑色のチェックマーク、失敗したノードに赤いエラーバッジを表示します。失敗したノードをクリックすると、出力パネルでエラーメッセージを確認できます。

外部イベントを待つトリガーノード（Webhookノードなど）の場合、n8nにはテストモードがあります。WebhookノードのListen for Test Eventをクリックすると、外部システムからリクエストを送信できます。n8nは実際のリクエストペイロードを1つキャプチャし、次の実際のイベントを待たずにそのデータに対してワークフローの残りの部分を構築・テストできます。

まとめ

n8nのエディターは、1つのキャンバス、ノードのライブラリ、そしてそれらの間の接続を中心に構築されています。ワークフローが自動化ロジックを保持します。トリガーノードが実行を開始します。通常ノードがデータを処理します。接続がJSONアイテムを左から右へ運びます。各テスト実行後の出力パネルが、すべてが正しく動作していることを確認する方法です。クリックして操作したり、ノードを追加したり、出力を確認したりすることに慣れてください ― コースの残りの部分はこれらのメカニクスを基盤としています。