Jira Cloud

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

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

המחבר של Jira Cloud משתמש בגרסאות 2 ו-3 של JIRA Cloud REST API. הם מנוהלים באופן פנימי ולא צריך לבצע הגדרות נוספות.

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

לפני שמשתמשים במחבר Jira Cloud, צריך לבצע את המשימות הבאות:

• בפרויקט שלכם ב-Google Cloud:
  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

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

  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

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

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

הגדרת המחבר

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

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

   כניסה לדף Connections

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

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

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

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

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

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   9. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
   • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. יש תמיכה בסוגי האימות הבאים:
     • בסיסי: אימות HTTP בסיסי.
     • ‫Digest: אימות HTTP מסוג Digest.
   • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
   • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
   • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. יש תמיכה בסוגי האימות הבאים:
     • ‫Auto (אוטומטי): הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
     • תמיד: החיבור תמיד מופעל באמצעות SSL.
     • לעולם לא: החיבור לא מופעל באמצעות SSL.
     • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
   • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
     1. לוחצים על + הוספת יעד.
     2. בוחרים סוג יעד.
        • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

          • יוצרים קובץ מצורף לשירות PSC.
          • יוצרים נקודת הקצה של הקישור ואז מזינים את הפרטים שלו בשדה Host address.
   10. אם רוצים, אפשר ללחוץ על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   11. לוחצים על הבא.
5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
   1. סוג היעד: בוחרים סוג יעד.
      • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.
        הערה: אם מציינים שם מארח, צריך לציין את כתובת ה-URL יחד עם הפרוטוקול (HTTP או HTTPS).

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

        • יוצרים קובץ מצורף לשירות PSC.
        • יוצרים נקודת הקצה של הקישור ואז מזינים את הפרטים שלה בשדה Host address.

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

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

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

      • שם משתמש וסיסמה

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

   2. לוחצים על הבא.
7. אם הפעלתם את המינוי לאירועים, הקטע פרטי המינוי לאירועים יופיע בדף ליצירת החיבור. במאמר הגדרת מינוי לאירועים מוסבר איך מגדירים את פרטי המינוי לאירועים.
8. בדיקה: בודקים את פרטי החיבור והאימות.
9. לוחצים על יצירה.

הגדרת מינוי לאירועים

אם הפעלתם את המינוי לאירועים, מזינים את הערכים הבאים בקטע פרטי המינוי לאירועים:

1. בוחרים סוג יעד.
   • כתובת המארח: בשדה מארח, מזינים את כתובת ה-URL של הרישום למערכת העורפית.
2. מזינים את פרטי האימות.
   1. שם משתמש: מזינים את שם המשתמש.
   2. API Token: בוחרים את הסוד ב-Secret Manager שמכיל את הטוקן של ה-API.
   3. Secret Version (גרסת ה-Secret): בוחרים את גרסת ה-Secret.
3. בוחרים באפשרות הפעלת קישוריות פרטית כדי ליצור קישוריות מאובטחת בין אפליקציית הקצה העורפי לבין החיבור. אם בוחרים באפשרות הזו, צריך לבצע שלבי הגדרה נוספים אחרי יצירת הקישור. מידע נוסף זמין במאמר בנושא קישוריות פרטית למינוי לאירועים.
4. מזינים את ההגדרה של תור ההודעות המתות. אם מגדירים תיבת דואר להודעות שלא נמסרו, החיבור כותב את האירועים שלא עברו עיבוד אל נושא Pub/Sub שצוין. ממלאים את הפרטים הבאים:
   1. מזהה פרויקט של הודעות שלא ניתן למסור: מזהה הפרויקט ב-Google Cloud שבו הגדרתם את נושא ה-Pub/Sub של הודעות שלא ניתן למסור.
   2. נושא להודעות ללא מוצא: נושא Pub/Sub שבו רוצים לכתוב את הפרטים של האירוע שלא עבר עיבוד.
5. אם רוצים להשתמש בשרת proxy כדי להתחבר לחלק האחורי של האתר (למינוי לאירועים), מזינים את הפרטים הבאים:
1. סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. בוחרים באחד מסוגי האימות הבאים:
   • תמיד: החיבור תמיד מופעל באמצעות SSL להרשמה לאירועים.
   • לעולם לא: החיבור לא מופעל באמצעות SSL למינוי לאירועים.
2. סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. יש תמיכה בסוגי האימות הבאים:
   • בסיסי: אימות HTTP בסיסי.
3. משתמש proxy: מזינים את שם המשתמש שישמש לאימות בשרת ה-proxy.
4. סיסמת ה-Proxy: בוחרים את הסוד של סיסמת המשתמש ב-Secret Manager.
5. Secret version (גרסת ה-Secret): בוחרים את גרסת ה-Secret.
6. בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
   1. לוחצים על + הוספת יעד ואז בוחרים באפשרות כתובת המארח בתור סוג היעד.
   2. מזינים את שם המארח או את כתובת ה-IP של שרת ה-proxy, ואת מספר היציאה של שרת ה-proxy.

הערה: כדי להבין איך אפשר להשתמש במינוי לאירועים בשילובים שלכם, אפשר לעיין במאמר בנושא טריגרים ב-Jira Cloud.

הגדרת אימות

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

• שם משתמש וסיסמה
  • שם משתמש: שם המשתמש ב-Jira Cloud שבו ישתמשו לחיבור.
  • אסימון API: הסיסמה לשם המשתמש תהיה אסימון API. בוחרים את הסוד ב-Secret Manager שמכיל את טוקן ה-API שמשויך לשם המשתמש ב-Jira Cloud.
• OAuth 2.0 – קוד הרשאה
• Client ID: מזהה הלקוח כפי שסופק על ידי האפליקציה החיצונית.
• היקפי הרשאות: היקפי הרשאות. כדי ליצור חיבור, צריך להגדיר את ההיקפים offline_access ו-read:jira-user. כדי להבין איך ההיקפים פועלים ולראות את כל ההיקפים הזמינים ב-Jira Cloud, אפשר לעיין במאמר היקפים.
• סוד לקוח: בוחרים באפשרות Secret Manager secret. צריך ליצור את ה-Secret Manager secret לפני שמגדירים את ההרשאה הזו.
• גרסת סוד: גרסת סוד ב-Secret Manager לסוד הלקוח.
• מזהה Cloud: מציינים את מזהה Cloud של אתר Atlassian. במאמר Cloud ID מוסבר איך מקבלים את מזהה הענן.

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

כשמגדירים את אפליקציית ה-OAuth של צד שלישי, צריך להשתמש בכתובת ה-URI המורשית להפניה אוטומטית (כתובת ה-URL של הקריאה החוזרת):

https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

הערה: אם אתם משתמשים בסוג האימות Authorization code וביצעתם שינויים בהגדרות של אפליקציית Jira Cloud, אתם צריכים להעניק מחדש הרשאת גישה לחיבור שלכם ל-Jira Cloud. במאמר אישור מחדש של קוד הרשאה מוסבר איך לאשר מחדש.

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

1. בדף החיבורים, מאתרים את החיבור החדש.

   שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

2. לוחצים על דרושה הרשאה.

   יוצג לוח עריכת הרשאה.

3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
4. מאמתים את פרטי ההרשאה.
5. לוחצים על Authorize.

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

אישור מחדש של קוד הרשאה

אם אתם משתמשים בAuthorization code סוג אימות וביצעתם שינויים בהגדרות של אפליקציית Jira Cloud, אתם צריכים לאשר מחדש את החיבור ל-Jira Cloud. כדי לחדש את הרשאת הגישה לחיבור:

1. לוחצים על החיבור הרצוי בדף החיבורים.

   ייפתח הדף עם פרטי החיבור.

2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

   אם צריך, מבצעים את השינויים הנדרשים.

4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
6. לוחצים על Authorize.

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

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

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

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

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

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

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

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

בקטע הזה מוסבר איך לבצע חלק מפעולות הישות במחבר הזה.

דוגמה – בעיות ברשימה

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

חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של filterClause, לדוגמה, CreatorEmail = '[e-mail]'. אפשר להשתמש ב-filterClause כדי לסנן רשומות על סמך העמודות.

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

דוגמה – קבלת בעיות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'בעיות' מהרשימה Entity.
3. בוחרים את הפעולה GET ולוחצים על סיום.
4. מגדירים את מזהה הישות ל-10000, שהוא מזהה המפתח שיועבר לבעיות. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 10000 בשדה Default Value.

