Обмен с контрагентами > Загрузка исторических данных > Запуск загрузки исторических данных

Чтобы инициировать загрузку исторических данных, запустите утилиту RxCmd и выполните команду exchange run-download. Команда создает сессию загрузки за указанный период для одного абонентского ящика нашей организации.

Синтаксис вызова команды через исполняемый файл:

<Путь до Rxcmd> exchange run-download <ИД абонентского ящика нашей организации> <Начало периода> <Конец периода> -n <Пользователь, от имени которого идет подключение к Directum RX> -p <Пароль пользователя>

Синтаксис вызова команды через скрипты развертывания:

do rxcmd run --command="exchange run-download <ИД абонентского ящика нашей организации> <Начало периода> <Конец периода> -n <Пользователь, от имени которого идет подключение к Directum RX> -p <Пароль пользователя>"

Аргументы команды exchange run-download:

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

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

•Начало периода и Конец периода. Период загрузки исторических данных. Даты указываются в формате ДД.ММ.ГГГГ. Оба аргумента обязательны для заполнения.

ВАЖНО. Периоды загрузки исторических и новых документов не должны пересекаться. Например, если организация начала создавать документы в Directum RX и обмениваться ими с контрагентами с 01.10.2022, то историческую загрузку необходимо запускать в период с даты начала работы в сервисе обмена без Directum RX до 30.09.2022.

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

Подробное описание команд см. в разделе «Утилита RxCmd».

Пример запуска исторической загрузки через исполняемый файл

"D:\DirectumLauncher\etc\_builds\DirectumRX\RxCmd\rxcmd.exe" exchange run-download 15 01.01.2022 30.09.2022 -n Administrator -p 11111

'/srv/DirectumLauncher/etc/_builds/DirectumRX/RxCmd' exchange run-download 15 01.01.2022 30.09.2022 -n Administrator -p 11111

В результате создается сессия загрузки для абонентского ящика с ИД=15. Для сессии указывается состояние InWork:

Start downloading historical messages.
Created download session:
Session (1), box (15), from 01.01.22 to 30.09.22, InWork.
The download of documents for this session will start when the "Electronic exchange. Receive historical messages" job runs.
Done starting of historical messages download.

Ссылка на созданную сессию заполняется для элемента очереди синхронизации сообщений и указывается в сведениях о документе обмена.

Затем по расписанию запускается фоновый процесс «Электронный обмен. Получение исторических сообщений», который:

1.Проверяет, если ли активные сессии для действующих абонентских ящиков. Если найдена сессия в состоянии InWork, то запускает по ней работу.

2.Порционно загружает сообщения с сервиса обмена, начиная с первой указанной в RxCmd даты, и ставит их в очередь на обработку. Каждая порция включает максимум 10 000 сообщений для одного абонентского ящика. Таким образом система защищена от перегрузки. Если сообщений больше, фоновый процесс прекращает добавлять их в очередь, пока остальные сообщения не будут обработаны. При необходимости размер порции сообщений для обработки можно изменить.

3.Для каждой порции сообщений запускает асинхронный обработчик ProcessMessages «Обработка сообщений из сервиса обмена».

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

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

Типовые ошибки запуска загрузки

Если при выполнении команды exchange run-download сессия загрузки не создалась, это значит, что в командной строке переданы некорректные значения аргументов:

СМ. ТАКЖЕ