Azure DevOps

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

גרסאות נתמכות

המחבר הזה תומך בגרסאות הבאות של Azure DevOps.

  • ‫Azure DevOps 2022, ‏ 2020, ‏ 2019
  • Team Foundation Server 2018

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

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים את התפקידים roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor ב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר.
  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

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

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

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

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

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Azure DevOps מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    8. ‫Azure Tenant: צריך לציין את השם או המזהה של דייר Azure DevOps.
    9. ארגון: מציינים את השם של הארגון או האוסף שמשתמש ב-Azure DevOps.
    10. סכימה: מזינים את הסכימה, כמו information, project.
    11. קטלוג: מזינים את שם הקטלוג.
    12. החלת טרנספורמציה: מזינים רשימה של טרנספורמציות שמופרדות באמצעות פסיקים.
    13. ‫Azure DevOps Edition: מזינים את המהדורה של Azure DevOps.
    14. ‫Azure DevOps Service API: מזינים את גרסת ה-Rest API של Azure DevOps.
    15. כתובת URL: מציינים את כתובת ה-URL של מופע Azure DevOps.
    16. Include Custom Fields (הכללת שדות בהתאמה אישית): בוחרים באפשרות הזו כדי לכלול שדות בהתאמה אישית ברשימת העמודות.
    17. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    18. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Azure DevOps תומך בסוגי האימות הבאים:

      • AzureAD
      • בסיסי

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

    2. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

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

  • AzureAD
    • ‫ClientID: מזינים את מזהה הלקוח של האפליקציה שיצרתם.
    • היקפים: מציינים את כל ההיקפים שמופרדים בפסיק, כמו read, write.
    • סוד לקוח: מזינים את הסוד של מנהל הסודות שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
    • גרסת סוד: בוחרים את גרסת הסוד של הסוד שנבחר למעלה.
    • כתובת URL להרשאה: מציינים את כתובת ה-URL להרשאה של הלקוח.
  • Basic
    • Personal Access Token (טוקן גישה אישי): מזינים את טוקן הגישה האישי שנוצר.
    • ‫Secret Version (גרסת סוד): בוחרים את גרסת הסוד של הסוד שהוזן.

דוגמאות להגדרת חיבור

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

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

  • מודל נתונים של פרויקט: סכימה שמגדירה איך נתונים שקשורים לפרויקט, כמו פריטים, מאגרי מידע, צינורות וצוותים, מאורגנים, מקושרים ומנוהלים ב-Azure DevOps.
  • מודל נתוני מידע: סכימה שמגדירה איך מסמכים, מטא-נתונים וארטיפקטים של תקשורת מובְנים, מאוחסנים ונגישים בפרויקטים של Azure DevOps.
  • מודל נתונים של מאגר: סכימה שמגדירה איך מאגרי קוד, ענפים, קומיטים, בקשות משיכה ומטא-נתונים קשורים מאורגנים ומנוהלים ב-Azure DevOps.
  • מודל נתונים של Analytics: סכימה שמתעדת ומארגנת נתונים היסטוריים ונתונים בזמן אמת מ-Azure DevOps לצורך דיווח, מרכזי בקרה וניתוח מתקדם.
  • כל מודלי הנתונים: חיבור יחיד שמאפשר גישה לכל מודלי הנתונים בחיבור יחיד.
שם השדה מודל מידע מודל הפרויקט מודל מאגר מודל Analytics כל המודלים חיבור AzureAD
מיקוםeurope-west1europe-west1europe-west1europe-west1asia-east1europe-west1
מחברAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOps
גרסת המחבר111111
שם החיבורazuredevops-informationmodelazuredevops-projectmodelazuredevops-repositorymodelazuredevops-analyticsmodelDevOpsazuredevops-oauth
הפעלת Cloud Loggingכןכןכןכןכןכן
רמת הרישום ביומןניפוי באגיםניפוי באגיםניפוי באגיםניפוי באגיםניפוי באגיםניפוי באגים
חשבון השירותYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccount
דייר AzureTenant_IdTenant_IdTenant_IdTenant_IdTenant_IdTenant_Id
ארגוןOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_Name
סכימהמידעפרויקטRepository__RepositoryIdAnalyticsפרויקט
קטלוגDevopsProject_ProjectIdProject_ProjectIdProject_ProjectIdProject_ProjectId
Azure Dev Ops EditionAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps Online
Azure Dev Ops Service API6.06.06.06.06.06.0
הכללת שדות מותאמים אישיתכןכןכןכןכןכן
CustomizedDefaultCatalogNameCustomizedDefaultCatalogName=GoogleCustomizedDefaultCatalogName=Google
מספר הצמתים המינימלי222222
מספר הצמתים המקסימלי505050505050
אימותכןכןכןכןכןכן
בסיסיכןכןכןכןכן
טוקן APIאסימון API שסופק על ידי האפליקציהאסימון API שסופק על ידי האפליקציהאסימון API שסופק על ידי האפליקציהאסימון API שסופק על ידי האפליקציהאסימון API שסופק על ידי האפליקציה
גרסה של סוד111111
AzureADכן
מזהה לקוחClient_Id
ערך סוד הלקוחערך סוד הלקוח
היקפיםuser_impersonation
כתובת אתר להרשאהhttps://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

אתם יכולים להשתמש במאפייני החיבור הבאים כדי לנהל את הנתונים שנשלפים מ-Azure DevOps.

