משימה של לולאת While

המשימה While Loop מאפשרת לבצע קריאות חוזרות לשילוב משני מהשילוב הנוכחי (הראשי) עד שמתקיים תנאי מסוים.

מזהה ההפעלה של ה-API ושם השילוב מזהים את השילוב המשני שרוצים להפעיל.

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

• אוספים את התגובה של כל הרצה במשתנה מערך, כאשר כל רכיב במערך מכיל את התגובה מהרצה מסוימת. כדי לאסוף את התשובות, מגדירים את המאפיין Collect values from sub-integration output(s).
• צבירת התשובות של כל ההרצות במשתנה יחיד. כדי לצבור את התשובות, מגדירים את המאפיין Override values from sub-integration output(s).

הערה:

• המשימה While Loop יכולה לפעול עד 8,000 איטרציות. ההגבלה הזו תקפה גם אם התנאי שהוגדר מוביל ללולאה אינסופית.
• הגודל המצטבר של הנתונים שנאספים מכל הרצה של שילוב משני לא יכול לחרוג מ-50 MB. אם הגודל חורג מ-50 MB, השילוב נכשל והמשימות במורד הזרם לא מופעלות.

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

• מוודאים שחיברתם חשבון שירות שמנוהל על ידי משתמש לשילוב. אם לא הגדרתם חשבון שירות בניהול המשתמשים בשילוב, המערכת תשתמש כברירת מחדל בחשבון השירות שמוגדר כברירת מחדל ([e-mail]) לצורך אימות.
• מוודאים שלחשבון השירות שלכם יש את תפקיד ה-IAM‏ Application Integration Invoker (הפעלת שילוב אפליקציות). במאמר ניהול הגישה לחשבונות שירות מוסבר איך נותנים לחשבון שירות תפקיד.

מאפייני ההגדרה

בטבלה הבאה מתוארים מאפייני ההגדרה של המשימה While Loop.

נכס	סוג הנתונים	תיאור
API Trigger ID	String	מזהה הטריגר של שילוב המשנה שרוצים להפעיל. הערך הזה זמין בשדה Trigger ID של API Trigger בשילוב המשנה.
Integration name	String	השם של שילוב המשנה שרוצים להפעיל.
While loop condition	לא רלוונטי	תנאי לסיום הלולאה. השילוב המשני פועל עד שהתנאי מתקיים. לדוגמה, $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s)	לא רלוונטי	הערכים שיועברו מהשילוב הנוכחי לשילוב המשנה. הערכים של המאפיין הזה הם בצורה של צמדי מפתח/ערך, כאשר המפתח הוא משתנה בשילוב הנוכחי, והערך הוא משתנה הקלט התואם בשילוב המשנה. לדוגמה, נניח שהשילוב הראשי כולל את המשתנה productID ואתם רוצים למפות אותו למשתנה של שילוב המשנה subIntProductID. במקרה כזה, תבחרו באפשרות productID בתפריט הנפתח Integration variable to map from ותזינו subIntProductID בשדה Sub-Integration input to map to.
Collect values from sub-integration output(s)	לא רלוונטי	איסוף התוצאות של הרצות השילוב המשני. בכל פעם שהשילוב המשני פועל, אפשר לאחסן את הפלט של השילוב המשני במשתנה מסוג מערך של השילוב הנוכחי. מזינים את משתנה הפלט של שילוב המשנה בשדה Sub-Integration output to collect from (פלט של שילוב משנה לאיסוף) ובוחרים את משתנה המערך בשילוב הנוכחי מהתפריט הנפתח Integration variable to collect into (משתנה שילוב לאיסוף). כל רכיב במערך מכיל את התשובה מהרצה של שילוב משנה מסוים. לדוגמה, אם משתנה המערך הוא resultsArray,‏ resultsArray[0] מכיל את התגובה מההרצה הראשונה ו-resultsArray[1] מכיל את התגובה מההרצה השנייה.
Override values from sub-integration output(s)	לא רלוונטי	קוראים את משתנה הפלט של הרצת שילוב משני ומאחסנים אותו במשתנה של השילוב הנוכחי. בתפריט הנפתח Sub-integration output to map from (פלט של שילוב משנה למיפוי), בוחרים את משתנה הפלט של שילוב המשנה. בתפריט הנפתח Integration variable to override (משתנה שילוב להחלפה), בוחרים את המשתנה התואם בשילוב הנוכחי. אפשר לשלוח את המשתנה שהוגדר כברירת מחדל בהפעלה הנוכחית של השילוב להפעלה הבאה של שילוב המשנה, על ידי מיפוי המשתנה במאפיין Map to additional sub-integration input(s). כתוצאה מכך, אפשר לצבור את התשובות מהרצות המשנה של האינטגרציה.
Loop metadata	מערך JSON	משתנה הפלט שמכיל את פרטי ההפעלה של ההפעלות של שילוב המשנה, כמו מזהה ההפעלה של שילוב המשנה, הודעות שגיאה וערכי משתנים שהועברו במהלך ההפעלה. מטא-נתונים של לולאה מכילים משתנים, כולל משתני הפלט הבאים: current_iteration_count, ‏ sub_integration_execution_ids, ‏ failure_location, ‏ current_element, ‏ iteration_element ו-failure_message. אזהרה: במטא-נתונים של הלולאה, תמצאו מפתחות כפולים למשתנה הפלט – לדוגמה, Current Iteration Count ו-current_iteration_count. מומלץ להשתמש במשתנים שמכילים את הסמל של הקו התחתון (_) כי המקשים האחרים יוצאים משימוש.

שיטות מומלצות

מידע על מכסות השימוש שחלות על המשימה While Loop זמין במאמר מכסות שימוש.

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

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

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

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

המאמרים הבאים

• מידע על כל המשימות והטריגרים
• איך בודקים ומפרסמים שילוב
• מידע נוסף על טיפול בשגיאות
• מידע נוסף על יומני ביצוע של שילובים