פרק 4

תהליך ראשון בקנבס

המדריך הרשמי Build your first workflow מראה איך לבנות תהליך ראשון ב-n8n: הפעלה לפי לוח זמנים, שליפת נתונים מכתובת אינטרנט, חיבור שדות להודעה בעזרת ביטויים (expressions), ושמירת כל הרצה בטבלת נתונים.

במדריך המהיר בונים תהליך שמושך את מזג האוויר בברלין כל בוקר, הופך אותו לדיווח קצר, ושומר כל דיווח. כך נבנה יומן מזג אוויר לאורך זמן.

דוגמה לדיווח שהתהליך מייצר:

The temperature in berlin is 7.4°C. It's currently overcast.

הבנייה אורכת כ-15 דקות. מלבד n8n אין צורך בחשבונות נוספים, במפתחות API או בניסיון בכתיבת קוד. נתוני מזג האוויר מגיעים מ-Mockingbird, שירות נתוני דוגמה של n8n למדריכים, ולכן מתקבלות תוצאות דומות למדריך.

#לפני שמתחילים

צריך מופע של n8n. אחת משתי אפשרויות:

סביבה	דרך התחלה
n8n Cloud	הרשמה לניסיון חינם: sign up for a free trial
התקנה עצמית	לפי המדריך host n8n

בסיום, התהליך רץ כל יום ב-8:00, שולף את מזג האוויר בברלין, בונה משפט דיווח, ושומר שורה בטבלה weather_data. בזמן הבנייה מריצים את התהליך ידנית לבדיקה. אחרי הפרסום, לוח הזמנים מריץ אותו.

טבלת רכיבי התהליך:

צומת	סוג או פעולה	תפקיד בתהליך
`Every day at 8am`	`Schedule Trigger`, On a schedule, Trigger at Hour = `8am`	הפעלת התהליך כל יום ב-8:00
`Get Berlin Weather`	`HTTP Request`	שליפת מזג אוויר מ-`https://mockingbird.n8n.io/v1/weather/berlin`
`Format Weather Message`	`Edit Fields (Set)`	שדה `report` עם עיר, טמפרטורה ומצב
`Save Weather Report`	`Data table`, פעולה `Insert row`	שמירת השדה `report` בטבלה `weather_data`

#שלב 1: יצירת התהליך

נכנסים למופע של n8n, ואז:

בוחרים Personal בתפריט השמאלי. כאן נמצאים התהליכים.
בוחרים Create workflow בפינה הימנית העליונה. נפתח הקנבס, ובו נבנה התהליך.
בוחרים את שם התהליך ומשנים אותו ל-Weather Log. בוחרים מקום כלשהו על הקנבס כדי לשמור את השם.

#שלב 2: הרצה כל יום ב-8:00

בצומת הזה משתמשים ב-Schedule Trigger.

השאלה הראשונה בבניית תהליך היא איך הוא מתחיל: לפי שעה, למשל 8:00 כל יום, כשמשתמש שולח טופס, או כשיישום כמו Telegram שולח הודעה. בתהליך הזה ההפעלה היא כל יום ב-8:00.

בוחרים Add first step, ואז On a schedule.
בתצוגת פרטי הצומת (Node details view) בוחרים 8am בשדה Trigger at Hour.
בוחרים Schedule Trigger בפינה השמאלית העליונה ומשנים את השם ל-Every day at 8am.
בוחרים ב-x בפינה הימנית העליונה כדי לסגור את תצוגת פרטי הצומת ולחזור לקנבס.

#שלב 3: מזג האוויר בברלין

בצומת הזה משתמשים ב-HTTP Request.

צומת HTTP Request שולח בקשה לכתובת אינטרנט, שנקראת endpoint, ומחזיר את הנתונים שהכתובת מספקת. שירותים שמשתפים נתונים כך הם APIs.

בוחרים + אחרי הטריגר, מקלידים http בתיבה Search nodes, ובוחרים HTTP Request.
בתצוגת פרטי הצומת מדביקים בשדה URL את הכתובת:
```
https://mockingbird.n8n.io/v1/weather/berlin
```

[!NOTE] Mockingbird הוא API לדוגמה עם מזג אוויר לכ-40 ערים באירופה. ערים אחרות מחזירות שגיאה.

בוחרים את שם הצומת בפינה השמאלית העליונה ומשנים אותו ל-Get Berlin Weather, ואז בוחרים Execute step. בפלט אמור להופיע מזג האוויר בברלין, כולל השדות city, temp_c ו-condition שמשמשים בשלב הבא.

#שלב 4: הפיכת הנתונים לדיווח

בצומת הזה משתמשים ב-Edit Fields (Set).

