Интеграция СПАРК / Виджеты решения «Интеграция СПАРК» и их настройка

Виджеты решения «Интеграция СПАРК» и их настройка

В состав бизнес-решения Интеграция СПАРК входят виджеты, которые позволяют наглядно отобразить полученную информацию о компании, а также найти определённого контрагента по базе сервиса.

По умолчанию виджеты используются в разделе СПАРК > Расширенная справка по российской компании. Если информация из СПАРК запрашивается с помощью пользовательских бизнес-процессов и передаётся в другое приложение системы, виджеты можно разместить на форме этого приложения.

К виджетам решения относятся:

  • Поиск компании — используется для идентификации компании в СПАРК по одному из её реквизитов, поиску совпадений в базе и передачи остальных реквизитов в ELMA365;
  • Индексы Спарка — визуализируют индексы риска компании, полученные через бизнес-процесс в запросе расширенной справки по компании. В виджете отображается значение индекса и цветовой индикатор уровня риска;
  • Сводный индикатор риска — показывает совокупную оценку надёжности компании в виде числового показателя и его цветового обозначения. Данные содержатся в расширенной справке по компании и запрашиваются в ходе бизнес-процесса;
  • Статус компании в СПАРК — отображает полученное через бизнес-процесс юридическое положение, в котором находится компания согласно действующему законодательству, а также дату его вступления в силу.

Рассмотрим настройку виджетов и отобразим их на формах приложения Компании.

Предварительные настройки приложения для использования виджетов

Чтобы разместить виджет, необходимо сопоставить параметры в его настройках с переменными из контекста приложения, на форму которого он добавляется:

  • для виджета Поиск компании — в контексте создаются свойства, в которые в ходе работы с виджетом записывается информация из СПАРК;
  • для виджетов Индексы Спарка, Сводный индикатор риска, Статус компании в СПАРК — свойства добавляются в контекст приложения в ходе настройки пользовательского бизнес-процесса, в котором запрашивается расширенная справка по компании. В них записываются результаты обработки запроса. Затем значения передаются в виджет и визуализируются.

Необходимые для настройки свойства из контекста приложения указаны в описании каждого виджета.

Виджет «Поиск компании»

Виджет представляет собой строку поиска и используется, чтобы найти компанию по её названию или реквизитам в базе сервиса СПАРК. Полученную из сервиса информацию можно отобразить на форме приложения.

Например, виджет можно использовать для добавления новой компании. Для этого он размещается на форме создания элемента приложения. Пользователь указывает на форме один из реквизитов компании, например, ИНН. Затем компания идентифицируется в сервисе. Найденные совпадения отображаются в ELMA365. Пользователь выбирает одну из записей, и остальные реквизиты компании в её карточке заполняются автоматически.

spark-14

Настройки виджета «Поиск компании»

Для настройки виджета можно создать в контексте приложения только те переменные, значения которых нужно заполнять на форме данными из СПАРК. Они должны совпадать по типу со свойствами виджета:

  • Идентификатор в СПАРК (тип Строка);
  • Наименование компании или ФИО ИП (тип Строка);
  • Полное наименование компании (тип Строка);
  • Код ИНН (тип Строка);
  • Код ОГРН/ОГРНИП (тип Строка);
  • Адрес компании (тип Строка);
  • ФИО руководителя компании (тип Ф.И.О.);
  • Наименование региона (тип Строка);
  • Признак компании (тип Выбор «да/нет»);
  • Доменное имя или сайт (тип Ссылка);
  • Признак действующей/ликвидированной компании или ИП (тип Выбор «да/нет»).

Чтобы добавить виджет на форму приложения, откройте её в дизайнере интерфейсов. Перетащите виджет из списка в правой части дизайнера на поле для моделирования или нажмите кнопку + Виджет на боковой панели формы. В открывшемся окне выполните настройку.

spark-15

  • Поиск по СПАРК — строка поиска в виджете. Для корректной настройки оставьте поле пустым;
  • Подсказка к строке поиска — текст, отображающийся на форме под строкой поиска. Например, вы указать, по каким параметрам осуществляется поиск компании в сервисе;
  • Показать выбор типа компании — выберите Да, чтобы в виджете отображались типы: Компания, Филиал, ИП. Пользователь сможет выбрать одну из опций, чтобы сузить поиск записи в базе сервиса;
  • Настройки для сопоставления со свойствами приложения — поля виджета сопоставляются с соответствующими переменными из контекста приложения. Когда пользователь введёт в строке поиска один из параметров компании, и она идентифицируется в сервисе, в сопоставленные переменные автоматически записываются значения из СПАРК. Например, наименование компании в сервисе можно отобразить в поле Название из приложения Компании. Для сопоставления напротив поля нажмите значок chain_icon и выберите переменную из контекста приложения.

