17. Управление вложениями

Интеграция не ограничивается текстовыми данными.

В промышленной или операционной среде одних данных недостаточно.
Реальную ценность потока составляет его способность бытьобоснованное, доказанное и контекстуализированное.

Вот почему модуль должен позволять связать с потоком XML наборвложения, qui représentent la preuve terrain.

Эти части могут включать в себя:

• PDF (отчеты, разрешения, отчеты),

• изображения (полевые фотографии, аномалии, до/после),

• сканы (подписанные документы, чеки),

• экспортированные формы,

• автоматически генерируемые отчеты,

• технические или нормативные документы.

Цель состоит в том, чтобы передать не толькоинформация, но исопутствующие документальные доказательства.

17.1 Централизация вложений

Модуль должен позволятьцентрализовать все документы, связанные с полевым действием или бизнес-объектом.

Каждое вмешательство, отчет или форма должны иметь возможность группировать:

• его фотографии,

• его документы,

• его доказательства,

• его экспорт.

Такая централизация позволяет:

• во избежание рассредоточения (электронная почта, локальные файлы, WhatsApp и т. д.),

• чтобы убедиться, что все прикреплено к правильному объекту,

• для упрощения передачи в целевые системы,

• для создания полной прослеживаемости.

Таким образом, каждый поток становитсяполный файл, а не простая строка данных.

17.2 Связь с XML-фидом

Вложения должны иметь возможностьсвязанный непосредственно с сгенерированным потоком XML.

Эту ассоциацию можно осуществить несколькими способами:

• включение в архив (ZIP с XML-файлами),

• ссылка на сохраненные документы,

• кодировка base64 (в соответствии с ограничениями ERP),

• параллельная передача через API или SFTP.

Модуль должен управлять:

• соответствие между XML и его частями,

• уникальная идентификация файлов,

• согласованность между содержимым XML и отправленными документами.

Пример :

• отчет о вмешательстве в формате XML должен сопровождаться соответствующим PDF-файлом,

• аномалия должна включать связанные фотографии,

• разрешение должно включать подписанную версию.

Это гарантирует, что целевая система получитобогащенный и полезный поток.

17.3 Поддерживаемые типы файлов

Модуль должен поддерживать разные форматы файлов, в зависимости от использования поля.

Основные форматы включают в себя:

• PDF (стандарт документа),

• JPEG/PNG (полевые фотографии),

• отсканированные файлы,

• созданные экспорты (формы, отчеты),

• возможно офисные документы (Word, Excel).

Важно, чтобы система:

• распознает форматы,

• проверяет их достоверность,

• обеспечивает их читаемость,

• избегает форматов, несовместимых с целью.

Такое управление гарантирует, что документы останутся пригодными для использования в течение долгого времени.

17.4 Именование и структурирование файлов

Каждое вложение должно бытьназваны и структурированы последовательным и стандартизированным образом.

Хорошее именование позволяет:

• быстро идентифицировать контент,

• чтобы избежать дублирования,

• для облегчения исследований,

• для гарантии совместимости с внешними системами.

Имя может включать в себя:

• идентификатор объекта (например, уведомление, оборудование),

• тип документа,

• дата,

• версия,

• автор или источник.

Пример :

SK_AVIS_1209961516_RAPPORT_2026-03-20.pdf

Модуль должен автоматически управлять этими соглашениями, чтобы избежать человеческих ошибок.

17.5 Отслеживание вложений

Как и в случае с XML, вложения должны бытьпрослеживаемый.

Система должна знать:

• кто добавил документ,

• когда оно было добавлено,

• с каким объектом он связан,

• если он был изменен или заменен,

• было ли оно передано или нет.

Эта прослеживаемость необходима для:

• аудиты,

• соответствие нормативным требованиям,

• управление спорами,

• доказательство вмешательства.

Таким образом, каждый файл становитсявременные и контекстуализированные доказательства.

17.6 Проверка вложений

Модуль должен иметь возможностьпроверяйте вложения перед их включением или отправкой.

Проверки могут включать в себя:

• обязательное наличие определенных документов,

• максимальный размер,

• разрешенный формат,

• читаемость файла,

• соответствие типу вмешательства.

Например :

• необходимо приложить разрешение,

• отчет без фотографии может быть заблокирован по бизнес-правилу,

• в выдаче испорченного документа должно быть отказано.

Эти элементы управления помогают предотвратить отправку неполных или непригодных для использования потоков.