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

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

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-файла с описанием сервиса. Возрадуйтесь!