Skip to main content

Создание и публикация базы

Публикация на web сервере происходит после создания базы. Тип базы (файловая или клиент-серверная) не важен.

После запуска 1С:Предприятие, создание и добавление баз осуществляется нажатием на кнопку "Добавить"

 AddBase1.JPG

  1. Создание новой базы: 
    1. Выбрать "Создание новой информационной базы", нажать Далее
    2. Выбрать "Создание информационной базы без конфигурации", нажать Далее
    3. Указать название базы, это название будет отображаться в списке информационных баз. Вариант "На данном компьютере..." создает файловую базу, вариант "На сервере..." - сетевую базу.
    4. Для файловой указать директорию размещения базы
  2. Добавление существующей базы 
    1. Выбрать "Добавление в список существующей информационной базы"

Публикация БД на web сервере:

Через конфигуратор

  1. Запустить Конфигуратор от имени администратора.

  2. В верхнем меню «Администрирование» -> «Публикация на веб-сервере...» .

  3. В открывшемся окне:

        Имя публикации: задайте короткое имя латиницей (например, base или test). Оно будет частью URL-адреса.

        Веб-сервер: выберите веб-сервер (IIS или Apache).

        Каталог: укажите папку, где будет храниться файл конфигурации публикации (default.vrd).

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

  4. Нажмите «Опубликовать».

  5. Перезапустите веб-сервер. Для IIS команда iisreset в командной строке, для Apache — перезапустить службу .

Через webinst

Консоль от имени Администратора. Для Apache:

webinst -publish -apache24 -wsdir mybase -dir "C:\inetpub\wwwroot\mybase" -connstr "File='C:\1C_Bases\MyBase';"

Адрес по умолчанию: http://localhost/имя_публикации (если веб-сервер на том же компьютере) или http://IP-адрес-сервера/имя_публикации

-apache24 Указывает версию Apache
-wsdir Имя виртуального каталога (алиас), по которому будет доступна публикация
-dir Физический путь к папке публикации
-connstr Строка подключения к базе. Если сервер 1С не на localhost или использует нестандартный порт, укажите его: Srvr=server-name:2641;Ref=base
-descriptor Путь к нашему файлу-шаблону .vrd
-confpath Путь к главному конфигурационному файлу Apache (чтобы утилита могла прописать алиас)

Важно

  1. Права доступа: для файловой базы у пользователя веб-сервера (например, IIS_IUSRS или пользователь Apache), должны быть права на чтение и запись в папку с файлом базы данных (.1CD). Без этого база не запустится.
  2. Лицензии: Запуск Конфигуратора для публикации занимает лицензию, как и обычный сеанс работы.
  3. Версия платформы: При публикации нескольких баз с разными версиями платформы, все они будут использовать расширение веб-сервера той версии, которая была опубликована последней.

АдресМеханизмы интеграции

HTTP-сервисы — REST API
Современная интеграция. Создаётся сервис, определяются URL-шаблоны, HTTP-методы и обработчики. Например:

МетодURLНазначение
GET/vmcurПолучить список ВМ
GET/vmcur/123Получить конкретную ВМ
POST/vmcurДобавить ВМ
PUT/vmcur/123Изменить ВМ
DELETE/vmcur/123Удалить ВМ

Web-сервисы — SOAP
Формализованный механизм интеграции, описывается полноценный контракт сервиса.  Основные элементы:

  • Операции — доступные методы сервиса.
  • Параметры — входные данные операций.
  • Возвращаемые значения — результат выполнения.
  • XDTO-пакеты — описание типов данных.
  • WSDL — описание интерфейса сервиса для webвнешних сервисовклиентов.
  • другой,

Например, можно создать SOAP-сервис VirtualMachineService с операциями:

  • GetVirtualMachines
  • GetVirtualMachine
  • CreateVirtualMachine
  • UpdateVirtualMachine 

Внешняя программа получает описание сервиса по WSDL и может автоматически сформировать клиентский код. Пример SOAP-запроса выглядит примерно так:

<soap:Envelope>
    <soap:Body>
        <GetVirtualMachines/>
    </soap:Body>
</soap:Envelope>

Ответ тоже приходит в негоXML, внутри SOAP-конверта.

Когда использовать SOAP:

  • интеграция с государственными информационными системами;
  • взаимодействие с банками;
  • работа с корпоративными системами, которые требуют SOAP;
  • интеграция с уже существующими сервисами, для которых предоставлен WSDL.

WS-ссылки 

