пользователям программных продуктов Scala 5.1, iScala 2.1, iScala 2.2, iScala 2.3, iScala 3.0, iScala 3.1, iScala 3.2 (и так далее)

Как настроить Service Connect для автоматического импорта Заказов на Закупку из XLS файла?

Иногда эта задача может показаться слишком сложной, особенно для того, кто раньше никогда не сталкивался с xslt преобразованиями, однако, на самом деле всё не так драматично, как может показаться на первый взгляд. Очень надеюсь, что моё пошаговое описание с картинками убедит Вас в этом.

Начнём с задачи: имеется xls файл, который поставщик присылает по электронной почте. Будем исходить из того, что коды запасов в этом файле совпадают с кодами запасов, имеющимися в iScala.

Файл для импорта в формате Excel

Перейдём в административную консоль iScala, откроем «Интеграция» и добавим новый пакет рабочего потока:

Создание нового пакета рабочего потока Service Connect

Сохраним его под именем PurchaseOrderImport и добавим в него новый рабочий поток:

Добавление нового рабочего потока

Выберем пункт меню Инструменты — Утилита схемы

Вызов утилиты схемы

Выберем исходный Excel файл, назовём также файл схемы. Выберем конверсию образцов данных, как на картинке ниже:

Параметры утилиты схемы

В следующем окне выберем преобразование excel2xml

преобразование excel2xml

Укажем следующие параметры преобразования:

<DefaultNamespace>http://XLS</DefaultNamespace>
<FirstRowContainsFieldNames>true</FirstRowContainsFieldNames>

Параметры преобразования

Проверка результатов настройки преобразования:

Проверка результатов настройки преобразования

Установим флажок как на картинке ниже:

Установите флажок как на картинке

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

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:tns="http://XLS" attributeFormDefault="unqualified" elementFormDefault="qualified"
targetNamespace="http://XLS" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="table">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" name="row">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="StockCode" type="xs:string" />
              <xs:element name="InvoiceNo" type="xs:unsignedInt" />
              <xs:element name="InvoiceDate" type="xs:string" />
              <xs:element name="LineNo" type="xs:unsignedByte" />
              <xs:element name="StockItemDescription" type="xs:string" />
              <xs:element name="Quantity" type="xs:unsignedShort" />
              <xs:element name="Price" type="xs:string" />
              <xs:element name="Value" type="xs:string" />
              <xs:element name="Origin" type="xs:string" />
              <xs:element name="NetWeight" type="xs:string" />
              <xs:element name="GrossWeight" type="xs:string" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
      <xs:attribute name="SheetName" type="xs:string" use="required" />
    </xs:complexType>
  </xs:element>
</xs:schema>

В меню выберем свойства процесса:

свойства процесса

На закладке «Компания» установим конкретную компанию:

Закладка Компания

А на закладке «Финансовый год» — конкретный финансовый год:

Закладка Финансовый Год

С помощью элемента «Connection» соединим Start и Finish

С помощью элемента Connection соединим Start и Finish

Теперь процесс может быть сохранён:

Сохранить процесс

Назовём его PurchaseOrderFromExcelFile:

Назовём его PurchaseOrderFromExcelFile

Добавим элемент Conversion и укажем входную и выходную схему:

Добавим элемент Conversion и укажем входную и выходную схему:

С помощью элемента Connection соединим элементы схемы

С помощью элемента Connection соединим элементы схемы

Возьмём готовый шаблон преобразования «плоского» одноуровневого представления данных в Excel файле в иерархическое представление структуры заказа на закупку. Файл подготовлен мною, называется XLStoPurchaseOrder.xslt и выглядит следующим образом:

Содержимое файла XLStoPurchaseOrder.xslt
Файл нужно положить в папку, как на картинке ниже

Местоположение файла преобразования

Как только файл появится в вышеупомянутой папке, он становится доступным в выпадающем списке в окне параметров преобразования:

окно параметров преобразования

Откорректируем файл (закомментируем ненужные поля, укажем код поставшика, приведём в соответствие названия полей из источника), например: <xsl:value-of select=»src:Quantity»></xsl:value-of> вместо <xsl:value-of select=»src:QtyOrdered»></xsl:value-of>

Корректировка файла преобразования. Начало

Корректировка файла преобразования. Окончание

Сохраним процесс. Даже если мы ничего не корректировали в редакторе, но что-то меняли в файле преобразования (внешним редактором), я рекомендую после этого зайти в рабочий процесс, который использует данное преобразование и принудительно сохранить его. Так система поймёт, что нужно заново прочитать все файлы, используемые процессом:

Сохранение процесса

Теперь необходимо объяснить системе, в каких случаях использовать созданный рабочий поток. Первое, что необходимо сделать, это создать новый тип сообщения:

Создание нового типа сообщения

Назовём его PurchaseOrderFromExcel и добавим действие под названием Process:

Назовём новый тип сообщения PurchaseOrderFromExcel и добавим действие под названием Process

Теперь добавим новую карту сообщений:

Новая карта сообщений

Новая карта сообщений

При нажатии на кнопку «Выбор» можно увидеть список всех возможных вариантов. Лучше всего снять все флажки кроме «Процессы»:

Лучше всего снять все флажки кроме Процессы

После выбора процесса возвращаемся в предыдущий экран

Новая карта сообщений

Следующий шаг — добавление входного канала:

Добавление нового входного канала

Назовём его PurchaseOrderFromSupplierXLS. Тип — Файл

Новый входной канал

Конфигурируем канал. Закладка «Свойства коммуникатора» должна выглядеть примерно так:

Свойства коммуникатора

Для «КнфгПреобразов.» указываем те же свойства, которые мы указывали при использовании утилиты схемы:

указываем те же свойства, которые мы указывали при использовании утилиты схемы

Возвращаемся обратно:

Свойства коммуникатора

На закладке «Свойства Сообщения» указываем тип сообщения, который мы недавно добавляли

На закладке Свойства Сообщения указываем тип сообщения, который мы недавно добавляли

Входной канал сконфигурирован

Входной канал настроен

Входной канал настроен

Копируем исходный XLS файл в папку входного канала:

Папка входного канала

Переходим в Административную консоль и в разделе «Отслеживание документов» видим результат:

Отслеживание обработки сообщений

Посмотрим, что внутри:

Подробности обработки сообщения

Подробности обработки сообщения

Возвращаемся в редактор рабочих потоков. Добавляем менеджер «Purchase Order In»:

Добавляем менеджер Purchase Order In

Конфигурируем его свойства

Свойства менеджера

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

С помощью элемента Connection соединим элементы схемы

Снова копируем исходный XLS файл в папку входного канала. Смотрим результат:

Отслеживание обработки сообщений

Подробности обработки сообщения

Теперь посмотрим, что произошло в iScala:

Запрос по заказу на закупку

Мы получили то, что хотели. На всё это у меня вместе с подготовкой картинок ушло чуть более одного часа. Чтобы подготовить это описание — ещё 2 часа. Думаю, что и у Вас получится.

Если у Вас возникли какие-либо вопросы, не стесняйтесь их задать.

 

Список опубликованных процедур: