Документация к модулю:
Активити: Курсы и конверсия валют НБРБ

Ссылка на установку модуля: Битрикс24 Маркет

3. Активити приложения
3.1. Конверсия по курсу НБРБ
3.1.1. переменные
3.1.2. результат
3.2. Получение курса НБРБ
3.2.1. переменные
3.2.2. результат

4. Кейсы
4.1. Отправляем ежедневно курсы валют в живую ленту

1. Настройка роботов в Битрикс24

Документация по роботам в Битрикс24

2. Особенности роботов приложения:

Внимание! Результат работы робота доступен не сразу, а через время.

Чтобы использовать результат работы в вашей бизнес логике, следующий робот должен запускаться последовательно, после окончания работы предыдущего.

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

Приложение вернет ошибку, только в случае невозможности обработки запроса (например, неверный код валюты) и вернет результат данной ошибки вашему процессу с учетом особенностей в абзаце выше.

* Подобная логика стандартна для бизнес процессов (ожидание результата N минут), но не "интуитивно понятна" в интерфейсе настройки роботов.

3. Активити приложения:

3.1. [Активити: Курсы и конверсия валют НБРБ] Конверсия по курсу НБРБ

3.1.1. Доступные переменные:

Сумма:
Указывается сумма для конвертации (будут вырезаны все символы кроме 0-9 и точки)
Например, для типа поля деньги: 100.99|RUB -> 100.99
Значение по умолчанию: 0

Код валюты суммы:
Указывается символьный код валюты НБРБ (будут вырезаны все символы кроме A-z и приведена в верхний регистр)
Например, для типа поля деньги: 100.99|RUB -> RUB
Значение по умолчанию: BYN

Код валюты расчета:
Валюта в которую необходимо сконвертировать сумму выше
Значение по умолчанию: BYN

Дата установки курса:
Дата в формате ISO 8601 (в случае другого неизвестного формата будет произведена попытка конвертации даты с помощью strtotime), если в данное поле передать UnixTime - она также будет обработана корректно
Значение по умолчанию: сегодняшний день

3.1.2. Результат обработки:

Значение расчета (4 знака):
Результат конверсии с округлением до 4 знаков

Значение расчета (2 знака):
Результат конверсии с округлением до 2 знаков

Значение расчета (до целых):
Результат конверсии с округлением до целого числа

Текст ошибки:
Приложение запишет ошибку конверсии, в данную переменную

Таймаут операции:
Системная переменная, приложение не устанавливает ее

3.2. [Активити: Курсы и конверсия валют НБРБ] Получение курса НБРБ

3.2.1. Доступные переменные:

Код валюты:
Указывается символьный код валюты НБРБ курс которой следует получить (будут вырезаны все символы кроме A-z и приведена в верхний регистр)
Например, для типа поля деньги: 100.99|RUB -> RUB
Значение по умолчанию: BYN

N (Amount, количество):
Если курс необходимо получить за N денежных знаков, то следует указать данное количество
Значение по умолчанию: Как в НБРБ (для РФ рубля [RUB] -> 100)

3.2.2. Результат обработки:

Курс НБРБ: Курс валюты НБРБ с учетом N (Amount, количество).
см. описание параметра N (Amount, количество)

Курс НБРБ за 1 единицу: Курс валюты НБРБ за количество 1.

N (Amount, количество): Количество денежных знаков за которое установлен курс.
см. описание параметра N (Amount, количество)

Текст ошибки:
Приложение запишет ошибку получения курса, в данную переменную

Таймаут операции:
Системная переменная, приложение не устанавливает ее

4. Кейсы:

4.1. Отправляем ежедневно курсы валют в живую ленту

* Выдуманный кейс для показа возможностей активити!

* Для просмотра информации о курсах можно использовать приложение - Курсы валют НБ РБ.
После установки приложения, добавьте ссылку в меню согласно документации.

Роботы в задачах доступны не на всех тарифах Битрикс24!

Количество роботов также может ограничиваться согласно тарифа.

4.1.1. Создаем переодическую задачу

Название задачи: Отправить курсы валют

Периодичность: каждый день

4.1.2. Создаем роботов для получения курсов

Условие: Название равно Отправить курсы валют

Код валюты: USD

Дата установки курса: {{Дата создания}}

4.1.3. Создаем роботов для остальных валют (устанавливаем условие работы после предыдущего)

4.1.4. Создаем робота Сообщение в живую ленту

Условие: Курс НБРБ больше 0

Тема: Курсы валют на {{Дата создания}}

Текст сообщения:
1 Долар США: Выбираем переменную cursValue у робота 1
1 Евро: Выбираем переменную cursValue у робота 2
100 Российских Рублей: Выбираем переменную cursValue у робота 3

4.1.5. Создаем робота Уведомление

Отправим ошибку, если курс не получен

Условие: Курс НБРБ не больше 0

Текст сообщения: Ошибка получения курсов в живую ленту

* можно добавить переменную с текстом ошибки (может быть заполнен)

4.1.6. Создаем робота Сменить статус

Статус: завершена

Документация к модулю: Активити: Курсы и конверсия валют НБРБ