הגדרת מאגר נתונים של Jira Cloud

בדף הזה מוסבר איך ליצור מאגר נתונים ולקשר את Jira Cloud ל-Gemini Enterprise.

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

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

יצירת מאגר נתונים ב-Jira Cloud

כדי ליצור מאגר נתונים ב-Jira Cloud:

  1. במסוף Google Cloud , עוברים לדף Gemini Enterprise.

    ‫Gemini Enterprise

  2. בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. לוחצים על יצירת מאגר נתונים.

  5. בקטע מקור, מחפשים את Jira Cloud ולוחצים על בחירה.

  6. בקטע נתונים:

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

    2. לוחצים על Continue.

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

      1. צריך לספק את פרטי האימות הבאים:

        • מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
        • סוד הלקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0 שלכם.
        • URI של המכונה: כתובת ה-URL הבסיסית של המכונה שלכם ב-Jira Cloud (לדוגמה, https://your-domain.atlassian.net).
        • ‫Instance ID: מזהה ייחודי של מופע Jira Cloud.

        מידע נוסף על קבלת פרטי הכניסה האלה זמין במאמר בנושא הגדרת Jira Cloud.

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

      3. לוחצים על Continue.

    4. בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Jira Cloud.

    5. לוחצים על Continue.

    6. בקטע Entities to search (אם בחרתם באפשרות Federated search) או Entities to sync (אם בחרתם באפשרות הטמעת נתונים):

      1. בוחרים את כל הישויות הנדרשות.
      2. אם בחרתם באפשרות חיפוש מאוחד, ממשיכים לשלב הבא.
      3. אם בחרתם באפשרות העברת נתונים, ממשיכים לשלבים הבאים:
        1. אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
          1. לוחצים על סינון.
          2. כדי לסנן ישויות מהאינדקס, בוחרים באפשרות החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, בוחרים באפשרות הכללה באינדקס.
          3. מזינים את מפתח הפרויקט. מקישים על Enter אחרי כל מפתח פרויקט. מידע נוסף על השגת מפתח הפרויקט זמין במאמר השגת מפתח הפרויקט.
          4. לוחצים על Save.
        2. כדי להגדיר את תזמון הסנכרון:
          1. ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
            • כדי לתזמן סנכרון מלא נפרד של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ואז בוחרים באפשרות אפשרויות בהתאמה אישית.
          2. ברשימה Incremental sync frequency (תדירות הסנכרון המצטבר), בוחרים את תדירות הסנכרון המצטבר. מידע נוסף זמין במאמר בנושא תזמון סנכרון.

  7. לוחצים על Continue.

  8. בקטע פעולות:

    • אם בחרתם באפשרות חיפוש מאוחד, בקטע בחירת פעולות ב-Jira Cloud להפעלה, בוחרים את הפעולות שרוצים להפעיל במאגר הנתונים.

    • אם בחרתם באפשרות העברת נתונים:

      1. בקטע הגדרות אימות:

        1. מזינים את פרטי האימות הבאים:
          • מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
          • סוד הלקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0 שלכם.
          • URI של המכונה: כתובת ה-URL הבסיסית של המכונה שלכם ב-Jira Cloud (לדוגמה, https://your-domain.atlassian.net).
          • ‫Instance ID: מזהה ייחודי של מופע Jira Cloud.

        מידע נוסף על פרטי הכניסה זמין במאמר הגדרת Jira Cloud.

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

      2. לוחצים על Continue.

      3. בקטע Select Jira Cloud actions to enable (בחירת פעולות ב-Jira Cloud להפעלה), בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.

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

  9. לוחצים על Continue.

  10. בקטע Configuration (הגדרה):

    1. ברשימה מספר אזורים, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה Your data connector name (השם של מחבר הנתונים), מזינים שם למחבר.
    3. אם בחרתם במיקום us או eu, צריך להגדיר את הגדרות ההצפנה:
      • אופציונלי: אם לא הגדרתם מפתחות של אזור יחיד, לוחצים על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר רישום מפתח של אזור יחיד למחברים של צד שלישי.
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות מפתח Cloud KMS:
        • ברשימה Key management type, בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key בוחרים את המפתח.
      מידע נוסף זמין במאמר בנושא מפתחות הצפנה בניהול הלקוח.

  11. לוחצים על Continue.

  12. בקטע Billing, בוחרים באפשרות General pricing או Configurable pricing. מידע נוסף זמין במאמרים אימות סטטוס החיוב של הפרויקטים ורישיונות.

  13. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.

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

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

אחרי שיוצרים את מאגר הנתונים, צריך ליצור אפליקציה, לקשר אותה למאגר הנתונים של Jira Cloud ולתת הרשאה ל-Gemini Enterprise לגשת ל-Jira Cloud לפני שמריצים שאילתות.

הפעלת סנכרון בזמן אמת להעברת נתונים

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

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

כדי להפעיל סנכרון בזמן אמת למאגר נתונים של Jira Cloud, פועלים לפי השלבים הבאים:

יצירת webhook URL

  1. עוברים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
  2. בוחרים מאגר נתונים של Jira Cloud.

  3. לוחצים על הצגה/עריכה בשורה סנכרון בזמן אמת.

  4. בתיבת הדו-שיח View and edit realtime sync parameters (הצגה ועריכה של פרמטרים של סנכרון בזמן אמת), מבצעים את הפעולות הבאות:

    1. כדי להפעיל את הסנכרון בזמן אמת, לוחצים על המתג הפעלת סנכרון בזמן אמת.
    2. מזינים ערך בשדה Client secret (סוד לקוח) ומעתיקים אותו. תצטרכו את הערך הזה שוב כשתיצרו webhook במסוף הניהול של Jira.
    3. לוחצים על Save.

  5. אחרי שהסטטוס של סנכרון בזמן אמת משתנה ל-Running, לוחצים על הצגה/עריכה.

  6. בתיבת הדו-שיח View and edit realtime sync parameters (הצגה ועריכה של פרמטרים של סנכרון בזמן אמת), מבצעים את הפעולות הבאות:

    1. מעתיקים את Webhook URL.
    2. לוחצים על Close.

יצירת webhook

  1. נכנסים למסוף הניהול של Jira.
  2. לוחצים על הגדרות ובוחרים באפשרות מערכת.
  3. בחלונית System settings (הגדרות המערכת), בוחרים באפשרות Webhooks (ווּבְהוּקים).
  4. לוחצים על יצירת webhook. מידע על webhooks זמין במאמר Webhooks.
  5. מזינים שם ל-webhook.
  6. בוחרים את הסטטוס Enabled.
  7. בשדה URL, מדביקים את כתובת ה-URL שהועתקה מ-Gemini Enterprise ומוסיפים את התו /{issue.id}.

  8. בשדה Secret, מזינים את אותו ערך שהזנתם כשייצרתם כתובת URL של webhook ב-Gemini Enterprise.

  9. בקטע Issue related events, בוחרים באפשרויות הבאות:

    ישויות נוצר מעודכן נמחק
    שגיאה כן כן כן
    יומן עבודה כן כן כן
    תגובה כן כן כן
    הקובץ המצורף כן לא כן

  10. בקטע Project related events, מסמנים את תיבות הסימון created,‏ updated ו-deleted עבור הישות Project.

  11. לוחצים על יצירה.

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

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

ביצוע שאילתה

אחרי שמאשרים את Jira Cloud ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש שלכם ישירות אל Atlassian API.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

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

  • מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי לחיפוש (Atlassian API).
  • יכול להיות שהצדדים השלישיים האלה יקשרו את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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