הפעלת שילוב משני באמצעות משימה מסוג For Each Loop (לולאת For Each)

במדריך למתחילים הזה נסביר איך ליצור שילוב שמשתמש במשימה For Each Loop כדי להפעיל שילוב משני. השילוב המשני מקבל את הקלט מהשילוב הראשי ושולח אימיילים לנמענים באמצעות המשימה 'שליחת אימייל'.

יצירת שילוב משנה

1. במסוף Google Cloud, עוברים לדף Application Integration.

   מעבר אל Application Integration

2. בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
3. לוחצים על יצירת שילוב.
4. מזינים שם ותיאור לשילוב.

   לצורך השימוש במדריך למתחילים הזה, מזינים את השם ForEachSendEmailSubIntegration ואת התיאור Quickstart sub-integration.

5. בוחרים אזור לשילוב.
   הערה: בתפריט הנפתח Regions (אזורים) מופיעים רק האזורים שהוקצו לפרויקט שלכם ב- Google Cloud . כדי להקצות אזור חדש, לוחצים על הפעלת אזור. מידע נוסף מופיע במאמר בנושא הפעלת אזור חדש.
6. לוחצים על יצירה כדי לפתוח את כלי העריכה של השילוב.

הוספת טריגר API בשילוב המשנה

טריגרים נדרשים כדי להתחיל את רצף המשימות שמרכיבות אינטגרציה. בהוראות האלה להתחלה מהירה, משתמשים בטריגר API כדי להפעיל את השילוב.

כדי להוסיף ולהגדיר את טריגר ה-API, מבצעים את השלבים הבאים:

1. בכלי לעריכת שילובים, לוחצים על טריגרים כדי לראות את רשימת הטריגרים הזמינים.
2. לוחצים על הרכיב API trigger (טריגר API) וממקמים אותו בכלי לעריכת שילובים.

יצירת משתנה קלט בשילוב המשני

השילוב המשני משתמש במשתנה כדי לאחסן את הפרטים שמתקבלים בפורמט JSON מהשילוב הראשי. כדי ליצור משתנה קלט חדש, מבצעים את השלבים הבאים:

1. לוחצים על (החלפת חלונית) בסרגל הניווט של כלי העיצוב כדי להציג את החלונית משתנים.
2. לוחצים על +יצירה כדי ליצור משתנה.

3. בחלונית Create Variable (יצירת משתנה):

   א. שם: מזינים order_details.

   ב. סוג הנתונים: בוחרים באפשרות JSON.

   ג. לוחצים על הסקת מסקנות מערך ברירת המחדל.

   ד. בקטע ערך ברירת מחדל, מזינים את ה-JSON הבא.

     {
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
         },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
         }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
         }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
         },
       "expectedDelivery": "15 March 2023"
     }
   

   באובייקט ה-JSON לדוגמה הזה, מחליפים את YOUR_EMAIL_ID במזהה האימייל שרוצים להשתמש בו כדי לבדוק את השילוב.

   ה. לוחצים על Use as an input to integration (שימוש כקלט לשילוב).

   ו. לוחצים על יצירה.

הוספה והגדרה של משימת מיפוי נתונים

המשימה Data Mapping מאפשרת להקצות משתנים בשילוב, לקבל ולהגדיר מאפיינים של אובייקטים מסוג JSON ולהחיל פונקציות טרנספורמציה מקוננות על ערכים. המשתנים שבהם משתמשת המשימה 'מיפוי נתונים' יכולים להיות משתני שילוב או משתני משימה.

כדי להוסיף ולהגדיר משימת מיפוי נתונים:

