בעיה ב-Google Issue Tracker היא דוח באג, בקשה לתכונה, בקשת שינוי או פריט בתהליך העבודה שהמשתמש רוצה לעקוב אחריו או מצפה שמשתמש או צוות אחר יעקבו אחריו. הבעיות מאורגנות ברכיבים, שכל אחד מהם מכיל קבוצה של בעיות קשורות. לכל בעיה ב-Issue Tracker יש דף פרטים משלה שבו המשתמשים עוקבים אחרי הפעילות בבעיה, כותבים תגובות ומעדכנים את נתוני הבעיה.
שדות הבעיה
לכל בעיה יש קבוצה של שדות משויכים שמתארים אותה ואת המצב הנוכחי שלה. המידע הזה כולל את סוג הבעיה, את מידת החשיבות שלה מבחינת חומרה ורמת העדיפות, ואת הרשומה של הפעילות בנושא הבעיה. יש שדות שתקפים לכל הבעיות. ב-Issue Tracker יש תמיכה גם בשדות מותאמים אישית שזמינים רק כשהבעיה משויכת לרכיב ספציפי. בכל בעיה חדשה יש כמה שדות חובה. השדות האלה כוללים את Component, Title, Priority ו-Type. לחלק מהרכיבים יש גם שדות בהתאמה אישית שחייבים למלא.
בדף הפרטים של הבעיה, רוב השדות נמצאים בצד שמאל של הדף בחלונית שדות הבעיה. שדות נוספים נמצאים בקטגוריה בעיות קשורות בחלק העליון של הדף. אפשר לערוך כמעט את כל השדות ב-Issue Tracker בלחיצה על הקישור, התפריט הנפתח או סמל העיפרון שמשויך אליהם. כשמעבירים את העכבר מעל שדה מסוים, מערכת מעקב הבעיות מציגה מידע קצר על השדה בטקסט שמופיע כשמעבירים את העכבר מעליו.
תיאור של שדות ברירת המחדל של הבעיות מופיע במאמר מילון מונחים של שדות.
סוג הבעיה
השדה Type מאפשר לסווג בעיות ברכיב באחת מכמה קבוצות נפוצות. חובה למלא את השדה הזה. בטבלה הבאה מפורטים סוגי הבעיות האפשריים:
סוג הבעיה | תיאור |
---|---|
באג | ההתנהגות לא תואמת למה שצפוי לקרות או לתועד, או שהמוצר לא פועל כצפוי. |
בקשה להוספת תכונה | המוצר פועל כמצופה, אבל אפשר לשפר אותו באמצעות השינויים שצוינו. |
בעיה של לקוח/ה | הבעיה משפיעה על צד שלישי, וייתכן שהאדם שדיווח עליה לא יוכל לשחזר אותה. יכול להיות שמדובר בבעיה פשוטה של פתרון בעיות או הדרכה, אבל יכול להיות שמדובר בבאג או בבקשה להוספת תכונה. |
ניקוי פנימי | לבעיה אין השפעה חיצונית על התנהגות המוצר, אבל טיפול בבעיה יאפשר אינטראקציה יעילה או אינטואיטיבית יותר במהלך הפיתוח של המוצר. אפשר גם להשתמש בסוג הזה כדי לעקוב אחרי בעיות תחזוקה. |
תהליך | 'תהליך' היא קטגוריה 'שונות' שיש לה שימושים שונים בהתאם לפרויקט. לדוגמה, אפשר להשתמש בסוג הזה לבעיות שנוצרות על ידי ממשק API, או כדי לעקוב אחרי משימות ניהוליות. |
נקודת חולשה | נקודות חולשה בפרטיות ובאבטחה כפופות ל-SLO שמוגדרים בהנחיות של Google בנושא פרטיות ואבטחה. קריאה בלבד עד אחרי 1 בנובמבר 2017. |
Project | מאמץ שמבוסס על מטרה, עם תאריכי התחלה וסיום מוגדרים, שמתמקד ביצירת מוצר, שירות או תוצאה ייחודיים. |
Milestone | אוסף עבודות שמייצג הישג חשוב בדרך להשלמת פרויקט. אפשר גם להשתמש ביעדים עסקיים כדי לייצג השקות או גרסאות. |
תכונה | אוסף עבודות שמספק ערך ספציפי למשתמש. |
Epic | אוסף גדול של עבודות שמטרתן להשיג יעד משותף. |
סטורי | אוסף קטן של עבודות שמספק ערך ספציפי למשתמש. |
משימה | יחידה קטנה של עבודה. |
תוכנית | אוסף של יעדים שקשורים זה לזה מבחינה נושאית (פרויקטים, תכונות, אבני דרך, משימות ארוכות טווח). |
עדיפות הבעיה
בשדה Priority אפשר לציין את רמת החשיבות של הבעיה. השדה הזה הוא חובה. בדרך כלל, לכל צוות יש קריטריונים שונים לקביעת רמת החשיבות של בעיה. בטבלה הבאה מופיעה שיטה נפוצה לקביעת העדיפות של בעיות:
רמת העדיפות של הבעיה | תיאור |
---|---|
P0 | בעיה שצריך לטפל בה באופן מיידי ולגייס לכך את כל המשאבים הנדרשים. בעיה כזו גורמת להפסקה מלאה בשירות או לכך שפונקציה קריטית של המוצר לא זמינה לכולם, ללא פתרון ידוע. |
P1 | בעיה שצריך לטפל בה במהירות. בעיה כזו משפיעה באופן משמעותי על אחוז גדול של משתמשים. אם יש פתרון זמני, הוא חלקי או קשה מדי. הבעיה משפיעה על פונקציה ארגונית מרכזית או מונעת באופן יסודי את הפעילות של צוות אחר. |
P2 | בעיה שצריך לטפל בה בזמן סביר. בעיה כזו יכולה להיות כל אחת מהבעיות הבאות: 1) בעיה שסווגה כ-P0 או כ-P1 אבל יש לה פתרון זמני סביר, 2) בעיה שחשובה לאחוז גדול של משתמשים ומקושרת לפונקציונליות הליבה של הארגון, 3) בעיה שמונעת את העבודה של צוותים אחרים ואין לה פתרון זמני סביר. רמת העדיפות P2 רלוונטית במיוחד לבעיות שקשורות לשימוש בפעם הראשונה או לבעיות שקשורות להתקנה, והיא רמת העדיפות שמוגדרת כברירת מחדל. |
P3 | בעיה שצריך לטפל בה כשהדבר אפשרי. בעיה כזו רלוונטית לתפקידים הליבה של הארגון או לעבודה של צוותים אחרים, אבל היא לא מעכבת את ההתקדמות או שיש לה פתרון עקיף סביר. |
P4 | בעיה שצריך לטפל בה בסופו של דבר. הבעיה לא רלוונטית לפונקציות הליבה של הארגון או לעבודה של צוותים אחרים, או שהיא קשורה רק לאטרקטיביות או לנוחות של המערכת. |
סטטוס הבעיה
בשדה סטטוס אפשר לציין את הסטטוס של הבעיה בתהליך הפתרון. בדרך כלל, לכל צוות יש הגדרות שונות לגבי הפעילויות שצריכות להתבצע כדי לשנות את הסטטוס של בעיה או כדי לפתור אותה. לא צריך להשתמש בכל הערכים הזמינים בשדה סטטוס כדי לעקוב אחרי פתרון הבעיה. בטבלה הבאה מפורטות דרכים נפוצות לשימוש בשדה Status:
סטטוס הבעיה | תיאור |
---|---|
חדש | לא הוקצה לבעיה אדם או קבוצה. |
הוקצו | הבעיה הוקצה לאדם מסוים. השם של המשתמש יופיע בשדה Assignee. |
בתהליך (אושר) | המשתמש שהוקצה אליו הבעיה אישר אותה והתחיל לטפל בה. |
קבוע | הבעיה טופלה. |
תוקנה (מאומתת) | הבעיה טופלה והמשתמש אישר את תקינות התיקון בשדה Verifier. |
לא יתוקן (לא ניתן לשחזר) | אין מספיק מידע כדי לפתור את הבעיה, או שלא ניתן ליצור מחדש את הבעיה כפי שדווחה. |
לא יתוקן (התנהגות מכוונת) | הבעיה מתארת את ההתנהגות הצפויה של המוצר בנסיבות שדווחו. |
לא יתוקן (לא רלוונטי) | הבעיה כבר לא רלוונטית בגלל שינויים במוצר. |
לא יתוקן (לא ניתן לביצוע) | לא ניתן לבצע את השינויים הנדרשים כדי לטפל בבעיה. |
כפילות | הבעיה דווחה במקום אחר. במאמר דיווח על בעיה כבעיה כפולה מוסבר איך מגדירים את הסטטוס בעיה כפולה. |
במערכת המעקב אחר בעיות, הבעיות נחשבות לפתוחות או לסגורות בהתאם לסטטוס שלהן. בעיות פתוחות הן בעיות שעדיין לא טופלו. הבעיות האלה כוללות כל בעיה עם סטטוס חדשה, הוקצתה או בטיפול. בעיות סגורות הן בעיות שלא נדרשת להן פעולה נוספת, מלבד אימות במקרים מסוימים. הסטטוסים האלה כוללים בעיות עם הסטטוסים תוקנה, לא יתוקן או שכפול.
סמלי סטטוס
סמלי הסטטוס מייצגים באופן חזותי את סטטוס הבעיה. סמל סטטוס מופיע מימין לבעיה שמופיעה ברשימה הנפתחת Blocked By או Blocking של בעיה אחרת. הסמלים האלה מספקים דרך מהירה להעריך את ההתקדמות של בעיה חסומה או של בעיה שגורמת לחסימה, בלי לצאת מהדף הנוכחי. אפשר גם להגדיר בעמודה סטטוס של דף תוצאות חיפוש שיוצגו סמלי סטטוס במקום טקסט של סטטוס.
שינוי מהיר של הסטטוס
יש שתי דרכים לשנות במהירות את הסטטוס של בעיה כדי להעביר אותה לשלב הבא בתהליך הטיפול. האפשרות הראשונה היא הלחצן Change Status (שינוי סטטוס) שנמצא בApp Bar (סרגל האפליקציות) ליד החלק העליון של דף פרטי הבעיה, והקישור Change Status (שינוי סטטוס) בחלונית Issue Fields (שדות הבעיה) שבצד שמאל של הדף. לחיצה על אחת מהאפשרויות האלה תגרום לשינוי הסטטוס של הבעיה באופן הבא:
אם הבעיה חדשה ולא הוקצה לה אחראי, או אם האחראי הוא מישהו אחר, ההודעה לשינוי המהיר תהיה הקצאה אליי. שינוי מהיר של הסטטוס יגרום להקצאת הבעיה אליכם, ואם הסטטוס הנוכחי שונה, הוא ישתנה להוקצה.
אם הבעיה הוקצה לכם והסטטוס שלה הוא הוקצה, ההנחיה לשינוי מהיר תהיה התחלת העבודה. שינוי מהיר ישנה את סטטוס הבעיה לבטיפול.
אם הבעיה הוקצה לכם והסטטוס שלה הוא בטיפול, ההנחיה לשינוי מהיר תהיה סימון כבעיה שנפתרה. שינוי מהיר ישנה את הסטטוס של הבעיה לנפתרה.
אם הסטטוס של בעיה מסוימת הוא נפתרה ואתם מאמתים, ההנחיה לשינוי מהיר תהיה אימות. שינוי מהיר ישנה את סטטוס הבעיה ל-תוקנה (אומתה).
אם לבעיה יש סטטוס סגור (תוקנה, כפילות או לא תטופל), ההנחיה לשינוי מהיר תהיה פתיחה מחדש (למעט במקרה שצוין למעלה). שינוי מהיר ישנה את הסטטוס לחדש אם לא הוקצה לבעיה אחראי, או להוקצה אם הוקצה לבעיה אחראי.
כרטיסי מידע על בעיות
כרטיס מרחף של בעיה מכיל מידע כמו השם, המזהה, התיאור והסטטוס הנוכחי של הבעיה. בנוסף, הוא מכיל לחצן CC Me שמוסיף אתכם לרשימת הנמענים של הבעיה (אם אתם כבר נכללים ברשימת הנמענים, הכיתוב בלחצן הוא Un-CC Me). לדוגמה:
כרטיסי ההודעות מופיעים כשמעבירים את העכבר מעל הפריטים הבאים:
- מספר הבעיה מופיע בכרטיסייה Blocked By (חסימה על ידי), Blocking (חסימת) או Duplicates (כפילויות) בחלונית Related Issues (בעיות קשורות).
- מזהה הבעיה בעמודה Blocked By (הגורם לחסימה), Blocking (הגורם לחסימה) או Duplicate Of (עותק כפול של) בדף תוצאות החיפוש של הבעיה.
- קישור לבעיה שנמצאת בחלונית בעיות אחרונות, שממוקמת בצד שמאל של הדף דיווח על בעיה.
- השדה סטטוס בדף בעיה שסומן כעותק כפול.
- קישור לבעיה בקובץ הקנוני שנמצאת בסרגל הצהוב בחלק העליון של דף שמסומן כעותק כפול.
בעיות בעריכה
אם יש לכם הרשאת צפייה ועריכה לרכיב, תוכלו לערוך את השדות שלו ולהוסיף לו תגובות. עם זאת, אי אפשר לערוך שדות מסוימים בכלל, כמו תאריך היצירה של הבעיה או תגובות שכבר נכתבו.
עריכת רמות
לשינויים בבעיה יש רמות שונות של חשיבות, שמחליטות אם השינויים יופיעו בחלונית ההיסטוריה של הבעיה ואם המשתמשים יקבלו הודעה באימייל כשהשינוי מתרחש.
סגירת פעולות העריכה
סגירת עריכות משנה את הסטטוס של הבעיה מפתוח לסגור. העריכות לסגירת הבעיה מופיעות בחלונית ההיסטוריה של הבעיה. עדכונים על סגירת עריכות נשלחים באימייל למשתמשים שהגדירו לקבל התראות באחת מהאפשרויות הבאות: כל העדכונים, עדכונים משמעותיים או סגירה בלבד.
במאמר בנושא סטטוס הבעיה מפורטת רשימה מלאה של הסטטוסים שאפשר להשתמש בהם כדי לסגור בעיה פתוחה.
עריכות משמעותיות
עריכות משמעותיות תמיד מופיעות בחלונית ההיסטוריה של הבעיה. אחרי עריכה משמעותית, נשלחת התראה באימייל למשתמשים שהגדרת ההתראות שלהם היא כל העדכונים או עדכונים משמעותיים. עריכות שנחשבות כמשמעותיות כוללות:
- היצירה הראשונית של הבעיה.
- תגובות שנוספו לבעיה.
- הבעיה הועברה לרכיב חדש.
- שינויים בעדיפות, בחומרה, בשמירה או במי שהוקצה לה.
- שינוי סטטוס לסגור, מאומת או נפתח מחדש.
- שינויים בשדות מותאמים אישית שמסומנים כעיקריים.
עריכות קלות
עריכות קלות מופיעות בחלונית ההיסטוריה של הבעיה רק אם רמת הסינון מוגדרת כהיסטוריה מלאה. באופן דומה, עריכות קלות נשלחות באימייל רק למשתמשים שהגדרת ההתראות שלהם בבעיה היא כל העדכונים.
עריכות שנחשבות משניות כוללות:
- שינויים בכותרות
- שינויים ברשימת המלצות
- הוספת קבצים מצורפים
- שינויים בבעיות קשורות (חסימה, חסימה על ידי, כפילויות)
- שינויים בסטטוס שלא צוינו במפורש כעריכות משמעותיות
- שינויים בשדות הבאים: Reporter, Type, Verifier, Found In, Targeted To, Verified In, In Prod
- שינויים בשדות מותאמים אישית שמסומנים כמשניים
עריכות שקופצות
עריכות שקשות לא יוצרות התראות באימייל למשתמשים, אלא אם העריכה היא להוספה או להסרה של המשתמשים האלה מהבעיה. עריכות שנחשבות ללא קול כוללות:
- הוספה או הסרה של רשומות מהשדות עותק אל או שותף עריכה (אלא אם המשתמש או הקבוצה נוספו או הוסרו לאחרונה)
- עריכת תגובה
- שינוי שדה מותאם אישית שמסומן כשקט
הגבלות גישה להנפקת תעודות
ב-Issue Tracker יש תמיכה בהגבלות על בקרת גישה שמאפשרות לבעיות מסוימות לכלול פחות גורמים עם הרשאת גישה בהשוואה לבעיות אחרות באותו רכיב.
אדמינים של בעיות יכולים לעדכן את סטטוס ההגבלה של בעיה לאחת מארבע רמות הגישה לבעיה:
גישה שמוגדרת כברירת מחדל – הכללים הרגילים חלים: לבעיה עם רמת הגישה שמוגדרת כברירת מחדל יש את אותם רכיבי גישה כמו לכל הבעיות האחרות ברכיב.
הרשאות להגיב מוגבלות – רק משתמשים שרשומים במפורש בבעיה כמקבלים, שותפים, גורמים מאמתים או נמענים יורשו להגיב עליה, גם אם יש להם הרשאות להגיב על בעיות אחרות ברכיב. לזהויות עם הרשאת 'ניהול בעיות' ברכיב תישאר גם גישה להוספת תגובות. הגישה לצפייה תישאר ברירת המחדל.
חשיפה מוגבלת – רק לזהויות שצוינו במפורש (האדם שהוקצה, שותף עריכה, גורם אימות או אדם שקיבל עותק) תהיה גישה לצפייה בבעיה.
חשיפה מוגבלת + Google – רק לזהויות שצוינו במפורש (הקצאה, שיתוף פעולה, אימות או CC), לגוגלרים במשרה מלאה ולחשבונות אוטומציה פנימיים תהיה גישה לצפייה בבעיה.