Подключение к чужим SOAP-сервисам. Например:

  • сторонняя система предоставляет: https://example.ru/services/VirtualMachineService?wsdl
  • этот адрес добавляется hsв конфигуратор Общие → WS-ссылки
  • 1С загружает WSDL, анализирует структуру сервиса и создаёт описание его операций и типов.

Затем возможно вызывать операции из встроенного языка 1С. Различие:

ОбъектНаправление
Web-сервис1С предоставляет сервис наружу
WS-ссылка1С обращается к чужому сервису

WS-ссылка — это клиентская часть интеграции.

OData 

Стандартный интерфейс доступа к данным 1С. В отличие от HTTP-сервисов и SOAP, для OData не нужно самостоятельно писать обработчики запросов. Платформа 1С предоставляет стандартный интерфейс доступа к опубликованным объектам информационной базы. Например, можно обратиться к справочнику виртуальных машин по адресу:
http://server/itinfo/odata/standard.odata/Catalog_ВиртуальныеМашины

Можно получать данные, фильтровать, сортировать и выбирать отдельные поля. Пример Python:

import requests 
from requests.auth import HTTPBasicAuth
URL = "http://server/itinfo/odata/standard.odata/Catalog_ВиртуальныеМашины"
response = requests.get(
                        URL,
                        auth=HTTPBasicAuth("username", "password"),
                        params={"$format": "json", "$select": "Ref,Description"},
                        timeout=15)
response.raise_for_status()
print(response.json())

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

  • Получение справочников.
  • Получение документов.
  • Чтение регистров.
  • Фильтрация данных.
  • Сортировка.
  • Создание и изменение объектов.
  • Получение метаданных информационной базы.

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

Планы обмена

Синхронизация между базами 1С. Классический механизм интеграции в платформе. Находится в конфигураторе: Планы обмена. Представим, у организации есть две информационные базы: Центральная база и Филиальная база. Необходимо передавать документы, справочники и изменения между ними. Для этого создаются:

  1. План обмена.
  2. Узлы обмена.
  3. Состав регистрируемых объектов.
  4. Механизм формирования и обработки сообщений обмена.

Платформа позволяет регистрировать изменения объектов и формировать сообщения обмена. Типичный сценарий:

  • В филиале создаётся документ.
  • Изменение регистрируется.
  • Формируется сообщение обмена.
  • Сообщение передаётся центральной базе.
  • Центральная база принимает и обрабатывает данные.

Это особенно полезно для распределённых информационных систем 1С.

Файловый обмен

Самый простой механизм. Одна система формирует файл, другая его забирает и обрабатывает. Преимущества:

  • Простота реализации.
  • Не требуется постоянное соединение.
  • Можно передавать большие объёмы данных.
  • Удобно организовать пакетный обмен по расписанию.

Недостатки:

  • нет мгновенного взаимодействия.
  • Необходимо организовать контроль доставки, повторную обработку и защиту от дублирования сообщений.

COM-соединение

COM позволяет внешним Windows-приложениям обращаться к объектной модели 1С. Например, Python может подключиться к установленной платформе 1С через COM. Для этого нужны Windows, установленная платформа 1С и соответствующие компоненты COM. Особенности:

  • Не требуется HTTP-сервис.
  • Можно обращаться к объектной модели 1С.
  • Подходит для локальной автоматизации.
  • Есть зависимость от Windows и установленной платформы.

Для удалённой интеграции через интернет обычно выбирают другие механизмы.

Сравнительная таблица

МеханизмПротокол / способДля чего предназначен
HTTP-сервисыHTTP, JSON, XMLСобственное API
Web-сервисыSOAP, XML, WSDLСтрогий контракт интеграции
WS-ссылкиSOAP, WSDLВызов чужих сервисов
ODataHTTP, REST/ODataСтандартный доступ к объектам
Планы обменаСообщения обменаСинхронизация баз 1С
Файловый обменXML, JSON, CSVПакетная передача
COMCOM/DCOMЛокальная Windows-интеграция

Варианты выбора механизмов при интеграции 1С с внешними сервисами:

ЗадачаМеханизм
Получить список виртуальных машинHTTP-сервис
Создать виртуальную машину в 1СHTTP-сервис
Изменить сетевой адрес ВМHTTP-сервис
Получить справочники без написания обработчиковOData
Получать данные из внешней SOAP-системыWS-ссылка
Предоставить SOAP API сторонней системеWeb-сервис
Синхронизировать две базы 1СПланы обмена
Выгружать большие массивы по расписаниюФайловый обмен