קטלוג

במאפיין הזה מציינים את השם או המזהה של הפרויקט שאליו רוצים להתחבר. כדי לקבל רשימה של מזהי פרויקטים ושמות, מריצים שאילתת SELECT מול הטבלה Projects.

  • כדי לשלוח שאילתה לנתונים של פרויקט ספציפי, מגדירים את Catalog לשם הפרויקט או למזהה שלו בפורמט Project_projectname.
    אם שם הפרויקט הוא dev והמזהה שלו הוא 2ee729d6-804d-4ece-84af-d5befa94abe8, צריך להגדיר את Catalog כ-Project_dev או כ-Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
  • כדי לשלוח שאילתות לנתונים שלא קשורים לפרויקט ספציפי, מגדירים את Catalog (קטלוג) לערך Devops. אם שם הקטלוג הוא Devops, אפשר להשתמש בכל שם במקום Devops.

סכימה

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

  • אם מגדירים את הקטלוג ואת הסכימה ל-INFORMATION בהגדרת החיבור, תהיה לכם גישה רק לסכימת מודל נתוני המידע. קטלוגים או סכימות אחרים של פרויקטים לא ייחשפו.
  • אם Catalog מוגדר לקטלוג פרויקטים, אפשר להגדיר את Schema לאחד מהערכים הבאים: Analytics,‏ Project או אחת מסכימות המאגר. אחרי שבוחרים את הסכימה המתאימה, אפשר לשלוח שאילתות לנתונים במאגר ספציפי.
    כדי לשלוח שאילתה לנתונים ממאגר עם המזהה 3ee729d6-804d-4ece-84af-d5befa94abe8, מגדירים את Catalog לערך Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

כדי ליצור אפליקציה ב-Azure Portal או ב-MS Entra ולהשתמש בכל הפרמטרים של האפליקציה שנוצרה ברמת החיבור של Azure AD, אפשר לעיין במאמרים Quickstart: Register an application with the Microsoft identity platform ו-Register a client application in Microsoft Entra ID.

מגבלות המערכת

מחבר Azure DevOps יכול לעבד עד 6 עסקאות בשנייה, לכל צומת, ומגביל עסקאות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור Azure DevOps בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

פעולות

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

פעולה CreateWorkItem

הפעולה הזו יוצרת פריט עבודה.

פרמטרים של קלט לפעולה CreateWorkItem

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

דוגמה להגדרת הפעולה CreateWorkItem מופיעה במאמר דוגמאות.

פעולת UpdateWorkItem

פרמטרים של קלט לפעולה UpdateWorkItem

הפעולה הזו מעדכנת פריט עבודה.

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
WorkItemId String כן המזהה של פריט העבודה.
מאת String לא נתיב המקור לפעולת ההעתקה או ההעברה.
Op String כן פעולת התיקון שמשנה את פריט העבודה, כמו הוספה, העתקה, העברה, הסרה, החלפה או בדיקה.
נתיב String כן הנתיב של הפעולה.
ערך String כן הערך של הפעולה.

דוגמה להגדרת הפעולה UpdateWorkItem מופיעה במאמר דוגמאות.

פעולת GetPullRequestCommits

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

פרמטרים של קלט לפעולה GetPullRequestCommits

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה או השם של המאגר. אם לא מגדירים את ProjectId, צריך להגדיר את RepositoryId.
PullRequestId String כן המזהה של בקשת המיזוג.

פרמטרים של פלט של הפעולה GetPullRequestCommits

דוגמה להגדרת הפעולה GetPullRequestCommits מופיעה במאמר דוגמאות.

הפעולה PushChanges

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

פרמטרים של קלט לפעולה PushChanges

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה או השם של המאגר. אם לא מגדירים את ProjectId, צריך להגדיר את RepositoryId.
BranchRefName String כן השם של ענף ה-git.
OldObjectId String כן מזהה האובייקט הנוכחי של הענף.
CommitComment String כן מציין את התגובה שכלולה בהעלאה.
ChangesAggregate String כן אובייקט מצטבר שמכיל פרטים על כל שינוי בהתחייבות.

דוגמה להגדרת הפעולה PushChanges מופיעה במאמר דוגמאות.

הפעולה DownloadReleaseLogs

הפעולה הזו מורידה יומנים של הגרסה הספציפית.

פרמטרים של קלט לפעולה DownloadReleaseLogs

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
ReleaseId מספר שלם כן המזהה של פריט התוכן.
FileLocation String לא המיקום של הקובץ.
קידוד String לא סוג הקידוד של הקלט FileData. הערכים המותרים הם NONE ו-BASE64. ערך ברירת המחדל הוא BASE64.
FileStream String לא מופע של זרם פלט שבו נכתבים נתונים של קובץ. הפרמטר הזה משמש רק אם לא צוין FileLocation.

דוגמה להגדרת הפעולה DownloadReleaseLogs מופיעה במאמר דוגמאות.

הפעולה DownloadTestAttachment

הפעולה הזו מורידה קובץ מצורף של תוצאת בדיקה או הרצה.

