יצירת פעולה של תהליך מותאם אישית

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

הערה

אם אתה מתכוון לכתוב יישום plug-in כדי ליישם את הלוגיקה שלך עבור פעולת תהליך מותאמת אישית במקום להשתמש במעצב זרימות העבודה, עליך להשתמש ב- API מותאם אישית במקום זאת. מידע נוסף: השווה פעולת תהליך מותאמת אישית ו- API מותאם אישית

יצירת פעולה של תהליך מותאם אישית

חשוב

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

בדומה לתהליכי זרימת עבודה, לפעולות תהליך מותאמות אישית יש את המאפיינים הבאים בתיבת הדו-שיח יצירת תהליך:

• שם תהליך

  לאחר הזנת שם עבור התהליך, שם ייחודי ייווצר עבורה על-ידי הסרת רווחים או תווים מיוחדים משם התהליך.

• קטגוריה

  מאפיין זה קובע כי זהו תהליך של פעולות. לא ניתן לשנות אותו לאחר שמירה של התהליך.

• טבלה

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

• סוג

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

שלא כמו תהליכי זרימת עבודה, אין צורך להגדיר את האפשרויות הבאות:

• הפעל בעת: פעולות מתחילות כאשר קוד קורא להודעה שנוצרה עבורן.

• טווח: פעולות תמיד פועלות בהקשר של המשתמש המתקשר.

• פעולה ברקע: פעולות הן תמיד זרימות עבודה בזמן אמת.

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

הערה

באפשרותך לאפשר פעולת תהליך מותאמת אישית מתוך זרימת עבודה מבלי לכתוב קוד. מידע נוסף: הפעלת פעולות תהליך מותאמות אישית מתוך זרימת עבודה

עריכת פעולה של תהליך מותאם אישית

עליך להשבית פעולות תהליך מותאמות אישית לפני שתוכל לערוך אותן.

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

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

בעת עריכת פעולה, עומדות בפניך האפשרויות הבאות:

• שם תהליך

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

• שם ייחודי

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

  חשוב

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

• אפשר חזרה למצב קודם

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

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

  הערה

  אין אפשרות להפעיל חזרה למצב קודם‬ אם פעולת תהליך מותאמת אישית מופעלת ישירות מתוך זרימת עבודה. באפשרותך להפעיל חזרה למצב קודם‬ אם פעולה הופעלה על-ידי הודעה של שירותי אינטרנט של Power Apps.

• הפעל בתור

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

• הגדרת ארגומנטים של תהליך

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

• הוספת שלבים וצעדים

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

הגדרת ארגומנטים של תהליך

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

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

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

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

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

סוגי ארגומנטים של תהליך פעולה

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

סוג	תיאור
Boolean	ערך true או false.
תאריך ושעה	ערך המאחסן מידע של התאריך והשעה.
עשרוני	ערך מספרי עם דיוק עשרוני. משמש כאשר הדיוק חשוב מאוד.
טבלה	שורה עבור הטבלה שצוינה. כאשר תבחר טבלה, הרשימה הנפתחת תהיה זמינה ותאפשר לך לבחור את סוג הטבלה.
entityCollection	אוסף של שורות טבלה.
entityReference	אובייקט המכיל את השם, המזהה והסוג של שורת טבלה המזהה אותו באופן ייחודי. כאשר תבחר entityReference, הרשימה הנפתחת תהיה זמינה ותאפשר לך לבחור את סוג הטבלה.
Float	ערך מספרי עם דיוק עשרוני. נמצא בשימוש כאשר מגיעים נתונים ממדידה שאינה מדויקת לחלוטין.
מספר שלם	מספר שלם.
כסף	ערך המאחסן נתונים על כמות הכסף.
רשימת בחירה	ערך המייצג אפשרות של התכונה OptionSet.
String	ערך טקסט.

הערה

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

הוספת שלבים וצעדים

פעולות תהליך מותאמות אישית הן סוג של תהליך דומה מאוד לזרימות עבודה בזמן אמת. כל הצעדים שניתן להשתמש בהן בזרימות עבודה בזמן אמת יכולים לשמש בפעולות. לקבלת מידע על הצעדים שיכולים לשמש עבור זרימות עבודה בזמן אמת ופעולות, ראה ‏‫שלבים וצעדים בזרימת עבודה‬.

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

מאפיינים מנוהלים

לפעולות תהליך מותאמות אישית יש שני מאפיינים מנוהלים רלוונטיים

ניתן להתאמה אישית

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

האם שלב עיבוד מותאם אישית מורשה עבור מפרסמים אחרים

המאפיין המנוהל הפעלת פעולות תהליך מותאמות אישית מתוך זרימת עבודה קובע אם מפתחים של יישומי Plug-in של צד שלישי יכולים לרשום שלבי יישום Plug-in בהודעה שנוצרה על-ידי פעולת התהליך המותאמת אישית. כאשר מאפיין זה מוגדר כ- True, יישומי Plug-in שנשרמו על-ידי אדם כלשהו בהודעה זו יפעלו ויכולים לשנות את אופן הפעולה של פעולת התהליך המותאמת אישית. כאשר הוא מוגדר כ- False, רק שלבים של יישומי Plug-in הרשומים בתוך פתרון של אותו מפרסם פתרונות יפעלו.

השלבים הבאים

הפעלת פעולות תהליך מותאמות אישית מתוך זרימת עבודה