Официальный ресурс: Документация платформы 1С — WS-ссылки и Методическая документация по Web-сервисам.

HTTP-сервисы

Адрес http сервисов: 

http://serveraddr:serverport/basename/hs/КорневойURL/имяШаблона

КорневойURL: 

image.png

ИмяШаблона: 

image.png

image.png

То есть адрес собираем по частям из разных точек конфигурации.

Пример функции, получающей данные из двух соединенных таблиц 

Функция ШаблонVmOsvmcur(Запрос) Экспорт
    // 1. Формируем запрос к справочникам
    ЗапросДанных = Новый Запрос;
    ЗапросДанных.Текст =
    "ВЫБРАТЬ
    |   ВиртуальныеМашины.Ссылка КАК Ссылка,
    |   ВиртуальныеМашины.СетевойАдрес КАК СетевойАдрес,
	|   ВиртуальныеМашины.Наименование КАК ИмяВМ,
    |   ОперационныеСистемы.Наименование КАК ИмяОС,
    |   ОперационныеСистемы.Версия КАК ВерсияОС
    |ИЗ
    |   Справочник.ВиртуальныеМашины КАК ВиртуальныеМашины
    |       ЛЕВОЕ СОЕДИНЕНИЕ Справочник.ОперационныеСистемы КАК ОперационныеСистемы
    |       ПО ВиртуальныеМашины.ОС = ОперационныеСистемы.Ссылка";

    // 2. Выполняем запрос
    РезультатЗапроса = ЗапросДанных.Выполнить();

    // 3. Формируем массив виртуальных машин
    МассивВМ = Новый Массив;

    Выборка = РезультатЗапроса.Выбрать();
    Пока Выборка.Следующий() Цикл
        СтруктураВМ = Новый Структура;

        СтруктураВМ.Вставить("Имя", Выборка.ИмяВМ);
        СтруктураВМ.Вставить("СетевойАдрес", Выборка.СетевойАдрес);
        СтруктураВМ.Вставить("ОС", Выборка.ИмяОС);
        СтруктураВМ.Вставить("ВерсияОС", Выборка.ВерсияОС);

        МассивВМ.Добавить(СтруктураВМ);
    КонецЦикла;

    // 4. Формируем структуру ответа
    ДанныеОтвета = Новый Структура;
    ДанныеОтвета.Вставить("Успех", Истина);
    ДанныеОтвета.Вставить("Данные", МассивВМ);

    // 5. Формируем HTTP-ответ
    Ответ = Новый HTTPСервисОтвет(200);
    Ответ.Заголовки.Вставить("Content-Type", "application/json; charset=utf-8");

    // 6. Сериализуем структуру в JSON
    ЗаписьJSON = Новый ЗаписьJSON;
    ЗаписьJSON.УстановитьСтроку();
    ЗаписатьJSON(ЗаписьJSON, ДанныеОтвета);
    ТелоОтвета = ЗаписьJSON.Закрыть();

    // 7. Устанавливаем тело HTTP-ответа
    Ответ.УстановитьТелоИзСтроки(
        ТелоОтвета,
        КодировкаТекста.UTF8
    );
    Возврат Ответ;
КонецФункции

Скрипт получения данных (естественно, лучше асинхронные библиотеки и все такое):

import requests
from requests.auth import HTTPBasicAuth
import json

URL = "http://servername:8080/itinfo/hs/vmos/vmcur"
# Учётные данные пользователя 1С
USERNAME = "integrator"
PASSWORD = "integrator"

try:
    response = requests.get(
        URL,
        auth=HTTPBasicAuth(USERNAME, PASSWORD),
        timeout=15
    )
    response.raise_for_status()
    data = response.json()
    #print("Ответ сервера:")
    #print(json.dumps(data, indent=4, ensure_ascii=False))

    if data.get("Успех"):
        for vm in data.get("Данные", []):
            print(
                f"Имя: {vm['Имя']} | "
                f"IP: {vm['СетевойАдрес']} | "
                f"ОС: {vm['ОС']} | "
                f"Версия: {vm['ВерсияОС']}"
            )
    else:
        print("1С вернула ошибку:", data)

except requests.exceptions.HTTPError as e:
    print(f"HTTP-ошибка: {e}")
    print("Код ответа:", response.status_code)

except requests.exceptions.RequestException as e:
    print(f"Ошибка подключения: {e}")