פרמטרים של קלט לפעולה DownloadTestAttachment

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
ResultId מספר שלם לא המזהה של תוצאת הבדיקה.
RunId מספר שלם כן המזהה של הרצת הבדיקה.
AttachmentId String לא המזהה של הקובץ המצורף.
FileLocation String לא המיקום של הקובץ.
קידוד String לא סוג הקידוד של הקלט FileData. הערכים המותרים הם NONE ו-BASE64. ערך ברירת המחדל הוא BASE64.
FileStream String לא מופע של זרם פלט שבו נכתבים נתונים של קובץ. הפרמטר הזה משמש רק אם לא צוין FileLocation.

דוגמה להגדרת הפעולה DownloadTestAttachment מופיעה במאמר דוגמאות.

הפעולה SetProjectProperties

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

פרמטרים של קלט לפעולה SetProjectProperties

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
מאת String לא נתיב המקור של פעולת ההעברה או ההעתקה.
Op String כן פעולת התיקון שמשנה את מאפייני הפרויקט, כמו הוספה, העתקה, העברה, הסרה, החלפה או בדיקה.
נתיב String כן הנתיב של הפעולה.
ערך String כן הערך של הפעולה.

דוגמה להגדרת הפעולה SetProjectProperties מופיעה במאמר דוגמאות.

פעולת DeleteTestCase

הפעולה הזו תמחק את תרחיש הבדיקה.

פרמטרים של קלט לפעולה DeleteTestCase

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
TestcaseId מספר שלם כן המזהה של תרחיש הבדיקה.

דוגמה להגדרת הפעולה DeleteTestCase מופיעה במאמר דוגמאות.

פעולת RunPipeline

הפעולה הזו מריצה צינור עם ההגדרה שצוינה.

פרמטרים של קלט לפעולה RunPipeline

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
PipelineId מספר שלם כן המזהה של צינור הנתונים.
PipelineVersion מספר שלם לא הגרסה של הפייפליין להרצה.
משאבים String כן המשאבים שההרצה דורשת.
משתנים String לא רשימת המשתנים והערכים לשימוש במהלך הפעלת צינור.
StagesToSkip String לא מערך של שמות של שלבים שצריך לדלג עליהם.
TemplateParameters String לא מיפוי של פרמטרים שמשמשים במהלך ההפעלה של צינור העיבוד.

דוגמה להגדרת הפעולה RunPipeline מופיעה במאמר דוגמאות.

פעולת CreatePullRequest

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

פרמטרים של קלט לפעולה CreatePullRequest

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה של המאגר.
כותרת String כן השם של ה-pull request.
תיאור String לא תיאור בקשת המיזוג.
SourceRefName String כן השם של ענף המקור של בקשת המיזוג.
TargetRefName String כן השם של ענף היעד של בקשת המיזוג.
CompletionOptions String לא אפשרויות שמשפיעות על אופן המיזוג של בקשת המשיכה כשהיא תושלם.
IsDraft בוליאני לא בקשת מיזוג (pull request) בסטטוס טיוטה או בתהליך עבודה (WIP).
תוויות String לא התוויות שמשויכות לבקשת המיזוג.
MergeOptions String לא אפשרויות שמשמשות כשמריצים את מיזוג בקשת המשיכה.
בודקים String לא רשימה של בודקים בבקשת המשיכה.
WorkItemRefs String לא הפניות לפריטי עבודה שמשויכות לבקשת המיזוג הזו.

דוגמה להגדרת הפעולה CreatePullRequest מופיעה במאמר דוגמאות.

פעולת UpdatePullRequest

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

פרמטרים של קלט בפעולה UpdatePullRequest

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה של המאגר.
PullRequestId String כן המזהה של בקשת המיזוג.
כותרת String לא השם של ה-pull request.
תיאור String לא תיאור בקשת המיזוג.
סטטוס String לא הסטטוס של בקשת המיזוג.
TargetRefName String לא השם של ענף היעד של בקשת המיזוג. האפשרות הזו זמינה רק כשהתכונה 'טירגוט מחדש של יחסי ציבור' מופעלת.
CompletionOptions String לא אפשרויות שמשפיעות על אופן המיזוג של בקשת המשיכה כשהיא תושלם.
MergeOptions String לא אפשרויות שמשמשות כשמריצים את מיזוג בקשת המשיכה.
AutoCompleteSetById String לא המזהה של המשתמש שהפעיל את ההשלמה האוטומטית.

דוגמה להגדרת הפעולה UpdatePullRequest מופיעה במאמר דוגמאות.

פעולת GetPullRequestCommits

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

פרמטרים של קלט לפעולה GetPullRequestCommits

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה של המאגר.
PullRequestId String כן מזהה ה-pull request.

דוגמה להגדרת הפעולה GetPullRequestCommits מופיעה במאמר דוגמאות.

פעולה AddBuildTag

הפעולה הזו מוסיפה תג ל-build.

פרמטרים של קלט לפעולה AddBuildTag

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
BuildId String כן המזהה של הגרסה.
תג String כן התג שרוצים להוסיף לבנייה.

דוגמה להגדרת הפעולה AddBuildTag מופיעה במאמר דוגמאות.

פעולת DeleteBuildTag

הפעולה הזו מוחקת תג מגרסת build.

פרמטרים של קלט לפעולה DeleteBuildTag

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
BuildId String כן המזהה של הגרסה.
תג String כן התג שרוצים להסיר מהגרסה.

דוגמה להגדרת הפעולה DeleteBuildTag מופיעה במאמר דוגמאות.

פעולת DownloadBuildReports

הפעולה הזו מורידה דוחות של בנייה.

