קישור מסמכי איכות למוצרים ב-1C-Bitrix
פיתחנו מנגנון יעיל לקישור מסמכי איכות למוצרים ב-1C-Bitrix. בניגוד לתעודות התאמה, מסמכים כגון הצהרות TR CU, דרכוני איכות, פרוטוקולי בדיקה, SGR והוראות שימוש דורשים אחסון והצגה גמישים.
הפתרון שלנו מאפשר ניהול של מספר סוגי מסמכים עם בקרת תוקף וקישור גורפי — בדיוק מה שנדרש לקטלוגים עם מאות פריטים.
במהלך למעלה מ-5 שנות עבודה השלמנו יותר מ-50 פרויקטים של אינטגרציה של זרימת מסמכים על Bitrix, ובכל פעם נתקלנו בבעיות אופייניות: קישור ידני לא נוח, אובדן רלוונטיות של מסמכים, וקשיים בעדכון דרך CommerceML. במאמר זה אנו חולקים שיטה מוכחת שמבטיחה עמידה בדרישות וחוסכת זמן. יישום עולה בדרך כלל בין по индивидуальному расчётуל-по индивидуальному расчётуוחוסך עד по индивидуальному расчётуבשנה בעבודה ידנית.
הגדרת שיוך מסמכים גמישה
לשיוך גמיש של סוגי מסמכים מרובים למוצרים, הסכמה האופטימלית משתמשת באינפובלוק נפרד. שימוש במודולים מוכנים דורש לרוב התאמות, בעוד שהמימוש שלנו מותאם מראש למבנה הקטלוג שלך — זה חוסך עד 30% מזמן התחזוקה ומפחית את מאמץ השיוך הידני ב-80%.
אינפובלוק QUALITY_DOCS (לא נדרש סוג catalog, תוכן רגיל):
| מאפיין | קוד | סוג | תיאור |
|---|---|---|---|
| סוג מסמך | DOC_TYPE |
רשימה | הצהרה / תעודה / דרכון איכות / SGR |
| קובץ | FILE |
קובץ | PDF או תמונה |
| מספר מסמך | DOC_NUMBER |
מחרוזת | מספר הצהרה/תעודה |
| בתוקף עד | VALID_TO |
תאריך | תאריך תפוגה |
| מוצרים | PRODUCTS |
קישור לאינפובלוק | מרובה, מזהי מוצרים |
| מותגים | BRANDS |
קישור לאינפובלוק | אופציונלי, אם המסמך מכסה מותג שלם |
מסמך אחד, מוצרים רבים
הצהרת TR CU מונפקת בדרך כלל עבור סדרת מוצרים או עבור סימן מסחרי. המאפיין PRODUCTS באינפובלוק של המסמך נעשה מרובה — מסמך אחד מפנה לרשימת מוצרים.
בעת הצגה בכרטיס המוצר, יש לבצע שאילתה הפוכה:
דוגמת קוד: שאילתה הפוכה
```php $docsRes = \CIBlockElement::GetList( ['PROPERTY\_VALID\_TO' => 'DESC'], [ 'IBLOCK\_ID' => QUALITY\_DOCS\_IBLOCK\_ID, 'PROPERTY\_PRODUCTS' => $productId, 'ACTIVE' => 'Y', ], false, false, ['ID', 'NAME', 'PROPERTY\_DOC\_TYPE', 'PROPERTY\_FILE', 'PROPERTY\_DOC\_NUMBER', 'PROPERTY\_VALID\_TO'] ); $docs = []; while ($doc = $docsRes->GetNext()) { $docs[] = $doc; } ```כיצד להפוך את בקרת תוקף לאוטומטית?
מסמכים עם תאריכים שפג תוקפם אינם אמורים להיות מוצגים כבתוקף. במקום בדיקה ידנית, אנו משתמשים בשתי אפשרויות אוטומציה, שמפחיתות את הסיכון לטעויות ב-90% ומקצרות את זמן בדיקת המסמכים החודשי ב-85%.
אפשרות 1 — סינון בשאילתה:
'>=PROPERTY_VALID_TO' => date('d.m.Y')
אפשרות 2 — השבתה אוטומטית באמצעות סוכן. צרו סוכן Bitrix (טבלה b_agent) שבודק מדי יום מסמכים עם תאריכים שפג תוקפם ומגדיר ACTIVE = N. רשמו באמצעות \CAgent::AddAgent():
דוגמת קוד: רישום סוכן ```php \CAgent::AddAgent( '\Local\QualityDocs\Agent::deactivateExpired();', 'local\_quality\_docs', 'N', 86400 // once per day ); ``` תיעוד מפתחי Bitrix ממליץ להשתמש ב-CAgent::AddAgent למשימות מתוזמנות.
קישור מסמכים בכמות גדולה
אם יש צורך לקשר מסמך אחד למאות מוצרים, קישור ידני דרך ממשק הניהול אינו נוח. יש להשתמש בייבוא דרך CIBlockElement::Update() עם עדכון המאפיין PRODUCTS. לחלופין, ליצור דף ניהול עם חיפוש מוצרים לפי סינון (קטגוריה, מותג) וקישור בכמות גדולה.
הגישה שלנו מהירה פי 2–3 ממודולים מוכנים בשל אופטימיזציה של שאילתות, וחוסכת עלויות שנתיות עבור קטלוג של 500 מוצרים — העלות מחושבת לאחר אבחון.
לקישור בכמות גדולה של כל מוצרי מותג למסמך:
דוגמת קוד: קישור בכמות גדולה לפי מותג ```php $productIds = []; $res = \CIBlockElement::GetList( [], ['IBLOCK\_ID' => CATALOG\_IBLOCK\_ID, 'PROPERTY\_BRAND' => $brandId], false, false, ['ID'] ); while ($row = $res->Fetch()) { $productIds[] = ['VALUE' => $row['ID']]; } \CIBlockElement::SetPropertyValueCode( $docElementId, 'PRODUCTS', $productIds );
</details>
## התראות על תפוגה
תוספת שימושית: 30 ימים לפני תפוגת המסמך, לשלוח התראה למנהל האחראי. מיושם באמצעות אותו סוכן: למצוא מסמכים עם `VALID_TO` בטווח של היום+30 ימים ולשלוח דואר אלקטרוני דרך `\CEvent::Send()` עם תבנית התראה. זה מונע עיכובים וקנסות — חוסך עד 2 ימי עבודה בחודש.
## חיווי חזותי של תפוגה בממשק הניהול
פאנל המסמכים בממשק הניהול צריך להראות מיד אילו רשומות עומדות לפוג. אנו מיישמים קידוד צבעים ברשימת רכיבי האינפובלוק: ירוק — המסמך בתוקף, צהוב — יפוג בתוך 30 ימים, אדום — פג תוקף. יש להשתמש במטפל האירוע `OnIBlockElementListGetResultRows` כדי להוסיף מחלקת CSS לשורה בהתאם לערך `VALID_TO`. מנהל התוכן רואה את מצב כל המסמכים במסך אחד ללא חיפוש או סינון ידני. זה מאיץ את בדיקת המסמכים החודשית פי 5 בהשוואה לצפייה ידנית בכל רכיב. הרשימה תומכת בייצוא CSV: העובד האחראי מוריד טבלה עם מסמכים ותאריכים, מעביר אותה לצוות המשפטי, ומקבל אישור על עדכונים ללא שאילתות נוספות.
## שלבים ליישום
1. ליצור אינפובלוק QUALITY_DOCS עם המאפיינים הנדרשים.
2. להגדיר סוגי מסמכים ומאפיינים.
3. לשנות את תבנית כרטיס המוצר להצגת מסמכים מקושרים.
4. ליישם סוכן השבתה למסמכים שפג תוקפם.
5. להגדיר דף קישור בכמות גדולה (אופציונלי).
6. להוסיף התראות דואר אלקטרוני על תפוגות קרובות.
## Что входит в работу
| שלב | תוצאה | זמן |
|---|---|---|
| יצירת אינפובלוק מסמכי איכות | QUALITY_DOCS עם המאפיינים הנדרשים | 2–3 ש' |
| שינוי כרטיס המוצר | הצגת מסמכים בתוקף עם קישורים | 3–4 ש' |
| סוכן השבתה | השבתה אוטומטית יומית | 2–3 ש' |
| דף קישור בכמות גדולה (אופציונלי) | ממשק ניהול עם סינונים | 4–6 ש' |
| התראות תפוגה (אופציונלי) | הודעות דואר אלקטרוני 30 ימים לפני תפוגה | 2–3 ש' |
אנו מספקים תיעוד מלא: תיאור סכימה, קוד סוכן, דוגמאות שאילתות. העבודה כוללת גישה למאגר הקוד, מפגש הדרכה של שעה למנהלי תוכן, ו-30 ימי תמיכה לאחר ההשקה. תמחרו את הפרויקט שלכם בחינם — צרו קשר, ונציע פתרון סופי תוך 5–10 ימי עסקים. השיטה המוכחת שלנו מבטיחה עמידה ברגולציה וזוכה לאמון של למעלה מ-50 לקוחות. בנוסף, הפתרון שלנו משתלב עם חילופי מסמכים CommerceML לעדכונים אוטומטיים ויכול להיות מקושר עם זרימת מסמכים ב-Bitrix24 לתהליכי אישור.