דלגו לתוכן

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

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

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

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

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

בוחרים רכיב שחוזר בהרבה מסכים

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

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

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

מצמידים את הכלל למקום שבו הוא חל

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

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

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

שומרים על עקבות שאפשר לעקוב אחריהן

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

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

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

מקדמים קטלוג שהצוות באמת רוצה להשתמש בו

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

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

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

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

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

רוצים לקבל פרטים נוספים?טופס פנייה קצר — לחצו לפתיחה

השאירו פרטים ונחזור אליכם בנושא פיתוח אפליקציות.

מסירת הפרטים היא לבחירתכם ונדרשת לקבלת מענה. הפנייה עשויה להימסר גם לכותב המאמר. מדיניות פרטיות