На вкладках События и Системные задаются системные настройки, одинаковые для всех виджетов.

Чтобы завершить настройку виджета нажмите кнопку Сохранить. Чтобы настроенная форма стала доступна пользователям, нажмите Сохранить и Опубликовать на верхней панели дизайнера интерфейсов.

Виджет «Индексы Спарка»

Индексы риска передаются в ELMA365 в результате запроса Расширенная справка по российской компании. Они помогают выявить благонадёжность компании. В виджете можно отобразить следующие показатели: Индекс должной осмотрительности, Индекс финансового риска, Индекс платежной дисциплины.

По умолчанию виджеты Индексы Спарка добавлены на форму просмотра приложения Расширенная справка по российской компании. Для каждого индекса виджет размещается и настраивается отдельно.

Настроенные виджеты в карточке компании выглядят следующим образом:

spark-16

Настройки виджета «Индексы Спарка»

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

Для каждого индекса на форму добавляются по два свойства с типом Строка: Описание значения индекса и Значение индекса.

Чтобы в виджете отображались показатели, поля на форме приложения должны содержать данные из СПАРК, полученные в результате запроса расширенной справки компании. Это можно сделать, например, настроив на уровне приложения пользовательский бизнес-процесс.

Рассмотрим настройку виджета на примере и отобразим на форме приложения Компании индекс должной осмотрительности.  

Чтобы добавить виджет, в дизайнере интерфейсов перетащите его из списка на боковую панель формы или нажмите кнопку + Виджет. Задайте и сохраните заголовок виджета, который будет отображаться в карточке элемента, например, Индекс должной осмотрительности. Затем выполните настройки в открывшемся окне.

spark-17

Сопоставьте параметры Описание значения индекса* и Значение индекса* с переменными из контекста приложения, в которых отображается результат запроса соответствующих данных в сервис. Для этого напротив параметра нажмите значок chain_icon и выберите свойство.

На вкладках События и Системные задаются системные настройки, одинаковые для всех виджетов.

Для завершения настройки виджета нажмите кнопку Сохранить.

Виджет «Сводный индикатор риска»

Сводный индикатор риска компании можно получить из сервиса в результате запроса Расширенная справка по российской компании и отобразить в виджете.

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

Настройки виджета «Сводный индикатор риска»

Для настройки виджета убедитесь, что в контекст приложения добавлена переменная Значение индикатора с типом Строка.

Чтобы отобразить индикатор риска в виджете, поле на форме заполняется значением из сервиса. Для этого запускается запрос на получение расширенной справки по компании, например, в ходе пользовательского бизнес-процесса.

Чтобы разместить виджет, в дизайнере интерфейсов перетащите его из списка на боковую панель формы или нажмите кнопку + Виджет. Укажите заголовок виджета, который будет отображаться в карточке элемента, и сохраните настройки.

В открывшемся окне сопоставьте параметр Значение индикатора*. Для этого нажмите значок chain_icon и выберите переменную из контекста приложения.

spark-18

На вкладках События и Системные задаются системные настройки, одинаковые для всех виджетов.

Сохраните настройки виджета.

Виджет «Статус компании в СПАРК»

Статус компании можно получить с помощью запроса в СПАРК Расширенная справка по российской компании.

По умолчанию статус отображается в элементах приложения Расширенная справка по российской компании. С помощью виджета Статус компании в СПАРК показатель можно добавить на форму любого приложения системы.

Настройки виджета «Статус компании в СПАРК»

Перед настройкой виджета убедитесь, что в контексте приложения присутствуют следующие переменные:

  • Значение статуса (тип Строка);
  • Наименование группы статусов (тип Строка);
  • Дата актуальности статуса (тип Дата/время).

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

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

spark-19

Сопоставьте параметры Наименование группы статусов, Значение статуса компании, Дата актуальности статуса с переменными из контекста приложения, в которых отображается результат запроса в сервис. Для этого напротив параметра нажмите значок chain_icon и выберите свойство.

На вкладках События и Системные задаются системные настройки, одинаковые для всех виджетов. Они позволяют управлять видимостью виджетов и доступом к ним, настраивать их поведение при наведении курсора и т. д.

Для завершения настройки виджета нажмите кнопку Сохранить.

Чтобы настроенная форма стала доступна пользователям, нажмите Сохранить и Опубликовать на верхней панели дизайнера интерфейсов.