Платформа 3V/Отчет/4. Настроить параметры/Задать формат параметра: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
(Новая страница: «{{DISPLAYTITLE:Форматы параметров}} == Параметр в отчете может иметь следующие типы данных: == #Ст...»)
 
Строка 1: Строка 1:
 
{{DISPLAYTITLE:Форматы параметров}}
 
{{DISPLAYTITLE:Форматы параметров}}
  
−
== Параметр в отчете может иметь следующие типы данных: ==
+
== Изменение формата вывода параметра ==
−
#Строка
+
Стандартный формат отображения параметра можно изменить, задав необходимые настройки.
−
#Справочник
+
== Изменение формата параметра 'дата' ==
−
#Целое число
+
Стандартно дата в параметре выводится в виде DD.MM.YYYY. В таком случае структура параметра выглядит следующим образом:
−
#Вещественное число
+
{| class="wikitable"
−
#Дата
+
|-
−
#Логический флаг
+
! "parameters": [...]
−
#Длинный текст
+
|-
−
#Json
+
| <syntaxhighlight lang="JSON" line>
−
#Guid
+
    {
−
#Длинное целое число
+
      "dataType": "DateTime",
−
#Файл
+
      "discriminator": "TypedValueParameterDto",
 +
      "defaultValue": null,
 +
      "value": null,
 +
      "isMultiselect": false,
 +
      "isEmptyValuePossible": true,
 +
      "isDisableable": false,
 +
      "isDisabled": false,
 +
      "id": 1,
 +
      "name": "Дата"
 +
    }
 +
</syntaxhighlight>
 +
|}
  
−
== Строка ==
+
Для добавления времени к дате, то есть отображения даты в формате DD.MM.YYYY hh:mm:ss, необходимо определить формат в "dataControlOptions".
−
Параметр со строчным типом данных предполагает ручной ввод данных в параметр для поиска в отчете.
+
{| class="wikitable"
−
Для его создания необходимо создать новый параметр на вкладке "Параметры" в отчете и выбрать тип – «Строка».
+
|-
−
[[Файл:Строка параметр.png|мини|слева]]<div style="clear:both;"></div>
+
! "dataControlOptions": [...]
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
      {
 +
        "format": "DD.MM.yyyy HH.mm.ss",
 +
        "mask": null,
 +
        "min": null,
 +
        "max": null,
 +
        "component": null
 +
      }
 +
</syntaxhighlight>
 +
|}
  
−
Для того, чтобы параметр работал, необходимо связать его с фильтруемыми данными. Для этого на вкладке «Области» нужно выбрать ту, которая будет связана с созданным параметром, далее перейти на вкладку «Фильтр» и добавить новый фильтр. В качестве атрибута выбрать тот атрибут справочника, который будет фильтроваться, этот атрибут должен содержать данные, введенные в параметр, следовательно, в качестве условия выбрать ‘Содержит’, тип – ‘Параметр’ и далее выбрать из списка созданный параметр.
+
В таком случае блок параметра будет выглядеть следующим образом:
−
[[Файл:Связь с параметром.png|мини|слева]]
+
{| class="wikitable"
 +
|-
 +
! "parameters": [...]
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
    {
 +
      "dataType": "DateTime",
 +
      "discriminator": "TypedValueParameterDto",
 +
      "defaultValue": null,
 +
      "value": null,
 +
      "isMultiselect": false,
 +
      "isEmptyValuePossible": true,
 +
      "isDisableable": false,
 +
      "isDisabled": false,
 +
      "dataControlOptions":{
 +
        "format": "DD.MM.yyyy HH.mm.ss",
 +
        "mask": null,
 +
        "min": null,
 +
        "max": null,
 +
        "component": null
 +
      },
 +
      "id": 1,
 +
      "name": "Дата"
 +
    }
 +
</syntaxhighlight>
 +
|}

Версия 10:00, 16 февраля 2022


Изменение формата вывода параметра

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

Изменение формата параметра 'дата'

Стандартно дата в параметре выводится в виде DD.MM.YYYY. В таком случае структура параметра выглядит следующим образом:

"parameters": [...] 
 1     {
 2       "dataType": "DateTime",
 3       "discriminator": "TypedValueParameterDto",
 4       "defaultValue": null,
 5       "value": null,
 6       "isMultiselect": false,
 7       "isEmptyValuePossible": true,
 8       "isDisableable": false,
 9       "isDisabled": false,
10       "id": 1,
11       "name": "Дата"
12     }

Для добавления времени к дате, то есть отображения даты в формате DD.MM.YYYY hh:mm:ss, необходимо определить формат в "dataControlOptions".

"dataControlOptions": [...] 
1       {
2         "format": "DD.MM.yyyy HH.mm.ss",
3         "mask": null,
4         "min": null,
5         "max": null,
6         "component": null
7       }

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

"parameters": [...] 
 1     {
 2       "dataType": "DateTime",
 3       "discriminator": "TypedValueParameterDto",
 4       "defaultValue": null,
 5       "value": null,
 6       "isMultiselect": false,
 7       "isEmptyValuePossible": true,
 8       "isDisableable": false,
 9       "isDisabled": false,
10       "dataControlOptions":{
11         "format": "DD.MM.yyyy HH.mm.ss",
12         "mask": null,
13         "min": null,
14         "max": null,
15         "component": null
16       },
17       "id": 1,
18       "name": "Дата"
19     }
Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Отчет/4._Настроить_параметры/Задать_формат_параметра&oldid=6072