Коннекторы

Содержание

Компонент «Коннекторы» обеспечивает загрузку данных в справочники и реестры Системы из внешних информационных систем и внешних файлов различных форматов.

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

Адаптер работает под ОС Windows через COM. Внешнее COM-соединение применяется для программного доступа из внешних приложений к данным «1С:Предприятия» старых версий 1С (8.2 и ниже).
CSV
Адаптер использует Python-библиотеку csv. Спецификация RFC 4180, общий формат и MIME-тип для файлов значений, разделенных запятыми (CSV - Comma-separated values). Коннектор обрабатывает не только CSV-файлы, но и файлы с другими разделителями (DSV - delimiter-separated values - значения, разделённые разделителем). Например: SCSV (Semi-colon-separated values - значения, разделенные точкой с запятой), TSV (Tab-separated values - значения, разделенные символом табуляции). В качестве разделителя можно также использовать двоеточие, пробел, вертикальную черту.
DBF
Адаптер использует Python-библиотеку dbf, в которой реализована поддержка форматов dBase III, FoxPro и Visual FoxPro. Формат dBase IV w/memo этой библиотекой не поддерживается.
OData.v3
Поддерживается протокол OData версии 3.0 (Open Data Protocol v3.0). Протокол реализован частично, только для реализации возможности чтения данных с внешнего сервиса. Используется для подключения к данным 1С последних версий. Для старых версий 1С (8.2 и ниже) подключение происходит по протоколу COM (см. выше).
SOAP

Обеспечивает загрузку данных по протоколу SOAP. При создании коннектора надо указать адрес сервера SOAP в формате: http://login:password@address. После того, как коннектор будет создан, надо добавить JSON-запрос, определяющий параметры method, args и xpath:

