Элемент управления "Обменный курс"
Данный раздел содержит описание примера реализации элемента управления ExchangeRates. Проект-расширение клиентской части Web-клиента. Содержит клиентский скрипт и стили для SampleExchangeRates.
Ссылка на пример на GitHub: ExchangeRates.
Пример рассчитан на версию Web-клиента dv6 или выше.
-
Microsoft Visual Studio 2022.
Сборка и установка
-
Откройте
/Samples.sln. -
Откройте консоль в папке
Controls > ExchangeRates > ExchangeRatesWebExtensionи выполните командуnpm installиnpm run build:prod. -
Скопируйте каталог
SamplesOutput\Plugins\SampleExchangeRatesDesignerExtensionв каталогПуть к директории с исполняемым файлом конструктора Web-разметок\Plugins. -
Скопируйте каталог
SamplesOutput\Content\Modules\ExchangeRatesWebExtensionв каталогПуть к сайту Web-клиента\Content\Modules. -
Перезапустите dvwebclient для Linux и Docsvision Web-client для Windows.
Проверка примера
-
Запустите конструктор разметок.
-
Импортируйте решение из файла
SampleExchangeRatesControlDescriptionLayout.xml. -
Сделайте решение
SampleExchangeRatesControlDescriptionLayoutактивным для карточки типа Документ вида ДокументУД/Исходящий. -
Откройте разметку
SampleExchangeRatesControlDescriptionLayout -
Зарегистрируйте бесплатный аккаунт на сайте fixer.io.
-
Перейдите по ссылке https://fixer.io/quickstart и скопировать ключ доступа к API.
-
Задайте параметру
Ключ доступа к APIэлемента управленияExchangeRatesзначение вашего ключа из шага выше. -
Задайте остальные желаемые параметры элемента управления.
-
Сохраните разметку.
-
Перезапустите dvwebclient для Linux и Docsvision Web-client для Windows.
-
Откройте карточку с этой разметкой.
-
Убедитесь, что появился новый элемент управления.
Описание ЭУ "SampleExchangeRatesControlDescription.xml"
Демонстрирует добавление нового ЭУ без написания расширения для конструктора разметок. Для этого необходимо описать ЭУ в xml-файле, используя уже подключенные к конструктору свойства и ресурсы.
<?xml version="1.0" encoding="utf-8" ?>
<Controls>
<Control Name="SampleExchangeRates" ControlGroupResourceKey="ControlGroup_Samples" DisplayName="Sample exchange rates">
<Properties> (1)
<Property Type="Name" />
<Property Type="Visibility" />
<Property Type="StandardCssClass" DefaultValue="sample-exchange-rates" /> (2)
<Property Type="CustomCssClasses" />
</Properties>
</Control>
</Controls>
| 1 | Содержит перечисление свойств ЭУ. |
| 2 | DefaultValue задаёт значение поля по умолчанию. |