# אינטגרציה לחומרה

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

העמוד המלא: https://oversight.co.il/solutions/hardware-integration

## בקצרה

התוכנה והציוד שלכם מתחילים לעבוד יחד.

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

- ציוד מחובר
- נתונים לתהליך
- תוכנה וחומרה

## הפירוט

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

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

## מה כלול

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

## היתרונות

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

## התהליך

1. **ממפים פעולה וציוד**: מגדירים את התהליך ואת הנתונים, ומזהים דגמים, סביבה וממשקים זמינים. אין הנחה שכל ציוד מתאים לאותה דרך חיבור.
2. **בוחרים את דרך החיבור**: בוחנים SDK, API ופרוטוקולים זמינים ומגדירים אם נדרשת שכבת תיווך מקומית. מסכמים את תרחישי הפעולה והחריגה.
3. **מפתחים את הרצף**: מפתחים את החיבור ואת הרכיבים שנבחרו ומשלבים את המידע או הפעולה בתוכנה שמקבלת אותם.
4. **בודקים מול הסביבה**: בודקים קריאה, תגובה וניתוק בתרחישים שנבחרו. מסכמים את ההתנהגות והתלויות לפני שילוב החיבור בעבודה.

## שאלות ותשובות

### האם אפשר להתחבר לציוד שכבר קיים בעסק?

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

### מה קורה כשאין SDK או תיעוד מתאים?

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

### האם החיבור יכול לעבוד עם מערכת Web?

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

### מה קורה אם הציוד מתנתק או מחזיר שגיאה?

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

### האם אתם גם רוכשים ומתקינים את הציוד?

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

### מה ההבדל בין חיבור ציוד לחיבור API בין מערכות?

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

## פרויקטים

- [Zedix](https://oversight.co.il/projects/zedix.md): Zedix
- [MindFly](https://oversight.co.il/projects/mindfly-live.md): MindFly

## פתרונות משלימים

- [פיתוח תוכנות למחשב](https://oversight.co.il/solutions/desktop-software.md)
- [פיתוח מערכות ואפליקציות Web](https://oversight.co.il/solutions/web-systems.md)
- [פיתוח מערכות מידע וניהול](https://oversight.co.il/solutions/management-systems.md)
- [סליקה ותשלומים](https://oversight.co.il/solutions/payments.md)

## מידע מקצועי

- [אינטגרציה שלא נשברת: איך מחברים מערכות שלא נבנו לדבר זו עם זו](https://oversight.co.il/knowledge/automation/api-integrations-guide.md): למה רוב האינטגרציות נופלות בחודש השלישי, ואיך בונים חיבור שממשיך לעבוד גם כשהצד השני משתנה.

## טכנולוגיות

- C#
- Node.js
- מדפסות ומשקלים
- מסופי סליקה
