Платформа 3V/Показатель/Показатели на стороннем API: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 4: Строка 4:
 
Методы сохранения данных и получения структуры идентичны.<br>
 
Методы сохранения данных и получения структуры идентичны.<br>
 
Примером данной реализации является контроллер '''WorkflowDataSourceView''' сервиса '''Workflow'''.
 
Примером данной реализации является контроллер '''WorkflowDataSourceView''' сервиса '''Workflow'''.
 +
 +
== Настройка показателя на стороннем API на примере Workflow (Согласования)==
 +
 +
Ниже будут описаны шаги по настройке показателя на основе объекта согласования. JSON согласования, на основе которого будет строиться показатель указан ниже.
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 +
<div style="font-weight:bold;line-height:1.6;">JSON согласования</div>
 +
<div class="mw-collapsible-content mw-collapsed-content">
 +
<syntaxhighlight lang="JSON" line>
 +
!!! JSON WORKFLOW !!!
 +
</syntaxhighlight>
 +
</div></div>
 +
 +
=== Создание соединения с источником ===
 +
 +
Создаем объект "Соединение с источником". Подробнее о том, как создать данный объект, написано в статье [[Платформа_3V/Соединение с источником|'''Соединение с источником''']]. Затем в JSON (???) необходимо добавить:
 +
 +
<syntaxhighlight lang="JSON" line>
 +
{
 +
  "dbType": "Web",
 +
  "connectionString": "http://workflow/api/WorkflowDataSourceView/"
 +
}
 +
</syntaxhighlight>
 +
 +
=== Создание справочника фактов ===
 +
 +
Создаем справочник, где будут храниться все необходимые атрибуты согласования. Подробнее о том, как создать справочник, написано в статье [[Платформа_3V/Справочник/Создание нового справочника|'''Создание нового справочника''']]. Например, вынесем в справочник "Факты_согласование" Идентификатор состояния, Статус и Комментарий:
 +
 +
!!! СКРИН СПРАВОЧНИКА !!!
 +
 +
=== Создание показателя ===
 +
 +
Создаем показатель, в котором измерениями будут являться все справочники, указанные в согласовании в качестве параметров. В данном случае в согласовании указан один параметр со справочником "Сотрудники", он и будет являться измерением показателя. Справочником фактов будет служить справочник "Факты_согласование", созданный на предыдущем шаге. В справочнике "Факты_согласование" выбираем все элементы:
 +
 +
!!! СКРИН КОНСТРУКТОРА ПОКАЗАТЕЛЯ !!!
 +
 +
Далее донастраиваем показатель в JSON:<br>
 +
1. В поле ''name'' указываем идентификатор согласования ("215").<br>
 +
2. В поле ''connectionId'' указываем идентификатор объекта "Соединение с источником", созданного на первом шаге ([[Платформа_3V/Показатели/Показатели_на_стороннем_API#Создание соединения с источником|'''Создание соединения с источником''']]) ("???").
 +
3. В поле ??? в первой колонке указан справочник измерения, который является параметром в согласовании. В поле name необходимо указать идентификатор этого параметра в согласовании ("1!!!").
 +
4. После всех измерений в поле ??? идет описание фактов (элементов справочника "Факты_согласование"). В поле name необходимо указать "???", "StateName", "???" соответственно для трех элементов справочника.
 +
 +
!!! СКРИН JSON ПОКАЗАТЕЛЯ С ОБОЗНАЧЕНИЯМИ 1-2-3-4 !!!
 +
 +
Результат:
 +
 +
!!! СКРИН САМОГО ПОКАЗАТЕЛЯ !!!

Версия 18:40, 23 марта 2021

Возможности работы с показателями во многом схожи с возможностями по работе со справочниками на стороннем API
Только для работы с показателями, при получении данных, не учитываются orderFields и limit, а фильтры всегда будут передаваться с условием Default.
Методы сохранения данных и получения структуры идентичны.
Примером данной реализации является контроллер WorkflowDataSourceView сервиса Workflow.

Настройка показателя на стороннем API на примере Workflow (Согласования)

Ниже будут описаны шаги по настройке показателя на основе объекта согласования. JSON согласования, на основе которого будет строиться показатель указан ниже.

JSON согласования
1 !!! JSON WORKFLOW !!!

Создание соединения с источником

Создаем объект "Соединение с источником". Подробнее о том, как создать данный объект, написано в статье Соединение с источником. Затем в JSON (???) необходимо добавить: 

1 {
2   "dbType": "Web",
3   "connectionString": "http://workflow/api/WorkflowDataSourceView/"
4 }

Создание справочника фактов

Создаем справочник, где будут храниться все необходимые атрибуты согласования. Подробнее о том, как создать справочник, написано в статье Создание нового справочника. Например, вынесем в справочник "Факты_согласование" Идентификатор состояния, Статус и Комментарий:

!!! СКРИН СПРАВОЧНИКА !!!

Создание показателя

Создаем показатель, в котором измерениями будут являться все справочники, указанные в согласовании в качестве параметров. В данном случае в согласовании указан один параметр со справочником "Сотрудники", он и будет являться измерением показателя. Справочником фактов будет служить справочник "Факты_согласование", созданный на предыдущем шаге. В справочнике "Факты_согласование" выбираем все элементы:

!!! СКРИН КОНСТРУКТОРА ПОКАЗАТЕЛЯ !!!

Далее донастраиваем показатель в JSON:
1. В поле name указываем идентификатор согласования ("215").
2. В поле connectionId указываем идентификатор объекта "Соединение с источником", созданного на первом шаге (Создание соединения с источником) ("???"). 3. В поле ??? в первой колонке указан справочник измерения, который является параметром в согласовании. В поле name необходимо указать идентификатор этого параметра в согласовании ("1!!!"). 4. После всех измерений в поле ??? идет описание фактов (элементов справочника "Факты_согласование"). В поле name необходимо указать "???", "StateName", "???" соответственно для трех элементов справочника.

!!! СКРИН JSON ПОКАЗАТЕЛЯ С ОБОЗНАЧЕНИЯМИ 1-2-3-4 !!!

Результат:

!!! СКРИН САМОГО ПОКАЗАТЕЛЯ !!!

Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Показатель/Показатели_на_стороннем_API&oldid=700