סקירה כללית

מאגר הנתונים של 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.

היקפים נדרשים

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

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

Classic scopes

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

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

אמצעי תחבורה הרשאה מטרה
חיפוש מאוחד ופעולות מאוחדות write:comment:jira מאפשר למאגר הנתונים לפרסם תגובות או תשובות חדשות ישירות מממשק החיפוש.
write:issue:jira מאפשרת למאגר הנתונים ליצור בעיות חדשות או לבצע עריכות משמעותיות בבעיות קיימות.
write:attachment:jira מאפשר למאגר הנתונים להעלות קבצים מצורפים לבעיות ב-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: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 מאפשרת ל-Assistant ליצור או לשנות בעיות.
הטמעת נתונים read:user:jira, read:group:jira, read:avatar:jira מאפשרת סריקה ואינדוקס של תוכן Jira ושל קשרי משתמשים.
read:issue-security-level:jira, read:issue-security-scheme:jira מאפשר מיפוי הרשאות כך שרק משתמשים מורשים יוכלו לחפש את הנתונים שהועברו.
read:audit-log:jira מאפשר למנוע הסנכרון לזהות אילו פריטים עודכנו או נמחקו.

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

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

מאגר הנתונים של 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 (לדוגמה, בעיה), נתונים קשורים כמו תגובות וקבצים מצורפים לא נכללים אוטומטית. הסיבה לכך היא שהם מאוחסנים ומסווגים כישויות נפרדות. חיפוש שמבוסס על התוכן של קובץ מצורף כדי למצוא את הבעיה הראשית לא נתמך.

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