פרמטרים של קלט לפעולה DownloadBuildReports

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
BuildId מספר שלם כן המזהה של הגרסה.
FileLocation String לא המיקום של הקובץ.
קידוד String לא סוג הקידוד של הקלט FileData. הערכים המותרים הם NONE ו-BASE64. ערך ברירת המחדל הוא BASE64.
FileStream String לא מופע של זרם פלט שבו נכתבים נתונים של קובץ. הפרמטר הזה משמש רק אם לא צוין FileLocation.

דוגמה להגדרת הפעולה DownloadBuildReports מופיעה במאמר דוגמאות.

פעולת DownloadBuildLogs

הפעולה הזו מורידה את יומני הבנייה.

פרמטרים של קלט לפעולה DownloadBuildLogs

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String כן המזהה של פרויקט Azure DevOps.
BuildId מספר שלם כן המזהה של הגרסה.
LogId מספר שלם כן המזהה של היומן.
StartLine מספר שלם לא השורה הראשונה של הגרסה.
EndLine מספר שלם לא השורה האחרונה ב-build.
FileLocation String לא המיקום של הקובץ.
קידוד String לא סוג הקידוד של הקלט FileData. הערכים המותרים הם NONE ו-BASE64. ערך ברירת המחדל הוא BASE64.
FileStream String לא מופע של זרם פלט שבו נכתבים נתונים של קובץ. הפרמטר הזה משמש רק אם לא צוין FileLocation.

דוגמה להגדרת הפעולה DownloadBuildLogs מופיעה במאמר דוגמאות.

פעולת UpdateUser

הפעולה הזו מעדכנת את פרטי המשתמש.

פרמטרים של קלט לפעולה UpdateUser

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

דוגמה להגדרת הפעולה UpdateUser מופיעה במאמר דוגמאות.

פעולת CloneTestPlan

הפעולה הזו משכפלת תוכנית בדיקה.

פרמטרים של קלט לפעולה CloneTestPlan

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String לא המזהה של פרויקט Azure DevOps.
DeepClone בוליאני לא הפעולה הזו משכפלת גם את כל תרחישי הבדיקה המשויכים.
CloneRequirements בוליאני לא אם הערך הוא True, הדרישות משוכפלות. ערך ברירת המחדל הוא False.
CopyAllSuites בוליאני לא העתקה של כל החבילות מתוכנית מקור.
CopyAncestorHierarchy בוליאני לא מעתיקים את ההיררכיה של הרכיבים הקודמים.
DestinationWorkItemType String לא השם של סוג פריט העבודה של השיבוט.
OverrideParameters String לא צמדי מפתח/ערך שבהם הערך של כל מפתח מוחלף בערך שצוין.
RelatedLinkComment String לא הוספת תגובה לתוכנית הבדיקה המשוכפלת.
DestinationPlanAreaPath String לא האזור בתוכנית הבדיקה.
DestinationPlanBuildId String לא גרסת build לבדיקה.
DestinationPlanDescription String לא תיאור תוכנית הבדיקה.
DestinationPlanEndDate String לא תאריך הסיום של תוכנית הבדיקה.
DestinationPlanIteration String לא נתיב האיטרציה של תוכנית הבדיקה.
DestinationPlanName String כן השם של תוכנית הבדיקה.
DestinationPlanOwnerId String לא מזהה המשתמש של הבעלים של תוכנית הבדיקה.
DestinationPlanProject String לא שם הפרויקט של היעד.
DestinationPlanStartDate String לא תאריך ההתחלה של תוכנית הבדיקה.
DestinationPlanState String לא המצב של תוכנית הבדיקה.
DestinationPlanSync בוליאני לא מציין איך בדיקות כפולות בחבילות בתוכנית בדיקה צריכות להתנהג.
SourceTestPlanId מספר שלם כן המזהה של תוכנית הבדיקה של המקור.
SourceTestPlanSuiteId מספר שלם לא רשימה מופרדת בפסיקים של מזהי חבילות בדיקה לשכפול בתוך תוכנית הבדיקה של המקור.

דוגמאות להגדרת הפעולה CloneTestPlan מופיעות במאמר דוגמאות.

פעולה CloneTestSuite

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

פרמטרים של קלט לפעולה CloneTestSuite

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String לא המזהה של פרויקט Azure DevOps.
DeepClone בוליאני לא משכפל את כל תרחישי הבדיקה המשויכים.
CloneRequirements בוליאני לא אם הערך הוא True, הדרישות משוכפלות. ערך ברירת המחדל הוא False.
CopyAllSuites בוליאני לא העתקה של כל החבילות מתוכנית מקור.
CopyAncestorHierarchy בוליאני לא העתקה של היררכיית האב.
DestinationWorkItemType String לא השם של סוג פריט העבודה עבור השיבוט.
OverrideParameters String לא צמדי מפתח/ערך שבהם הערך של כל מפתח מוחלף בערך שצוין.
RelatedLinkComment String לא הוספת תגובה לחבילת מקרים לבדיקה המשוכפלת.
DestinationTestSuiteId מספר שלם כן המזהה של חבילת מקרים לבדיקה של היעד.
DestinationProjectName String לא שם הפרויקט ביעד.
SourceTestSuiteId מספר שלם כן המזהה של חבילת מקרים לבדיקה המקורית.

דוגמה להגדרת הפעולה CloneTestSuite מופיעה במאמר דוגמאות.

פעולת CloneTestCase

