Платформа 3V/DataManager/Маппинг показателей: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 75: Строка 75:
 
|Json|| "fieldDataType": "Json"|| Данные должны приходит в таком "кавычках", если необходимо атрибуты занести в формат json, то следует использовать выражение: "expression": "[атрибут]" и не прописывать в настройках "SaveMode"
 
|Json|| "fieldDataType": "Json"|| Данные должны приходит в таком "кавычках", если необходимо атрибуты занести в формат json, то следует использовать выражение: "expression": "[атрибут]" и не прописывать в настройках "SaveMode"
 
|}
 
|}
 +
=== Шаг 3. Завершение настройки ===
 +
Остается добавить только верный дискриминатор ('''DictionaryDataOptions'''), dictionaryIdent ('''код справочника-приемника'''), SaveMode
 +
<syntaxhighlight lang="JSON" line>
 +
"Destination": {
 +
                "discriminator": "DictionaryDataOptions",
 +
                "SaveMode": "Postgres",
 +
                "mapperOptions": [
 +
  {
 +
    "propertyName": "name",
 +
    "filedName": "NAME",
 +
    "dataType": "String",
 +
    "isPrimary": false,
 +
    "discriminator": "MapperOption"
 +
  },
 +
  {
 +
    "propertyName": "root_id",
 +
    "filedName": "root_id",
 +
    "dataType": "Int32",
 +
    "isPrimary": true,
 +
    "discriminator": "MapperOption"
 +
  },
 +
{
 +
    "propertyName": "start_date",
 +
    "filedName": "start_date",
 +
    "dataType": "DateTime",
 +
    "isPrimary": false,
 +
    "discriminator": "MapperOption"
 +
  }
 +
  ],
 +
  "dictionaryIdent": "New_Dictionary_5535"
 +
}
 +
</syntaxhighlight>

Версия 09:16, 12 декабря 2022

Если приемник данных - показатель, то настройка выглядит следующим образом:

1 "Destination": {
2                  "discriminator": "IndicatorDataOptions",
3                  "mapperOptions": [ {}, {}],
4                  "expressions": [{}],
5                  "clearData": false,
6                  "Code": ""
7                }

Шаг 1. Настройка самого показателя-приемника

Для начала следует создать показатель для загрузки. Чтобы корректно сработала задача загрузки, перед созданием показателя необходимо ознакомиться с атрибутами из источника и их типами данных. Например, необходимо выгрузить геометрию для каждого наименования:

показатель-приемник.png

Показатель строится на основе справочнике, после его создания необходимо обратиться к конструктору показателя и обратить внимание на "columns", из данной иерархии используется название и тип данных.

конструктор показателя.png

  • "name": "fact" - будет использоваться для загрузки геометрии
  • "name": "d_416103_id" - атрибут для первичного ключа

Шаг 2. Настройка полей

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

 1 "mapperOptions": [
 2                    {
 3                     "propertyName": "root_id",
 4                     "filedName": "d_416103_id",
 5                     "dataType": "Int32",
 6                     "isPrimary": true,
 7                     "discriminator": "MapperOption"
 8                    },
 9                    {
10                     "ExpressionId": 1,
11                     "filedName": "fact",
12                     "fieldDataType": "Json",
13                     "isPrimary": false,
14                     "discriminator": "MapperOption"
15                    }            
16                  ],
17  "Expressions": [
18                  {
19                    "id": 1,
20                    "expression": "[0]",
21                    "Variables": {
22                                  "0": "geometry"
23                                 }
24                   }
25                  ]

Откуда берется:

  • propertyName - название атрибута из источника
  • filedName - название столбцов из показателя ("columns")
  • dataType/fieldDataType - тип данных, который должен совпадать в приемнике и источнике
  • isPrimary - является ли данный атрибут первичным ключом (хотя бы один из атрибутов должен содержать настройку "isPrimary": true)
  • discriminator - здесь всегда необходимо ставить "MapperOption"

Типы данных, которые поддерживает DataManager

Тип Как записать в настройке Небольшой комментарий
Строка String Если в источнике приходит тип guid или длинное число, то лучше записать в приемник в атрибут с типом "String"
Целое число (Integer) Int32 Int64 не поддерживается
Вещественное число (Double) Double Формат записи через запятую ("370,70")
Дата и время DateTime Формат записи через запятую 01.01.2000 (даже, если приходят данные в формате "2020-01-01")
Логический тип Boolean -
Json "fieldDataType": "Json" Данные должны приходит в таком "кавычках", если необходимо атрибуты занести в формат json, то следует использовать выражение: "expression": "[атрибут]" и не прописывать в настройках "SaveMode"

Шаг 3. Завершение настройки

Остается добавить только верный дискриминатор (DictionaryDataOptions), dictionaryIdent (код справочника-приемника), SaveMode

 1 "Destination": {
 2                 "discriminator": "DictionaryDataOptions",
 3                 "SaveMode": "Postgres",
 4                 "mapperOptions": [
 5    {
 6     "propertyName": "name",
 7     "filedName": "NAME",
 8     "dataType": "String",
 9     "isPrimary": false,
10     "discriminator": "MapperOption"
11    },
12    {
13     "propertyName": "root_id",
14     "filedName": "root_id",
15     "dataType": "Int32",
16     "isPrimary": true,
17     "discriminator": "MapperOption"
18    },
19  {
20     "propertyName": "start_date",
21     "filedName": "start_date",
22     "dataType": "DateTime",
23     "isPrimary": false,
24     "discriminator": "MapperOption"
25    }
26   ],
27   "dictionaryIdent": "New_Dictionary_5535"
28  }