×
Меню
Поиск
 
   
   
   
 
SalesWorks Enterprise 2.73.26
 (c) SoftServe Business Systems, 2021

Процедуры обмена

Справочник Процедуры обмена предназначен для регистрации процедур Импорта\Экспорта и определения прав доступа к процедуре для пользователей системы. Для регистрации процедур Импорта и Экспорта используется  одна форма. Тип процедуры определяет логику поведения элементов формы и определяет количество закладок в нижней части формы редактирования.
 
 
Табличный список [Наверх]
 
 
Табличный список Процедуры обмена содержит следующие колонки:
 
В окне Создания процедуры обмена существует возможность создать и редактировать процедуру Импорта или Экспорта.
 
 
Справочник Пакеты процедур обмена предназначен для возможности запускать несколько процедур обмена в одной логической трансакции:
 
Табличный список Пакеты процедур обмена содержит следующие колонки:
 
Режим пакета Архив с файлами предполагает , что результаты работы пакета процедур обмена будут представлены одним архивом с файлами с результатом работы процедуры в каждом из них.
Режим пакета Файл со страницами означает, что результаты работы пакета процедур обмена представлены на нескольких страницах одного файла.
 
Если в процедурах обмена (которые включены в определенный пакет процедур) и в Пакете процедур обмена проставлены разные способы доставки, то выполняться тот способ, который указан в Пакете процедур обмена.
 
При привязке, отвязке или изменении свойств привязки, через инлайн едит, Пакет процедур обмена переводится в статус Разрабатывается, и не отображается в справочнике Запуск процедур обмена.
Также, чтобы Пакет процедур обмена отображался в справочнике Запуск процедур обмена, пользователь должен иметь доступ ко всем процедурам пакета.
 
Процедура Импорта [Наверх]
 
Процедура Импорта позволяет загружать необходимые данные в систему. 
 
 
Закладка Общие дает возможность настроить общие параметры по Импорту/Экспорту данных.
 
Выпадающий список Тип процедуры имеет такие значения:
0 – импорт
1 – экспорт
 
Выпадающий список Папка содержит набор существующих вложенных папок для группировки процедур Импорта с возможностью создания новых элементов. Список отображается в виде Дерева или Таблицы. 
 
В ячейку Процедура обмена вводится краткое описание процедуры. 
 
В поле Описание производится развернутое описание процедуры обмена.
 
Флажок Нотификация о результатах дает возможность получить результаты процедуры на электронный адрес, который прописан в поле  Список получателей. Так же данный адрес должен быть прописан в настройках системы. В случае отсутствия флажка Список получателей будет неактивным. Нотификация будет работать только в случае установки в опции 10087 значения 1 и заполнения параметров SMTP сервера в опции 10088.
 
Параметры -> Глобальные параметры -> Отправлять результаты импорта на почту операторам (10087)
Параметры -> Глобальные параметры -> Параметры SMTP сервера для отправки сообщения на почту (10088)
 
Выпадающий список Статус содержит перечень статусов процедуры обмена. Возможные значения:
1 – разрабатывается
2 – активный
9 – неактивный
 
При создании процедуры Импорта в статус 2 – активный можно перевести только после заполнения закладки Колонки
 
Выпадающий список Тип файла для Импорта состоит из перечня форматов, в которых процедура сможет обрабатывать данные:
0 – CSV
1 – XLS
2 – XLSX
 
Поле Имя или маска файла обязательно для заполнения и предназначено для введения имени или маски файла.
 
Выпадающий список Уровень контроля выходных данных появляется только при выборе типа процедуры Импорт и несет такие доступные значения:
0 – Не загружать при наличии ошибок
1 – Загружать все записи
 
Флажок в ZIP-формате указывает, что файл будет помещен в ZIP-архив.
 
Поле Пример данных дает возможность сохранить с процедурой пример файла с подготовленными данными. Файл будет доступен только при Импорте, для процедур Экспорта поле недоступно.
 
Выпадающий список Способ доставки для процедуры Импорта определят вариант доставки файлов и содержит следующие значения:
0 - FTP-сервер
1 - Почтовый ящик
2 - Локальная папка
3 - Диалоговая форма
 
Указанное значение в списке Способ доставки определяет доступность следующих полей.
 
При значении  FTP-сервер - становится доступным поле FTP-сервер\Папка\Emal, которое содержит название подпапки FTP-сервера. При других значениях списка Способ доставки поля FTP-сервер\Папка\Emal недоступны.
 
Выпадающий список Регулярность определяет периодичность выполнения процедуры и содержит набор предопределенных значений:
0 - Ручной запуск
1-7 - Каждые понедельник – воскресение (нумерация по порядку относительно дня недели)
101-131 – Каждое 1 – 31-е число (нумерация по порядку относительно числа месяца)
255 – ежедневный запуск
 
Закладка Текст процедуры [Наверх]
 
 
Поле SQL-процедура содержит текст процедуры Импорта и является обязательным для выполнения.
 
Закладка Колонки [Наверх]
 
 
 
Закладка Колонки доступна только для процедуры Импорта.
Содержит перечень следующих значений:
Для типов numeric и nvarchar в форме радактирования колонок будет доступно для ввода поле Маска\Длина. Для типа numeric можно указать маску ввода, для nvarchar максимальную длину.  Для всех прочих типов поле по умолчанию получает значение Пусто.
 
В колонке Тип набор предопределенных значений стает доступным только после создания процедуры обмена.
 
В поле Маска/Длина загрузка данных не выполняется в случае превышения разрядной сетки или длины.
 
