שתף באמצעות

שימוש בגירסה 2 של ממשקי API של לוחות זמנים של פרוייקט עם ‬Power Automate

  • מאמר

חל על: Project Operations לתרחישים מבוססי משאבים/לא מלאי, פריסה קלה - עסקה בחשבונית פרופורמה

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

הדוגמה במאמר זה משתמשת ב-API PssCreateV2. לדוגמה המשתמשת ב-API של PssCreateV1, ראה שימוש בממשקי API של לוח זמנים של פרויקט V1 עם Power Automate.

להלן רשימה מלאה של השלבים המתועדים בזרימה לדוגמה במאמר זה:

  1. יצירת גורם מפעיל של PowerApps
  2. יצירת פרוייקט
  3. אתחול משתנה עבור חבר הצוות
  4. יצירה של חבר צוות כללי
  5. יצירת קבוצת פעולות
  6. יצירת מיכל של פרוייקט
  7. אתחול משתנה עבור מספר המשימות
  8. אתחול משתנה עבור משימת הפרוייקט
  9. אתחול מערך
  10. בצע עד
  11. הגדרת משימת פרוייקט
  12. הוסף משימה למערך
  13. יצירת הקצאת משאב
  14. הקטנת משתנה
  15. הוסף משימות והקצאות לקבוצת הפעולות
  16. הפעלת קבוצת פעולות

הנחות

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

צור זרימה

בחר סביבה

תוכל ליצור את זרימת Power Automate בסביבה שלך.

  1. עבור אל https://flow.microsoft.com והשתמש באישורי מנהל מערכת כדי להיכנס.
  2. בפינה השמאלית העליונה, בחר ‏‫סביבות‬.
  3. מתוך הרשימה, בחר את הסביבה שבה מותקן Dynamics 365 Project Operations.

יצירת פתרון

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

  1. בחלונית הניווט, בחר פתרונות.
  2. בדף פתרונות, בחר פתרון חדש.
  3. בתיבת הדו-שיח פתרון חדש, הגדר את השדות הדרושים ובחר צור.

שלב 1: יצירת גורם מפעיל של PowerApps

  1. בדף פתרונות, בחר את הפתרון שיצרת ולאחר מכן בחר חדש.
  2. בחלונית הימנית, בחר זרימות ענן>אוטומציה>זרימת ענן>מיידי.
  3. בשדה שם הזרימה, הזן זרימת הדגמה של API של לוח זמנים.
  4. ברשימה בחר כיצד להפעיל זרימה זו, בחר Power Apps. כאשר אתה יוצר גורם מפעיל של Power Apps, הלוגיקה תלויה בך כמחבר. עובר הדוגמה במאמר זה, השאר את פרמטרי הקלט ריקים למטרות בדיקה.
  5. בחר צור

שלב 2: יצירת פרוייקט

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

  1. בזרימה שיצרת, בחר צעד חדש.

    הוספת צעד חדש.

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

    בחירת פעולה.

  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.

    שינוי שם של צעד.

  4. שנה את שם הצעד ליצירת פרויקט.

  5. בשדה שם פעולה בחר msdyn_CreateProjectV1.

  6. בשדה msdyn_subject, בחר הוסף תוכן דינמי.

  7. בכרטיסיה ביטוי בשדה פונקציה, הזן concat('Project name - ',utcNow()).

  8. בחר אישור.

צעד 3: אתחול משתנה עבור חבר הצוות

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן אתחל משתנה. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם השלב לאתחל חבר צוות.
  5. בשדה שם, הזן TeamMemberAction.
  6. בשדה סוג, בחר מחרוזת.
  7. בשדה ערך, הזן msdyn_CreateTeamMemberV1.

