סקירה כללית

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

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

מאגר הנתונים של Jira Cloud תומך בגרסה 2 של Jira Cloud API בארכיטקטורת REST.

פעולות נתמכות

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

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

היקפי ההרשאות הנדרשים

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

היקפי הרשאות קלאסיים

מצב החיבור הרשאה מטרה
חיפוש מאוחד ופעולות מאוחדות read:jira-user, read:jira-work מאפשרת ל-Assistant לאחזר ולהציג תוצאות חיפוש ופרטי משתמשים בזמן אמת.
write:jira-work מאפשרת לעוזר לשנות פריטי עבודה (לדוגמה, לעדכן שדות של בעיות), לנהל הערות או בעיות ולהעלות קבצים מצורפים.
manage:jira-project מאפשרת לעוזר לנהל את הגדרות הפרויקט ב-Jira וליצור אובייקטים חדשים ברמת הפרויקט, כמו גרסאות ורכיבים. נדרש לפעולות של יצירה ועדכון של פרויקטים.
חיפוש מאוחד בלבד read:jira-user, read:jira-work העוזר הדיגיטלי יכול לחפש ולראות בעיות, פרויקטים ופרופילי משתמשים.
העברת נתונים ופעולות read:jira-work מאפשרת ל-Assistant לבצע סריקה רחבה של נתונים וליצור אינדקס של פריטי עבודה.
write:jira-work מאפשר לעוזר לבצע פעולות כתיבה (יצירה, עדכונים, תגובות וקבצים מצורפים) בפריטי עבודה בסביבה שהוזנה.
הטמעת נתונים read:jira-work מאפשר לעוזר הדיגיטלי לסרוק ולאנדקס תוכן ב-Jira כדי שיהיה זמין לחיפוש.

היקפי הרשאות פרטניים

מצב החיבור הרשאה מטרה
חיפוש מאוחד ופעולות מאוחדות write:comment:jira מאפשר למאגר הנתונים לפרסם תגובות או תשובות חדשות ישירות מהממשק של Gemini Enterprise.
write:issue:jira מאפשרת למאגר הנתונים ליצור בעיות חדשות או לבצע עריכות משמעותיות בבעיות קיימות.
write:attachment:jira מאפשר למאגר הנתונים להעלות קבצים מצורפים לבעיות ב-Jira.
write:project:jira מאפשר למאגר הנתונים ליצור ולעדכן פרויקטים ב-Jira.
write:issue-worklog:jira מאפשר למאגר הנתונים ליצור ולעדכן יומני עבודה של בעיות.
write:issue-link:jira מאפשר למאגר הנתונים ליצור ולעדכן קישורים בין בעיות.
read:issue:jira מאפשר למאגר הנתונים לקרוא בעיות.
read:issue-type:jira מאפשר למאגר הנתונים לקרוא סוגי בעיות.
read:comment:jira מאפשר למאגר הנתונים לקרוא תגובות.
read:comment.property:jira מאפשר למאגר הנתונים לקרוא את המאפיינים של התגובות לבעיות.
read:project:jira מאפשרת למאגר הנתונים לקרוא פרויקטים.
read:priority:jira מאפשר למאגר הנתונים לקרוא את סדרי העדיפויות.
read:issue.transition:jira מאפשרת למאגר הנתונים לקרוא מעברים בין סטטוסים של בעיות.
read:issue-meta:jira מאפשר למאגר הנתונים לקרוא את המטא-נתונים של הבעיה.
read:board-scope.admin:jira-software מאפשר למאגר הנתונים לקרוא את ההגדרות האישיות, את תכונות הפרויקט, את המסננים, את המאפיינים ואת המסננים המהירים של לוח.
read:board-scope:jira-software מאפשר למאגר הנתונים לקרוא לוחות, בעיות בלוח, בעיות מתוך backlog, דוחות וגרסאות.
read:issue-details:jira מאפשר למאגר הנתונים לקרוא את פרטי הבעיה.
read:jql:jira מאפשר למאגר הנתונים לקרוא שאילתות ב-Jira Query Language‏ (JQL).
חיפוש מאוחד בלבד read:issue:jira מאפשר למאגר הנתונים לקרוא בעיות.
read:issue-type:jira מאפשר למאגר הנתונים לקרוא סוגי בעיות.
read:comment:jira מאפשר למאגר הנתונים לקרוא תגובות.
read:comment.property:jira מאפשר למאגר הנתונים לקרוא את המאפיינים של התגובות לבעיות.
read:project:jira מאפשרת למאגר הנתונים לקרוא פרויקטים.
read:priority:jira מאפשר למאגר הנתונים לקרוא את סדרי העדיפויות.
read:issue.transition:jira מאפשרת למאגר הנתונים לקרוא מעברים בין סטטוסים של בעיות.
read:issue-meta:jira מאפשר למאגר הנתונים לקרוא את המטא-נתונים של הבעיה.
read:board-scope.admin:jira-software מאפשר למאגר הנתונים לקרוא את ההגדרות האישיות, את תכונות הפרויקט, את המסננים, את המאפיינים ואת המסננים המהירים של לוח.
read:board-scope:jira-software מאפשר למאגר הנתונים לקרוא לוחות, בעיות בלוח, בעיות מתוך backlog, דוחות וגרסאות.
read:sprint:jira-software מאפשרת למאגר הנתונים לקרוא את פרטי הספרינט.
read:issue-details:jira מאפשר למאגר הנתונים לקרוא את פרטי הבעיה.
read:jql:jira מאפשר למאגר הנתונים לקרוא שאילתות ב-Jira Query Language‏ (JQL).
העברת נתונים ופעולות read:user:jira, read:group:jira, read:avatar:jira מאפשרת לסנכרן מטא-נתונים של משתמשים או קבוצות ולהציג פרופילים של משתמשים.
read:issue-security-level:jira, read:issue-security-scheme:jira ההרשאה מאפשרת בקרת גישה, כדי לוודא שהנתונים שמועברים מכבדים את גבולות האבטחה של Jira.
read:audit-log:jira מאפשר לעקוב אחרי שינויים ולבצע סנכרונים מצטברים כדי לשמור על עדכניות הנתונים שנטמעו.
write:comment:jira מאפשר להוסיף תגובות לבעיות באמצעות מאגר הנתונים.
write:issue:jira העוזר הדיגיטלי יכול ליצור או לשנות בעיות.
<!--Data ingestion-->הטמעת נתונים read:user:jira, read:group:jira, read:avatar:jira מאפשרת סריקה והוספה לאינדקס של תוכן וקשרי משתמשים ב-Jira.
read:issue-security-level:jira, read:issue-security-scheme:jira מאפשר למפות הרשאות כדי שרק משתמשים מורשים יוכלו לחפש בנתונים שהוטמעו.
read:audit-log:jira מאפשר למנוע הסנכרון לזהות אילו פריטים עודכנו או נמחקו.
read:sprint:jira-software מאפשרת למאגר הנתונים לקרוא את פרטי הספרינט.

