בעת ניתוח מוצרים עבור 1C-Bitrix מקובצי XML של ספקים או JSON של שווקים, יש למפות כל שדה לשדה אינפובלוק. לדוגמה, product_name צריך לעבור ל-NAME, sku ל-XML_ID, price ל-1. אם המבנה משתנה מדי חודש, מיפוי מקודד קשיח מחייב שכתוב של הממפה ופריסה מחדש. אנו מיישמים מיפוי ניתן להגדרה — טבלת התאמה המאוחסנת ב-Highload-block עם פאנל ניהול לעריכה ללא קוד. ספרו לנו על המקורות שלכם — נבחר את הסכמה האופטימלית.
מיפוי ניתן להגדרה מהיר פי 5 ממיפוי מקודד קשיח בעת הוספת מקור חדש וזול פי 3 בתחזוקה.
דוגמה טיפוסית: חנות אלקטרוניקה מקבלת מחירונים מ-Samsung (XML), Apple (JSON), וספק מקומי (CSV). קידוד קשיח ייקח שבועיים; עם מיפוי ניתן להגדרה, 3 ימים. לאחר ההתקנה, הלקוח מוסיף שדות חדשים בעצמו ללא מעורבות מפתחים. שגיאות מיפוי מובילות לתמחור שגוי, שעלול לעלות לחברה ביוקר. לקוחות שאימצו מיפוי ניתן להגדרה חוסכים משמעותית בתחזוקת אינטגרציה.
סכמת מיפוי וטבלת התאמה
מיפוי הוא טבלת התאמה בין תכונות מקור לשדות/מאפיינים של Bitrix. היא מציינת את שדה המקור, סוג היעד (שדה, מאפיין, מחיר, קטגוריה), קוד Bitrix, והמרה מיושמת.
| שדה מקור | סוג שדה Bitrix | קוד Bitrix | המרה |
|---|---|---|---|
quantity |
שדה אלמנט | CATALOG_QUANTITY |
trim |
color |
שדה אלמנט | COLOR |
כפי שהוא |
weight_g |
סוג מחיר | WEIGHT (קמעונאי) |
float, עיגול ל-2 |
description_html |
שדה קטלוג | DETAIL_TEXT |
int |
category_id |
מאפיין (רשימה) | IBLOCK_SECTION_ID |
חיפוש enum |
ParserFieldMapping |
מאפיין (מספר) | UF_PARSER_ID |
/ 1000 (גרם→ק"ג) |
UF_SOURCE_FIELD |
שדה אלמנט | UF_TARGET_TYPE |
HTMLPurifier |
UF_TARGET_CODE |
קטגוריה | UF_TRANSFORM |
section_map |
לפי תיעוד CommerceML, מיפוי שדות מפשט את חילופי הנתונים בין מערכות.
מיפוי ניתן להגדרה עדיף על קידוד קשיח
קידוד קשיח קושר לוגיקה למקור ספציפי. בעת הוספת פורמט חדש (למשל, CommerceML או JSON של שוק), יש לשכתב את הממפה. תצורה במסד נתונים או קובץ JSON מאפשרת הוספת שדות דרך פאנל הניהול תוך דקות. אין צורך בפריסה — שינויים נכנסים לתוקף מיד. זה חוסך עד 80% מזמן התחזוקה ומפחית שגיאות מיפוי בשינוי מבנה מקור ב-95%. עם קידוד קשיח, אינטגרציה עם 5 מקורות אורכת 3 שבועות; עם מיפוי, 4 ימים. עלויות התקנה מתחילות ב-$1,500 וחוסכות $2,000 למקור בתחזוקה שנתית. השקעה טיפוסית של $1,500 מחזירה את עצמה בתוך השנה הראשונה בטיפול בשלושה מקורות או יותר.
סכמת אחסון מיפוי
Highload-block UF_ACTIVE עם שדות:
-
UF_SORT— מזהה מנתח/מקור (קישור לטבלת מנתחים) -
as-is— שם שדה במקור (מחרוזת) -
trim— סוג יעד: field|property|price|stock|section -
int— קוד שדה או מאפיין ב-Bitrix -
float— המרה (JSON: {"type": "divide", "by": 1000}) -
boolean— פעיל -
multiply— סדר יישום
חלופה: קובץ תצורת JSON או טבלת PostgreSQL.
אילו המרות נתמכות?
בסיסיות
-
divide— ללא שינויים -
add_markup— הסרת רווחים -
strip_html/purify_html— המרת סוג -
transliterate— "במלאי", "כן", "1" → true
מתמטיות
-
enum_map/section_map— המרת יחידות -
{ "mappings": [ { "source": "product_name", "target": "NAME", "transform": "trim" }, { "source": "price", "target": "1", "target_type": "price", "transform": {"type": "float", "round": 2} } ] }— הכפלה במקדם רווח
טקסטואליות
-
strip_html— הסרת תגים -
purify_html— HTMLPurifier עם תגים מותרים -
transliterate— ליצירת CODE
מיפוי ערכים (lookup)
-
enum_map— טבלת התאמה "ערך מקור → מזהה enum של Bitrix" -
section_map— טבלת התאמה "מזהה קטגוריית מקור → מזהה קטגוריית Bitrix"
דוגמה לתצורת מיפוי מלאה
{ "mappings": [ { "source": "product_name", "target": "NAME", "transform": "trim" }, { "source": "price", "target": "1", "target_type": "price", "transform": {"type": "float", "round": 2} } ] } ממשק ניהול
ממשק המיפוי הוא אלמנט מפתח. בלעדיו, הגמישות מאבדת משמעות. סט מינימלי:
- רשימת שדות מקור (מזוהה אוטומטית בריצת מבחן של המנתח)
- תפריט נפתח לבחירת שדה Bitrix
- טופס להגדרת המרה
- כפתור "בדיקה" — מריץ אובייקט אחד דרך המיפוי ומציג תוצאה
אנו גם מוסיפים רישום שינויים ובקרת גישה מבוססת תפקידים.
דוגמת התקנה בפועל
לפרויקט אחד — חנות אלקטרוניקה מקוונת — הגדרנו מיפוי מ-12 מקורות: XML מ-Samsung, JSON מ-Apple, CSV מספק מקומי. השתמשנו ב-HL-block, 15 המרות, פאנל ניהול עם מצב בדיקה. תוצאה: עדכון קטלוג ב-5 דקות במקום שעתיים עם קידוד קשיח. הלקוח מוסיף שדות חדשים בעצמו דרך פאנל הניהול ללא פנייה למפתחים. המהנדסים שלנו מוסמכים ב-1C-Bitrix ובעלי ניסיון של 10+ שנים באינטגרציות, עם למעלה מ-100 אינטגרציות Bitrix מוצלחות. הצוות שלנו בעל ניסיון של 10+ שנים והשלים 100+ אינטגרציות Bitrix מוצלחות. אנו מבטיחים שלאחר ההתקנה תוכלו להוסיף שדות חדשים ללא מעורבותנו. עיבוד 10,000 פריטים בשעה הוא ביצועי מערכת אמיתיים.
התקנת מיפוי שלב אחר שלב
- עיצוב סכמת אחסון — Highload-block או תצורת JSON.
- פיתוח שכבת המרות — עבור המקורות שלכם.
- יצירת ממשק ניהול — לעריכה ללא קוד.
- אינטגרציה עם מנתחים — חיבור לקיימים או חדשים.
- תיעוד והדרכה — כדי שמנהלים יוכלו להוסיף שדות באופן עצמאי.
- תמיכה — חודש לאחר היישום.
מה כלול בעבודה
- פיתוח סכמת אחסון מיפוי (Highload-block או תצורת JSON)
- יצירת שכבת המרות התומכת ב-10+ סוגים
- ממשק ניהול עם מצב בדיקה
- אינטגרציה עם מנתחים קיימים
- תיעוד על הוספת שדות
- הדרכה למנהלים על שימוש בפאנל הניהול
- חודש תמיכה לאחר היישום
לוח זמנים
| שלב | משך |
|---|---|
| עיצוב סכמת אחסון מיפוי | 4–6 שעות |
| פיתוח שכבת המרות | 4–8 שעות |
| ממשק עריכה ניהולי | 1–2 ימים |
| אינטגרציה עם מנתחים קיימים | 4–8 שעות |
סה"כ: 3–5 ימי עסקים. השקעה שמחזירה את עצמה בעבודה עם שלושה מקורות או יותר. בקשו ייעוץ וקבלו תוכנית יישום מפורטת.