Вставка штрихкодов с конвертацией в PDF

Репозиторий с шаблоном разработки «Вставка штрихкодов с конвертацией в PDF».

Описание

Решение производит конвертацию документа в pdf и вставку штрихкода в формате Code128 на каждую страницу последней версии документа.

Ограничения:

1. Документ должен быть сохранен в системе перед началом преобразования.
2. Документ не должен быть заблокирован другими пользователями.
3. Если установку штрихкода выполняет пользователь, то у него должны быть права на изменение документа.
4. Документ должен иметь хотя бы одну версию.
5. Документ должен иметь формат doc, docx или pdf.

Состав объектов разработки:

1. Решение BarCode, включающее асинхронный обработчик по вставке штрихкодов и конвертации в pdf. Поскольку решение BarCode не содержит перекрытий объектов коробочного решения, конфликты при публикации не возникнут. Это позволяет использовать функциональность, как при старте нового проекта, так и в ходе сопровождения существующих инсталляций системы.
2. Решение BarCodeTemplate, включающее действие «Создать PDF c штрихкодом документа» на ленте в карточке Договора. Служит в качестве примера вызова асинхронного обработчика, не предназначено для публикации в рамках проектов.

Note

Замечания и пожеланию по развитию шаблона разработки фиксируйте через Issues. При оформлении ошибки, опишите сценарий для воспроизведения. Для пожеланий приведите обоснование для описываемых изменений - частоту использования, бизнес-ценность, риски и/или эффект от реализации.

Внимание! Изменения будут вноситься только в новые версии.

Варианты расширения функциональности на проектах

1. Реализация вызова асинхронного обработчика на различных событиях в зависимости от бизнес-кейсов. Например, в рамках согласования перед этапом печать последняя версия конвертируется в pdf с простановкой штрихкода.
2. Изменение координат проставления штрихкода.
3. Изменение формата штрихкода, в т.ч. на QR-code.
4. Изменение состава страниц, на которые устанавливается штрихкод.
5. Добавление новых форматов документов.

Порядок установки

Для работы требуется установленный Directum RX версии 4.1 и выше.

Установка для ознакомления

1. Склонировать репозиторий с rx-template-barcodehandler в папку.
2. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.1>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': https://github.com/DirectumCompany/rx-template-barcodehandler.git'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''

Установка для использования на проекте

Возможные варианты

A. Fork репозитория.

1. Сделать fork репозитория rx-template-barcodehandler для своей учетной записи.
2. Склонировать созданный в п. 1 репозиторий в папку.
3. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.2>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': https://github.com/DirectumCompany/rx-template-barcodehandler.git'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''

B. Подключение на базовый слой.

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

1. Склонировать репозиторий rx-template-barcodehandler в папку.
2. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.1>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': '<Адрес репозитория для рабочего слоя>'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': 'https://github.com/DirectumCompany/rx-template-barcodehandler.git'

C. Копирование репозитория в систему контроля версий.

Рекомендуемый вариант для проектов внедрения.

1. В системе контроля версий с поддержкой git создать новый репозиторий.
2. Склонировать репозиторий rx-template-barcodehandler в папку с ключом --mirror.
3. Перейти в папку из п. 2.
4. Импортировать клонированный репозиторий в систему контроля версий командой: git push –mirror <Адрес репозитория из п. 1>