הגדרת תצוגת גיליון נתוני בטיחות למוצרים ב-1C-Bitrix

function importSdsDocuments(string $zipPath, int $iblockId): array {
    $zip = new \ZipArchive();
    $zip->open($zipPath);
    $results = ['ok' => 0, 'not_found' => [], 'error' => []];
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $filename = $zip->getNameIndex($i);
        if (!str_ends_with(strtolower($filename), '.pdf')) continue;
        preg_match('/^([A-Z0-9\-]+)/i', $filename, $matches);
        $article = $matches[1] ?? '';
        $product = \CIBlockElement::GetList([], [
            'IBLOCK_ID' => $iblockId,
            'PROPERTY_ARTICLE' => $article,
        ], false, ['nPageSize' => 1], ['ID', 'NAME'])->GetNext();
        if (!$product) {
            $results['not_found'][] = $filename;
            continue;
        }
        $tmpPath = sys_get_temp_dir() . '/' . $filename;
        file_put_contents($tmpPath, $zip->getFromIndex($i));
        $fileId = \CFile::SaveFile([
            'name' => $filename,
            'tmp_name' => $tmpPath,
            'type' => 'application/pdf',
        ], 'sds_documents');
        if ($fileId) {
            \CIBlockElement::SetPropertyValuesEx($product['ID'], $iblockId, [
                'SAFETY_DATA_SHEET' => $fileId,
                'SAFETY_DATA_SHEET_DATE' => date('d.m.Y'),
            ]);
            $results['ok']++;
        }
    }
    $zip->close();
    return $results;
}

הסקריפט מהיר פי 5 מהעלאה ידנית: מעבד 100 קבצים ב-20 דקות במקום שעתיים.

התקנה ב-4 שלבים:

1. צור מאפיינים function importSdsDocuments(string $zipPath, int $iblockId): array { $zip = new \ZipArchive(); $zip->open($zipPath); $results = ['ok' => 0, 'not_found' => [], 'error' => []]; for ($i = 0; $i < $zip->numFiles; $i++) { $filename = $zip->getNameIndex($i); if (!str_ends_with(strtolower($filename), '.pdf')) continue; preg_match('/^([A-Z0-9\-]+)/i', $filename, $matches); $article = $matches[1] ?? ''; $product = \CIBlockElement::GetList([], [ 'IBLOCK_ID' => $iblockId, 'PROPERTY_ARTICLE' => $article, ], false, ['nPageSize' => 1], ['ID', 'NAME'])->GetNext(); if (!$product) { $results['not_found'][] = $filename; continue; } $tmpPath = sys_get_temp_dir() . '/' . $filename; file_put_contents($tmpPath, $zip->getFromIndex($i)); $fileId = \CFile::SaveFile([ 'name' => $filename, 'tmp_name' => $tmpPath, 'type' => 'application/pdf', ], 'sds_documents'); if ($fileId) { \CIBlockElement::SetPropertyValuesEx($product['ID'], $iblockId, [ 'SAFETY_DATA_SHEET' => $fileId, 'SAFETY_DATA_SHEET_DATE' => date('d.m.Y'), ]); $results['ok']++; } } $zip->close(); return $results; } ו-SAFETY_DATA_SHEET בבלוק המידע של המוצרים.
2. מקם את הסקריפט SAFETY_DATA_SHEET_DATE בחלק הניהולי.
3. הוסף קישור ל-SDS בתבנית כרטיס המוצר.
4. הגדר את הדוח ואת מטפל האימות.

בדיקת נוכחות SDS: חשיבות ויישום

תצוגה בכרטיס המוצר

בתבנית importSdsDocuments, הוסף בלוק זה:

