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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
(Новая страница: «{{DISPLAYTITLE:Форматы параметров}} == Параметр в отчете может иметь следующие типы данных: == #Ст...»)
 
 
(не показаны 3 промежуточные версии 1 участника)
Строка 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>
 +
|}
 +
<div class="NavFrame collapsed" style="width:700px; overflow:auto;">
 +
  <div class="NavHead">Пример</div>
 +
  <div class="NavContent">
 +
[https://study.3v-cloud.com/navigator/#/home?objectId=1689 Отчет с параметрами "Дата от" и "Дата до"]
 +
  </div>
 +
</div>
 +
<br>
 +
 
 +
<!--
 +
 
 +
Информация неактуальна. Значение в параметре не форматируется, потому что там редактор, а не отформатированная строка.
 +
 
 +
=== Изменение формата параметра 'вещественное число' ===
 +
Стандартно вещественное число в параметре выводится в виде 0.00. В таком случае структура параметра выглядит следующим образом:
 +
{| class="wikitable"
 +
|-
 +
! "dataControlOptions": [...]
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
    {
 +
      "dataType": "Double",
 +
      "discriminator": "TypedValueParameterDto",
 +
      "defaultValue": null,
 +
      "value": null,
 +
      "isMultiselect": false,
 +
      "isEmptyValuePossible": true,
 +
      "isDisableable": false,
 +
      "isDisabled": false,
 +
      "id": 1,
 +
      "name": "Вещественное число"
 +
    }
 +
</syntaxhighlight>
 +
|}
 +
 
 +
Форматы отображения на примере числа 10000,1234:
 +
* '0,0.000' - 10 000,123;
 +
* '0.000' - 10000,123;
 +
* '0,0.00[000]' - 10 000,1234;
 +
 
 +
Для изменения отображения вещественного числа, необходимо выбрать подходящий формат из списка выше и определить его в "dataControlOptions".
 +
{| class="wikitable"
 +
|-
 +
! "dataControlOptions": [...]
 +
|-
 +
| <syntaxhighlight lang="JSON" line>
 +
      {
 +
        "format": "0,0.00[000]",
 +
        "mask": null,
 +
        "min": null,
 +
        "max": null,
 +
        "component": null
 +
      }
 +
</syntaxhighlight>
 +
|}
 +
 
 +
<div class="NavFrame collapsed" style="width:700px; overflow:auto;">
 +
  <div class="NavHead">Пример</div>
 +
  <div class="NavContent">
 +
[https://study.3v-cloud.com/navigator/#/?viewId=1684 Отчет с параметром "Вещественное число"]
 +
  </div>
 +
</div>
 +
<br> -->

Текущая версия на 08:47, 27 мая 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=6611