БИТ.ФИНАНС

Инструкция по подключению мобильного приложения БИТ.ФИНАНС


Первичная настройка мобильного приложения
Внимание! Для корректной работы приложения "БИТ.ФИНАНС" в разделе "Настройки (БИТ)"->"Константы (БИТ)" должен быть установлен флаг "Использовать механизм оповещений".
Перед непосредственной настройкой мобильного приложения проверьте настройки публикации информационной базы на сервере.
1. Зайдите в мобильное приложение
2. В мобильном приложении перейдите в раздел «Сервис»
3.1 Зайдите в «Настройки подключения»
3.2 Нажмите кнопку «+» для добавления подключения к базе данных
4. Заполните реквизиты для подключения

Портфельный менеджер
АЛЕКСАНДР ЖУРАВЛЕВ
  • Бывший руководитель департамента разработки финансовых систем в крупнейшем ИТ интеграторе
  • Более 20 выполненных проектов по внедрению ИТ решений в крупных компаниях (системы финансового и управленческого учета, мобильные приложения)
  • РосНОУ, Программист-экономист, "Информационные системы и компьютерные технологии"
4.1. «Наименование» - произвольное наименование подключения
4.2. «Сервер» - имя сервера, на котором выполнена публикация базы 1С
4.3. «Имя базы» - имя публикации на сервере
4.4. «Пользователь» - необходимо указать имя пользователя информационной базы, для которого будут получены документы для визирования и задачи. Пользователь должен быть зарегистрирован в информационной базе.
4.5. «Пароль» - пароль пользователя указанного в п.4.4 для доступа в информационную базу.
4.6. «HTTPS» - перевести в активное положение, если используется https соединение.
5. Нажмите кнопку «Действия - Сохранить»
6. В дополнительных настройках также есть возможность настраивать таймаут ожидания ответа от сервера и отключить проверку цепочки сертификатов (только в Андройд версии). Последняя опция будет полезна тем, у кого https используется с самовыпущенным сертификатом.
Подробная информация о публикации информационной базы на веб-сервере содержится на ИТС http://its.1c.ru/db/v83doc#content:19:1.
7. Обновите список в разделе «Визирование»

Ошибки при подключении
В случае если при подключении возникают ошибки, необходимо проверить публикацию информационной базы на сервере. Информация о публикации на диске 1C:ИТС

http://its.1c.ru/db/v837doc#bookmark:adm:TI000000194
Для конфигураций 1С с подсистемой БИТ.Финанс менее 3.1.40 доступна только публикация веб-сервиса «bit_ApprovalService»
Для подсистемы БИТ.ФИНАНС начиная с 3.1.40 доступна публикация через http-сервис «bit_ApprovalServiceNew». Рекомендуется использовать именно этот механизм для доступности новых функций.
Доменная авторизация мобильным приложением не поддерживается, поэтому в настройках публикации веб-сервера необходимо использовать "Анонимную проверку подлинности":
Если публикация произведена правильно, то строка подключения должна открываться в браузере с WSDL, т.е. ссылка типа:

https://demo.1cbit.online/Finans_Test_WEB/ws/bit_A... (для версии до 3.1.40)

по ссылке после логина должен открыться текстовый файл с большим набором символов (описание веб-сервиса).

https://demo.1cbit.online/Finans_Test_WEB/hs/appro...

(при использовании версии 3.1.40 и новее и публикации http-сервиса) по ссылке должна открыться пустая страница с текстом «pong».

При использовании http-сервиса необходимо перед началом работы заполнить в БИТ.ФИНАНС регистр сведений «Объекты мобильного визирования» теми объектами, которые будут проходить визирование в мобильном приложении.

В релизе БИТ.ФИНАНС 3.1.23.2 реализован режим отладки веб-сервиса.

Нужно в константах (через все функции) поставить константу «Режим отладки веб сервисов (БИТ)». В этом режиме все вызовы методов веб-сервиса регистрируются в журнале регистрации с переданными параметрами и ответами. Поэтому в случае ошибок подключения желательно обновиться на релиз 3.1.23.2 и анализировать проблему с помощью журнала регистрации. Анализ можно производить при попытке переходить по ссылке типа http://ls.1cbit.ru/Finans_Test_WEB/ws/bit_ApprovalService/?wsdl в браузере.

Подключение к веб-сервису с установленным удостоверяющим сертификатом безопасности
Мобильное приложение может подключаться по ссылке вида «https://ИмяХоста/ИмяВебСервиса» к веб-сервису, опубликованному на веб сервере с установленным удостоверяющим сертификатом безопасности.

Сертификат должен быть действительным, выданным официальным центром сертификации (например, https://www.reg.ru/ssl-certificate/) под конкретный домен, на котором доступен целевой веб сервер.

Иногда, необходимо защитить как основной домен, так и все поддомены, в этом случае поможет «Wildcard» сертификат, подробнее тут.

Проверить корректность установленного сертификата можно с помощью различных on-line сервисов, например, по этой ссылке (для проверки необходимо ввести имя хоста и нажать кнопку Check SSL).

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

Добавление новых документов для согласования
Если в информационной базе есть объекты, к которым добавлены механизмы согласования БИТ.ФИНАНС (с помощью доработок конфигурации), то данные документы также можно будет согласовывать с помощью мобильного приложения. Для этого их необходимо добавить в регистр сведений – Объекты мобильного визирования.

Push-уведомления
В мобильное приложение добавлена возможность принимать push-оповещения из информационной базы БИТ.ФИНАНС.
Настройка Push-уведомлений

Для работы push-уведомлений, необходимо в мобильном приложении БИТ.ФИНАНС, в настройке подключения к информационной базе выполнить команду «Действия - Сохранить». В этот момент происходит регистрация мобильного устройства в базе 1С.
После выполнения команды в информационной базе БИТ.ФИНАНС в справочнике «Мобильные устройства» должна появиться запись с новым устройством.
А также должна появиться новая запись в регистре сведений «Назначение точек доставки»
Далее в самой информационной базе необходимо настроить оповещения так же, как и оповещения по электронной почте.

Но в справочнике «Настройки доставки оповещений» необходимо указывать обработку доставки «Обработка доставки оповещений посредством Push уведомлений».
Также в справочнике «Шаблоны сообщений» появился новый способ транспорта «Push notification» и новый тип текста «Простой текст» для формирования push-уведомлений, для этого типа текста есть только «Заголовок» и «Текст».
Далее оповещения регистрируются и отправляются так же, как и оповещения по электронной почте.
Made on
Tilda