Коннекторы и источники данных

Коннектор связывает AxioLabel Автоматизацию с источником данных: файлом Excel или CSV, базой данных либо входящим REST-запросом. Он хранит настройки чтения, рабочий набор полей, условия отбора и, если доступно, расписание.

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

Открыть каталог коннекторов

В боковом меню раскройте Принт Навигатор и выберите Коннекторы.

Таблица содержит следующие колонки:

• Имя — название коннектора. Значок замка означает редактирование на другой рабочей станции.
• Тип — код источника: excel, csv, mssql, mysql, postgresql или rest-inbound.
• Активен — участвует ли коннектор в активной цепочке обработки.
• Состояние — текущий этап работы либо результат, требующий внимания.
• Последний запуск — локальные дата и время последнего запуска и его результат.
• Действия — изменение, удаление, ручной запуск и предпросмотр данных.

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

Выбрать тип источника

Тип задаётся при создании и после сохранения не изменяется.

• excel — файл или директория, лист, наличие и положение строки заголовка, первая строка данных.
• csv — файл или директория, маска файлов, разделитель, кодировка и наличие заголовка.
• mssql — сервер, порт, база данных, схема и таблица, представление либо запрос только для чтения.
• mysql — сервер, порт, база данных и объект либо запрос только для чтения.
• postgresql — сервер, порт, база данных, схема и объект либо запрос только для чтения.
• rest-inbound — аутентификация, формат входящего JSON, состав полей и адрес эндпойнта.

Доступный список зависит от возможностей текущей лицензии. Если раздел источников недоступен, приложение показывает соответствующее предупреждение.

Создать коннектор

1. Нажмите Создать.
2. Укажите понятное уникальное имя и выберите Тип.
3. Заполните настройки источника, не используя реальные секреты в учебном примере.
4. Нажмите Добавить или обновить поля источника либо примените JSON-образец для входящего REST.
5. Перенесите нужные поля в группу Используемые поля. Остальные оставьте в группе Неиспользуемые поля.
6. При необходимости задайте Отбор записей и Расписание.
7. Нажмите Сохранить.

После сохранения приложение закрывает редактор, обновляет каталог и показывает сообщение Источник «…» сохранён.

Настроить файловый источник

Для Excel и CSV выберите Конкретный файл или Директория. Во втором случае файлы выбираются во входной директории по маске. Маска содержит только имя файла с символами * и ?, без пути к директории.

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

Действия После успеха и После ошибки могут оставлять, удалять или перемещать файл. Не выбирайте удаление до проверки сценария на копии тестовых данных.

Настроить базу данных

1. Укажите сервер, порт, пользователя и пароль.
2. При необходимости настройте шифрование и доверие сертификату сервера по правилам вашей инфраструктуры.
3. Нажмите Загрузить доступные базы данных.
4. Выберите базу и нажмите Загрузить схемы и объекты.
5. Выберите режим: Таблица, Представление или Запрос.
6. Для режима запроса используйте только чтение.
7. Загрузите поля и оставьте включёнными только данные, необходимые шаблону.

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

Настроить входящий REST

1. Выберите тип rest-inbound и режим аутентификации.
2. Укажите безопасный JSON-образец одного объекта.
3. Нажмите Обновить поля из образца и настройте используемые поля.
4. Выберите формат сообщения: Один объект или Массив объектов.
5. Сохраните источник и откройте Пример для интегратора.

Пример учитывает эндпойнт, аутентификацию, формат сообщения и включённые поля. Перед передачей интегратору замените заполнители учётных данных. Для вызова с другого компьютера вместо localhost используется имя или IP-адрес сервера; протокол и порт не изменяются без настройки хоста.

Проверить поля и данные

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

Сохраните коннектор и в каталоге выберите Предпросмотр:

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

Команда Запустить не заменяет предпросмотр: при наличии связанного маршрута она может передать записи дальше по цепочке обработки.

Настроить расписание

Если тип поддерживает чтение по расписанию, доступны режимы:

• Без расписания;
• Фиксированный интервал — новый отсчёт начинается после завершения предыдущего запуска;
• Календарное (Cron) — используется часовой пояс хост-приложения.

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

Понять состояние

• Ожидает — коннектор сейчас не выполняет чтение или передачу.
• Чтение данных — источник получает очередную порцию записей.
• Передача в маршрут — подготовленные данные передаются связанному маршруту.
• Ожидание печати — созданные задания ожидают дальнейшей обработки.
• Постобработка — выполняется настроенное действие после результата.
• Нет данных — запуск завершён без подходящих записей.
• Завершён — запуск выполнен; итог дополнительно указан в колонке последнего запуска.
• Ошибка — операция завершилась ошибкой и требует диагностики.

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

Изменить или удалить коннектор

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

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

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

Если возникла ошибка

1. Скопируйте точный текст сообщения и корреляционный идентификатор, если он показан.
2. Проверьте доступность файла, директории, сервера или эндпойнта с рабочей станции Автоматизации.
3. Проверьте выбранные поля и условия отбора.
4. Не публикуйте пароль, API-ключ, JSON с реальными данными или строку подключения.
5. Откройте Параметры → Системный журнал и сопоставьте событие по времени и корреляционному идентификатору. Безопасный порядок описан в статье «Параметры и системная диагностика».