1. בכלי לעריכת שילובים, לוחצים על משימות כדי לראות את רשימת המשימות הזמינות.
2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
3. לוחצים על הרכיב מיפוי נתונים בכלי לעריכת השילוב כדי לפתוח את חלונית הגדרת המשימה.
4. לוחצים על פתיחת הכלי למיפוי נתונים.
5. מגדירים את הקלט באופן הבא:
   1. בקטע קלט, לוחצים על משתנה או ערך.
   2. בקטע 'משתנה', מזינים item ואז בוחרים באפשרות order_details.items.
   3. לוחצים על Save.
   4. מוסיפים פונקציית מיפוי ל-order_details.items. לוחצים על הסמל + לצד order_details.items. ברשימת הפונקציות, גוללים ובוחרים באפשרות FOR_EACH(Any) -> JSON.
   5. מזינים את פרמטר הקלט של הפונקציה FOR_EACH. לוחצים על משתנה או ערך ובוחרים באפשרות ‎~obj1.
   6. לוחצים על Save.
   7. מוסיפים פונקציית מיפוי ל-obj1. לוחצים על + בשורה FOR EACH בתוך הסוגריים אחרי האלמנט obj1 שזה עתה הוספתם. ברשימת הפונקציות, גוללים ובוחרים באפשרות GET PROPERTY(String) -> JSON.
   8. לוחצים על משתנה או ערך ובשדה ערך מזינים itemName.
   9. לוחצים על Save.
   10. לוחצים על + הוספת פונקציה בשורה שאחרי GET PROPERTY ובוחרים באפשרות TO_STRING() -> String.
   11. לוחצים על + הוספת פונקציה בשורה האחרונה ובוחרים באפשרות TO_STRING() -> מחרוזת.
6. מגדירים את הפלט באופן הבא:
   1. יוצרים משתנה פלט חדש. בקטע פלט, לוחצים על יצירת פלט חדש.
   2. בחלונית יצירת משתנה מזינים את השם items, משאירים את ערכי ברירת המחדל בכל השדות האחרים ולוחצים על יצירה.
7. מוודאים שהגדרת מיפוי הנתונים דומה לתמונה הבאה.

   

8. סוגרים את הכלי לעריכת מיפוי נתונים כדי לחזור לכלי לעריכת שילובים.

הוספה והגדרה של משימה לשליחת אימייל

כדי להוסיף ולהגדיר את המשימה שליחת אימייל לשליחת אימייל לכל אחד מהנמענים, מבצעים את השלבים הבאים.

1. בכלי לעריכת שילובים, לוחצים על הוספת משימה או טריגר.
2. עוברים אל משימות, לוחצים על הרכיב שליחת אימייל וממקמים אותו בכלי לעריכת שילובים.
3. לוחצים על רכיב המשימה Send Email (שליחת אימייל) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת המשימה.

4. מגדירים את השדות הבאים של Task Input:

   1. אל הנמענים: לוחצים על משתנה ובוחרים באפשרות order_details.emailId.
   2. נושא: מזינים את נושא האימייל. לצורך השימוש במדריך למתחילים הזה, מזינים Order delivery notification.
   3. גוף ההודעה בטקסט פשוט: מזינים את הטקסט הבא:

   Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
   

חיבור הרכיבים בשילוב המשני

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

1. מוסיפים קצה מהרכיב API trigger לרכיב Data Mapping. מעבירים את העכבר מעל נקודת בקרה ברכיב API trigger וגוררים קו אל נקודת בקרה ברכיב Data Mapping.
2. באופן דומה, מוסיפים קצה מהרכיב מיפוי נתונים לרכיב שליחת אימייל.

בדיקה ופרסום של שילוב המשנה

1. כדי לבדוק את השילוב המשני הזה, לוחצים על בדיקה בסרגל הכלים של כלי העריכה של השילוב, ואז על בדיקת השילוב בתיבת הדו-שיח בדיקת השילוב. השילוב המשני פועל עם ערך ברירת המחדל כקלט ושולח אימייל לכתובת האימייל שצוינה במשימה 'שליחת אימייל'. בסיום הבדיקה אמורה להופיע הודעה על הצלחה.
2. כדי לפרסם את השילוב המשני הזה, לוחצים על פרסום בסרגל הכלים של כלי העריכה של השילוב.

יצירת השילוב הראשי

