Создание и публикация базы
Публикация на web сервере происходит после создания базы. Тип базы (файловая или клиент-серверная) не важен.
После запуска 1С:Предприятие, создание и добавление баз осуществляется нажатием на кнопку "Добавить"
- Создание новой базы:
- Выбрать "Создание новой информационной базы", нажать Далее
- Выбрать "Создание информационной базы без конфигурации", нажать Далее
- Указать название базы, это название будет отображаться в списке информационных баз. Вариант "На данном компьютере..." создает файловую базу, вариант "На сервере..." - сетевую базу.
- Для файловой указать директорию размещения базы
- Добавление существующей базы
- Выбрать "Добавление в список существующей информационной базы"
Публикация БД на web сервере:
Через конфигуратор
-
Запустить Конфигуратор от имени администратора.
-
В верхнем меню «Администрирование» -> «Публикация на веб-сервере...» .
-
В открывшемся окне:
Имя публикации: задайте короткое имя латиницей (например, base или test). Оно будет частью URL-адреса.
Веб-сервер: выберите веб-сервер (IIS или Apache).
Каталог: укажите папку, где будет храниться файл конфигурации публикации (default.vrd).
Флажки: «Публиковать тонкий и веб-клиенты» (или «Публиковать доступ для клиентских приложений»). При необходимости OData (например, для интеграций), установите флажок.
-
Нажмите «Опубликовать».
-
Перезапустите веб-сервер. Для 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 (чтобы утилита могла прописать алиас) |
Важно
- Права доступа: для файловой базы у пользователя веб-сервера (например, IIS_IUSRS или пользователь Apache), должны быть права на чтение и запись в папку с файлом базы данных (.1CD). Без этого база не запустится.
- Лицензии: Запуск Конфигуратора для публикации занимает лицензию, как и обычный сеанс работы.
- Версия платформы: При публикации нескольких баз с разными версиями платформы, все они будут использовать расширение веб-сервера той версии, которая была опубликована последней.
Механизмы интеграции
HTTP-сервисы — REST API
Современная интеграция. Создаётся сервис, определяются URL-шаблоны, HTTP-методы и обработчики. Например:
| Метод | URL | Назначение |
| GET | /vmcur | Получить список ВМ |
| GET | /vmcur/123 | Получить конкретную ВМ |
| POST | /vmcur | Добавить ВМ |
| PUT | /vmcur/123 | Изменить ВМ |
| DELETE | /vmcur/123 | Удалить ВМ |
Web-сервисы — SOAP
Формализованный механизм интеграции, описывается полноценный контракт сервиса. Основные элементы:
- Операции — доступные методы сервиса.
- Параметры — входные данные операций.
- Возвращаемые значения — результат выполнения.
- XDTO-пакеты — описание типов данных.
- WSDL — описание интерфейса сервиса для внешних клиентов.
Например, можно создать 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
- этот адрес добавляется в конфигуратор Общие → 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С.
Файловый обмен
Самый простой механизм. Одна система формирует файл, другая его забирает и обрабатывает. Преимущества:
- Простота реализации.
- Не требуется постоянное соединение.
- Можно передавать большие объёмы данных.
- Удобно организовать пакетный обмен по расписанию.
Недостатки:
- нет мгновенного взаимодействия.
- Необходимо организовать контроль доставки, повторную обработку и защиту от дублирования сообщений.
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 | Вызов чужих сервисов |
| OData | HTTP, REST/OData | Стандартный доступ к объектам |
| Планы обмена | Сообщения обмена | Синхронизация баз 1С |
| Файловый обмен | XML, JSON, CSV | Пакетная передача |
| COM | COM/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:
ИмяШаблона:
То есть адрес собираем по частям из разных точек конфигурации.
Пример функции, получающей данные из двух соединенных таблиц
Функция Шаблон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}")



No comments to display
No comments to display