ВНИМАНИЕ!

Данная статья содержит информацию по настройкам, релевантным только для обмена с кассами или модулем интеграции. Настройки импорта XML для обмена через сервер доступны по обращению к команде техподдержки УКМ 5.

В данной статье приведены только некоторые настройки, необходимые для корректной работы конвертера Импорт XML. Ознакомиться с подробным описанием структуры файлов импорта можно ЗДЕСЬ. 

Настройка выполняется в конфигурационном файле xml5_import.conf (services\converters\xml5_import.conf), расположенном на кассовом сервере по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:


Загрузка данных о кассирах

В настройках есть три параметра для управления загрузкой кассиров:

- defaultRoleIdForUser – роль по умолчанию;

- roleIdMap;

- createUserCard:

[  {externalId = 1, internalId = 1}

   {externalId = 2, internalId = 2}  ]            (соответствие между ролями во внешней системе (externalId)
                                                   и в кассовой системе (internalId))

Правила загрузки параметров defaultRoleIdForUser и roleIdMap следующие:

- если в записи в файле storeCashiers отсутствует тег roleId или если тег roleId есть, но для него не указано мапирование во внутреннюю роль, то:

       - если в базе нет кассира с идентификатором id, то в базу будет добавлена новая запись с ролью, указанной в параметре  defaultRoleIdForUser=1;

       - если базе есть идентификатор с таким id, то назначенная ему роль изменена не будет, но в остальные параметры будут записаны значения из файла;

- если в записи присутствует тег roleId, и для него указано мапирование данной роли во внутреннюю роль, то:

       - если в базе нет кассира с идентификатором id, то в базу данных будет добавлена новая запись с ролью в соответствии с мапированием;

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

Пример:

<?xml version="1.0" encoding="UTF-8"?>

<storeCashiers fullness="F" storeId="00-000001">

       <cashier>

             <id>12</id>

             <name>Лисник М. В.</name>

             <password>123345</password>

       </cashier>

       <cashier>

<roleId>3</roleId>

             <id>10</id>

             <name>Иванюк И. В.</name>

             <password>34567</password>

       </cashier>

</storeCashiers>

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

Конвертирование из "внешнего" XML-формата во "внутренний" документ

{

  "converters.xml5_import_converter_plugin": {

    params : {

      inputFolderName = "/home/ukm5/mint/exchange/converters/in"                 (каталог, куда торговая система выкладывает данные)

      outputFolderName = "/home/ukm5/mint/exchange/items/in"                     (каталог, куда конвертер выгружает входную информацию,
                                                                                  преобразованную во внутренний формат)

       archiveFolderName = "/home/ukm5/mint/exchange/converters/xml_in_archive"  (каталог, куда конвертер «складывает» обработанные файлы)

      tempFolderName = "/home/ukm5/mint/exchange/converters/xml_in_tmp"

      scanDelay = 60 seconds                                                     (частота, с которой конвертер просматривает входной каталог
                                                                                  inputFolderName)

      storeIdMap: [                                                              (соответствие кодов магазинов во внешней системе (externalId) и 
                                                                                  магазинов в УКМ 5 (internalId). Коды магазинов во внешней системе –
                                                                                  это storeId в описанных выше файлах)

        {externalId = 11, internalId = 1}
        {externalId = 22, internalId = 2}
        {externalId = 33, internalId = 3}
        {externalId = 44, internalId = 4}

      ]

roleIdMap: [ 
{externalId = 1, internalId = 1}
{externalId = 2, internalId = 2}
]

defaultRoleIdForUser = 1
createUserCard = true

groupItemsConvertEnable = true
itemsConvertEnable = true
pricesConvertEnable = true
sellersConvertEnable = true
taxesConvertEnable = true
usersConvertEnable = true
}
}
}

Если для магазина мапирование не указано, то файлы будут загружаться с идентификатором, указанным в настройках магазина на кассовом сервере по адресу Магазин – Описание – Интеграция – Id во внешней системе:

Другими словами, отсутствие записи для магазина в данном параметре эквивалентно следующей записи:

{externalId = 1144, internalId = 39}.

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

 roleIdMap:[                                 (соответствие идентификаторов ролей кассиров во внешней системе (externalId)
                                              и магазинов в УКМ 5 (internalId). Код роли во внешней системе – 
                                              это roleId в файле storeCashiers)

        {externalId = 1, internalId = 1}
        {externalId = 2, internalId = 2}

      ]

      defaultRoleIdForUser = 1               (роль, к которой будет привязана новая запись о кассире, если 
                                              в файле storeCashiers для неё не указан параметр roleId 
                                              (подробнее см. описание файла storeCashiers))

      createUserCard = true                  (если этот параметр установлен в true, то для всех загружаемых записей 
                                              будут созданы карты кассиров и в них будет записано содержание поля
                                              storeCashiers.password)

Описание, какую информацию необходимо загружать конвертеру

      groupItemsConvertEnable = true – товарная иерархия

      itemsConvertEnable = true      – товары (и штрихкоды)

      pricesConvertEnable = true     – цены

      sellersConvertEnable = true    – продавцы

      taxesConvertEnable = true      – налоги

      usersConvertEnable = true      – кассиры

Если внешняя система выгружает файлы определенного типа, а конвертер их не загружает (из-за соответствующей настройки), то выгруженные файлы будут оставаться во входном каталоге (inputFolderName).