1. בתפריט הניווט, לוחצים על שילובים כדי לחזור לדף שילובים.
2. לוחצים על יצירת שילוב.
3. מזינים שם לשילוב ואפשר גם להוסיף תיאור. לצורך השימוש במדריך למתחילים הזה, מזינים את השם ForEachSendEmail ואת התיאור Quickstart main integration.
4. בוחרים אזור לשילוב מתוך רשימת האזורים הנתמכים. חשוב לוודא שיוצרים את השילוב הראשי באותו אזור שבו נמצא שילוב המשנה.
5. לוחצים על יצירה.

הוספת טריגר API בשילוב הראשי

1. בכלי לעריכת שילובים, לוחצים על Triggers כדי לראות את רשימת המשימות והטריגרים הזמינים.
2. לוחצים על הרכיב API trigger (טריגר API) וממקמים אותו בכלי לעריכת שילובים.

יצירת משתנה קלט בשילוב הראשי

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

1. לוחצים על (החלפת חלונית) בסרגל הניווט של כלי העיצוב כדי להציג את החלונית משתנים.

2. בחלונית Create Variable (יצירת משתנה):

   א. שם: מזינים order_requests.

   ב. סוג הנתונים: בוחרים באפשרות JSON.

   ג. לוחצים על הסקת מסקנות מערך ברירת המחדל.

   ד. בשדה ערך ברירת מחדל, מזינים את ה-JSON הבא:

     [{
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
       },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
       }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
       }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
       },
      "expectedDelivery": "15 March 2023"
     }, {
       "orderId": "2",
       "customerName": "Tim Harvey",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "Los Angeles",
         "country": "USA",
         "zipcode": "210738"
       },
       "items": [{
         "itemid": "222-333-444",
         "itemName": "Laptop",
         "itemPrice": 5999.0,
         "quantity": 1.0
      }],
       "paymentDetails": {
         "mode": "Online Payment",
         "status": "Success"
       },
       "expectedDelivery": "21 Feb 2023"
     }]
   

   באובייקט ה-JSON לדוגמה הזה, מחליפים את שני המקרים של YOUR_EMAIL_ID במזהה האימייל שרוצים להשתמש בו כדי לבדוק את השילוב.

   ה. לוחצים על Use as an input to integration (שימוש כקלט לשילוב).

   ו. לוחצים על יצירה.

הוספה והגדרה של משימה מסוג For Each Loop

1. בכלי לעריכת שילובים, לוחצים על משימות.
2. לוחצים על הרכיב For Each Loop וממקמים אותו בכלי לעריכת שילובים.
3. לוחצים על רכיב המשימה For Each Loop (לולאת For Each) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת המשימה.
4. בחלונית ההגדרות, מבצעים את הפעולות הבאות:
   1. רשימה לביצוע איטרציה: בוחרים את משתנה הקלט שיצרתם, order_requests.
   2. מזהה טריגר API: בוחרים את טריגר ה-API בשילוב המשנה. במדריך הזה למתחילים, בוחרים באפשרות api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. שם השילוב: בוחרים את השם של שילוב המשנה שרוצים להפעיל. לצורך השימוש במדריך למתחילים הזה, בוחרים באפשרות ForEachSendEmailSubIntegration.
   4. מיפוי של שילוב משנה של רכיב איטרציה: בוחרים באפשרות order_details.

חיבור הרכיבים בשילוב הראשי

1. מוסיפים קצה מהרכיב API trigger לרכיב For Each Loop. מעבירים את העכבר מעל נקודת בקרה ברכיב API trigger וגוררים קו לנקודת בקרה ברכיב For Each Loop.

בדיקה ופרסום של השילוב הראשי

המשימה האחרונה היא לבדוק ולפרסם את השילוב הראשי.

1. בסרגל הכלים של כלי העריכה של השילוב, לוחצים על בדיקה ואז על בדיקת השילוב בתיבת הדו-שיח בדיקת השילוב. בסיום הבדיקה אמורה להופיע הודעה על הצלחה.

2. כדי לפרסם את השילוב הזה, לוחצים על פרסום בסרגל הכלים של כלי העריכה של השילוב.

   אחרי שהשילוב יסתיים בהצלחה, יישלח אימייל לכתובת האימייל שצוינה במשימה Send Email (שליחת אימייל). מאשרים את קבלת האימייל בתוכנת האימייל.

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.