צריך להעביר את הערך של מזהה הישות ישירות, למשל, 10000. בדוגמה הזו, 10000 הוא ערך המפתח הראשי הייחודי. אפשר לבצע את הפעולה Get רק בישויות עם מפתח ראשי ייחודי.

דוגמה – מחיקת בעיות

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'בעיות' מהרשימה Entity.
3. בוחרים את הפעולה DELETE ולוחצים על סיום.
4. מגדירים את מזהה הישות ל-10000, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 10000 בשדה Default Value.

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

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות IssueTypes מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Name": "task123456",
     "Description": "New description is added."
   }
   

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

   {
     "Id": "10041"
   }
   

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'בעיות' מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

     {
       "IssueTypeName": "Subtask", 
       "ProjectName": "kanban4", 
       "Summary": "Summary Added", 
       "ParentKey": "KN-6" 
     }
   

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

   {
     "Id": 10071.0
   }
   

דוגמה – יצירת ספרינטים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'ספרינטים' מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Name": "PROJ Sprint GCPcloud",
     "State": "future",
     "Goal": null,
     "OriginBoardId": 2.0,
     "StartDate": "2023-06-27 07:06:08",
     "EndDate": "2023-07-27 07:06:08"
   }
   

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

   {
     "Id": 23.0
   }
   

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'הערות' מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "IssueId": 10001.0,
     "Body": "Adding comments to above ID by editing it"
   }
   

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

   {
     "Id": 10023.0,
     "IssueId": null
   }
   

דוגמה – יצירת משתמשים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'משתמשים' מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "GroupName": null,
     "DisplayName": "Charlie",
     "EmailAddress": "[e-mail]",
     "Active": true,
     "TimeZone": null,
     "Locale": "en_US",
     "AccountType": "atlassian"
   }
   

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

   {
     "AccountId": "557058:0a04612c-746d-4d47-a909-71ba797fe228"
   }
   

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Worklogs (יומני עבודה) מהרשימה Entity.
3. בוחרים את הפעולה Create ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "IssueKey": "GJCT-1",
     "Started": "2023-06-10 08:08:08",
     "TimeSpent": "2000"
   }
   

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

   {
     "Id": "41718",
     "IssueId": 10000.0
   }
   

דוגמה – עדכון של IssueTypes

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות IssueTypes מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Name": "NEW_TASK",
     "Description": "New Description"
   }
   

5. מגדירים את מזהה הישות לישות של IssueTypes. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 10038 בשדה Default Value.

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

   {
     "Id": "10038"
   }
   

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'בעיות' מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "AssigneeAccountId": "61d572aa7c6f9800705289a1",
     "AssigneeName": "Charlie c"
   }
   

5. מגדירים את מזהה הישות לישות של הבעיות. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 10024 בשדה Default Value.

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

   {
     "AssigneeDisplayName": "Charlie Cruz"
   }
   

דוגמה – עדכון ספרינטים

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'ספרינטים' מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Name": "PROJ Sprint GCP_Updated",
     "State": "future",
     "StartDate": "2023-06-27 07:06:08",
     "EndDate": "2023-07-27 07:06:08"
   } 
   

5. מגדירים את מזהה הישות לישות של הספרינטים. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 2 בשדה Default Value.

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

   {
   }
   

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות 'הערות' מהרשימה Entity.
3. בוחרים את הפעולה Update ולוחצים על סיום.
4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Name": "PROJ Sprint GCPcloud_Updated",
     "State": "future",
     "StartDate": "2023-06-27 07:06:08",
     "EndDate": "2023-07-27 07:06:08"
   } 
   

5. מגדירים את מזהה הישות לישות של התגובות. כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 2 בשדה Default Value.

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

   {
   }
   

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר	סוג נתונים	חובה	תיאור
proxy_enabled	בוליאני	לא נכון	מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme	ENUM	לא נכון	סוג האימות שמשמש לאימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user	מחרוזת	לא נכון	שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password	SECRET	לא נכון	סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_ssltype	ENUM	לא נכון	סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ‏ ALWAYS, ‏ NEVER, ‏ TUNNEL

שימוש בחיבור ל-Jira Cloud בשילוב

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

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

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

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

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

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