|
|
| (не показано 25 промежуточных версий этого же участника) |
| Строка 1: |
Строка 1: |
| − | {{DISPLAYTITLE: Описание модели настроек DataManager}}
| |
| − | Модель Json разделена на две части - '''Source''' (источник данных) и '''Destination''' (приёмник данных)
| |
| | | | |
| − | == Источник данных (Source) ==
| |
| − | === Дискриминатор ===
| |
| − | discriminator - дискриминатор (тип данных - string)
| |
| − |
| |
| − | * '''UrlDataManagerSource''' - в случае, если источник данных ''ссылка на ресурс''
| |
| − | Если источник данных - ''ссылка'', то в SOURCE необходимо указать '''Uri, Credentials, Headers''':
| |
| − | <syntaxhighlight lang="JSON" line>
| |
| − | "Source": {
| |
| − | "discriminator": "UrlDataManagerSource",
| |
| − | "Uri": "",
| |
| − | "Credentials": "",
| |
| − | "Headers": ""
| |
| − | },
| |
| − | </syntaxhighlight>
| |
| − | * '''ConstantDataManagerSource''' - если источник данных ''файл''
| |
| − | Если источник данных - ''файл'', то в SOURCE достаточно прописать только дискриминатор:
| |
| − | <syntaxhighlight lang="JSON" line>
| |
| − | "Source": {
| |
| − | "discriminator": "ConstantDataManagerSource"
| |
| − | },
| |
| − | </syntaxhighlight>
| |
| − |
| |
| − | === Унифицированный идентификатор ресурса ===
| |
| − | Uri - унифицированный идентификатор ресурса
| |
| − |
| |
| − | DataManager поддерживает следующие источники:
| |
| − | * Postgres
| |
| − | * Любой get/post запрос
| |
| − | ВАЖНО: необходимо, чтобы запрос, прописанный в Uri возвращал данные в '''формате json'''
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Стенд !! Пример !! Пояснение
| |
| − | |-
| |
| − | | finance || <syntaxhighlight lang="JSON" line>
| |
| − | "Source": {
| |
| − | "discriminator": "UrlDataManagerSource",
| |
| − | "Uri": "https://fmpcloud.io/api/v3/symbol/available-indexes?apikey=887f267b885bd2384c2b3ef0bfbee3c9"
| |
| − | },
| |
| − | </syntaxhighlight>
| |
| − | || Если перейти по ссылке, то данные представляются в json-формате
| |
| − | |-
| |
| − | | double.dev || <syntaxhighlight lang="JSON" line>
| |
| − | "Source": {
| |
| − | "discriminator": "UrlDataManagerSource",
| |
| − | "Uri": "http://filestorage/api/File/e0e88d78-339e-496c-baa8-d5fb18848692"
| |
| − | },
| |
| − | </syntaxhighlight>
| |
| − | || Ссылка на get-запрос файлового хранилища
| |
| − | ''(как получить ссылку на файл из файлового хранилища см ниже)''
| |
| − | |-
| |
| − | | corp-portal || <syntaxhighlight lang="JSON" line>
| |
| − | "Source": {
| |
| − | "discriminator": "UrlDataManagerSource",
| |
| − | "Uri": "https://bs-extension.bright-soft.org/atlassian-adapter/Jira/Projects"
| |
| − | },
| |
| − | </syntaxhighlight>
| |
| − | || Ссылка на get-запрос сервиса atlassian-adapter
| |
| − | |}
| |
| − |
| |
| − | Для того, чтобы получить ссылку на файл, необходимо сделать следующее:
| |
| − | # Получить идентификатор файла с помощью [[Платформа 3V/Справочник/Задание атрибутов в справочнике/Вычислимые значения файла|вычислимого атрибута]]
| |
| − | # Перейти в файловое хранилище проекта (filestorage) и найти get-метод [https://3v.3v-group.net/filestorage/swagger/index.html#/File/File_GetFile File/{fileid}]
| |
| − | # Заполнить параметр вызова "fileid" найденным в первом пункте значением (некоторые стенды дополнительно в качестве параметра запуска принимают тенант), запустить метод
| |
| − | # После запуска метода скопировать Request URL, оставить строку в формате "http://filestorage/api/File/НАБОР_ЦИФР" (набор цифр, в данном случае - ''fileid'')
| |
| − |
| |
| − | ''В случае, если данные предоставляются не из файлового хранилища, Request URL следует оставить без изменений''
| |
| − |
| |
| − | === Параметры авторизации ===
| |
| − | Credentials - параметры авторизации
| |
| − | Credentials содержит следующие настройки:
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Поле !! Описание !! Тип
| |
| − | |-
| |
| − | | discriminator ||
| |
| − | * ConfidentialClientAuthenticationSettingsDto - аутентификация конфиденциального клиента
| |
| − | * PasswordAuthenticationSettingsDto - аутентификация с помощью логина и пароля
| |
| − | || string (строка)
| |
| − | |-
| |
| − | | TokenRequestUrl || Адрес запроса токена - брать из кк || string (строка)
| |
| − | |-
| |
| − | | ClientId || Брать из кк (realm - clients - взять нужного) || string (строка)
| |
| − | |-
| |
| − | | ClientSecret || Брать из кк (realm - clients - взять нужного) - credentials - поле "secret" || string (строка)
| |
| − | |-
| |
| − | | UserName || Логин для авторизации на стенде ''(данное поле добавляется для дискриминатора '''"PasswordAuthenticationSettingsDto"''''') || string (строка)
| |
| − | |-
| |
| − | | Password || Пароль для авторизации на стенде''(данное поле добавляется для дискриминатора '''"PasswordAuthenticationSettingsDto"''''') || string (строка)
| |
| − | |}
| |
| − |
| |
| − | Настройка для Credentials для авторизации по логину/паролю:
| |
| − |
| |
| − | <syntaxhighlight lang="JSON" line>
| |
| − | "Credentials": {
| |
| − | "discriminator": "PasswordAuthenticationSettingsDto",
| |
| − | "TokenRequestUrl": "https://3v.3v-group.net/auth/realms/trivium/protocol/openid-connect/token",
| |
| − | "clientId": "clientid",
| |
| − | "clientSecret": "5gq428rz-wpx1-5751-b0r1-h4x5wb9m5210",
| |
| − | "UserName": "username",
| |
| − | "Password": "password"
| |
| − | }
| |
| − | </syntaxhighlight>
| |
| − |
| |
| − | Настройка для Credentials для аутентификации конфиденциального клиента:
| |
| − | <syntaxhighlight lang="JSON" line>
| |
| − | "Credentials": {
| |
| − | "discriminator": "ConfidentialClientAuthenticationSettingsDto",
| |
| − | "TokenRequestUrl": "https://smart-id-test.mos.ru/iam/auth/realms/dev/protocol/openid-connect/token",
| |
| − | "clientId": "clientid",
| |
| − | "clientSecret": "5gq428rz-wpx1-5751-b0r1-h4x5wb9m5210"
| |
| − | }
| |
| − | </syntaxhighlight>
| |
| − |
| |
| − | === Токен доступа ===
| |
| − | Headers - токен доступа
| |
| − |
| |
| − | '''1 вариант - тенант'''
| |
| − |
| |
| − | "Headers": { "namespace": "landscaping" }
| |
| − |
| |
| − | '''2 вариант - Bearer <token>'''
| |
| − |
| |
| − | Токен берем из средств разработчика (f12 или ctrl+f12)
| |
| − |
| |
| − | "Headers": {"Authorization": "Bearer <token>"}
| |
| − |
| |
| − | '''3 вариант - секрет'''
| |
| − |
| |
| − | Создается отдельный клиент, который по написанному токену имеет ограниченный набор прав
| |
| − |
| |
| − | "Headers": { "secret": "Ke2QSqWkX4FgyKnx6RYnYFLyqA2MHTq9Jvdk" }
| |
| − |
| |
| − | == Приемник данных (Destination) ==
| |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Название полей !! Описание !! Тип
| |
| − | |-
| |
| − | | discriminator || Дискриминатор:
| |
| − | * Если приемник - справочник, то "DictionaryDataOptions"
| |
| − | * Если приемник - показатель, то "IndicatorDataOption
| |
| − | || Текст ячейки
| |
| − | |-
| |
| − | | SaveMode ||
| |
| − | * DictionaryClient - запись через апи справочников (стоит по умолчанию, можно не прописывать)
| |
| − | * Postgres - запись через БД (в данном случае следует указать)
| |
| − | || string (строка)
| |
| − | |-
| |
| − | | mapperOptions[] || Настройки маппинг || string (строка)
| |
| − | |-
| |
| − | | expressions[] || Настройки выражений (при необходимости) || коллекция полей
| |
| − | |-
| |
| − | | clearData || Очистить данные (для справочника '''(если дискриминатор - DictionaryDataOptions)''' добавлена настройка для частичной очистки данных) || boolean (логический тип)
| |
| − | |-
| |
| − | | dictionaryIdent || Код справочника-приемника данных || string (строка)
| |
| − | |}
| |
| − |
| |
| − | === Настройки маппинга ===
| |
| − | Все настройки маппинга записываются в поле mapperOptions
| |