צעד 4: צור חבר צוות פרויקט כללי

  1. בזרימה, בחר צעד חדש.

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

  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.

  4. שנה את שם השלב לצור חבר צוות.

  5. עבור השדה שם פעולה, בחר TeamMemberAction בתיבת הדו-שיח תוכן דינמי.

  6. בשדה פרמטרי פעולה, הזן את פרטי הפרמטרים הבאים.

    {
    "TeamMember": {
        "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projectteam",
        "msdyn_projectteamid": "@{guid()}",
        "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
        "msdyn_name": "ScheduleAPIDemoTM1"
    }
}

    להלן הסבר על הפרמטרים:

    • odata.type - שם הישות. לדוגמה, הזן "Microsoft.Dynamics.CRM.msdyn_projecttask".
    • msdyn_projectteamid – המפתח הראשי של מזהה צוות הפרוייקט. הערך הוא ביטוי של מזהה ייחודי כללי (GUID). המזהה נוצר מהכרטיסיה ביטוי.
    • msdyn_project@odata.bind – מזהה של לוח השנה עבור הפרוייקט.. הערך הוא תוכן דינמי שמגיע מהתגובה של הצעד "יצירת פרוייקט". ודא שאתה מזין את הנתיב המלא ומוסף תוכן דינמי בין הסוגריים. יש צורך במירכאות. למשל, הזן "/msdyn_projects(הזן תוכן דינמי)".
    • msdyn_name – שם חבר הצוות. לדוגמה, הזן ScheduleAPIDemoTM1.

צעד 5: צור קבוצת פעולות

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן בצע פעולה לא מאוגדת. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם הצעד ליצירת קבוצת פעולות.
  5. בשדה שם פעולה, בחר פעולה מותאמת אישית msdyn_CreateOperationSetV1 של Dataverse.
  6. בשדה תיאור, הזן ScheduleAPIDemoOperationSet.
  7. עבור השדה Project, בחר msdyn_CreateProjectV1Response ProjectId בתיבת הדו-שיח תוכן דינמי.

צעד 6: יצירת מיכל של פרוייקט

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן הוסף שורה חדשה. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם הצעד לצור מיכל.
  5. בשדה שם טבלה, בחר מיכלים של פרוייקט.
  6. בשדה שם, הזן ScheduleAPIDemoBucket1.
  7. בשדה פרוייקט, הזן /msdyn_projects(.
  8. בתיבת הדו-שיח תוכן דינמי, בחר msdyn_CreateProjectV1Response ProjectId.
  9. בשדה פרוייקט, הזן ).

צעד 7: אתחול משתנה עבור מספר המשימות

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן אתחל משתנה. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם השלב לאתחל מספר משימות.
  5. בשדה שם, הזן מספר משימות.
  6. בשדה סוג, בחר מספר שלם.
  7. בשדה ערך, הזן 5.

צעד 8: אתחול משתנה עבור משימת הפרוייקט

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן אתחל משתנה. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם השלב לInit ProjectTaskID.
  5. בשדה שם, בחר msdyn_projecttaskid.
  6. בשדה סוג, בחר מחרוזת.
  7. עבור השדה Value, הזן guid() בבונה הביטויים.

שלב 9: אתחול מערך

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

צעד 10: בצע עד

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

צעד 11: הגדרת משימת פרוייקט

  1. בזרימה, בחר הוסף פעולה.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן הגדר משתנה. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בשלב החדש, בחר בשלוש הנקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם השלב להגדרת משימת פרוייקט.
  5. בשדה שם פעולה בחר msdyn_projecttaskid.
  6. עבור השדה Value, הזן guid() בבונה הביטויים.