הפעולה הזו משכפלת את פרטי תרחיש הבדיקה.

פרמטרים של קלט לפעולה CloneTestCase

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String לא המזהה של פרויקט Azure DevOps.
IncludeAttachments בוליאני לא כולל קבצים מצורפים של תרחיש בדיקה אם הערך הוא True. ערך ברירת המחדל הוא False.
IncludeLinks בוליאני לא אם המדיניות מוגדרת כ-True, הקישורים נכללים. ערך ברירת המחדל הוא False.
RelatedLinkComment String לא כדי להוסיף תגובה לתרחיש הבדיקה המשוכפל.
DestinationTestPlanId מספר שלם כן המזהה של תוכנית הבדיקה של היעד.
DestinationTestSuiteId מספר שלם כן המזהה של חבילת מקרים לבדיקה של היעד.
SourceTestPlanId מספר שלם כן המזהה של תוכנית הבדיקה של המקור.
SourceTestSuiteId מספר שלם כן המזהה של חבילת מקרים לבדיקה המקורית.
TestCaseId מספר שלם כן רשימה מופרדת בפסיקים של מזהי תרחישי בדיקה לשכפול.

דוגמה להגדרת הפעולה CloneTestCase מופיעה במאמר דוגמאות.

פעולת DeletePullRequestAttachment

הפעולה הזו מוחקת את פרטי הקובץ המצורף לבקשת המיזוג.

הזנת פרמטרים של הפעולה DeletePullRequestAttachment

שם הפרמטר סוג נתונים חובה תיאור
ProjectId String לא המזהה של פרויקט Azure DevOps.
RepositoryId String כן המזהה של המאגר.
PullRequestId מספר שלם כן המזהה של בקשת המיזוג.
FileName String כן השם של הקובץ המצורף.

דוגמה להגדרת הפעולה DeletePullRequestAttachment מופיעה במאמר דוגמאות.

דוגמאות לפעולות

דוגמה – יצירת פריט עבודה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CreateWorkItem ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }
    4. אם הפעולה מצליחה, לפרמטר התגובה CreateWorkItem של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{
"Success": "True"
}]

כדי ליצור ישויות שונות כמו משימה, סיפור אפי, סיפור משתמש, תרחיש בדיקה, תכונה ובעיה, צריך רק לשנות את הערך של השדה Type (סוג) במטען הייעודי (payload) של הקלט.
כדי להגדיר את הסוג כ-Epic, אפשר להגדיר את "Type": "Epic". באופן דומה, אפשר לשנות את הערך ל-Type: Task,‏ Type: User Story,‏ Type: Test Case,‏ Type: Feature או Type: Issue כדי ליצור את הישות המתאימה.

דוגמה – עדכון פריט עבודה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdateWorkItem ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }

    4. אם הפעולה מצליחה, לפרמטר התגובה UpdateWorkItem של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{
"Success": "True"
}]

דוגמה – קבלת בקשת משיכה של קומיט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetPullRequestCommits ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }

    4. אם הפעולה מצליחה, לפרמטר התגובה GetPullRequestCommits של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "CommitId": "7299b6623d7d146751d8cf280af301f9a345ff05", "AuthorName": "jeffersonloveshi.k", "AuthorEmail": "jeffersonloveshiking@gmail.com", "AuthoredDate": "2024-08-12 11:25:23.0", "CommitterName": "lakshminarayana.k", "CommitterEmail": "jeffersonloveshiking@gmail.com", "CommittedDate": "2024-08-12 11:25:23.0", "Comment": "Added sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/7299b6623d7d146751d8cf280af301f9a345ff05" } ]

דוגמה – שליחת שינויים למאגר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה PushChanges ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "BranchRefName": "refs/heads/US_Googlecloud_Push1", "OldObjectId": "4d66aafb75efda2bbdda7a2b609b152b1b715b7e", "CommitComment": "Googlecloud PUSH Changes", "ChangesAggregate": "{\n \"changeType\": \"edit\",\n \"item\": {\n \"path\": \"/tasks.md\"\n },\n \"newContent\": {\n \"content\": \"# Tasks\\n\\n* Item 1\\n* Item 2\",\n \"contentType\": \"rawtext\"\n }\n }" }

    4. אם הפעולה מצליחה, לפרמטר התגובה PushChanges של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "NewObjectId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitTreeId": "7e7394dcfc5b4d4cf2c8c21d70a96fe34f8eaf3e", "AuthorName": "Charlie Cruz", "AuthorEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "AuthoredDate": "2024-11-19 07:04:42.0", "CommitterName": "Charlie Cruz", "CommitterEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "CommittedDate": "2024-11-19 07:04:42.0", "CommitUrl": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/commits/949e4710336bc5bdc779ca6b334e029c2f50a029", "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "RepositoryName": "refs/heads/US_Googlecloud_Push1", "PushId": "193", "PushDate": "2024-11-19T07:04:42.5793751Z", "PushURL": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/pushes/193" } ]

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadReleaseLogs ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }

    4. אם הפעולה מצליחה, לפרמטר התגובה DownloadReleaseLogs של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "FileData": "{Base64encodedvalue}]

