Импорт данных

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

Источники данных описываются в справочнике Внешние источники данных. Вы можете добавлять или изменять источники, используя этот справочник. Перейти в справочник Внешние источники данных вы можете через Меню > Справочники > Внешние источники данных.

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

Обычный импорт (пошаговый)

В разделе Печать этикеток, Каталог товаров или в справочнике нажмите кнопку Импорт. Откроется форма импорта данных.

Импорт данных состоит из 2 шагов:

  1. Чтение данных из источника. Данные из источника будут помещены во временную таблицу Данные для импорта.
  2. Импорт данных. Данные из временной таблицы Данные для импорта будут добавлены в:
    • Данные для печати, если импорт был открыт в разделе Печать этикеток.
    • Каталог товаров, если импорт был открыт в разделе Каталог товаров.
    • Справочник, если импорт был открыт в справочнике.

Шаг 1 - Чтение данных из источника

  1. Перейдите во вкладку 1 Шаг — чтение данных из источника.

  2. Выберите источник данных.

    1. Нажмите на поле Источник данных.

    2. Откроется форма выбора источника внешних данных. Выберите источник данных и нажмите Выбрать этот Внешний источник данных.

  3. Нажмите кнопку Прочитать данные из источника

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

Шаг 2 - Импорт данных

  1. Перейдите во вкладку 2 Шаг — Импорт данных (после чтения данных эта вкладка будет открыта автоматически).

    Таблица Данные для импорта - это временная таблица, содержащая прочитанные из источника данные.

  2. Определите с какой строки по какую расположены данные, которые будут импортированы, и установите первую и последнюю строки этого диапазона.

  3. Свяжите колонки с полями данных.

    1. Нажмите на иконку настройки в заголовке нужной колонки.

    2. Откроется форма выбора поля данных, которое будет связано с данной колонкой.

      Выберите поле данных, которое будет связано с данной колонкой 1, и нажмите ОК.

      Для колонок, которые не участвуют в импорте, нажмите кнопку 2 Не импортировать эту колонку.

      Если вы не нашли подходящее вам поле данных, вы можете добавить ваше собственное поле данных 3 (доступно при импорте в Данные для печати).

  4. Если нужно задать количество этикеток для каждого товара (по умолчанию 1) из ваших данных, то свяжите колонку, содержащую количество этикеток, с полем данных Количество этикеток для печати.

  5. Нажмите кнопку Импортировать данные.

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

Обновить данные

Если импорт произведен в Данные для печати, то программа запоминает параметры этого импорта и далее вы можете повторять импорт в одно нажатие кнопки Обновить данные.

Это удобно, если у вас один источник импорта, например файл Excel, и при изменении в нем вы можете быстро загрузить измененные данные одним нажатием этой кнопки.

Импорт в одно нажатие

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

Предварительная настройка

Выполните необходимые настройки источника данных.

  1. Откройте справочник Внешние источники данных через Меню > Справочники > Внешние источники данных, выберите нужный источник данных и нажмите Редактировать.

  2. Задайте все необходимые настройки импорта.

Пример настроек для импорта из файла Excel

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

  1. Задайте путь к файлу.

  2. Задайте номер строки с заголовками и номер первой строки с данными.

  3. Свяжите поля данных с колонками в файле по названиям заголовков в первой строке.

Импорт

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

  1. Нажмите кнопку 1 справа от кнопки Импорт.
  2. Выберите нужный источник данных 2.
  3. Установите флаг 3 Импорт в одно нажатие.

Это разовая настройка, которая позволяет выполнять импорт автоматически без открытия окна импорта.

Выполните импорт в одно нажатие кнопки Импорт.

Настройки импорта

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

  1. Нажмите Настройки импорта, если у вас открыто окно импорта данных.
  2. Откройте справочник Внешние источники данных через Меню > Справочники > Внешние источники данных, выберите нужный источник данных и нажмите Редактировать.

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

Чтение данных

Подключение

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

Назначение настроек:

  • Путь к файлу или Путь к базе данных. Путь к файлу с данными. Если оставить пустым, то будет показан диалог выбора файла.
  • SQL-запрос. Для отбора определенных данных из базы данных.
  • Имя пользователя, Пароль. Для авторизации в базе данных.
  • Строка подключения. Для подключения к источнику ODBC.
  • Authorization Token. Для авторизации в EposNow.

Чтение

Здесь вы можете настроить параметры чтения данных. Содержимое вкладки может различаться в зависимости от типа источника.

Назначение настроек:

  • Строка с заголовками. Номер строки, в которой находятся заголовки. 0 - нет заголовков.
  • Первая строка с данными. Номер строки, начиная с которой находятся данные. 0 - автоматическое определение.
  • Номер листа. Номер листа электронной таблицы. 0 - будет показано окно выбора листа, если в электронной таблице несколько листов.
  • Кодировка файла. Кодировка текста в файле с данными.
  • Разделитель полей. При чтении из источника с типом CSV.
  • Обрамление строк. При чтении из источника с типом CSV.
  • Действия при чтении данных.

    • Связать поля данных с колонками по ключевым словам. Если флаг установлен, то поля данных будут автоматически связаны с колонками импортируемых данных по совпадению с ключевыми словами. Ключевые слова задаются на вкладке Поля данных. Игнорируется, если указана прямая связь параметров с колонками на вкладке Поля данных.
    • Определить диапазон строк. Если флаг установлен, то диапазон импортируемых строк будет определен автоматически, с учетом настройки Первая строка с данными.
    • Только при первом чтении в сеансе. Если флаг установлен, то две предыдущих настройки будут работать только при первом чтении после запуска программы.

