Установка и настройка

Для установки и настройки расширения "Бром" необходимо проделать несколько несложных операций.

1. Получение файла расширения

Расширение "Бром" может быть загружено с официалного сайта  http://brom.itworks.group. В разделе "Скачать" можно загрузить как последнюю версию расширения, так и предшествующие версии расширений.

2. Установка расширения

Загруженный файл формата "cfe" может быть установлен в конфигурацию как из пользовательского режима, так и через конфигуратор.

Для установки расширения из пользовательского режима:

  1. Запустите приложение в пользовательском режиме. Пользователь, от имени которого осуществляется вход, должен быть администратором, а именно - должен иметь права: "Режим "Все функции"" и "Администрирование расширений конфигурации";
  2. Откройте форму управления расширениями (Главное меню -> Все функции -> Стандартные -> Управление расширеними конфигурации);
  3. Добавьте расширение "Бром" в список расширений, установив его из загруженного ранее файла.
  4. Перезапустите приложение.

Для установки расширения из конфигуратора:

  1. Запустите приложение в режиме конфигуратора. Пользователь, от имени которого осуществляетс вход, должен иметь право "Администрирование расширений конфигурации";
  2. Откройте форму управления расширениями конфигурации (Конфигурация -> Расширения конфигурации);
  3. Добавьте расширение "Бром" в список расширений, установив его из загруженного ранее файла.

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

  1. В режиме конфигуратора перейдите в раздел "Администрирование -> Публикация на веб-сервере";
  2. Укажите наименование публикации а также установите флажки "Публиковать web-сервисы" и "Публиковать web-сервисы расширений по умолчанию";
  3. Опубликуйте базу данных.

После публикации веб-сервис и wsdl-файл с описанием сервиса будут доступны по следующим адресам:

http://{адрес_сервера}/{имя_публикации}/ws/brom_api

http://{адрес_сервера}/{имя_публикации}/ws/brom_api?wsdl 

4. Настройки доступа

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

В типовых конфигурациях 1С предусмотрена возможность установки ролей досутпа из пользовательского режима. Если используемая конфигурация не позволяет устанавливать роли доступа в пользовательском режиме, то вы можете воспользоваться внешней обработкой "brom_УстановкаРолейПользователей.epf", которая доступна на официальном сайте.

Доступные в расширении "Бром" роли доступа подробно описины в разделе "Роли доступа".

Если расширение будет использоваться для удаленного вызова методов, то необходимо указать области видимости методов. Области видимости методов могут быть заданы непосредственно в расширении (общий модуль "brom_Настройки" метод "ОбластьДотупаУдаленныхВызовов"). Имена областей задаются по следующим правилам:

Пример Описание
* Любой метод глобального контекста.
{ИмяМетода} Конкретный метод глобального контекста.
*.* Любой метод любого общего модуля.
{ИмяМодуля}.* Любой метод конкретного общего модуля.
*.{ИмяМетода} Конкретный метод любого общего модуля.
*.*.* Любой метод любой коллекции любого типа.
{ИмяТипа}.*.* Любой метод любой коллекции конкретного типа. Например только "Справочники".
{ИмяТипа}.*.{ИмяМетода} Конкретный метод из любой коллекции определенного типа.

5. Проверка доступности веб-сервиса

Для проверки доступности опубликованного веб-сервиса: 

  1. Откройте браузер и перейдите по адресу: http://localhost/{имя_публикации}/ws/brom_api?wsdl
    где, {имя_публикации} - наименование публикации, указанное в п. 3;
  2. В появившемся окне авторизации укажите имя пользователя и пароль, установленные в п. 4;
  3. Если веб-сервис опубликован корректно, Вы увидите содержимое WSDL-файла с описанием сервиса. Возрадуйтесь!