{"method":"НазваниеМетода",
"args": ["Список", "аргументов"],
"xpath": "Путь/к/таблице"}
XLS
Адаптер использует Python-библиотеку xlrd, загружает файлы формата xls и xlsx.
XML
Коннектор для загрузки данных из XML-файла. После того как коннектор будет создан, надо добавить произвольный запрос в формате XPath, определяющий путь к загружаемой таблице. Спецификацию языка XML Path (XPath) версии 1.0 см. подробнее на http://citforum.ru/internet/xpath/index.shtml и на https://www.w3.org/TR/1999/REC-xpath-19991116/.
БД по ODBC
Адаптер к базам данных PostgreSQL, MySQL, Firebird, MSSQL, Oracle работает через ODBC-драйвер.
Текст
В отличие от формата CSV адаптер обрабатывает неструктурированный текст, без заданной структуры столбцов, не пытается разделить на столбцы «по умолчанию». При настройке коннектора необходимо самостоятельно создать вычисляемые поля на основе разбора строк данных.
Битрикс24
Адаптер работает через Rest API (см. подробнее: https://dev.1c-bitrix.ru/rest_help/).
RetailCRM
Адаптер работает через Rest API v5 (см. подробнее: https://www.retailcrm.ru/docs/Developers/ApiVersion5).
Google Adwords
Адаптер использует API отчетов (см. подробнее: https://developers.google.com/adwords/api/docs/appendix/reports/all-reports).
Google Spreadsheets
Адаптер использует API к таблицам Google (см. подробнее: https://developers.google.com/sheets/api/).

Коннекторы к источнику данных настраиваются средствами пользовательского интерфейса. Коннекторов в Системе может быть создано неограниченное количество. Сохраненные коннекторы можно менять, перенастраивать и удалять. Каждый из коннекторов имеет пользовательское название, которое задается при его создании.

Создание нового коннектора

Для создания нового коннектора необходимо в главном меню нажать на кнопку «+» около пункта меню «Загрузка данных».

_images/connectors_04a.png

В результате откроется окно для создания нового коннектора.

_images/kon_new.png

В данном окне необходимо ввести название нового коннектора и выбрать его тип (1С, MS SQL Server, MySQL, OData.v3, Oracle, PostgreSQL, XLS, коннектор к БД по ODBC и др.).

_images/kon_list_types.png

XLS-коннектор

Коннектор типа «XLS» предназначен для загрузки данных из файла формата xls или xlsx.

Для того, чтобы выполнить загрузку данных из xls-файла (xlsx-файла), необходимо в окне создания коннектора ввести название нового коннектора, в поле «Коннектор к» выбрать значение «XLS», нажать на кнопку «Выберите файл» и выбрать интересующий файл, который будет закреплен за данным коннектором. После того, как появится надпись «Файл загружен» под кнопкой выбора файла, следует нажать кнопку «ОК». В результате начнется первичная обработка данных Системой.

_images/connectors_04.png

Разные листы одного xls-файла (xlsx-файла) будут рассмотрены Системой как разные таблицы с данными. При этом названия таблиц будут совпадать с названиями листов в файле.

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

В случае, если файл MS Excel размещен в сети Интернет, можно указать его адрес. Для этого следует изменить тип подключения с «Файл» на «URL» и ввести адрес файла в сети Интернет.

_images/connectors_56.png

При установленном флаге «Дополнительные заголовки» появляется возможность задать дополнительные заголовки HTTP-запроса к источнику данных.

XML-коннектор

Коннектор типа «XML» предназначен для загрузки данных из файла формата xml. Кроме того, XML-коннектор позволяет использовать XML API Системы.

Перед началом работы необходимо в окне создания коннектора ввести название нового коннектора и в поле «Коннектор к» выбрать значение «XML». Затем аналогично настройкам для XLS-коннектора (см. подраздел «XLS-коннектор») загрузить xml-файл или выбрать тип подключения «URL» и ввести адрес файла в сети Интернет.

_images/xml-conn-img.png

При установленном флаге «Дополнительные заголовки» появляется возможность задать дополнительные заголовки HTTP-запроса к источнику данных.

После того, как источник открыт, необходимо нажать на кнопку «+» возле кнопки «Выбрать таблицу», далее указать наименование таблицы, а в поле «Запрос к источнику данных» добавить запрос в формате XPath. Этот запрос определяет путь к таблице. Спецификация языка XML Path (XPath) версии 1.0 описана по ссылке http://citforum.ru/internet/xpath/index.shtml.

ODBC-коннектор

ODBC-коннектор предназначен для подключения к базе данных (БД) по ODBC.

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

Для настройки подключения к базе данных по ODBC в окне создания коннектора необходимо ввести название нового коннектора и в поле «Коннектор к» выбрать значение «БД по ODBC».

В появившемся поле «Подключение» выбирается способ подключения к БД.

В поле «Способ предпросмотра» выбирается способ предпросмотра таблиц в БД. Выбранное значение определяет объем предварительно загружаемых данных и, как следствие, время открытия коннектора и загрузки данных.

Возможны следующие значения:

  • Все таблицы и данные — загружается список всех таблиц в БД, после этого асинхронно подгружается содержимое каждой таблицы (позволяет видеть количество элементов в таблицах).
  • Все таблицы и данные (доступные пользователю) — загружается список всех доступных пользователю таблиц БД (проверка на доступность может занимать длительное время), после этого асинхронно подгружается содержимое каждой таблицы (позволяет видеть количество элементов в таблицах).
  • Только названия таблиц — загружаются названия всех таблиц БД, содержимое загружается только для выбранных таблиц.
  • Только названия таблиц (доступные пользователю) — загружаются названия всех доступных пользователю таблиц БД (проверка на доступность может занимать длительное время), содержимое загружается только для выбранных таблиц.
  • Только настроенные таблицы — при создании нового коннектора таблиц вообще не будет, для загрузки необходимо писать SQL-запрос. Если коннектор уже настроен (например, при загрузке модуля), то будут загружены уже настроенные таблицы и ничего кроме них. Самый быстрый вариант загрузки.
_images/connectors_58.png

Для БД с большим числом записей рекомендуется выбирать способ «Только названия таблиц».

В случае, если в поле «Подключение» выбрано значение «строка подключения», то в поле «Строка подключения» необходимо ввести строку подключения.

_images/connectors_57.png

Строка подключения имеет вид:

DRIVER=PostgreSQL Unicode;SERVER=servername;DATABASE=dbname;UID=username;PWD=password;SCHEMA=

Параметры:

  • Servername — имя сервера.
  • Dbname — имя БД.
  • Username — пользователь БД.
  • Password — пароль к БД.
  • Schema – схема БД (по умолчанию – public).

Если в поле «Подключение» выбрано значение «указанные параметры», то потребуется выбрать подходящий драйвер в поле «Драйвер», а также ввести параметры:

  • Имя БД.
  • Сервер БД.
  • Пользователь БД.
  • Пароль к БД.
  • Схема БД (по умолчанию - public).

Флаг «Не загружать данные» рекомендуется использовать в том случае, если количество данных в источнике очень велико, а в каждом конкретном отчете необходима лишь небольшая их часть. Данные источника коннектора будут доступны только в формах (без возможности редактирования данных) и отчетах.

_images/connectors_60.png

Обратите внимание, что при установленном флаге «Не загружать данные» в коннекторе:

  • Не поддерживаются вычисляемые поля.
  • Все используемые справочники должны быть загружены заранее.

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

Oracle, MS SQL Server, Firebird, PostgreSQL

Коннекторы к СУБД Oracle, MS SQL Server, Firebird или PostgreSQL работают через ODBC-драйвер. Для создания коннектора в поле «Коннектор к» необходимо указать соответствующее значение (название СУБД). Остальные настройки выполняются аналогично описанным в подразделе «ODBC-коннектор»).

OData-коннектор

OData-коннектор предназначен для работы с сервисами по протоколу OData версии 3.0.

Перед началом работы необходимо в окне создания коннектора ввести название нового коннектора и в поле «Коннектор к» выбрать значение «OData.v3». Затем в поле URL указать адрес сервиса для подключения и нажать на кнопку «ОК».

Проверить подключение можно с помощью тестового адреса: http://services.odata.org/V3/OData/OData.svc.

_images/connectors_36.png

Для доступа к сервису, использующему Basic Auth для аутентификации, имя пользователя (username) и пароль (userpass) необходимо включить в строку адреса в формате:

http://username:userpass@odata.service/odata.svc

1С-коннектор

Для настройки подключения к 1С понадобится загрузить несколько файлов на компьютер, где установлен 1С.

При создании коннектора в поле «Коннектор к» нужно выбрать значение «1С» и заполнить поле «Название» для последующей работы с коннектором.

Выбор способа предпросмотра таблиц из базы 1С влияет на объем загружаемых данных и скорость загрузки коннектора:

  • Все таблицы и данные — загружается список всех таблиц, после этого асинхронно подгружается содержимое каждой таблицы (позволяет видеть количество элементов в таблицах).
  • Только названия таблиц — загружаются названия всех таблиц 1C, содержимое загружается только для выбранных таблиц.
  • Только настроенные таблицы — имеет смысл только для уже настроенного коннектора: будут загружены уже настроенные таблицы и ничего кроме них. Самый быстрый вариант загрузки.

После заполнения полей «Коннектор к», «Название» и выбора способа предпросмотра можно нажать кнопку «ОК».

_images/1c_01.png

Затем система предложит перейти в настройки коннектора для скачивания файлов.

_images/1c_02.png

Для этого нужно нажать шестеренку с настройками коннектора.

_images/1c_03.png

И загрузить zip-архив на компьютер, где установлен 1С.

_images/1c_04.png

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

Дальнейшие действия нужно произвести на компьютере с загруженным архивом и 1С:

  1. Распаковать архив. Копия этой инструкции содержится в файле INSTALL.html в составе архива.
  2. В файле «connector.conf» нужно указать путь к базе 1С в параметре path_1c (например, C:\1C\1Cv82\Бухгалтерия\). Его можно узнать в стартовом окне 1С в свойствах нужной базы. Если на компьютере несколько баз 1С, то на каждую нужно создавать отдельный коннектор. Если 1С использует SQL базу данных, то необходимо указать название сервера и название базы в параметрах srvr_1c и ref_1c соответственно.
  3. Также в файле «connector.conf» необходимо указать логин и пароль для доступа к нужной базе 1С, а затем сохранить файл.
  4. После этого можно запустить файл «connector1c.exe», при запросе брандмауэра разрешить приложению доступ в сеть.

Если при последнем шаге возникает ошибка «Не найдена библиотека MSVCR100.dll» (например, это может происходить на Windows Server 2008 и в старых версиях Windows), необходимо установить Visual C++ 2010 Redistributable Package (x86), который можно бесплатно скачать с сайта Microsoft (http://www.microsoft.com/en-us/download/details.aspx?id=5555). Важно установить именно эту, x86, версию пакета, даже для x64 операционной системы.

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

_images/1c_06.png

Рядом с exe-файлом появится log-файл с журналом событий «connector.log». Коннектор готов к работе, а о его активности и ошибках можно узнать из log-файла.

_images/1c_07.png

После того, как стало понятно что коннектор работает, его рекомендуется добавить как сервис, чтобы он продолжал работу после перезапуска Windows. Для этого нужно сначала выключить запущенный коннектор (нажать правой кнопкой мыши на иконку приложения в трее и выбрать «Quit»), а затем запустить от имени администратора файл «add_service.bat», расположенный в папке коннектора. Узнать статус сервиса, остановить или снова запустить его можно при помощи других bat файлов в той же папке.

Теперь можно нажать «Выбрать таблицы» внутри коннектора и перейти к выбору данных для загрузки (см. следующий раздел).

_images/1c_05.png

Настройка таблиц для загрузки данных

После окончания обработки данных из источника окно создания коннектора закроется, и в поле работы с таблицами появится кнопка «Выбрать таблицы». По нажатию на кнопку «Выбрать таблицы» откроется список, в котором можно выбрать, какие таблицы из источника данных необходимо загрузить в Систему. Их необходимо отметить флагами. Справа от названия каждой из таблиц указано, сколько строк (записей) она содержит.

_images/337.png

Все выбранные для загрузки таблицы отобразятся в списке под кнопкой «Выбрать таблицы». Чтобы удалить какую-либо таблицу из загрузки, необходимо нажать на крестик рядом с названием данной таблицы или снять флаг в выпадающем списке со всеми таблицами коннектора.

_images/338.png

По нажатию на любую из таблиц в правой части экрана появится информация о выбранной таблице.

_images/connectors_06.png

Для изменения параметров таблицы следует нажать на кнопку с изображением шестеренки, расположенную справа от названия таблицы.

_images/connectors_46.png

В результате откроется окно редактирования таблицы.

_images/connectors_59.png

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

Флаг «Загрузка в справочник» по умолчанию не используется, и данные таблицы загружаются не в справочник, а в обычный реестр. Этот флаг может использоваться для того, чтобы в дальнейшем было проще отделить данные, загруженные через определенный коннектор. Следует учитывать, что при загрузке в справочник большого объема данных (1000 записей и более), эта операция занимает много системных ресурсов.

Флаг «Синхронизировать удаление» означает, что при удалении записи в источнике данных эта запись будет удалена из Системы. Если на запись уже есть ссылки и удаление провести невозможно, то это приведет к ошибке загрузки данных.

Флаг «Пропускать дубликаты» означает, что дубликаты по ключам таблицы не приведут к ошибке загрузки, а будут пропущены. Пропуск дубликатов производится после обработки вычисляемых полей. Из нескольких значений берется первое, кроме полей с видом показателя «Значение» и галочкой в чекбоксе «Поддержка синонимов» в настройках полей. Опция «Поддержка синонимов» позволяет указать в поле, на которое необходимо ссылаться, несколько значений через перевод строки.

Создание новой таблицы в XLS-коннекторе

Помимо существующих таблиц в сохраненном коннекторе можно создать новую таблицу. Для этого следует нажать на кнопку «+» справа от кнопки «Выбрать таблицы».

_images/339.png

В результате откроется окно настроек новой таблицы.

_images/340.png

В данном окне необходимо настроить добавляемую таблицу:

  • Поле «Название таблицы» предназначено для ввода названия таблицы, которое будет отображаться в списке слева, а также по умолчанию использоваться как название справочника при его создании.
  • Флаг «Загрузка в справочник» предназначен для того, чтобы ссылаться на записи данной таблицы из других таблиц. Также эта опция учитывается при обновлении данных. В один справочник можно загрузить несколько таблиц.
  • Флаг «Синхронизировать удаление» означает, что при удалении записи в источнике данных эта запись будет удалена из Системы. Если на запись уже есть ссылки и провести удаление невозможно, то это приведет к ошибке загрузки данных.
  • Флаг «Пропускать дубликаты» означает, что дубликаты по ключам таблицы не приведут к ошибке, а будут пропущены. Пропуск дубликатов производится после обработки вычисляемых полей. Из нескольких значений берется первое, кроме полей с видом показателя «Значение» и галочкой в чекбоксе «Поддержка синонимов» в настройках полей. Опция «Поддержка синонимов» позволяет указать в поле, на которое необходимо ссылаться, несколько значений через перевод строки.
  • Выбор области с данными — кнопки выбора задают поля ниже, предназначенные для выборки данных с листа xls-файла. Есть два основных способа представления данных в электронных таблицах: реестры и таблицы.
  1. Кнопка «Реестр».

В случае, если данные в xls-файле расположены в виде реестра, и при загрузке данных необходимо, чтобы каждый столбец в xls-файле попал в отдельный показатель, следует использовать область с данными «Реестр».

Например, таблица в xls-файле имеет следующий вид:

  A B C D E F
1 Выгрузка №123          
2   Номер Дата Тип документа Контрагент Сумма
3   000001 7/17/2014 Поступление Продуктовая база 32000
4   000019 7/17/2014 Поступление Электротовары 309000
5   000002 7/18/2014 Поступление Электротовары 270500
6   000022 7/27/2014 Реализация Алан 61800
7   000002 7/31/2014 Ввод остатков   0

Если необходимо загрузить все данные, то для этого достаточно в поле «Данные по строкам» указать диапазон данных первой строки (первой записи в таблице). В данном примере диапазон «B3:F3» – это первая строка с данными. Считывание данных будет продолжаться вниз до первой полностью пустой строки.

Если заранее известно количество строк, то в поле «Диапазон по строкам» можно указать «прямоугольный» диапазон. Например, диапазон «B3:F5» ссылается на первые три строки из приведенного примера.

Если необходимо пропустить часть столбцов, то для этого следует указать несколько диапазонов. Каждый диапазон записывается с новой строки. Например, для загрузки первой строки с данными с полями «Номер», «Контрагент» и «Сумма» необходимо указать диапазоны «B3» и «D3:F3».

  1. Кнопка «Таблица».

В случае, если необходимо «развернуть» часть данных из разных столбцов в один показатель, то следует использовать область с данными «Таблица».

Например, таблица в xls-файле имеет следующий вид:

  A B C D E F
1     2010 г.   2011 г.  
2     План Факт План Факт
3   Галицкое 15 16 17 17
4   Самарское 110 97 105 107
5   Троицкое 55 59 60 61
6   Садовое 5 7 6 6

В данном примере необходимо загрузить все числовые данные в один показатель, чтобы его признаками были период, план/факт и отделение. Для этого следует указать:

  1. Данные по строкам, т.е. отделения (они «продолжаются» вниз): B3.
  2. Данные по столбцам, т.е. период и план/факт (они «продолжаются» вправо): C1:C2.
  3. Табличные данные (достаточно указать левую верхнюю ячейку): C3.

В результате новая таблица примет следующий вид:

field_1 field_2 field_3 field_4
Галицкое 2010 г. План 15
Галицкое 2010 г. Факт 16
Галицкое 2011 г. План 17
Галицкое 2011 г. Факт 17
Самарское 2010 г. План 110
Самарское 2010 г. Факт 97
Самарское 2011 г. План 105
Самарское 2011 г. Факт 107

После выбора типа области с данными необходимо заполнить оставшиеся поля:

  • Поле «Лист» (для реестра и таблицы) предназначено для ввода названия листа, из которого берутся данные. По умолчанию используется первый лист. Также можно указать символ «*», чтобы загрузить все листы, или диапазоны «1,3-7» для загрузки определенных листов. В случае загрузки из нескольких листов название листа будет доступно как еще одно (последнее) поле в таблице.
  • В поле «Данные по строкам» (для реестра и таблицы) вводятся ячейки (например, «A3») или диапазоны (например, «А3:D3»). Каждая ячейка или диапазон записывается с новой строки. Данные из этих ячеек будут считываться по строкам. Если заданный диапазон покрывает только одну строку, то считывание будет продолжаться вниз до первой полностью пустой строки.
  • В поле «Данные по столбцам» (только для таблицы) вводятся ячейки (например, «A3») или диапазоны (например, «А3:A7»). Каждая ячейка или диапазон записывается с новой строки. Данные из этих ячеек будут считываться по столбцам. Если заданный диапазон покрывает только один столбец, то считывание будет продолжаться вправо до первого полностью пустого столбца.
  • В поле «Табличные данные» (только для таблицы) вводится ячейка начала данных (например, «A3») или диапазон (например, «А3:A7»). Табличные данные считываются в заданной области построчно, «разворачивая» данную область в один ряд данных. Если заданы и данные по строкам, и данные по столбцам, то достаточно ввести левую верхнюю ячейку данных.
  • В поле «Фиксированные данные» (для реестра и таблицы) — в этом поле вводятся ячейки (например, «A3») или диапазоны (например, «А3:A7»). Каждая ячейка или диапазон записывается с новой строки. Данные из этих ячеек будут повторяться в каждой строке результирующих данных. Эту функцию необходимо использовать в том случае, если на листе в некоторых ячейках есть информация, характеризующая все данные на листе.

После заполнения всех полей необходимо нажать на кнопку «ОК». В результате в коннектор будет добавлена новая таблица с выбранными данными. В дальнейшем с ней можно работать так же, как и с другими таблицами.

_images/341.png

Создание новой таблицы в ODBC-коннекторе

В ODBC-коннекторе помимо существующих таблиц можно создать новую с помощью произвольного SQL-запроса. Для этого необходимо нажать на кнопку «+» справа от кнопки «Выбрать таблицы».

_images/344.png

В появившемся окне в поле «Название» необходимо ввести название таблицы, а в поле «Запрос к источнику данных» написать SQL-запрос к БД.

_images/342.png

После нажатия на кнопку «ОК» новая таблица появится в перечне выбранных и далее с ней можно работать так же, как и с другими таблицами.

_images/343.png

Загрузка таблицы в справочник

По умолчанию флаг «Загрузка в справочник» не используется, и данные таблицы загружаются не в справочник, а в обычный реестр.

Если в настройках таблицы установить флаг «Загрузка в справочник», то таблица будет загружена в справочник. Каждая строка таблицы будет являться элементом справочника.

Если поле «Справочник» оставить пустым, то для загружаемой таблицы будет создан новый справочник. Название данного справочника будет таким же, как название таблицы (его можно будет изменить в поле «Название таблицы»).

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

_images/connectors_48.png

Для окончания настройки таблицы необходимо нажать «ОК».

_images/connectors_49.png

Например, при загрузке одностраничного файла «Товары.xls» будет создан справочник «Товары», элементами которого будут строки из данного файла. Также будет создан показатель «Товары» (показатель типа «Справочник»), ссылающийся на справочник «Товары».

При создании справочника одно из полей рассматривается как название всей строки.

Например, таблица с товарами имеет следующий вид:

Товар Бренд Категория
Apple iPhone 5C 32Gb White Apple iPhone 5C
Apple iPhone 4 8Gb Black Apple iPhone 4

Элементом справочника является одна строка таблицы, и Системе необходимо указать, какое из полей использовать в качестве ее названия. Для этого необходимо настроить загрузку названия в показатель «Название».

В данном примере поле «Товар» должно загружаться в показатель «Название». Это необходимо для того, чтобы в случае, когда потребуется вывести информацию про конкретный элемент справочника (товар), можно было обратиться к элементу справочника по его названию (например, «Apple iPhone 5C 32Gb White»).

Если ни одно из полей не загружается в показатель «Название», то Система будет выводить элементы справочника по id. Другими словами, в отчете вместо «Apple iPhone 5C 32Gb White» будет выводиться идентификатор, сформированный Системой.

Для загрузки данных в иерархический справочник необходимо указать, какое из полей использовать в качестве названия, а какое - в качестве родительского элемента.

Например, таблица с товарами имеет следующий вид:

Товар Категория товара
Apple iPhone 5C 32Gb White Смартфоны
Apple iPhone 4 8Gb Black Смартфоны
Samsung Galaxy Tab A 10.1 LTE 32Gb Black Планшеты
Huawei MediaPad M5 Lite 8.0 LTE 32Gb Grey Планшеты

Каждый товар относится к определенной категории товаров. Значит, значения столбца «Категория товара» - элементы верхнего уровня (родительские элементы).

Для того, чтобы данную таблицу загрузить в иерархический справочник, необходимо в файле в столбце «Товар» добавить уникальные названия категорий товаров. Таким образом, таблица с товарами примет следующий вид:

Товар Категория товара
Apple iPhone 5C 32Gb White Смартфоны
Apple iPhone 4 8Gb Black Смартфоны
Samsung Galaxy Tab A 10.1 LTE 32Gb Black Планшеты
Huawei MediaPad M5 Lite 8.0 LTE 32Gb Grey Планшеты
Смартфоны  
Планшеты  

В данном примере поле «Товар» будет загружаться в показатель «Название», а поле «Категория товара» в показатель «Товары» типа «Справочник».

Обратите внимание, что в режиме редактирования показателя «Товары» должна стоять галочка в чекбоксе «Иерархический справочник, группировать по текущему показателю».

Настройка показателей для загрузки данных

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

_images/connectors_07.png

В левой части области следующий состав полей:

  • Поле с флагами для выбора загружаемых показателей.
  • Поле «Название» – названия показателей из загружаемой таблицы (берется из первой строки таблицы).
  • Поле «Тип» – текущий тип данных показателей.
  • Поле «Показатель» – названия показателей в Системе. В эти показатели будут загружаться данные.
  • Поле «Ред.» – кнопки для редактирования настроек показателей.

В правой части области расположены первые несколько строк с данными из таблицы, с которой ведется работа в данный момент (в транспонированном виде).

Для того чтобы выбрать показатели для загрузки, следует установить флаги в левом столбце в строке с названием показателя.

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

_images/connectors_08.png

В Системе существуют следующие виды загрузки данных в показатели Системы:

  1. Значения показателя загружаются непосредственно из ячеек загружаемой таблицы в новый показатель (см. подраздел «Создание нового показателя»).
  2. Значения показателя загружаются непосредственно из ячеек загружаемой таблицы в показатель, существующий в Системе (см. подраздел «Запись данных в существующие показатели»).
  3. Значения показателя выбираются по ссылке из справочника, который существует в Системе (см. подраздел «Выбор значений из существующего справочника по ссылке»).
  4. Значения показателя выбираются по ссылке из другой таблицы того же источника данных (см. подраздел «Ссылка на другую таблицу»).
  5. Значения показателя вычисляются путем преобразования данных, полученных из того же источника данных (см. подраздел «Вычисляемые поля в коннекторах»).

В Системе реализована возможность как записывать данные в уже существующие показатели, так и создавать новые.

Кроме того, существует разделение по типам данных показателей. Типы данных показателей описаны в подразделе «Тип значений показателя». При обработке данных из источника Система автоматически определяет тип данных в каждом из столбцов.

Если в Системе уже существует показатель с таким же названием, какое указано в первой строке рассматриваемого столбца загружаемой таблицы, то Система автоматически («по умолчанию») подставляет его как показатель, соответствующий данному столбцу таблицы.

Для настройки показателя и его типа данных необходимо нажать на кнопку «Ред.».

_images/connectors_09.png

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

_images/connectors_10.png

Создание нового показателя

Для создания нового показателя необходимо в окне настройки показателя в поле «Показатель» выбрать опцию «Новый», а затем в поле «Тип показателя» выбрать тип данных в раскрывающемся списке.

_images/connectors_13.png

В поле «Название показателя» вводится название нового показателя. По умолчанию название совпадает с названием поля таблицы, указанным в первой строке загружаемой таблицы.

Если в качестве типа данных показателя выбран «Справочник», то в поле «Справочник» следует указать справочник, из которого он будет брать свои значения. Для удобства выбора при большом количестве справочников в верхней строке выбора есть поле поиска по названию.

_images/connectors_31.png

Если нужного справочника в Системе нет, то в окне выбора «Справочник» следует оставить значение по умолчанию (значение «Новый»).

_images/connectors_30.png

Название вновь созданного справочника будет совпадать с введенным названием показателя.

При загрузке данные проходят форматно-логический контроль. Если данные не соответствуют указанному типу (в числовой показатель записывается текст, в показателе с типом «Целое» есть числа с дробной частью и т. п.), то таблица не будет загружена в Систему.

Запись данных в существующие показатели

Для загрузки данных в существующий показатель необходимо в окне настройки показателя в поле «Показатель» выбрать значение «Выбрать из существующих».

_images/connectors_11.png

В поле «Выберите из списка» необходимо выбрать показатель, существующий в Системе.

_images/connectors_12.png

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

_images/connectors_12-1.png

Выбор значений из существующего справочника по ссылке

Для показателя типа «Справочник» можно установить соответствие между загружаемыми данными и элементами справочника в Системе по полю, заданному для элементов справочника.

Например, справочник «Организации» в Системе имеет следующий вид:

_images/kon_sprav_org.png

Каждый элемент данного справочника имеет показатели «Название» и «ID организации». Необходимо загрузить в Cистему список контактов сотрудников.

_images/kon_set_table.png

В источнике данных все организации заданы через их идентификаторы (id).

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

_images/kon_pokaz_org.png

Поле «Организация (ID)» необходимо настроить особым образом, нажав на кнопку «Ред.». В открывшемся окне в поле «На какое поле ссылаемся» следует выбрать показатель, по которому будет производиться поиск соответствующего элемента справочника. В справочнике «Организации» это поле «ID организации».

_images/kon_set_org.png

В настройках полей коннектора отображается и показатель «Организация, в которой работает сотрудник», в который загружаются данные об организации сотрудника, и через стрелочку показатель «ID организации», который служит идентификатором при установлении соответствия между загружаемыми данными и элементами справочника в Cистеме.

_images/kon_set_table_2.png

После настройки полей коннектора необходимо сохранить внесенные изменения, нажав на кнопку «Сохранить» слева от поля с названием коннектора, и загрузить данные, нажав на кнопку «Загрузить данные». В результате загруженные данные будут выглядеть следующим образом:

_images/kon-table-2.png

В поле «Организация, в которой работает сотрудник» отображаются названия элементов справочника «Организации», а не «ID организации», как это было в источнике данных.

Ссылка на другую таблицу

Если в одной из таблиц определенного источника данных в каком-либо столбце содержатся значения, которые выбираются из другой таблицы того же источника, то для соответствующего этому столбцу показателя необходимо:

  • Выбрать вид показателя не «Значение», а «Ссылка на таблицу».
  • Указать таблицу источника данных, из которой выбираются значения.
  • Указать поле таблицы, на которое должен ссылаться показатель (то поле таблицы, из которого выбираются значения).

Поле таблицы, на которое ссылается показатель, должно быть уникальным (единственным в таблице источника, из которой выбираются значения). Это необязательное поле. Если его не задать, то соответствие будет определяться автоматически по ключу таблицы, на которую ссылается показатель.

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

Например, в таблице «Заявки» содержатся следующие данные:

_images/connect-link-1.png

В таблице «Заявки» вместо названий организаций указаны их идентификаторы (id).

В таблице «Организации» содержатся и id, и названия организаций. Поскольку поле «ID организации» уникально, оно однозначно определяет название организации для каждой из заявок.

_images/connect-link-2.png

Таблица «Организации» загружается в новый справочник, которому автоматически будет присвоено название «Организации» (такое же, как название загружаемой таблицы). Данные из столбца «Название организации» загружаются в существующий системный показатель «Название», а данные из столбца «ID организации» - в новый показатель «ID организации» типа «Строка».

_images/connect-link-3-1.png

После настройки таблицы «Организации» необходимо сохранить коннектор, чтобы при настройке таблицы «Заявки» можно было использовать сведения о настройках таблицы «Организации».

Таблица «Заявки» загружается не в справочник, а в обычный реестр. Данные из столбца «ID заявки» загружаются в новый показатель «ID заявки» (тип «Целое»), а данные из столбца «Название заявки» загружаются в новый показатель «Название заявки» (тип «Строка»).

_images/connect-link-3-2a.png

Вместо столбца «ID организации» должны быть загружены значения нового показателя «Организации» типа «Справочник», ссылающегося на справочник «Организации». В результате параметры настройки столбца «ID организации» будут выглядеть следующим образом:

_images/connect-link-4-1.png

После сохранения выставленных настроек (кнопка «Сохранить» слева от поля с названием коннектора) коннектор будет иметь следующий вид:

_images/connect-link-3-2.png

Для того, чтобы загрузить данные в Систему, необходимо нажать на кнопку «Загрузить данные» в левом верхнем углу страницы.

_images/257.png

В результате загруженные данные будут выглядеть следующим образом:

_images/connect-link-7.png

В поле «Организации» отображаются названия элементов справочника «Организации», а не «ID организации», как это было в источнике данных.

Настройка параметров загрузки

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

  • Флаг «Обязательное» — при загрузке будет проверяться наличие данных в каждой ячейке этого столбца. Если в каких-то ячейках данных нет, будет выведено сообщение об ошибке. В этом случае таблица не будет загружена.
  • Флаг «Ключ» — при загрузке будет проверяться уникальность (единственность) значения этого показателя (либо сочетания двух и более ключевых показателей). Это позволяет избежать дублирования данных в Системе. При каждой новой загрузке данных из источника будет происходить обновление существующих данных в соответствии с заданным ключом.
  • Флаг «Поддержка синонимов» позволяет указать в поле, на которое необходимо ссылаться, несколько значений через перевод строки.
_images/connectors_15.png

Если в качестве типа данных показателя указан «Справочник», то в окне настройки показателя появится возможность указать следующие настройки:

  • Флаг «Разрешено добавление новых значений» — все встреченные новые значения в столбце будут добавлены в справочник. Важно не забывать про эту настройку при первой загрузке показателя-справочника.
  • Флаг «Пропускать строку при ошибке» — при ошибке (значение в ячейке этого показателя не встречается в справочнике в Системе) будет пропущена строка, содержащая эту ячейку, целиком. Все остальные строки таблицы будут загружены.
  • Флаг «Пропускать поле при ошибке» — при ошибке (значение в ячейке этого показателя не встречается в справочнике в Системе) будет пропущена ячейка с этим показателем (для загружаемого в этой строке объекта данный показатель будет не определен). Данные для остальных показателей из этой строки и остальные строки таблицы будут загружены.
  • Флаг «Распознавать как адрес» - поле будет распознано как адрес при помощи КЛАДР/ФИАС. Распознавание идет с точностью до дома (при этом из КЛАДР берется только улица, а дом хранится в произвольном виде). Адреса добавляются в древовидный справочник по необходимости.
_images/connectors_16.png

Справа от названий флагов указаны пиктограммы, которые будут отображаться в столбце «Тип» в строке показателя в левой таблице основной рабочей области окна для визуализации настроек коннектора.

Вычисляемые поля в коннекторах

В Системе существует возможность задания вычислений данных прямо в коннекторе для их дальнейшей загрузки. Это может быть необходимо, если в данных содержатся ошибки. Например, лишние пробелы в названиях элементов будущего справочника. Система автоматически воспримет названия «Apple» и «Apple » (с пробелом в конце) как два разных элемента справочника, хотя подразумевался один и тот же бренд. Обработка вручную объемного справочника товаров требует больших временных и трудовых затрат, а Система может сделать это автоматически при загрузке данных.

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

Кроме того, может возникнуть необходимость объединить несколько полей в одно (например, фамилию, имя и отчество в одно поле «ФИО») или, наоборот, разделить одно поле из базы данных на два и более показателей в Системе.

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

Задание вычисления у существующего поля

Если необходимо задать вычисление уже существующего в коннекторе поля, то в окне редактирования настроек загружаемого показателя следует поставить флаг «Задать преобразование».

_images/connectors_37.png

В появившемся текстовом поле «Программа для вычисления» следует задать необходимые преобразования на языке Python (подробнее см. на https://docs.python.org/3.5/index.html). Обратите внимание, что в поле «Программа для вычисления» автоматически добавляется преобразование, обрезающие лишние пробелы.

_images/connectors_38.png

Текущее (редактируемое) поле доступно через переменную field, все остальные поля доступны в переменной fields и f (необходимо указание их названия).

Для получения подсказки следует нажать на пиктограмму «вопрос» рядом с названием поля.

_images/connectors_39.png

Создание нового вычисляемого поля

Также Система позволяет создавать новые вычисляемые поля для загрузки данных. Для этого необходимо нажать на кнопку «+» в левом верхнем углу области работы с загружаемыми данными.

_images/connectors_40.png

В открывшемся окне необходимо заполнить поле «Программа для вычисления» (см. подраздел «Заполнение поля для вычисления» <fill-field-calc>) и обязательное для заполнения поле «Название поля», куда нужно ввести название нового поля.

_images/connectors_41.png

После ввода программы для вычисления данных и названия поля необходимо выбрать, в какой показатель будут загружаться вычисленные данные (в новый или в уже существующий). Если необходимо создать новый показатель, то следует ввести его название и выбрать тип данных. Обратите внимание, что название показателя и название поля полностью независимы друг от друга. Далее можно задать все доступные данному типу данных настройки аналогично другим полям коннектора («обязательный», «ключ» и т. д.).

Для сохранения настроек вычисляемого поля необходимо нажать на кнопку «ОК», иначе – на кнопку «Отмена».

_images/connectors_42.png

В результате новое поле будет добавлено в таблицу с показателями для загрузки данных.

_images/connectors_43.png

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

Заполнение поля для вычисления

В окне редактирования настроек загружаемого показателя при заполнении поля «Программа для вычисления» можно ввести программу на языке Python, которая позволит преобразовать данные перед загрузкой или пропустить некоторые строки.

Программа оперирует одной строкой исходных данных, причем можно обращаться к любому полю, даже если оно не отмечено для загрузки. Все поля доступны в переменной fields или в ее коротком синониме f. Значение переменной — это словарь, где ключи — названия полей. При вводе доступно автодополнение, оно включается после того как была набрана открывающая скобка. Нужно вернуть значение при помощи оператора return.

Приведенный ниже пример демонстрирует, как можно обрезать пробелы в начале и конце текстового поля под названием full_name:

return fields["full_name"].strip()

Следующий пример демонстрирует, как можно разбить поле по дефису и вернуть первую часть:

return f["full_name"].split('-')[0]

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

return f["some_name"][:-2] # отрезать первые два символа: [2:]

Следует иметь ввиду, что тип значения, который поступает на обработку, определяется типом в источнике данных и не зависит от типа показателя. Значения типа datetime.date приводятся к типу datetime.datetime.

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

Если задается программа преобразования существующего поля, то можно обращаться к нему не указывая название, просто через переменную field. Например, так можно привести переменную к правильной единице измерения:

if field.endswith("m"):
    return int(field.rstrip("m ")) * 1024
else:
    return int(field)

Доступен модуль регулярных выражений re — с его помощью можно извлекать фрагменты текста или производить замены. В следующем примере извлекается число из поля «index», которое возможно содержит и другую информацию:

m = re.search("\d+", f["index"])
if m:
    return m.groups()[0]

Также можно использовать объекты из модуля datetime: timedelta для расчета разницы между моментами времени, и datetime для представления даты и времени. Например, используя встроенную переменную now, можно посчитать, сколько дней прошло с момента создания объекта:

return (now - f["created"]).days

Также есть переменная date, которая содержит текущую дату.

С помощью функции datetime.strptime можно распознать дату в любом формате. Например:

return datetime.strptime(fields["date"], "%Y %m %d")

Можно пропустить некоторые записи, добавив исключение Skip. Например, так можно пропустить все записи, обновленные более двух часов назад:

if (now - f["updated"]).seconds > 2 * 3600:
    raise Skip
else: # возвращаем без изменений
    return f["updated"]

Сохранение коннектора

После того как заданы настройки для загрузки всех необходимых показателей во всех интересующих таблицах, можно их сохранить. Для этого следует нажать на кнопку «Сохранить» слева от поля с названием коннектора в верхнем меню страницы.

_images/connectors_04b.png

Также можно сразу перейти к загрузке данных в Систему, нажав на кнопку «Загрузить данные». При этом настройки коннектора сохранятся автоматически.

_images/connectors_04c.png

При сохранении коннектора (при загрузке данных или по кнопке «Сохранить») в Системе создаются все новые показатели.

Загрузка данных

По нажатию на кнопку «Загрузить данные» на странице работы с коннектором происходит загрузка всех выбранных данных в Систему. Обратите внимание, что загрузка таблиц с большим числом строк может занять значительное время.

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

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

Обновление данных

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

Результат загрузки

После успешной загрузки данных выводится сообщение с информацией о загрузке: сколько записей создано, обновлено и удалено (при повторных загрузках и с флагом «Синхронизировать удаление») по каждой из таблиц.

_images/243z.PNG

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

_images/242z.PNG

После завершения загрузки данных можно приступить к анализу данных и построению отчетов (подробнее см. в подразделе «Редактор отчетов, форм, реестров. Аналитическая панель и конструктор»).

Загрузка одной таблицы

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

Для этого необходимо на странице работы с коннектором нажать на кнопку с изображением стрелки справа от кнопки «Загрузить данные» и в выпадающем списке выбрать пункт «Только выбранную таблицу».

_images/317.png

При этом будет загружена таблица, отображенная в данный момент на странице, а также все связанные с ней таблицы (например, если в таблице есть ссылка на соседнюю таблицу, то соседняя таблица тоже будет загружена).

Все настройки коннектора для других таблиц сохранятся в Системе.

Эта функция нужна, например, если одно из полей таблицы должно ссылаться на другую таблицу (например поле «Магазин» в таблице «Продажи» ссылается на таблицу «Магазины», находящуюся в том же файле. Можно либо сделать два отдельных коннектора для каждой из таблиц, либо сначала загрузить отдельно таблицу с магазинами, а затем — таблицу «Продажи» со ссылкой на «Магазины».

Настройка периодической загрузки данных

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

_images/310.png

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

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

_images/311.png

Чтобы указать время и дни, когда необходимо производить загрузку, следует ввести их в поле «Расписание». Подсказка о том, как это правильно делать, появляется при нажатии на вопросительный знак рядом с заголовком этого столбца.

_images/312.png

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

_images/313.png

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

_images/314.png

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

_images/315.png

Чтобы добавить новую строку с настройкой, следует нажать на синюю кнопку «+» в нижней части окна.

Чтобы вернуться к работе с коннекторами после завершения необходимых настроек, следует нажать на кнопку «ОК» в нижней части окна (либо на кнопку «Отмена», если сохранять измененные настройки не нужно).

_images/316.png

Просмотр загруженных данных

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

_images/244.png

Откроется реестр с загруженными данными в режиме просмотра (подробнее про работу в этом режиме см. подраздел Просмотр отчетов, форм, реестров).

Для возвращения к работе с коннектором нужно кликнуть на эту же кнопку.

_images/245.png

Открытие и работа с сохраненным коннектором

Для работы с существующим коннектором следует на странице работы с коннектором нажать на кнопку с изображением папки (кнопка «Открыть»), расположенную слева от поля, где выводится название текущего коннектора, из списка выбрать нужный коннектор и нажать на его название. Через некоторое время загрузится выбранный коннектор со всеми настройками. Дальнейшая работа аналогична работе с новым коннектором.

_images/305.png

Если необходимо обновить настройки коннектора в Системе (обновить файл с данными, изменить название коннектора), необходимо нажать на кнопку «Настройки» в верхнем меню окна.

_images/306.png

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

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

Для возврата к работе с коннектором необходимо нажать на кнопку «ОК», чтобы сохранить изменения (либо на кнопку «Отмена», если сохранять внесенные изменения не нужно).

Обратите внимание, если файл с данными был обновлен, то сначала следует нажать на кнопку «Сохранить» в верхнем меню страницы и только после этого можно будет приступать к загрузке данных (кнопка «Загрузить данные» в верхнем меню страницы).

Также изменить название коннектора можно в поле в верхнем меню на странице работы с коннектором. После изменения названия необходимо нажать кнопку «Сохранить» слева от этого поля.

_images/307.png

Журнал загрузок

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

Для того, чтобы просмотреть историю загрузок данных, следует в главном пункте меню «Загрузка данных» выбрать вкладку «Журнал загрузок».

_images/246.png

В результате откроется страница с журналом загрузок из всех коннекторов.

_images/247z.PNG

В верхней части страницы расположены кнопки:

  • «Обновить журнал» (предназначена для обновления информации на странице).
  • «Сброс настроек размеров заголовков» (сбрасывает размеры заголовков до настроек по умолчанию).
  • «Экспортировать в xls» (позволяет экспортирует журнал загрузок в файл MS Excel).
_images/248z.PNG

Работа с таблицей осуществляется так же, как с другими таблицами (отчетами и реестрами): можно изменять ширину и высоту заголовков столбцов, применять сортировку по нажатию на заголовок и т.п.

По нажатию на ссылку в столбце «Коннектор» откроется страница выбранного коннектора.

_images/249.png

По нажатию на ссылку в столбце «Обновляемые таблицы» откроется реестр с загруженными из этой таблицы данным.

_images/250.png

Если в столбце «Статус загрузки данных» указано, что есть ошибки, то эти ошибки выводятся в столбце «Сообщение об ошибках».

_images/251z.PNG

Обратите внимание, что большие файлы загружаются в несколько заходов (по 10 000 строк).

_images/252.png

Если после загрузки данных коннектор был удален, то запись о загрузке останется, но в столбцах «Коннектор» и «Обновляемые таблицы» будет пусто.

_images/253z.PNG

Удаление коннектора

Для удаления сохраненного в Системе коннектора необходимо нажать на кнопку «Удалить коннектор» в правом верхнем углу страницы.

_images/308.png

Данное действие требует подтверждения во всплывающем окне. Также в диалоговом окне следует указать, необходимо ли удалить только коннектор или коннектор со всеми справочниками, показателями, данными, которые используются в Системе только в этом коннекторе (в этом случае следует установить флаг «Удалить вместе с данными»).

_images/309.png

Для подтверждения действия удаления следует нажать на кнопку «Удалить», либо на кнопку «Отмена» для возврата к работе с Системой.

При удалении коннектора и данных из Системы данные в источнике (файле, базе данных), из которого они загружены, не затрагиваются.