В правом нижнем углу закладки Колонки размещена кнопка Изменить фильтр. При ее нажатии открывается окно Редактор фильтра, в котором можно внести изменения для использующегося фильтра.
 
Закладка Параметры процедуры обмена [Наверх]
 
 
Закладка Параметры процедуры обмена содержит параметры для процедуры Импорта. Задание значений для Параметров процедуры обмена использует аналогичный принцип для параметров отчетов. При корректном определении начальных значений параметров процедура Импорта может быть выполнена без участия пользователя.
 
Данная закладка состоит из следующих колонок:
 
Закладка Права доступа [Наверх]
 
 
Закладка Права доступа содержит перечень пользователей системы, которым предоставлен доступ для запуска процедур и анализа результатов их работы в форме запуска.
 
Процедура Экспорта [Наверх]
 
 
 
Процедура Экспорта позволяет выгружать необходимые данные из системы и сохранять их в файлах, которые создаются автоматически при выполнении процедуры.
 
Закладка Общие содержит общие параметры процедуры Экспорта.
 
Процедура Экспорта определяется в выпадающем списке Тип процедуры.
 
Выпадающий список Папка содержит набор существующих вложенных папок для группировки процедур Экспорта с возможностью создания новых элементов. Список отображается в виде Дерева или Таблицы.  Вид Дерево дает возможность увидеть список в иерархической последовательности. Вид Таблица отображает информацию стандартным списком.
 
Поля Процедура обмена и Описание предназначены для краткого и развернутого описания процедуры.
 
Флажок Нотификация о результатах дает возможность получить результаты процедуры на электронный адрес, который прописан в поле  Список получателей. Так же данный адрес должен быть прописан в настройках системы. В случае отсутствия флажка Список получателей будет неактивным. Нотификация будет работать только в случае установки в опции 10087 значения 1 и заполнения параметров SMTP сервера в опции 10088.
 
Выпадающий список Тип файла для Экспорта состоит из перечня форматов, в которых процедура сможет обрабатывать данные:
0 – CSV
1 – XLS
 
Поле Имя или маска файла обязательно для заполнения и предназначено для введения имени или маски файла. 
 
Флажок в ZIP-формате указывает, что файл будет помещен в ZIP-архив. 
 
Выпадающий список Способ доставки для Процедуры Экспорта определят вариант доставки файлов и содержит следующие значения:
0 - FTP-сервер
1 - Почтовый ящик
2 - Локальная папка
3 – Диалоговая форма
 
Значение в списке Способ доставки определяет доступность поля FTP-сервер\Папка\Emal (которое содержит название подпапки FTP-сервера): оно доступно только при значении  FTP-сервер. При других значениях списка поля FTP-сервер\Папка\Emal недоступны.
 
Выпадающий список Регулярность определяет периодичность выполнения процедуры и содержит набор предопределенных значений:
0 - Ручной запуск
1-7 - Каждые понедельник – воскресение (нумерация по порядку относительно дня недели)
101-131 – Каждое 1 – 31-е число (нумерация по порядку относительно числа месяца)
255 – ежедневный запуск
 
В закладке Текст процедуры открывается поле SQL-процедура, которое содержит текст процедуры Экспорта и является обязательным для выполнения.
 
Закладка Колонки отсутствует для процедур Экспорта.
 
Закладка Параметры процедуры обмена содержит параметры для процедуры Экспорта. Использование параметров должно быть согласовано со значением поля Регулярность. Задание значений для параметров использует аналогичный принцип для параметров отчетов. При корректном определении начальных значений параметров процедура Экспорта может быть выполнена без участия пользователя.
 
Параметры FTP- и почтового сервера [Наверх]
Файл конфигурации содержит параметры FTP- и почтового серверов, используемых при Импорте/Экспорте.
 
В файл конфигурации системы добавлена новая секция ExchangeSettings с двумя разделами параметров Pop3Settings для почтового сервера и FtpSettings для FTP-сервера.
 
Для корректной работы процедуры обмена с использованием FTP сервера пользователь должен настроить конфигурационный файл системы (Win/Web модуля). По умолчанию, конфигурационный файл размещен по адресу:
 
В конфигурационном файле пользователь заполняет следующие поля:
<ftpSettings>
      <add id="ServerIP" value="PROJECT.datacenter.ssbs.com.ua" />
      <add id="Port" value="21" />
      <add id="UsePassive" value="false" />
      <add id="UserID" value="User" />
      <add id="Password" value="Password" />
      <add id="RemoteDirectory" value="Exchange" />
    </ftpSettings>
 
Поле ServerIP содержит адрес FTP сервера.
 
Поле Port содержит номер порта.
 
Поле UserID содержит идентификатор пользователя.
 
Поле Password содержит пароль пользователя.
 
Поля UserID и Password необязательны при анонимной авторизации в FTP.
 
Поле RemoteDirectory содержит название папки, через которую происходит обмен данными.
 
Для правильного функционирования экспорта/импорта с использованием FTP, на примере настроек описанных выше, необходимо создать следующую структуру папок по адресу - ftp://Project.datacenter.ssbs.com.ua:
 
Пример директории для хранения папок и файлов - C:\inetpub\ftproot\LocalUser\Exchangeftp\XXX\Import
 
Пользователь создает папку Optional в случае необходимости разделения информации (напимер, экспорта/импорта данных из нескольких разных точек синхронизации). Для корректной работы процедур пользователю необходимо внести название опциональной папки в поле FTP-сервер\Папка\E-mail вкладки Общие выбранной процедуры обмена.