עשרים שאלות שצריך לענות עליהן בכתב לפני שמחברים שתי מערכות, בארבע קבוצות - נתונים, הרשאות, כשל ואחריות - ולכל שאלה גם איך נשמעת תשובה גרועה ומה היא מסתירה.
עיקרי הדברים
- שאלה שאין עליה תשובה כתובה תיענה בקוד, על ידי מי שאין לו את ההקשר העסקי.
- "שתי המערכות מעודכנות" אינה תשובה למי מקור האמת. זו הצהרה שאין מקור אמת.
- רוב התקלות המאוחרות נולדות בקבוצת הכשל, שהיא גם הקבוצה שהכי ממהרים לדלג עליה.
- לכל אינטגרציה צריך שם של אדם אחראי. "הצוות" הוא לא אדם.
- תשובה שמתחילה ב"זה לא יקרה" מסמנת בדיוק את המקרה שכדאי לתכנן.
לפני שמחברים שתי מערכות יש עשרים עובדות שצריך לדעת, לא לנחש. הן מתחלקות לארבע קבוצות: אילו נתונים זזים ומי מקור האמת, מי נותן גישה ואיפה הסודות, מה קורה כשמשהו נכשל, ומי אחראי אחרי המסירה. לכל שאלה כאן מופיע גם איך נשמעת תשובה גרועה.
איך משתמשים ברשימה הזו?
עוברים עליה פעם אחת, בכתב, ומסמנים כל שאלה באחת משלוש דרכים: יש תשובה, אין תשובה ומי אמור לתת אותה, או לא רלוונטי ולמה. המסמך הזה הוא הפלט. הוא שווה יותר ממסמך אפיון ארוך, כי אפשר לחזור אליו כשמשהו נשבר ולראות מה הונח.
| הקבוצה | מה תשובה טובה מייצרת | מה היא מונעת |
|---|---|---|
| נתונים | טבלת מיפוי שדות ומזהה משותף | רשומות כפולות ונתון שנדרס |
| הרשאות | רשימת סודות עם בעלים ומועד תפוגה | תפוגה שמפילה הכול באמצע חודש |
| כשל | תור חריגים והתראה עם יעד | ימים שבהם כלום לא רץ ואף אחד לא ידע |
| אחריות | שם, זמן תגובה, ותוכנית כיבוי | תקלה שעוברת בין שלושה גורמים שבוע |
נתונים: אילו עובדות חייבות להיסגר לפני שמשהו נכתב?
- מי מקור האמת לכל שדה? בלי החלטה לכל שדה, שני הצדדים ידרסו זה את זה. תשובה גרועה: "שתי המערכות".
- מה המזהה המשותף שקובע ששתי רשומות הן אותה ישות? זו העבודה הגדולה ביותר וגם הפחות נראית. תשובה גרועה: "נזהה לפי שם".
- אילו שדות בדיוק זזים, בשמות של שני הצדדים? רשימה מפורשת מונעת גילוי מאוחר של שדה חובה. תשובה גרועה: "כל פרטי הלקוח".
- מה הנפח לכל הרצה והאם הוא גדל? נפח קובע אם התכנון הוא לרשומה או לאצווה. תשובה גרועה: "לא הרבה".
- איך נראית רשומה חלקית שעדיין תקינה? זה מגדיר מה נדחה ומה מתקבל. תשובה גרועה: "זה לא יקרה".
הרשאות: מי נותן, לכמה זמן, ואיפה נשמר
- מי בכל צד מוסמך להנפיק את ההרשאה, וכמה זמן זה לוקח? זה זמן לוח שנה ולא זמן פיתוח. תשובה גרועה: "נפתח קריאה".
- מה סוג ההרשאה ומה תוקפה, ומי מקבל התראה לפני שפג? תפוגה היא סיבת תקלה נפוצה ושקטה. תשובה גרועה: "אין לזה תפוגה".
- איפה יישמר הסוד ומי יכול לקרוא אותו? סוד שנמצא בתוך תהליך אוטומציה גלוי לכל מי שרואה את התהליך. תשובה גרועה: "זה שמור אצלנו".
- קיימת סביבה שאינה ייצור, והנתונים בה מייצגים? בלי זה כל בדיקה נעשית על נתונים אמיתיים. תשובה גרועה: "נבדוק בזהירות בייצור".
- יש הגבלה על מקור הפנייה - כתובות מותרות, VPN, תעודה? מגבלה כזו מתגלה בדרך כלל ביום ההעלאה. תשובה גרועה: "אין לי מושג".
כשל: מה קורה כשזה לא עובד?
- מה קורה אם היעד אינו זמין למשך שעה? צריך לדעת אם ההודעות ממתינות או נעלמות. תשובה גרועה: "יש ניסיון חוזר" בלי לומר כמה ולאן.
- מה קורה אם אותה הודעה מגיעה פעמיים? בלי מנגנון ייחודיות מתקבל מסמך כפול או חיוב כפול. תשובה גרועה: "זה לא קורה".
- איך אדם מגלה שהרצה נכשלה, ותוך כמה זמן? התראה בלי יעד אנושי שווה ללא התראה. תשובה גרועה: "זה יופיע בלוג".
- לאן הולכת רשומה שנדחתה ומי מטפל בה? צריך תור שמישהו פותח, לא שורה בקובץ. תשובה גרועה: "זה נרשם".
- מה קורה כשרשומה מתוקנת במקור אחרי שכבר סונכרנה? זו השאלה שמייצרת שקט בין המערכות. תשובה גרועה: "נסנכרן הכול מחדש".
אחריות: מי בעל הדבר הזה אחרי המסירה?
- מי האחראי בשם על האינטגרציה אחרי העלייה לאוויר? בלי שם, כל תקלה מתחילה בבירור מי מטפל. תשובה גרועה: "הצוות".
- מי משלם כששינוי גרסה אצל ספק שובר את החיבור? זה יקרה, והשאלה היא רק מתי. תשובה גרועה: "נטפל בזה כשזה יקרה".
- מה תוכנית החזרה לאחור אם הרצה כתבה נתונים שגויים? צריך צעדים כתובים, לא כוונה. תשובה גרועה: "נשחזר מגיבוי".
- איפה כתוב מיפוי השדות ומי מעדכן אותו? מיפוי שקיים רק בקוד אבוד ברגע שהמפתח מתחלף. תשובה גרועה: "זה בקוד".
- מי מוסמך לכבות את האינטגרציה, ומה קורה ידנית בזמן שהיא כבויה? בלי תשובה, כיבוי הופך להשבתה של תהליך עסקי. תשובה גרועה: "אי אפשר לכבות".
שתי תשובות כתובות עד הסוף
תשובה טובה נראית אחרת מתשובה שנשמעת טוב בפגישה. שתי דוגמאות:
שאלה 2, מזהה משותף. תשובה חלשה: "נזהה לפי דוא"ל". תשובה כתובה: המזהה הראשי הוא מספר הלקוח במערכת הפיננסית. הוא נשמר בשדה מותאם במערכת השנייה ומולא ידנית ל-1,840 הלקוחות הקיימים. רשומה חדשה שאין לה מספר כזה אינה מסונכרנת אלא נכנסת לתור התאמה שנבדק פעם ביום. התאמה לפי דוא"ל משמשת רק כהצעה לאדם, לעולם לא כהכרעה אוטומטית.
שאלה 14, רשומה שנדחתה. תשובה חלשה: "זה נרשם ביומן". תשובה כתובה: רשומה שנדחתה נשמרת עם הסיבה המקורית ועם הנתונים כפי שהיו, ומופיעה במסך חריגים עם כפתור הרצה חוזרת. בעל התהליך פותח את המסך כל בוקר, ורשומה שממתינה יותר מ-48 שעות מייצרת התראה נוספת. חריג שטופל נשאר ברשימה עם סימון, כדי שאפשר יהיה לראות דפוס חוזר.
ההבדל בין שתי הרמות הוא לא ניסוח אלא כמות ההחלטות שכבר התקבלו.
מה עושים עם התשובות
הרשימה הזו אינה טופס למילוי חד-פעמי. שמרו את המסמך ליד האינטגרציה עצמה, וחזרו אליו בשלוש נקודות: לפני העלייה לאוויר, אחרי התקלה הראשונה, ובכל שינוי גרסה בצד השני. שאלה שהתשובה עליה השתנתה היא ההסבר הכי מהיר לתקלה שאף אחד לא מבין.
קשור: חיבור מערכות בעסק ישראלי, כשל שקט בכלי אוטומציה ואיך מנטרים אותו, מה זו אינטגרציית API.
מקורות
שאלות נפוצות
מה קורה אם אין תשובה לחלק מהשאלות?
זה מצב נורמלי בהתחלה. הכתיבו את הפער עצמו: מה לא ידוע, מי אמור לענות ועד מתי. השאלות שנשארות פתוחות בעלייה לאוויר הן בדיוק רשימת הסיכונים של הפרויקט, וכדאי שהיא תופיע במסמך ולא בזיכרון של מישהו.
מי אמור לענות על השאלות האלה?
לא כולן על אותו אדם. שאלות הנתונים שייכות לבעל התהליך, שאלות ההרשאות לגורם התשתית או לספק, שאלות הכשל למפתח, ושאלות האחריות למי שמנהל את התקציב. אם אין למי להפנות קבוצה שלמה, זה ממצא בפני עצמו.
האם צריך לענות על כל העשרים גם באינטגרציה קטנה?
כן, אבל התשובה יכולה להיות קצרה. באינטגרציה של קריאה בלבד חלק מהשאלות נענות במשפט אחד, ושאלה 12 על כפילויות עשויה להיות לא רלוונטית. הערך הוא בכך שסימנתם "לא רלוונטי, כי" ולא שדילגתם.
מתי חוזרים לרשימה אחרי העלייה לאוויר?
בשלוש נקודות קבועות: אחרי התקלה הראשונה, בכל שינוי גרסה של אחת המערכות, ובכל החלפה של האדם שאחראי. שינוי בתשובה לשאלה שכבר נענתה הוא לרוב ההסבר לתקלה שנראית בלתי מוסברת.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.