בוחרים + אחרי Get Berlin Weather, בוחרים Data transformation, ואז Edit Fields (Set).
בוחרים Add Field במרכז תצוגת פרטי הצומת. בשדה Name מזינים report.
בשדה Value מזינים The temperature in, ואז גוררים את city מלוח הקלט בצד שמאל. כשמשחררים שדה, n8n מעבירה את Value למצב Expression, ומופיע:
```
The temperature in {{ $json.city }}
```

[!NOTE] {{ $json.city }} הוא מציין מקום, שנקרא ביטוי (expression). כשהתהליך רץ, n8n מחליפה אותו בערך האמיתי. לוח הקלט מציג את הפלט של Get Berlin Weather, והוא הקלט של הצומת הזה. גוררים שדות במקום להקליד אותם, והתצוגה המקדימה מתחת לשדה מראה את המשפט המוגמר. להרחבה: Expressions.

גוררים את temp_c ומעדכנים את הניסוח ל:

The temperature in {{ $json.city }} is {{ $json.temp_c }}°C.

מוסיפים בסוף את It's currently, ואז גוררים את condition:

The temperature in {{ $json.city }} is {{ $json.temp_c }}°C. It's currently {{ $json.condition }}.

משנים את שם הצומת ל-Format Weather Message ובוחרים Execute step. הפלט אמור להיראות כך:
```
The temperature in berlin is 7.4°C. It's currently overcast.
```

#שלב 5: שמירת הנתונים

בצומת הזה משתמשים ב-Data table. הנתונים נשמרים ב-data tables של n8n.

בוחרים Personal בתפריט השמאלי, ואז Data tables.
בוחרים Create data table, נותנים את השם weather_data, ובוחרים Create.
בוחרים Add Column, מזינים report בשדה Name, ואז בוחרים שוב Add Column. כך נוצרת עמודה לשמירת דיווח מזג האוויר.
פותחים את התהליך Weather Log (Personal > Weather Log). מוסיפים צומת Data table אחרי Format Weather Message, ובוחרים בפעולה Insert row.
משנים את שם הצומת ל-Save Weather Report.
בוחרים weather_data מהרשימה Data table, ומשנים את Mapping Column Mode ל-Map Automatically. לשדה report מצומת Format Weather Message יש אותו שם כמו לעמודה בטבלה, ולכן n8n ממפה אותם.

#שלב 6: בדיקה ופרסום

בוחרים Execute workflow לבדיקה, ואז פותחים את הטבלה weather_data ובודקים ש-n8n הוסיפה שורה.
בוחרים Publish בכותרת הקנבס ועוקבים אחרי ההנחיות כדי לפרסם את התהליך.

אחרי הפרסום התהליך רץ כל יום ב-8:00.

#מה לומדים בדרך

הפעלת תהליך עם טריגר. כאן ההפעלה לפי לוח זמנים: Schedule Trigger.
הוספת צמתים וחיבור ביניהם. כל צומת עושה משימה אחת ומעביר את התוצאה לצומת הבא: Work with nodes.
שליפת נתונים מ-API. צומת HTTP Request מביא מזג אוויר מכתובת אינטרנט: HTTP Request.
עבודה עם נתונים בין צמתים. הפלט של צומת אחד הופך לקלט של הבא: Understand n8n's data structure.
שימוש בביטויים. גרירת שדה בונה ביטוי, ואפשר להשתמש בנתונים חיים בלי לכתוב קוד: Expressions for data transformation.
שמירת נתונים. כל הרצה שומרת שורה חדשה בטבלה, והדיווח נשאר גם אחרי שהתהליך מסתיים: Data tables.

#אופציונלי: בנייה עם n8n Assistant

[!NOTE] Preview status

n8n Assistant נמצא ב-Preview ועשוי להשתנות במהדורות הבאות. זמינות: Use the n8n Assistant.

n8n Assistant הוא דרך נוספת לבנות תהליכים, בעזרת הנחיות (prompts). אחרי שבניתם את Weather Log בעצמכם, קל יותר להבין מה Assistant יוצר.

פותחים את התהליך Weather Log, בוחרים Published בפינה הימנית העליונה, ובוחרים Unpublish. בלי זה, גם התהליך שלכם וגם התהליך ש-Assistant יוצר רצים ב-8:00.
בוחרים n8n Assistant בתפריט השמאלי.

מזינים את ההנחיה:

Every day at 8am:
- Get the weather for Berlin from https://mockingbird.n8n.io/v1/weather/berlin
- Add a report field that contains the city, temperature, and conditions
- Save the report to a data table called weather_data

[!TIP] n8n Assistant עשוי לזהות את התהליך הקיים Weather Log. מבקשים ממנו לבנות עותק חדש ונפרד: “build a fresh, separate copy”.

מאשרים כל שלב כש-n8n Assistant מבקש. בסיום אמור להופיע תהליך דומה.
בוחרים Execute workflow, ואז בודקים בטבלת הנתונים שנוספה שורה חדשה.

#הצעד הבא

קורסים ב-n8n Academy.
דוגמאות נוספות ב-workflow templates.