משימת אישור

המשימה Approval מאפשרת להגדיר שילובים שמבוססים על אישורים. הוא גם מאפשר לכם לשלוט בתהליך השילוב.

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

במהלך הפעלת אינטגרציה, כשהבקרה מגיעה למשימה Approval, ההפעלה נעצרת וכל המשימות שאחרי המשימה Approval מושהות. האינטגרציה ממשיכה לפעול רק כשמשתמש מאשר או דוחה את בקשת האישור, במסוף Google Cloud או באמצעות ה-API.

אפשר להשתמש במשימה Approval למטרות הבאות:

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

השוואה בין משימת אישור, משימת השעיה ומשימת טיימר

שלוש המשימות (Approval,‏ Suspend ו-Timer) מבצעות פונקציה דומה של השהיה וחידוש של אינטגרציה. עם זאת, יש ביניהם הבדלים קלים. בטבלה הבאה מתוארים ההבדלים בין שלוש המשימות.

משימת אישור	השעיית המשימה	משימת טיימר
התהליך ממשיך כשמשתמש מאשר או דוחה את הבקשה בממשק המשתמש של Integrations או באמצעות ה-API.	תמיכה בהפעלה מחדש של שילוב באופן ידני ואוטומטי. אם לא תהיה התערבות ידנית לביטול ההשעיה, האינטגרציה תמשיך לפעול באופן אוטומטי אחרי שתוקף מגבלת הזמן של ההשעיה יפוג.	תומך רק בהפעלה מחדש אוטומטית של שילוב. הפעלת השילוב ממשיכה באופן אוטומטי אחרי שתקופת ההשעיה מסתיימת.
אפשר להמשיך את השילוב דרך ממשק המשתמש של השילובים או באמצעות קריאה ל-method‏ suspensions.resolve. אישור או דחייה באמצעות ה-API	אפשר להמשיך את השילוב על ידי קריאה ל-method‏ suspensions.lift.	תומך רק בהפעלה מחדש אוטומטית של שילוב.
המשתמשים מקבלים התראה כשהשילוב מושהה (מושעה).	המשתמשים לא מקבלים התראה כשהשילוב מושהה.	המשתמשים לא מקבלים התראה כשהשילוב מושהה.
תומכת במשתנה פלט (בוליאני), שמאפשר לבצע בדיקות מותנות לפני שממשיכים את האינטגרציה. עם זאת, משתנה הפלט יכול להיות רק הערך true או false.	תומכת במשתנה פלט (מחרוזת), שמאפשר לבצע בדיקות מותנות לפני שממשיכים את האינטגרציה. אפשר להגדיר כל ערך למשתנה הפלט.	לא תומך במשתני פלט.

הגדרת המשימה Approval

כדי להגדיר את המשימה Approval:

1. נכנסים לדף Application Integration במסוף Google Cloud .

   כניסה ל-Application Integration

2. בתפריט הניווט, לוחצים על Integrations (שילובים).

   מופיע הדף Integrations, שבו מפורטים כל השילובים שזמינים בפרויקט בענן ב-Google Cloud.

3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

   אם אתם יוצרים שילוב חדש:

   1. מזינים שם ותיאור בחלונית Create Integration.
   2. בוחרים אזור לשילוב.
      הערה: בתפריט הנפתח Regions מופיעים רק האזורים שהוקצו בפרויקט בענן שלכם ב-Google Cloud. כדי להקצות אזור חדש, לוחצים על Enable Region. מידע נוסף זמין במאמר הפעלת אזור חדש.
   3. בוחרים חשבון שירות לשילוב. אתם יכולים לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב, דרך החלונית סיכום השילוב בסרגל הכלים של השילוב.
      הערה: האפשרות לבחור חשבון שירות מוצגת רק אם הפעלתם את ניהול השילובים באזור שנבחר.
   4. לוחצים על יצירה. האינטגרציה החדשה שנוצרה נפתחת בעורך האינטגרציות.

4. בסרגל הניווט של עורך השילובים, לוחצים על Tasks כדי להציג את רשימת המשימות והמחברים הזמינים.
5. לוחצים על רכיב המשימה Approval וממקמים אותו בעורך השילובים.
6. לוחצים על רכיב המשימה Approval במעצב כדי להציג את חלונית ההגדרות של המשימה Approval.
7. מגדירים את השדות שמוצגים באמצעות מאפייני ההגדרה של המשימה, כמו שמפורט בטבלה הבאה.

   כל השינויים במאפיינים נשמרים באופן אוטומטי.

מאפייני ההגדרות האישיות

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