במאמר הגדרת היקף הרשאות מינימלי לאפליקציה מוסבר איך להגדיר את היקפי ההרשאות האלה.

מגבלות קצב להעברת נתונים

מאגר הנתונים של Jira Cloud תומך במגבלת קצב ברירת מחדל של 12 שאילתות לשנייה (QPS) להטמעת נתונים. מגבלות הקצב האלה חלות רק על הטמעת נתונים ממאגר הנתונים של Jira Cloud.

מגבלות

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

  • כשיוצרים אפליקציה חדשה או מוסיפים מאגר נתונים לאפליקציה קיימת, מומלץ לשייך רק מאגר נתונים אחד לפעולות ששייכות לסוג מחבר אחד.
  • אי אפשר לאכוף מתחם VPC Service Controls על מאגרי נתונים קיימים של Jira Cloud. כדי לאכוף את VPC Service Controls, צריך למחוק את מאגרי הנתונים וליצור אותם מחדש. מידע נוסף על VPC Service Controls ועל אופן השימוש בפעולות אחרי הפעלת VPC Service Controls זמין במאמר אבטחת האפליקציה באמצעות VPC Service Controls.
  • מאגר הנתונים של Jira Cloud נתמך רק במיקומים global,‏ us ו-eu.

אלה המגבלות של מאגר הנתונים להטמעה מ-Jira Cloud:

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

  • בנתונים מובְנים, הגודל של כל מסמך לא יכול לחרוג מ-500KB.

  • אי אפשר להעניק הרשאות ברמת האבטחה או Browse project לתפקידי אפליקציה עם תפקידים ספציפיים שאינם ריקים.

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

  • ב-Jira Cloud אין הגבלות על רמות של יומני עבודה.

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

  • קבצים שמצורפים לתגובות פרטיות לא מקבלים בירושה את הגבלות הגישה (ACL) שחלות על התגובות.

  • רק 20 התגובות האחרונות לבעיה ב-Jira Cloud מאוחזרות.

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

  • המודל הקודם של ניהול משתמשים לא נתמך בשילוב עם Jira Cloud. יש תמיכה רק במודל ניהול המשתמשים המרוכז. מידע נוסף זמין במדריך לאיחוד ארגונים של Atlassian.

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

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