Создание подключения — настройка «Базы данных»

Для настройки подключения к источникам (базы данных, 1С-приложения, файлы) или приемникам (включая хранилища), перейдите в раздел «База данных» одним из способов:

• «Начальная страница/ Источники данных/ Базы данных»
• или через меню «Размещение данных/ Справочная информация/ Базы данных»:

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

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

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

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

Создание нового источника данных

Чтобы создать новый источник данных, перейдите в «Источники данных» одним из способов:

• «Начальная страница/ Источники данных»;
• или через меню «Размещение данных/ Справочная информация/ Источники данных»:

Откроется окно, в котором отображается список источников данных. Вы можете создать новый источник тремя способами:

• Нажмите на кнопку «Создать».
• Нажмите на кнопку «Создать новый элемент копированием текущего» .
• Или нажмите на кнопку «Создать элементы по шаблону».

Дальнейшая настройка зависит от вида источника данных.

Настройка разных видов источников данных

Источниками данных могут быть:

• База данных (1С или СУБД);
• Веб-сервис;
• Файл.

Настройка для вида «База данных»

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

Настройка для вида «Веб сервис»

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

На вкладке «Дополнительные настойки» укажите «Адрес сервера»:

Настройка для вида «Файл»

Вид источника данных «Файл» предполагает регулярную загрузку данных из файлов (xlsx, xls или csv), которые размещаются в определенном каталоге, а после обработки переносятся в другой каталог — «Каталог обработанных файлов».

Источники описывают шаблон группы файлов. Для источников вида «Файл» указываются следующие параметры:

• «Вид источника» — файл;
• «База данных» — выбор из справочника «Базы данных». Заполняется если получение данных происходит через ADO-ODBC. Настройка базы данных, описывающей конкретный файл или каталог с файлами, подробнее описана ниже, в разделе «Настройка подключения к источнику типа "Файл"».
• «Каталог к файлу» — укажите каталог с новыми файлами для загрузки;
• «Маска файлов» — маска, по которой будет происходить поиск новых файлов в Каталоге к файлу;
• «Каталог обработанных файлов» и «Каталог файлов с ошибками» — каталоги, куда после обработки (успешной или нет) будут перемещены новые файлы.

Настройка подключения к источнику типа «Файл»

Используется при получении данных через ADO-ODBC.

При настройке «Базы данных» для файлов «XLSX» и «XLS» указываются следующие параметры:

• «Тип базы данных» — Файл;
• «Путь к файлу» — путь к одному из файлов. При получении данных через «Состав выгрузки» этот параметр может быть переопределен в зависимости от настроек конкретного источника данных.
• «Шаблон строки подключения» — выберите из списка шаблон строки подключения.

При настройке базы данных — файла «CSV» указываются следующие параметры:

• «Тип базы данных» — файл;
• «Шаблон строки подключения» — шаблон строки подключения с драйверами нужной разрядности;
• «Путь к файлу» и  «Имя пользователя» — укажите каталог, из которого будут загружаться «CSV» файлы.

Сохраните настройки, нажав на кнопку «Сохранить».

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

Требования к исходным файлам загрузки

Файлы Excel («XLSX», «XLS»):

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

Файлы «CSV»:

• заголовки не должны содержать символы «.», «,», перевод строки (если в заголовке есть пробелы, то заголовок нужно заключать в двойные кавычки в запросе правила и в схеме);
• если значение содержит в себе CRLF, CR, LF (символы-разделители строк), двойную кавычку или запятую (символ-разделитель полей), то заключение значения в кавычки обязательно. В противном случае — допустимо;
• если внутри закавыченной части встречаются двойные кавычки, то используется специфический квотинг кавычек в «CSV» — их дублирование;
• длина наименования названия поля (AS) до 20 символов.

Регистрация набора источников

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

Сервисные функции по управлению1С: Fresh-источниками

Интеграция с менеджером облачного сервиса для обновления справочной информации об источниках данных.

Для облачных баз 1C: Fresh описание источников данных обычно содержится в Менеджере сервиса и возможно обновлять справочник «Источники данных», подключаясь к Менеджеру сервиса с помощью web-сервиса.

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

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

• для существующих записей (элемент найден по ключу) обновлять изменившиеся поля;
• для новых (элемент не найден по ключевому полю) добавлять в справочник новые записи.

Для активации функционала перейдите в раздел «Главное/ Информация/ Основные настройки/ Настройки получения данных» и установите галочку «Использовать менеджер сервиса 1С: Fresh»:

Для запуска процедуры вручную перейдите в меню «Главное/ Сервис/ Загрузка справочной информации»:

Настройка регламентного задания загрузки данных об источниках (областях) через web-сервис осуществляется через меню «Администрирование/ Обслуживание/ Регламентные операции/ Регламентные и фоновые задания/ Задание» — «Загрузка Справочной Информации».

Установите галочку «Включено» и настройте расписание обновления, нажав на ссылку «Расписание»:

Проверка доступности баз данных

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

1. Для проверки подключения к определенной БД выберите базу и нажмите на кнопку «Проверить подключение». Появится информационное окно «Подключение к базе данных установлено». В случае недоступности будет выведено подробное сообщение об ошибке:
   
2. Для проверки подключения к нескольким БД нажмите на кнопку «Все», в открывшемся окне по умолчанию выбраны все базы, при необходимости снимите галочки с баз, по которым проверка не нужна. Нажмите на кнопку «Запустить проверку». Прогресс и время выполнения отображается на шкале. После завершения проверки, если подключение успешно, появится зеленый значок.