Элемент управления "Обменный курс"

Данный раздел содержит описание примера реализации элемента управления ExchangeRates. Проект-расширение клиентской части Web-клиента. Содержит клиентский скрипт и стили для SampleExchangeRates.

Ссылка на пример на GitHub: ExchangeRates.

Пример рассчитан на версию Web-клиента 6.1 или выше.

Перечень необходимых инструментов:

Сборка и установка

  1. Откройте /Samples.sln.

  2. Откройте консоль в папке Controls > ExchangeRates > ExchangeRatesWebExtension и выполните команду npm install и npm run build:prod.

  3. Скопируйте каталог SamplesOutput\Plugins\SampleExchangeRatesDesignerExtension в каталог Путь к директории с исполняемым файлом конструктора Web-разметок\Plugins.

  4. Скопируйте каталог SamplesOutput\Content\Modules\ExchangeRatesWebExtension в каталог Путь к сайту Web-клиента\Content\Modules.

  5. Перезапустите dvwebclient.

Проверка примера

  1. Запустите конструктор разметок.

  2. Импортируйте решение из файла SampleExchangeRatesControlDescriptionLayout.xml.

  3. Сделайте решение SampleExchangeRatesControlDescriptionLayout активным для карточки типа Документ вида ДокументУД/Исходящий.

  4. Откройте разметку SampleExchangeRatesControlDescriptionLayout

  5. Зарегистрируйте бесплатный аккаунт на сайте fixer.io.

  6. Перейдите по ссылке https://fixer.io/quickstart и скопировать ключ доступа к API.

  7. Задайте параметру Ключ доступа к API элемента управления ExchangeRates значение вашего ключа из шага выше.

  8. Задайте остальные желаемые параметры элемента управления.

  9. Сохраните разметку.

  10. Перезапустите dvwebclient.

  11. Откройте карточку с этой разметкой.

  12. Убедитесь, что появился новый элемент управления.

Описание ЭУ "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 задаёт значение поля по умолчанию.