Файл конфигурации импорта. Тег <config>

Описание

Тег <config> — основной тег конфигурации, в него вложены все остальные теги. В параметрах тега задаются основные параметры импорта.

Параметры

• name — имя конфигурации.

  Используется как ключ для группировки результатов (логов) импорта. Результаты импортов с одинаковыми именами выводятся в одном и том же списке.

  Тип: Строка. Необязательный.

• save-log — управление файлом с логами импорта.

  Файл с логами импорта по умолчанию сохраняется в системе. Параметр предназначен для отмены записи файла логов в систему, в исключительных случаях проведения больших импортов, когда файл достигает больших размеров (десятки и сотни мегабайт = сотни тысяч и миллионы объектов).

  Возможные значения параметра:

  • true — файл с логами импорта сохраняется в системе,
  • false — файл с логами импорта не сохраняется в системе, логи импорта сохраняются только в логах приложения.

  Тип: Логический. Необязательный. По умолчанию: true

• threads-number — количество потоков, которыми будут обрабатываться элементы из внешнего источника. Возможность обработки данных в несколько потоков зависит от технических параметров подключения к базе данных.

  Тип: Целое число. Необязательный. По умолчанию: 1 (один поток)

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

  В многопоточном режиме проходит только сам импорт данных. Операции предобработки и постобработки всегда выполняются в один поток.

  • К предобработке относятся тэги: data-source, hierarchical-filter, column-notempty-filter, id-prefix, metaclass-resolver, script-customizer и before-import в нем.

    Если на этапе предобработки используется тег hierarchical-filter, то весь последующий импорт выполняется также в одном потоке. Это связано с необходимостью последовательного формирования иерархии данных и соблюдения их порядка, что не позволяет распараллеливать вычисления

  • К самому импорту относятся тэги: before-process-item, object-searcher, attr, converter, before-process, сохранение объекта и потом after-process
  • К постобработке относятся тэги: remove-customizer и тэги к нему относящиеся, script-customizer и after-import в нем

• description — описание импорта.

  Используется только в самой конфигурации.

  Тип: Строка. Необязательный.

• skip-workflow — управление выполнением проверок, связанных с жизненным циклом объектов.

  Пример использования: импорт закрытых запросов с переводом их в статус "Закрыт".

  Возможные значения параметра:

  • false — пропускаются проверки, связанные с жизненным циклом объектов.
  • true — проверки выполняются.

  Тип: Логический. Необязательный. По умолчанию: false.

Вложенные теги

• <mode> — режим импорта
• <parameter> — дополнительные параметры
• <gui-parameter> — дополнительные параметры
• <class> — объявление импорта из источника

Пример

<config description="Example"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="../../../../../../target/classes/advimport/schema1.xsd"
        save-log="true"
        threads-number="1"
        skip-workflow="false" >
  
  
</config>