<?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE'])): ?>
    <?php $sdsFile = \CFile::GetFileArray($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']); ?>
    <div class="product-sds">
        <h4>Документация по безопасности</h4>
        <a href="<?= \CFile::GetPath($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']) ?>" download="<?= htmlspecialchars($sdsFile['ORIGINAL_NAME']) ?>" class="sds-download-btn">
            <span class="pdf-icon"></span> Паспорт безопасности (PDF)
            <?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'])): ?>
                <small>версия от <?= $arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'] ?></small>
            <?php endif; ?>
        </a>
        <p class="sds-note">В соответствии с <cite>ГОСТ 30333-2007</cite></p>
    </div>
<?php endif; ?>

המאפיין bitrix:catalog.element מבטיח הורדה ישירה.

אימות בעת הוספת מוצר

עבור קטגוריות שבהן SDS הוא חובה (למשל, "כימיקלים", "צבעים"), השתמש במטפל OnBeforeIBlockElementAdd:

AddEventHandler('iblock', 'OnBeforeIBlockElementAdd', function(&$fields) {
    $requiredSdsSections = \Bitrix\Main\Config\Option::get('sds_module', 'required_sections', '');
    $requiredSectionIds = array_filter(explode(',', $requiredSdsSections));
    if (in_array($fields['IBLOCK_SECTION_ID'], $requiredSectionIds)) {
        if (empty($fields['PROPERTY_VALUES']['SAFETY_DATA_SHEET'])) {
            $GLOBALS['APPLICATION']->ThrowException(
                'Внимание: для этого раздела рекомендуется прикрепить паспорт безопасности.',
                'SDS_MISSING'
            );
        }
    }
});

דוח עבור מוצרים ללא SDS

דוח ניהולי (GET <?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE'])): ?> <?php $sdsFile = \CFile::GetFileArray($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']); ?> <div class="product-sds"> <h4>Документация по безопасности</h4> <a href="<?= \CFile::GetPath($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']) ?>" download="<?= htmlspecialchars($sdsFile['ORIGINAL_NAME']) ?>" class="sds-download-btn"> <span class="pdf-icon"></span> Паспорт безопасности (PDF) <?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'])): ?> <small>версия от <?= $arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'] ?></small> <?php endif; ?> </a> <p class="sds-note">В соответствии с <cite>ГОСТ 30333-2007</cite></p> </div> <?php endif; ?> ) מציג רשימה של מוצרים מקטגוריות "כימיות" ללא SDS מצורף, עם כפתור העלאה מהירה.

SELECT ie.ID, ie.NAME, s.NAME as section_name
FROM b_iblock_element ie
JOIN b_iblock_section s ON s.ID = ie.IBLOCK_SECTION_ID
LEFT JOIN b_iblock_element_property iep ON iep.IBLOCK_ELEMENT_ID = ie.ID AND iep.IBLOCK_PROPERTY_ID = (
    SELECT ID FROM b_iblock_property WHERE IBLOCK_ID = ie.IBLOCK_ID AND CODE = 'SAFETY_DATA_SHEET'
)
WHERE ie.IBLOCK_ID = ? AND ie.ACTIVE = 'Y' AND s.ID IN (/* разделы с обязательным SDS */)
AND (iep.VALUE IS NULL OR iep.VALUE = '')
ORDER BY s.NAME, ie.NAME;

הדוח מאפשר לזהות את כל המוצרים ללא SDS בכמה קליקים.

תהליך העבודה

מה כלול

• מאפייני בלוק מידע (SAFETY_DATA_SHEET, SAFETY_DATA_SHEET_DATE)
• סקריפט העלאה המונית מ-ZIP עם טיפול בשגיאות
• תבנית תצוגה בכרטיס המוצר
• דוח עבור מוצרים ללא SDS
• תיעוד והדרכה (שעה אחת)
• חודש תמיכה

שגיאות אופייניות ורשימת בדיקה

שגיאות:

• שם קובץ שגוי (אי-התאמת מקט) — הסקריפט מסמן כ-download.
• הקובץ חורג מהמגבלה (>20 MB) — הגדר מגבלות.
• תאריך גרסה לא מוגדר — נלקח אוטומטית התאריך הנוכחי.
• שכחת לצרף SDS ידנית — האימות מזהיר.

רשימת בדיקה לפני השקה:

• [ ] כל שמות המקטים בקבצים תואמים למוצרים
• [ ] המאפיינים SAFETY_DATA_SHEET ו-SAFETY_DATA_SHEET_DATE נוצרו
• [ ] קטגוריות עם SDS חובה מוגדרות באפשרויות
• [ ] תבנית כרטיס המוצר מציגה קישור הורדה
• [ ] הדוח עובד ומציג את המוצרים הנכונים

לוח זמנים

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