Организация — это структурное подразделение, ведущее собственную канцелярию. В орг. структуре одного экземпляра ARTA Synergy может быть одна или несколько организаций. Предполагается, что если на одном сервере должно присутствовать несколько организаций, то для каждой из них настраиваются журналы входящих и исходящих документов и на эти журналы даются права сотрудникам канцелярии соответствующих организаций.

Группа организаций — это именованное объединение нескольких организаций, находящихся на одном и/или разных серверах ARTA Synergy.

Получателем документа может выступать как организация, так и группа организаций, отправителем — одна организация.

Обмен документами происходит через почту. После регистрации документа отправителем df-ex формирует почтовое сообщение и отправляет его на почтовые адреса получателей.

Вложения документа ARTA Synergy добавляются в почтовое сообщение так же как вложения. Если размер файла вложения превышает 10МБ, то он бьется на части по 10МБ и каждая часть отправляется отдельным письмом.

Требования к форме карточки документа:

Участники обмена документами (организации и группы организаций) хранятся в Synergy в справочнике с кодом ExtDtiOrganization.

Данный справочник содержит следующие поля, характеризующие участника:

Организации объединяются в группы через дополнительный справочник с кодом ExtDtiOrganizationGroup. Данный справочник, должен иметь поля:

Идентификаторы получателей справочника ExtDtiOrganization и идентификаторы справочника ExtDtiOrganizationGroup должны быть уникальны.

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

Код типа документов для журнала входящих

Код типа документов для журнала входящих может быть указан двумя способами: как значение поля DocTypeCode справочника организаций или зашит в форму исходящего документа. Рассмотрим подробнее оба случая.

1. Значение кода типа документа в поле DocTypeCode справочника ExtDtiOrganization

Данный способ наиболее прост в использовании. Его необходимо выбрать если есть необходимость существования нескольких организаций на одном сервере либо для каждой организации достаточно наличие одного журнала входящих документов.

При использовании этого способа каждая организация может иметь только один журнал входящих и один журнал исходящих документов (имеются ввиду те, которые будут участвовать в обмене документами. Не участвующих в обмене документами журналов может быть создано неограниченное количество)

2. Значение кода типа документа зашито в форму исходящего документа

Тип документа «зашит в форму» означает, что тип документа, прописан в форме исходящего документа и у любого получателя тип документа с данным кодом должен существовать. Строка, соответствующая коду документа, прописывается в данных формы таким образом:

<DocDataType>DocAnswer</DocDataType>

Значением DocDataType является не сам код типа документа, а его часть. В таблице ниже описано соответствие DocDataType и кода типа документа.

Этот способ указания типа документа можно использовать если каждая организация находится на выделенном сервере и существует необходимость в использовании двух журналов для входящих документов.

В этом случае на каждом экземпляре AS вы должны будете создать типы документов с перечисленными выше кодами и соответствующие им журналы входящих.

Код типа документов для журнала исходящих

Код типа документов для журнала исходящих должен быть выбран исходя из описанных ниже правил, иначе — после регистрации документа, он не будет отправлен получателям.

Если на одном экземпляре ARTA Synergy существует только одна организация-участник обмена документами, то код типа документа должен быть ExtDtiOutDocInc.

Если на одном экземпляре ARTA Synergy существует несколько организаций, то код типа документа должен иметь вид ExtDtiOutDocInc - идентификатор_организации

Этот пакет создает необходимые библиотеки для работы DFEX модуля. Для установки пакета нужно поставить пакет arta-synergy-dfex на серверах всех участниках интеграции.

Устанавливаем пакет dfex:

aptitude install arta-synergy-dfex 

В результате установки пакетов создаются файлы:

Так же автоматически вносятся следующие изменения для каждого участника интеграции:

Для настройки логирования действий по отправке и получению откройте файл:

nano /opt/synergy/jboss/standalone/configuration/standalone-onesynergy.xml

В элемент subsystem xmlns="urn:jboss:domain:logging:1.1" добавьте следующее:

<periodic-rotating-file-handler name="integration-handler"> 
    <formatter> 
        <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/> 
    </formatter> 
    <file relative-to="jboss.server.log.dir" path="integration.log"/> 
    <suffix value=".yyyy-MM-dd"/> 
    <append value="true"/> 
</periodic-rotating-file-handler> 
<logger category="kz.arta.synergy.ext.dfex"> 
    <level name="TRACE"/> 
    <handlers> 
        <handler name="integration-handler"/> 
    </handlers> 
</logger> 

Выполнить следующий запрос:

use synergy;
update sc_application_log_provider set alp_jndi='java:app/df-ex-ejb/DTIApplicationLogProviderEJB!kz.arta.synergy.ejb.log.ApplicationLogProvider' WHERE alp_id='EXT_DFEX';

Чтобы посмотреть логи

tail -f -n 100 /var/log/supervisor/app-stderr---supervisor-….log