דוגמה – הורדה של קובץ מצורף של תוצאת בדיקה או הרצה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadTestAttachment ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }

    4. אם הפעולה מצליחה, לפרמטר התגובה DownloadTestAttachment של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "FileData": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAABlSURBVDhP7cxBCsAgDERR739pG/CnGJI0FopQ8O2cjNP6R85QbeNQU7wT1dkijaQ3vkZoWElaoTeJojW01cYh0jwfgiFBV/lEjOZtacijN/nLkOBHhIaVDgn+Wdycp6FXzlCl9wt0Y0cAzHo/zgAAAABJRU5ErkJggg==" } ]

דוגמה – הגדרת מאפייני פרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SetProjectProperties ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }

    4. אם הפעולה מצליחה, לפרמטר התגובה SetProjectProperties של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success" } ]

דוגמה – מחיקת תרחיש בדיקה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeleteTestCase ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }

    4. אם הפעולה מצליחה, לפרמטר התגובה DeleteTestCase של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success" } ]

דוגמה – הפעלת צינור עיבוד נתונים בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה RunPipeline ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "PipelineId": 7, "Resources": "{\n \"repositories\": {\n \"self\": {\n \"refName\": \"refs/heads/main\" // Specify the branch or tag\n }\n }\n }" }
    4. אם הפעולה מצליחה, לפרמטר התגובה RunPipeline של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "State": "inProgress", "RunId": "16", "RunName": "20241113.2", "RunHref": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/pipelines/7/runs/16", "CreatedDate": "2024-11-13 12:07:38.9237296" } ]

דוגמה – עדכון בקשת מיזוג

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdatePullRequest ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": "26", "Description": "updated pull req", "Title": "Googlecloud M pull request" }

    4. אם הפעולה מצליחה, לפרמטר התגובה UpdatePullRequest של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "PullRequestId": 26 } ]

דוגמה – יצירת בקשת מיזוג

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CreatePullRequest ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "Title": "Googlecloud M pull request", "SourceRefName": "refs/heads/Test_Branch", "TargetRefName": "refs/heads/main" }

    4. אם הפעולה מצליחה, לפרמטר התגובה CreatePullRequest של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "PullRequestId": 26 } ]

דוגמה – קבלת קומיט של בקשת מיזוג

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetPullRequestCommits ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }

    4. אם הפעולה מצליחה, לפרמטר התגובה GetPullRequestCommits של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "CommitId": "ebb720c5b93c52341cb86ccfb42258bb562a8406", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:24:19.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:24:19.0", "Comment": "Updated sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/ebb720c5b93c52341cb86ccfb42258bb562a8406" }, { "CommitId": "353f74b48ada83111449b922f4660a338e058989", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:23:01.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:23:01.0", "Comment": "Updated bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/353f74b48ada83111449b922f4660a338e058989" }, { "CommitId": "50a74dee46f8bcad4637d730994144f944c7d589", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:21:59.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:21:59.0", "Comment": "Added bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/50a74dee46f8bcad4637d730994144f944c7d589" }, { "CommitId": "9813f562b0548144006f773314704db274c757c4", "AuthorName": "Alex amal", "AuthorEmail": "cloudysanfrancisco@gmail.com", "AuthoredDate": "2024-11-26 11:19:29.0", "CommitterName": "Alex amal", "CommitterEmail": "cloudysanfrancisco@gmail.com", "CommittedDate": "2024-11-26 11:19:29.0", "Comment": "hello", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/9813f562b0548144006f773314704db274c757c4" } ]

דוגמה – הוספת תג build

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddBuildTag ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }

    4. אם הפעולה מצליחה, לפרמטר התגובה AddBuildTag של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{ "Status": "Success" }]

דוגמה – מחיקת תג build

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeleteBuildTag ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}

    4. אם הפעולה מצליחה, לפרמטר התגובה DeleteBuildTag של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{ "Status": "Success" }]

דוגמה – הורדת דוח בנייה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadBuildReports ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }

    4. אם הפעולה מצליחה, לפרמטר התגובה DownloadBuildReports של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "FileData": "Base64-format data" } ]

דוגמה – הורדת יומני בנייה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadBuildLogs ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }

    4. אם הפעולה מצליחה, לפרמטר התגובה DownloadBuildLogs של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success", "FileData": "Base64-format data" } ]

דוגמה – עדכון משתמש

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UpdateUser ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "UserId": "088a8c28-1b83-4538-9c74-b7ca97eb4ef2", "Op": "add", "Path": "/projectEntitlements/50fac9d4-37aa-4a13-a81a-887d12be7b9f", "Value": "{ \"projectRef\": {\n \"id\": \"50fac9d4-37aa-4a13-a81a-887d12be7b9f\",\n \"name\": \"Postman_Testing_Project\"\n }, \n \"group\": {\n \"groupType\": \"projectContributor\"\n }}" }

    4. אם הפעולה מצליחה, לפרמטר התגובה Update User של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "Status": "Success" } ]