נכס	סוג הנתונים	תיאור
Recipients	מערך מחרוזות	כתובות האימייל שאליהן נשלחת התראה כשהמשימה מושעית. כדי להזין כמה כתובות אימייל, מפרידים ביניהן באמצעות פסיק. הערה: בפרויקט בענן ב-Google Cloud, צריך להקצות את התפקיד Application Integration Approver ב-IAM לכל כתובות האימייל שצוינו בשדה Recipients. במאמר הענקה, שינוי וביטול של גישה מוסבר איך מקצים תפקידים ב-IAM.
Custom notification message	String	הודעה בהתאמה אישית שתיכלל בהתראה באימייל כשהמשימה מושעית. הערך יכול להיות ליטרל או משתנה. אם ההודעה המותאמת אישית זמינה במשתנה, לוחצים על VAR ובוחרים את המשתנה.
Reminder frequency (in hours)	מספר שלם	תדירות התזכורות. אם ההשעיה לא נפתרה, אתם יכולים לשלוח תזכורות באימייל למשתמשים מורשים כדי שיפתרו את הבעיה.
Time until expiration (in hours)	מספר שלם	תקופת ההשעיה. אם ההשעיה לא תטופל במסגרת מגבלת הזמן, היא תידחה כברירת מחדל.
On expiration	בוליאני	הפעולה שתתבצע אחרי שתוקף ההשעיה יפוג. אתם יכולים לבחור אם לדחות את ההשעיה או לבטל אותה. כברירת מחדל, ההשעיה נדחית.
isApproved (Approval)	בוליאני	משתנה פלט שמכיל את סטטוס ההשעיה אחרי הטיפול. המשתנה isApproved מוגדר כ-True אם ההשעיה אושרה, וכ-False אם ההשעיה נדחתה. טיפ: אפשר להשתמש במשתנה isApproved כשמציינים תנאי קצה למשימות הבאות כדי לשלוט בתהליך האינטגרציה. מידע נוסף על תנאי קצוות זמין במאמר תנאי קצוות. בדוגמה הבאה מוצג תנאי קצה שמוגדר באמצעות המשתנה isApproved: $TASK_ID_isApproved$ = TRUE

תגובה לבקשת אישור באמצעות ה-API

כדי לאשר או לדחות בקשת אישור בהמתנה בלי מסוף Google Cloud , צריך להפעיל את ה-method‏ projects.locations.integrations.executions.suspensions.resolve.

כדי לאשר או לדחות בקשה, צריך את ההרשאה integrations.suspensions.resolve. כדי לראות את רשימת ההשעיות, צריך גם את ההרשאה integrations.suspensions.list. התפקיד "מאשר של Application Integration" (roles/integrations.suspensionResolver) כולל את שתי ההרשאות, וכך גם התפקיד "אדמין של Application Integration" (roles/integrations.integrationAdmin).

אם השילוב משתמש בחשבון שירות מסוג run-as, צריך להקצות את התפקיד "משתמש בחשבון שירות" (roles/iam.serviceAccountUser) בחשבון השירות הזה. הדרישה הזו נכנסת לתוקף ככל שמתקדמת ההשקה שמתוארת בקטע הקצאת התפקיד "משתמש בחשבון שירות".

1. כדי למצוא את הבקשה בהמתנה, מציגים את רשימת ההשהיות של ההפעלה באמצעות השיטה projects.locations.integrations.executions.suspensions.list:

   curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions"
   

   בתשובה, מחפשים את ההשעיה שהערך של taskId שלה הוא המזהה של משימת האישור, והערך של state שלה הוא PENDING. התגובה כוללת גם השעיות ממשימות השעיה וממשימות אישור אחרות באותו ביצוע. שימו לב ל-name של ההשעיה, שמסתיים במזהה ההשעיה.

2. כדי לאשר או לדחות את הבקשה, מפעילים את ה-method‏ suspensions.resolve:

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -d '{
         "suspension": {
           "eventExecutionInfoId": "EXECUTION_ID",
           "integration": "INTEGRATION_NAME",
           "taskId": "TASK_ID",
           "state": "STATE"
         }
       }' \
       "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions/SUSPENSION_ID:resolve"
   

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫LOCATION: האזור של האינטגרציה.
• ‫INTEGRATION_NAME: שם השילוב.
• ‫EXECUTION_ID: המזהה של ההפעלה שהושעתה.
• ‫TASK_ID: המזהה של משימת האישור (taskId של ההשעיה).
• ‫SUSPENSION_ID: מזהה ההשעיה מהשדה name של ההשעיה.
• STATE: מצב הפתרון. משתמשים ב-LIFTED כדי לאשר את הבקשה (הערך של isApproved מוגדר כ-true), או ב-REJECTED כדי לדחות אותה (הערך של isApproved מוגדר כ-false).

הערה:

• פרסום גרסה חדשה של האינטגרציה מבטל את ההפעלות שלה שממתינות לאישור.
• ה-method‏ suspensions.lift ממשיכה משימה מושהית. היא לא מאשרת או דוחה משימת אישור.

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

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

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

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

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

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