שלב 12: הוסף משימה למערך

  1. בזרימה, בחר צעד חדש.

  2. בתיבת הדו-שיח בחר פעולה, בשדה החיפוש, הזן צירוף למערך.

  3. בצעד, בחר שלוש נקודות (...) ולאחר מכן בחר שנה שם.

  4. שנה את שם השלב הוסף משימה למערך.

  5. בשדה שם, בחר משימות והקצאות.

  6. בשדה ערך, הזן את פרטי הפרמטרים הבאים.

    {
    "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
    "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
    "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
    "msdyn_subject": "ScheduleAPIDemoTask1",
    "msdyn_projectbucket@odata.bind": "/msdyn_projectbuckets(@{outputs('Create_Bucket')?['body/msdyn_projectbucketid']})",
    "msdyn_start": "@{addDays(utcNow(), 1)}",
    "msdyn_scheduledstart": "@{utcNow()}",
    "msdyn_scheduledend": "@{addDays(utcNow(), 5)}",
    "msdyn_LinkStatus": "192350000"
}

    להלן הסבר על הפרמטרים:

    • odata.type - שם הישות. לדוגמה, הזן "Microsoft.Dynamics.CRM.msdyn_projecttask".
    • msdyn_projecttaskid – המזהה הייחודי של המשימה. יש להגדיר את הערך למשתנה דינמי מ- msdyn_projecttaskid.
    • msdyn_project@odata.bind – מזהה של לוח השנה עבור הפרוייקט.. הערך הוא תוכן דינמי שמגיע מהתגובה של הצעד "יצירת פרוייקט". ודא שאתה מזין את הנתיב המלא ומוסף תוכן דינמי בין הסוגריים. יש צורך במירכאות. למשל, הזן "/msdyn_projects(הזן תוכן דינמי)".
    • msdyn_subject – כל שם של משימה.
    • msdyn_projectbucket@odata.bind – מיכל הפרוייקט המכיל את המשימות. הערך הוא תוכן דינמי שמגיע מהתגובה של הצעד "יצירת מיכל". ודא שאתה מזין את הנתיב המלא ומוסף תוכן דינמי בין הסוגריים. יש צורך במירכאות. למשל, הזן "/msdyn_projectbuckets(הוסף תוכן דינמי)".
    • msdyn_start – תוכן דינמי עבור תאריך ההתחלה. לדוגמה, יום המחר מיוצג כ- "addDays(utcNow(), 1)"‎.
    • msdyn_scheduledstart – תאריך ההתחלה המתוזמן. לדוגמה, יום המחר מיוצג כ- "addDays(utcNow(), 1)"‎.
    • msdyn_scheduleend – תאריך הסיום המתוזמן. בחר תאריך בעתיד. למשל, ציין "addDays(utcNow(), 5)".
    • msdyn_LinkStatus – הקישור להגדרת החיוב. לדוגמה, הזן "192350000"‎ אם אין קישור להגדרת החיוב או "192350001"‎ אם חיוב ההגדרה מקושרת.

שלב 13: יצירת הקצאת משאבים

  1. בזרימה, בחר הוסף פעולה.

  2. בתיבת הדו-שיח בחר פעולה, בשדה החיפוש, הזן צירוף למערך.

  3. בצעד, בחר שלוש נקודות (...) ולאחר מכן בחר שנה שם.

  4. שנה את שם השלב הוסף הקצאה למערך.

  5. בשדה שם, בחר משימות והקצאות.

  6. בשדה ערך, הזן את פרטי הפרמטרים הבאים.

    {
    "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_resourceassignment",
    "msdyn_resourceassignmentid": "@{guid()}",
    "msdyn_name": "ScheduleAPIDemoAssign1",
    "msdyn_taskid@odata.bind": "/msdyn_projecttasks(@{variables('msdyn_projecttaskid')})",
    "msdyn_projectteamid@odata.bind": "/msdyn_projectteams(@{outputs('Create_Team_Member')?['body/TeamMemberId']})",
    "msdyn_projectid@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})"
}

צעד 14: הקטנת משתנה

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

שלב 15: הוסף משימות והקצאות לקבוצת הפעולות

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן בצע פעולה לא מאוגדת. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בצעד, בחר שלוש נקודות (...) ולאחר מכן בחר שנה שם.
  4. שינוי שם השלב הוסף משימות והקצאות לקבוצת הפעולות.
  5. בשדה שם פעולה בחר msdyn_PssCreateV2.
  6. בשדה OperationSetId, בחר msdyn_CreateOperationSetV1Response OperationSetId בתיבת הדו-שיח תוכן דינמי.
  7. בשדה EntityCollection בחר העבר קלט למערך כולו.
  8. עבור השדה EntityCollection, בחר משימות והקצאותבתיבת הדו-שיח תוכן דינמי.

צעד 16: הפעלת קבוצת פעולות

  1. בזרימה, בחר צעד חדש.
  2. בתיבת הדו-שיח בחר פעולה בשדה החיפוש, הזן בצע פעולה לא מאוגדת. לאחר מכן, בכרטיסיה פעולות, בחר את הפעולה ברשימת התוצאות.
  3. בצעד, בחר שלוש נקודות (...) ולאחר מכן בחר שנה שם.
  4. שנה את שם הצעד לביצוע קבוצת פעולות.
  5. בשדה שם פעולה בחר msdyn_ExecuteOperationSetV1.
  6. בשדה OperationSetId, בחר msdyn_CreateOperationSetV1Response OperationSetId בתיבת הדו-שיח תוכן דינמי.

הפניות