דוגמה – שכפול של תוכנית בדיקה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CloneTestPlan ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "CloneRequirements": true, "CopyAllSuites": true, "RelatedLinkComment": "Cloned from existing test plan googlecloud", "DestinationPlanName": "TestPlan 2", "DestinationPlanAreaPath": "GCPTesting_New_Project", "DestinationPlanIteration": "GCPTesting_New_Project", "DestinationPlanProject": "GCPTesting_New_Project", "SourceTestPlanId": 1, "CopyAncestorHierarchy": true }

    4. אם הפעולה מצליחה, לפרמטר התגובה CloneTestPlan של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "CloneOperationId": null, "CloneOperationState": "queued", "sourcetestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestplan_project_name": "GCPTesting_New_Project", "sourcetestplan_project_state": "unchanged", "sourcetestplan_project_visibility": "unchanged", "sourcetestplan_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestplan_id": "1", "sourcetestplan_name": "Test Plan 1", "destinationtestplan_id": "15", "destinationtestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestplan_project_name": "GCPTesting_New_Project", "destinationtestplan_project_state": "unchanged", "destinationtestplan_project_visibility": "unchanged", "destinationtestplan_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestplan_updateddate": "2025-01-07T14:02:31.247Z", "destinationtestplan_updatedby_displayname": "Charlie Cruz", "destinationtestplan_updatedby_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_updatedby_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_rootsuite_id": "16", "destinationtestplan_rootsuite_name": "TestPlan 2", "destinationtestplan__links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15", "destinationtestplan__links_clienturl_href": "mtms://dev.azure.com:443/sunitavenkata2024/p:GCPTesting_New_Project/Testing/testplan/connect?id=15", "destinationtestplan__links_rootsuite_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15/Suites/16", "destinationtestplan_revision": "1", "destinationtestplan_name": "TestPlan 2", "destinationtestplan_areapath": "GCPTesting_New_Project", "destinationtestplan_startdate": "2025-01-07T14:02:31.0878913Z", "destinationtestplan_enddate": "2025-01-14T14:02:31.0878913Z", "destinationtestplan_iteration": "GCPTesting_New_Project", "destinationtestplan_owner_displayname": "sunita m V", "destinationtestplan_owner_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_owner_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_state": "Active", "destinationtestplan_testoutcomesettings_syncoutcomeacrosssuites": "false", "cloneoptions_relatedlinkcomment": "Cloned from existing test plan gcp", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "true", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/0" } ]

דוגמה – שכפול של חבילת מקרים לבדיקה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CloneTestSuite ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
    4. אם הפעולה מצליחה, לפרמטר התגובה CloneTestSuite של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "CloneOperationId": 2, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_id": "18", "sourcetestsuite_name": "Test Plan 3", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "2", "destinationtestsuite_name": "Test Plan 1", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "false", "cloneoperationresponse_opid": "2", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Suites/CloneOperation/2" } ]

דוגמה – שכפול של תרחיש בדיקה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CloneTestCase ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }

    4. אם הפעולה מצליחה, לפרמטר התגובה CloneTestCase של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [ { "CloneOperationId": 3, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_testcaseids": "3", "sourcetestsuite_id": "2", "sourcetestsuite_name": "Test Plan 1", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "21", "destinationtestsuite_name": "Test Plan 4", "cloneoptions_includelinks": "false", "cloneoptions_includeattachments": "false", "cloneoperationresponse_opid": "3", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/3" } ]

דוגמה – מחיקת קובץ מצורף לבקשת מיזוג

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeletePullRequestAttachment ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }
    4. אם הפעולה מצליחה, היא מחזירה הודעת אישור של DeletePullRequestAttachment, והערך של פרמטר התגובה connectorOutputPayload של המשימה DeletePullRequestAttachment יהיה דומה לזה:

    [ { "Status": "Success" } ]

דוגמאות לפעולות על ישויות

אחזור כל לוחות הבקרה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Dashboards מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. בקטע Task Input של המשימה Connectors, אפשר להגדיר את filterClause בהתאם לדרישות הלקוח. אפשר לעיין בהערה שבהמשך

    5. הערך של filterClause צריך תמיד להיות מועבר בתוך מירכאות בודדות (') בפורמט הזה.
    אפשר להשתמש ב-filterClause כדי לסנן קבוצה מסוימת של רשומות על סמך עמודות כלשהן.

דוגמה – אחזור לוח בקרה יחיד באמצעות המזהה שלו

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Dashboards מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות לערך '2f671e29-e48f-4d26-8869-859e154b5f20', שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "2f671e29-e48f-4d26-8869-859e154b5f20" בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

    את הערך של מזהה הישות צריך להעביר ישירות, למשל "2f671e29-e48f-4d26-8869-859e154b5f20". בדוגמה הזו, הערך הייחודי של המפתח הראשי הוא '2f671e29-e48f-4d26-8869-859e154b5f20', והוא מועבר.

    במקרים מסוימים, העברה של מזהה ישות יחיד עלולה לגרום לשגיאה כי לישות יש שני מפתחות מורכבים. במקרים כאלה, אפשר להשתמש ב-filterClause ולהעביר את הערך, למשל id='2f671e29-e48f-4d26-8869-859e154b5f20'.

דוגמה – הסרת לוח בקרה באמצעות המזהה שלו

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Dashboards מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות לערך '2f671e29-e48f-4d26-8869-859e154b5f20', שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "2f671e29-e48f-4d26-8869-859e154b5f20" בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

    אם לישות יש שני מפתחות עסקיים מורכבים או שני מפתחות ראשיים, במקום לציין את entityId, אפשר להגדיר את filterClause ל- id='2f671e29-e48f-4d26-8869-859e154b5f20'.

דוגמה – יצירת לוח בקרה חדש בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Dashboard מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "a2402c49-6c17-43a9-bfc4-3701d07bcfee" }

דוגמה – יצירת הרשאה חדשה למשתמש בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Users מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "5e373a81-073d-4d64-a2c5-23d0b6cc287f" }