Поля данных

На этой вкладке вы можете связать поля данных, используемые в программе, с колонками / полями / сущностями импортируемых данных и установить другие настройки, связанные с полями данных.

Связь с колонками / полями источника

Назначение настроек для поля данных:

  • Связать с колонкой.
    • По номеру. Номер колонки (отсчет начинается с 1), которая связана с полем данных. Можно указать несколько колонок, разделяя их пробелом. При указании нескольких колонок значения из них будут объединены с использованием настройки Объединитель значений.
    • По заголовку. Заголовок таблицы источника или название сущности/поля источника, с которым связано поле данных. Можно указать несколько (максимум 3). При указании нескольких заголовков значения из полей источника будут объединены с использованием настройки Объединитель значений.
  • Ключевые слова. Используются, если установлен флаг Связать поля данных с колонками по ключевым словам на вкладке Чтение данных и не установлена связь полей данных с колонками через номера колонок или заголовки. При чтении данных будет выполнено связывание поля данных с колонкой по первому частичному совпадению с одним из ключевых слов/фраз. Слова/фразы располагаются в отдельных строках.

Настройки импорта / печати из источника

Назначение настроек для поля данных:

  • Объединитель значений. Если поле данных связано с несколькими колонками, то значения этих колонок будут объединены в одну строку с использованием данной строки между ними.
  • Разделители значений. В колонке может находиться несколько значений, разделенных любым из указанных здесь символов. Символ-разделитель может использоваться при перечислении штрихкодов, кодов маркировки, состава комплекта, папок товара (пути).
  • Цвет колонки. Во временной таблице с данными в окне импорта.
  • Формула для получения значения. Формула для изменения значения в поле данных. Если оставить пустой, то значение поля данных будет импортировано без изменений.
  • Это URL или путь к файлу / папке. Если флаг установлен, то будет считаться что это поле данных содержит URL или путь к файлу. Если поле данных содержит "https:", "http:" или "ftp:", то это URL, иначе путь к файлу. Если это путь к файлу и он относительный, то путь преобразуется в абсолютный при импорте (в качестве базового пути используется путь к файлу-источнику). Если это путь к файлу и он содержит только имя файла, то путь преобразуется в полный при импорте (в качестве базового пути используется путь к файлу-источнику).

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

Импорт данных

Настройки импорта в Данные для печати

Здесь вы можете установить специфические настройки импорта в Данные для печати:

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

Настройки импорта в каталог "Товары"

Здесь вы можете установить специфические настройки импорта в каталог товаров:

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

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

    • Обновлять и добавлять новые. Будет производиться поиск существующих товаров по ключевым полям данных, задаваемым в Набор полей данных для поиска товара (записи). Если товары будут найдены, у них будут обновлены параметры, не являющиеся ключевыми, иначе товары будут добавлены.
    • Всегда добавлять. Товары будут добавлены всегда (поиск существующих товаров не будет производиться).
    • Только обновлять. Будет производиться поиск существующих товаров по ключевым полям данных, задаваемым в Набор полей данных для поиска товара (записи). Если товары будут найдены, у них будут обновлены параметры, не являющиеся ключевыми.
    • Только добавлять новые. Будет производиться поиск существующих товаров по ключевым полям данных, задаваемым в Набор полей данных для поиска товара (записи). Если товары не будут найдены, то они будут добавлены.

      Поиск товаров производится во всем каталоге, если не установлен флаг Поиск существующих товаров только в этой папке. Если флаг установлен, поиск товаров будет осуществляться в пределах папки для импорта.
      Игнорируется, если правило обновления / добавления товаров Всегда добавлять.
  • Очищать каталог перед импортом. Если флаг установлен, то перед импортом каталог товаров будет полностью очищен.
  • Добавлять товары в Данные для печати. Если флаг установлен, то кроме добавления товаров в каталог, эти товары будут добавлены в Данные для печати раздела Печать этикеток.

    • Очищать данные для печати. Если флаг установлен, то перед добавлением товаров Данные для печати раздела Печать этикеток будет очищен.
      Игнорируется, если не установлен флаг Добавлять товары в Данные для печати.
    • Правило добавления. Правило позволяет настраивать логику добавления товаров в Данные для печати раздела Печать этикеток.

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

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

Фильтрация строк при импорте

Для фильтрации импортируемых строк задайте условие, нажав на кнопку Задать формулу. Условие будет проверяться на каждой импортируемой строке. Строка будет импортирована, если в условии утверждение будет истинным или формула вернет 1.