יום ראשון, 10 בנובמבר 2019

מיגרציה מ-Quality Center ל-Jira חלק שלישי: המעבר של הבאגים


הפעם אספר על ההעברה של הבאגים לג'ירה, על המיגרצה עצמה.

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

הצורה בה מייצאים מ-QA ומייבאים לג'ירה

הדרך שבחרנו להעברת האגים היא פשוטה - ייצוא של הבאגים שהחלטנו שיעברו לג'ירה כקובץ אקסל. זה נעשה ב-GUI באיזור הרגיל של הבאגים. לכן דבר ראשון הוא יצרירת פילטר מתאים ב-Quality Center, להלן QC.
במהלך התהליך, יש ליצור מיפוי בין השדות (העמודות) של ה-QC לאלו של הג'ירה, ועל כך בהמשך.

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

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

טיפ: מהרגע שהבנו שנעבור לג'ירה, ביקשנו מהבודקים לשמור את ה-attachments בספרייה כללית ברשת ולא בבאג עצמו. בבאג פשוט הוספנו את הלינק לספרייה זו. כך שכשהבאג יעבור לג'ירה יהיה קל להגיע ל--attachments.

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

הייצוא ב-QC הוא לאקסל. הייבוא ל-CSV. אבל אחרי הייצוא ולפני ההמרה, יש כמה דברים שכדאי לעשות.
1. האם שמות המשתמשים ב-QC זהים לאלו בג'ירה? למשל ייתכן ששמות המשתמשים ב-QC הם שמות שנשמרים לוקלית בשרת, ואילו הג'ירה מחוברת ל-Active Directory, כלומר למאגר שנות העובדים כפי שניתן לראות ב-Outlook למשל.
זה הזמן למפות את השמות של ה-QC ל-AD.
2. יש שדות ב-QC ששם מאוחסנים מספר ערכים שונים, כמו למשל ה-label בג'ירה שבו ניתן לשמור מספר מילות מפתח.
לדוגמא: שדה ב-QC בשם labs ששומר ערכים של כל המעבדות שבהן הבאג משתחזר - lab a, lab b.
בתהליך המיגרציה, אחרי המיפוי של השדות, כל הערכים בשדה ה-labs ימוזגו לערך אחד של "lab a lab b".
זה דבר שאותו אנו לא רוצים, עיוון שאנו מעוניינים שיהיה לנו החופש להכניס כל מעבדה בנפרד.
פתרון: ליצור באקסל מספר עמודות שכולן נקראות labs ובכל אחת מהן יהיה ערך רלוונטי.
להלן דוגמה:

בדרך זו כל הערכים יכנסו בנפרד לשדה labs בגירה.
אחרי החלוקה לעמודות יש למחוק את העמודה המקורית.
אני השתמשתי בתוסף בתשלום לשם כך בשם ablebits.

מידע חשוב: הערכים שעובדים בשדה בעצם נשמרים, כלומר שכנדווח על באג חדש כבר בג'ירה, נוכל לבחור בין המעבדות lab a, lab b, lab c וכן lab d, ערך אחד או יותר, לפי הגדרת השדה בג'ירה.

3. חשוב להעביר את מספר הבאג של ה-QC, למרות שבג'ירה יקבל כל דיווח key חדש. אם רוצים "לפנק", ניתן להוסיף עמודה באקסל ליד מספר הבאג של הלינק אל הבאג (אפשר להוציא אותו למשל מהמייל שמקבלים מה-QC על שינוי שנעשה בבאג - זה לינק גנרי פרט למספר הבאג בסופו), ואז בפונקציה של אקסל לחבר ביניהם, החלטנו שנעביר את מספר הבאג וגם את הלינק אליו בשני שדות.

טיפ: אם במהלך המניפולציות באקסל יצרנו תאים מחושבים עדיף להעתיק אותם ולהדביק את הערכים שלם (יש כזו אפשרות באקסל) ולבטל פילטורים.

מידע חשוב: יש אפשרות ב-QC לבחור בסוג שדה שבו תהיה אפשרות לסחור מרשימה או לעדכן ידנית. אין דבר דומה בג'ירה.

אם סיימנו כאן, נעשה המרה של קובץ האקסל ל-CSV.

תהליך ההמרה

למידע מפורט לחצו כאן.

תהליך ההמרה בג'ירה נעשה בחלק של האדמין וכולל מספר שלבים מבחירת הקובץ על ההמרה עצמה.

הצעד הראשון הוא להיכנס כאדמין לחלק של ה-system בקונפיגורצה ולבחור ייבוא ממקור חיצוני, ואז CSV.

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

כדאי לוודא שאתם מייבאים את הבאגים לפרוייקט ול-issue type הנכונים. לכן כדאי ליצור פרוייקט נפרד בג'ירה. בסופו של דבר, אחרי המיגרציה יהיה אפשר להעביר את הבאגים לפרוייקט המתאים (או להשאיר שם).

המיפוי

לאחר מסירת הפרטים כמו מיקום הקובץ ומה שנאמר למעלה, הגיע זמן המיפוי של השדות. בתהליך פשוט ממפים את השדה מהאקסל לשדה בג'ירה. יש צ'ק בוקס ליד כל שדה שנקרא map.field value.
הפונקציונליות של השדה היא לתת, במסך הבא, אפשרות מיפוי של הערכים. כדאי לסמן רק את מה שראוי למפות.
למשל שדה טקסט שעובר לשדה טקסטואלי אחר אין טעם למפות.
אבל שדה של ערכים קבועים מרשימה (או ערכים טקסטואלים שנרצה לשנות) שכבר קיימים בג'ירה כדאי למפות בעיקר אם הם שונים.
למשל: פריוריטי ב-QC היא מילולית (למשל: showstopper, High, Medium and low) והג'ירה מספרית (1 עד 4). במקרה הזה נמפה בין הערכים ובג'ירה showstopper יופיע כ"1".

המיגרציה

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

זהו זה לגבי הבאגים. אני מקווה להמשיך בנודע ל-test cases בעתיד.

רשומות פופולריות