Платформа 3V/Формы/Выражения: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 6: Строка 6:
 
   ...
 
   ...
 
   "expressions": [
 
   "expressions": [
      "id": 1,
+
    {
      "expression": "...",
+
      "id": 1,
      "returnFirstParameterValue": false,
+
      "expression": "...",
      "parameters": [
+
      "returnFirstParameterValue": false,
      ....
+
      "parameters": [
      ],
+
        ...
      "comment": null
+
        ],
   ],
+
      "comment": null
 +
    }
 +
   ]
 
   ...
 
   ...
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
== Описание свойств выражений ==
+
=== Описание свойств выражений ===
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Строка 34: Строка 36:
 
|}
 
|}
  
== Виды параметров выражения ==
+
==Параметры выражения==
 +
 
 +
Операнды или параметры выражения (блок parameters), используемые в расчете выражения указываются в квадратных скобках: [1]
 +
 
 +
=== Пример выражения с параметром ===
 +
<syntaxhighlight lang="JSON" line>
 +
{
 +
  "id": 1,
 +
  "expression": "if([1]>0, true, false)",
 +
  "returnFirstParameterValue": false,
 +
  "parameters": [
 +
      {
 +
        "uiSourceId": 123,
 +
        "id": 1,
 +
        "discriminator": "EntryExpressionUiSourceParameterDto"
 +
      }
 +
  ],
 +
    "comment": null
 +
}
 +
</syntaxhighlight>
 +
 
 +
=== Описание базовых свойств параметров ===
 +
{| class="wikitable"
 +
|-
 +
! Свойство !! Описание
 +
|-
 +
| id || Идентификатор параметра
 +
|-
 +
| allowMultipleValues|| Флаг об получении результата в виде коллекции значений (true/false)
 +
|-
 +
| discriminator|| Вид параметра (см.таблицу ниже)
 +
|}
 +
 
 +
=== Виды параметров выражения ===
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-

Версия 10:52, 8 апреля 2021

Расчеты в серверной карточке, выполняемые на основании источников и элементов управления серверной карточки, объектов репозитория и прочего описываются в блоке expressions Расчеты могут происходить по вызову действий, могут быть связанны с определенными элементами управления карточки, а также использоваться для фильтраций внутри карточки

 1 {
 2   ...
 3   "expressions": [
 4      { 
 5        "id": 1,
 6        "expression": "...",
 7        "returnFirstParameterValue": false,
 8        "parameters": [
 9         ...
10         ],
11        "comment": null
12      }
13   ]
14   ...
15 }

Описание свойств выражений

Свойство Описание
id Идентификатор выражения
expression Расчетное выражение, формируемое с помощью определенного синтаксиса (может иметь пустое значение: "expression": null)
returnFirstParameterValue Флаг получения в выражении отметки первого параметра в блоке "parameters" без учета самого выражения, написанного в "expression"
parameters Перечень параметров (операндов), используемых для расчета выражения. Возможные типы параметров см.ниже
comment Комментарий для описания выполняемого выражения

Параметры выражения

Операнды или параметры выражения (блок parameters), используемые в расчете выражения указываются в квадратных скобках: [1]

Пример выражения с параметром

 1 {
 2    "id": 1,
 3    "expression": "if([1]>0, true, false)",
 4    "returnFirstParameterValue": false,
 5    "parameters": [
 6        {
 7         "uiSourceId": 123,
 8         "id": 1,
 9         "discriminator": "EntryExpressionUiSourceParameterDto"
10        }
11    ],
12     "comment": null
13 }

Описание базовых свойств параметров

Свойство Описание
id Идентификатор параметра
allowMultipleValues Флаг об получении результата в виде коллекции значений (true/false)
discriminator Вид параметра (см.таблицу ниже)

Виды параметров выражения

discriminator Описание
EntryExpressionUiSourceParameterDto Значение элемента управления серверной карточки
EntryExpressionDictionarySourceParameterDto Элементы источника - справочника серверной карточки
EntryExpressionConstantParameterDto Постоянное значение (единичное или коллекция значений)
EntryExpressionByDictionaryRequestDto Коллекция элементов справочника - объекта репозитория, выбранная из некоторого атрибута справочника по заданному фильтру. Справочник может не являться источником серверной карточки
EntryExpressionByExpressionDto Значение другого выражения
EntryExpressionConditionParameterDto Значение выражения при выполнении определенных условий
EntryExpressionCardParameterDto Значение параметра серверной карточки
EntryExpressionDictionaryElementCountParameterDto Количество элементов справочника - источника формы, с учетом заданных фильтров
EntryExpressionDictionaryElementCountByDictionaryRequestParameterDto Количество элементов справочника - объекта репозитория, с учетом заданных фильтров
EntryExpressionPivotCheckedParameterDto Коллекция элементов справочника, которые выбраны флагом (чекбоксами) в отчете - источнике карточки
EntryExpressionPivotParamParameterDto Значение указанного параметра отчета - источника формы
EntryExpressionPivotFocusedCellDictionarySelectionDto Значение атрибута справочника, по отмеченной пользователем ячейке отчета
EntryExpressionPivotFocusedCellColumnValueDto Значение ячейки отчета по заданной отметке столбца и выбранной строке
EntryExpressionBusinessLogicApiScalarDto Значение, которое указанный метод API возвращает в качестве результата вычисления
EntryExpressionCalendarByDateDto Коллекция элементов календарного справочника, определенная на основании заданной даты и уровня календаря, по которому необходимо найти вхождение
EntryExpressionCurrentDateDto Значение текущей даты с учетом уровня календаря, до которого необходимо произвести округление (год, полугодие, квартал и прочее)
EntryExpressionFormatDateParameterDto Форматированное значение даты, которое приходит в качестве результата вычисления другого выражения
EntryExpressionDictionaryDataFilterByIndicatorParameterDto Коллекция элементов справочника, отфильтрованных с помощью показателя
EntryExpressionJsonQueryParameterDto Значение выражения, значение которого получается путем запроса JsonPath к указанному JSON-источнику
EntryExpressionGetDictionaryJsonModelParameterDto Значение атрибутов элемента справочника - объекта репозитория в формате JSON
EntryExpressionTokenAttributeParameterDto Значение атрибута токена пользователя