דוגמה – יצירת שאילתה חדשה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Queries מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "New Queries Googlecloud", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "IsFolder": true, "Wiql": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] = 'New' ORDER BY [System.ChangedDate] DESC", "ParentQueryId": "df947cf9-dbbe-43bc-93a4-3e4d7287adb8" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "cf4a25e8-d2d2-48b7-a483-dd901c78293b" }

דוגמה – יצירת צינור חדש בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Pipelines מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": 9 }

דוגמה – יצירת קבוצת פריסה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות DeploymentGroups מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "Deployment group 2 Googlecloud" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": 139 }

דוגמה – יצירת הגדרת בדיקה חדשה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestPlan מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "Googlecloud_TestPlan" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": 106 }

דוגמה – יצירת חבילת מקרים לבדיקה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestSuite מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": 22264 }

דוגמה – יצירת הרצת בדיקה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestRun מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "TestRun_Googlecloud1"}

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": 46 }

דוגמה – יצירת פרויקט חדש

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Projects מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של המשימה Projects יהיה ערך שדומה לזה:

    { "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }

    5. המזהה שנוצר אחרי ביצוע הפעולה Create בפרויקט הוא לא מזהה הפרויקט בפועל.
    כדי לאחזר את הפרטים המדויקים של הפרויקט, צריך לבצע את פעולת הרשימה עם שם הפרויקט כתנאי סינון, למשל Name= 'Google Project Integration'.

דוגמה – יצירת צוות בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Teams מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "M new team"}

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }

דוגמה – יצירת סביבה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Environments מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "9" }

דוגמה – יצירת ווידג'ט חדש במרכז בקרה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Widgets מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "Name": "Widget 2", "DashboardId": "6cb82f8d-393c-422e-b4e3-563d5e34fc31", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1", "RowPosition": 4, "ColumnPosition": 4, "RowSpanSize": 1, "ColumnSpanSize": 2, "ContributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.OtherLinksWidget" }

    בדוגמה הזו אפשר לראות איך מוסיפים ווידג'טים. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לערך הבא:

    { "Id": "7d049ae2-d995-4b3e-9ebd-662d94a53cc8" }

דוגמה – הוספת בודק לבקשת משיכה במאגר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות PullRequestReviewers מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "PullRequestId": null }

דוגמה – יצירת קבוצת משתנים בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות VariableGroups מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {
  "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc",
  "Type": "Vsts",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"Variable Group new test\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"Googlecloud-Demo-Project\"\n      }\n    }\n  ]",
  "Name": "Variable Group new test"
}

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {"Id": "12"}

דוגמה – יצירת הגדרת build חדשה במאגר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות BuildDefinition מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    {"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {"Id": "25"}

דוגמה – יצירת גרסה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Releases מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload כמשתנה מקומי. 
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    { "Id": "13" }

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Teams מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "M new team update" }
  5. מגדירים את מזהה הישות במיפוי הנתונים לישות של Teams. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 5285fb98-a1bc-42e1-9668-3c2780061367.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }

דוגמה – עדכון שאילתה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Queries מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Update Queries" }
  5. מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של השאילתות. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 81797017-624d-4967-bc85-842a817bff48.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "81797017-624d-4967-bc85-842a817bff48" }

דוגמה – עדכון לוח בקרה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Dashboard מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": " update from googlecloud" }
  5. מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של לוח הבקרה. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 139.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "139" }

דוגמה – עדכון של חבילת מקרים לבדיקה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestSuite מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "UPdated_Suite", "ParentSuiteId": 108 }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של TestSuite. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 22264.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "22264" }

דוגמה – עדכון של קבוצת פריסה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות DeploymentGroups מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Deployment" }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של DeploymentGroups. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 138.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "138" }

דוגמה – עדכון של תוכנית בדיקה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestPlan מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "TestPlan_Update" }
  5. מגדירים את מזהה הישות בכלי למיפוי נתונים לישות של TestPlan. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 104.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "104" }

דוגמה – עדכון של הרצת בדיקה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות TestRuns מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של TestRuns. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך 46.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "46" }

דוגמה – עדכון פרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Projects מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Projects Update" }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של הפרויקטים. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }

דוגמה – עדכון סביבה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Environments מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Environment Update M", "Description": "Update environment " }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של Environments. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך { "Id": "9" }.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": 9 }

דוגמה – עדכון קבוצת משתנים בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות VariableGroups מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"New VariableGroup googlecloud updated\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"GoogleCloud-Demo-Project\"\n      }\n    }\n  ]",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "Name": "Variable Group new test updated"
}
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של VariableGroups. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך { "Id": "12" }.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": 12 }

דוגמה – עדכון הגדרת build בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות BuildDefinition מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של BuildDefinition. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": 25 }

דוגמה – עדכון של בודק בקשת מיזוג בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות PullRequestReviewers מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    {"isFlagged": true}
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של PullRequestReviewers. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81","PullRequestId": null}

דוגמה – עדכון של מהדורה בפרויקט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Releases מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי. 
    { "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
  5. מגדירים את מזהה הישות ב-Data Mapper לישות של הגרסאות. כדי להגדיר את מזהה הישות, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים באפשרות EntityId/ConnectorInputPayload/FilterClause כמשתנה מקומי.

    במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך {"Id": 13}.

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {"Id": 13 }

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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