Справка 1С/Клиентское приложение/Публикация на веб-сервере

Публикация на веб-сервере

Публикация на веб-сервере

Задача публикации сводится к размещению файла публикации в соответствующем каталоге.

Для того, чтобы выполнить публикацию, следует выполнить команду меню "Администрирование - Публикация на веб-сервере...". 

В результате выполнения этой команды будет открыто окно, в котором осуществляется публикация информационной базы на локальном компьютере.

Внимание! Выполнение операции требует наличия прав администратора (для ОС Windows) или прав суперпользователя (для ОС Linux) на компьютере, на котором выполняется публикация.

  • Основные настройки [#main]
  • Настройки использования OpenID-аутентификации [#openid]
  • Публикация Web- и HTTP-сервисов [#services]
  • Прочие настройки [#other]
  • Использование утилиты webinst [#webinst]

Основные настройки публикации

На закладке "Основные" отображаются данные, необходимые для выполнения публикации.

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

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

Имя публикации должно соответствовать правилам URL (стандарт RFC 1738). 
Если выбран веб-сервер Apache 2.2 или Apache 2.4, то для имени каталога следует использовать US ASCII символы.

Примечание. При использовании веб-сервера Apache в диалоге настройки доступны для выбора обе версии веб-сервера. Следует учитывать, что настройки публикации для Apache 2.2 и Apache 2.4 несовместимы между собой. Поэтому необходимо правильно выбрать версию веб-сервера в диалоге.

Укажите необходимость публикации доступа для клиентских приложений (тонкого клиента, веб-клиента и мобильного клиента), а также Web- и HTTP-сервисов. 

Если флажок "Публиковать доступ для клиентских приложений" установлен, будет возможна работа с опубликованной информационной базой с помощью тонкого, мобильного и веб-клиентов.

Если флажок "Публиковать стандартный интерфейс ODATA" установлен, будет опубликован сервис ODATA, который позволяет считывать и изменять данные информационной базы с помощью HTTP-запросов.

Если флажок "Публиковать систему аналитики" установлен, то вместе с файлом публикации информационной базы будет опубликован HTTP-сервис системы аналитики. Для работы сервиса требуется предварительно установить сервер "1С:Аналитика". Для доступа к сервису пользователь должен обладать правом "Клиент системы аналитики".

Публикация Web-сервисов

На закладке "Web-сервисы" установите флажок "Публиковать Web-сервисы" и в таблице сформируйте список путем установки проставления флажков для тех Web-сервисов, которые нужно опубликовать.

Если флажок "Публиковать Web-сервисы по умолчанию" установлен, то при обновлении публикации выбранные web-сервисы будут опубликованы автоматически. В противном случае, web-сервисы будут отмечены как не публикуемые.

Если флажок "Публиковать Web-сервисы расширений по умолчанию" установлен, то при обновлении публикации web-сервисы, добавленные расширениями, будут опубликованы автоматически.

Публикация HTTP-сервисов

На закладке "HTTP-сервисы" в таблице сформируйте список путем проставления флажков для тех HTTP-сервисов, которые нужно опубликовать.

Если флажок "Публиковать HTTP-сервисы по умолчанию" установлен, то при обновлении публикации выбранные HTTP-сервисы будут опубликованы автоматически. В противном случае, HTTP-сервисы будут отмечены как не публикуемые.

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

Чтобы предоставить возможность установить тонкий клиент в случае, если версии тонкого клиента и сервера не совпадают, установите флажок "Публиковать дистрибутив тонкого клиента" и в списке "Расположение публикуемого дистрибутива" выберите полное имя zip-архива, который будет использоваться в качестве дистрибутива для выбранной операционной системы:

  • Windows x64 - для 64-разрядного клиента "1С:Предприятие" под управлением Windows,
  • Windows x32 - для 32-разрядного клиента "1С:Предприятие" под управлением Windows,
  • Linux (DEB) x64 - для 64-разрядного клиента "1С:Предприятие" под управлением DEB-системы,
  • Linux (DEB) x32 - для 32-разрядного клиента "1С:Предприятие" под управлением DEB-системы, 
  • Linux (RPM) x64 - для 64-разрядного клиента "1С:Предприятие" под управлением RPM-системы,
  • Linux (RPM) x32 - для 64-разрядного клиента "1С:Предприятие" под управлением RPM-системы,
  • MacOS x64 - для 64-разрядного клиента "1С:Предприятие" под управлением macOS.
  • Установите флажок "Использовать аутентификацию операционной системы на веб-сервере", если предполагается доступ к клиенту с использованием аутентификации операционной системы. Флажок виден только в том случае, если выбран веб-сервер "Internet Information Services".

    Если при окончании работы веб-клиента требуется выполнить переход по заданному адресу, укажите URL-адрес в поле "Адрес перехода при окончании работы веб-клиента".

    В поле "Наименование прогрессивного веб-приложения" можно задать наименование, которое будет использовано:

  • для отображения в окне установки/удаления прогрессивного веб-приложения,
  • в главном меню прогрессивного веб-приложения,
  • в названии иконки программы:
  • для Windows - в меню Пуск и на Рабочем столе;
  • для Linux и macOS - в панели Dock.

Настройки использования OpenID-аутентификации

На закладке "OpenID" редактируются настройки:

Использовать OpenID-аутентификацию – указывает, используются ли OpenID.

Адрес OpenID-провайдера – соответствует атрибуту url элемента .

Использовать в качестве OpenID-провайдера – указывает, является ли база провайдером OpenID.

Время жизни аутентификации – соответствует элементу , подчиненному элементу .

Разрешенные адреса для переадресации - соответствует набору элементов , подчиненных элементу . Доступно, если публикация на веб-сервере используется в качестве OpenID-провайдера.

Прочие настройки публикации

На закладке "Прочие" отображаются данные, хранящиеся в vrd-файле, не отображаемые в основной части диалога.

Каталог временных файлов – соответствует атрибуту temp.

Настройки пула соединений

Размер пула – соответствует атрибуту size элемента .

Время жизни соединения в пуле – соответствует атрибуту maxAge элемента .

Настройки соединения с сервером "1С:Предприятия"

Число попыток соединений – соответствует атрибуту attempts элемента .

Время ожидания соединения – соответствует атрибуту attemptTimeout элемента .

Время ожидания между попытками соединения – соответствует waitTimeout элемента .

Таймаут проверки – соответствует атрибуту serverPingTimeout элемента . Устанавливает период отправки пакетов в миллисекундах.

Период проверки – соответствует атрибуту serverPingPeriod элемента . Устанавливает время, в течение которого ожидается хотя бы один ответный пакет, чтобы данное направление соединения считалось доступным.

Настройки отладки

Отладка – соответствует атрибуту enable элемента .  В этом параметре можно выбрать используемый протокол для отладки:

Отладка по протоколу HTTP - соответствует значению "http" атрибута protocol элемента .

Адрес сервера отладки HTTP – соответствует атрибуту url элемента . Если адрес сервера отладки не указан, будет предложено использовать адрес текущего сервера отладки. 

Отладка по протоколу TCP/IP- соответствует значению "tcp/ip" атрибута protocol элемента .

Адрес отладчика – соответствует атрибуту url элемента

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

Табличное поле настройки зон по разделителям Разделение данных – соответствует элементу . Содержит все разделители конфигурации.

Колонка Использование – флажок, указывает используется ли разделитель в публикации. Так как зоны vrd-файла не имеют имен, связываются с разделителями согласно порядку указания, флажки в колонки могут быть установлены только начиная с 1-го разделителя.

Колонка Имя – имя разделителя.

Колонка Значение разделителя задано – указывает, используется ли значение разделителя.

Колонка Значение – значение разделителя (может быть пустым) соответствует атрибуту value элемента .

Колонка Указание – соответствует атрибуту specify элемента .

Колонка Безопасное – соответствует атрибуту safe элемента

Фоновые задания в файловом варианте - соответствует атрибуту pointEnableCommon элемента :

Значение Разрешить соответствует значению атрибута по умолчанию.

Значение Запретить соответствует значению off.

Значение Принудительно соответствует значению force.

Для публикации нажмите кнопку "Опубликовать". 
При нажатии кнопки "Отключить" выполняется удаление файла публикации. При этом выдается запрос на удаление каталога. 

При нажатии кнопки "Загрузить" выполняется чтение указанного vrd-файла. Перед чтением показывает диалог выбора файла.

При нажатии кнопки "Сохранить" выполняется сохранение vrd-файла по указанному пути.

Использование утилиты webinst

Для публикации на удаленном компьютере можно также использовать утилиту webinst. Данная утилита должна запускаться из каталога двоичных файлов платформы (для ее запуска требуется наличие динамических библиотек, входящих в состав платформы):

Публикация:

webinst [-publish] websrv -wsdir VirtualDir -dir Dir -connstr connStr -confPath confPath

Удаление публикации:

webinst -delete websrv -wsdir VirtualDir -dir Dir [-confPath confPath]

-publish – опубликовать (ключ по умолчанию);

-delete – удалить публикацию;

websrv – тип веб-сервера. Может принимать следующие значения: 

  • iis – публикация веб-клиента для IIS;
  • apache2 – публикация веб-клиента для Apache 2.0;
  • apache22 – публикация веб-клиента для Apache 2.2;

-wsdir VirtualDir – виртуальный каталог;

-dir Dir – физический каталог, в который будет отображен виртуальный каталог;

-connstr connStr – строка соединения информационной базы [v8help://SyntaxHelperLanguage/ConnectionString];

-confPath confPath – полный путь к конфигурационному файлу Apache (только для  публикации на Apache);

-osauth – использование Windows авторизации (только для IIS);

–descriptor <путь к vrd файлу> – указывает новый файл-дескриптор публикации. При публикации существующий vrd файл полностью переписывается указанным. Если в вызове утилиты указаны также ключи –wsdir и/или –connstr, их значения перекрывают значения полей vrd-файла base и ib соответственно. Если указан ключ –delete, ключ –descriptor используется для получения имени публикации (поле base vrd-файла) и проверки строки соединения (проверка, что по этому имени опубликована требуемая база). Должен использоваться именно файл-дескриптор публикации.

При создании или обновлении публикации предлагается перезагрузка веб-сервера в следующих ситуациях:


Изменилась версия 1С:Предприятия;


Изменился путь каталога установки 1С:Предприятия;


Создана новая публикация на Apache.

Если не удалось найти каталог установки Apache, то выдается диалог с просьбой указать каталог установки.

При публикации на веб-сервере файловой информационной базы при использовании анонимной аутентификации выполняется проверка наличия прав на каталог базы данных у пользователя, выступающего в роли anonimous. Если прав недостаточно, то выдается предупреждение о невозможности работы с этой информационной базой через веб-сервер. Рекомендуется или дать права или установить флажок "Использовать аутентификацию операционной системы на веб-сервере".

При публикации из конфигуратора, или при помощи утилиты webinst под веб-сервер IIS 7 дополнительно проверяется, чтобы каталог публикации не совпадал с %SystemDrive%\Inetpub\wwwroot. Если совпадает, выдается ошибка.

При самой первой публикации на веб-сервере базы из конфигуратора, в случае, если публикация с заданным именем уже существует, выдается предупреждение: "Существует публикация с именем XXXX, которая, возможно, была выполнена другими средствами. Заменить существующую публикацию? Да/Нет".