KORTO V2 (предварительная версия)

Настраиваемый соединитель к системе управления записями Korto версии 2.0

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Корто
URL	https://korto.io/
Адрес электронной почты	contact@korto.info

Метаданные соединителя
Publisher	Корто
Веб-сайт	https://korto.io/
Политика конфиденциальности	https://korto.io/
Категории	Содержимое и файлы; Данные

Используйте этот соединитель для взаимодействия с экземпляром API Системы управления записями Корто версии 2.0.

Предпосылки

Обратитесь к нам , чтобы получить экземпляр среды приложения Korto. После настройки среды Korto вы сможете получить необходимый URL-адрес API Korto и ключ API для создания подключения соединителя.

Получение учетных данных

Для проверки подлинности необходимо использовать ключ API. Ключи можно создать в разделе "Администратор" в экземпляре приложения Korto.

Начало работы с соединителем

Прежде чем использовать этот соединитель, следует быть фермилья с средой приложения Korto и понятиями тегов Korto, записей и значений тегов записей. Поддерживаемые операции тегов: создание определения тега, получение определения тега и удаление определения тега. Поддерживаемые операции записи: создание записи, получение определения записи, скачивание содержимого файла записи и удаление определения записи. Поддерживаемые операции с тегами записей: добавление значения тега в запись, обновление значения тега для записи и удаление значения тега в записи.

Известные проблемы и ограничения

В настоящее время нет зарегистрированных проблем и ограничений.

Инструкции по развертыванию

Используйте эти инструкции Майкрософт для развертывания этого соединителя в качестве пользовательского соединителя в Microsoft Power Automate и Power Apps.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API для этого API	True
URL-адрес API Korto	струна	Полный URL-адрес API экземпляра Korto.	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Добавление значения тега Korto Record	Добавление тега из записи в Корто
Обновление значения тега Korto Record	Обновление значения уже существующего тега в Korto Record
Получение определения Korto Record	Получение определения записи из Корто
Получение определения тега Korto	Получение определения тега, определенного в Korto
Скачивание Korto Record	Скачивание содержимого файла записи из Korto
Создание Korto Record	Создание новой записи в Корто
Создание определения тега Korto	Создание определения тега в Корто
Удаление Korto Record	Удаление записи из Корто
Удаление значения тега Korto Record	Удаление тега из записи в Корто
Удаление определения тега Корто	Удаление определения тега в Корто

Добавление значения тега Korto Record

Идентификатор операции:

AddTagToRecord

Добавление тега из записи в Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификатор записи во внешней системе	externalRecordID		string	Уникальный идентификатор записи во внешней системе
Уникальное имя тега в Корто	tagName		string	Уникальное имя тега в Корто
Значение добавленного тега	tagValue		string	Значение добавленного тега

Возвращаемое значение

Тело

RecordQueryResponseItem

Обновление значения тега Korto Record

Идентификатор операции:

UpdateTagOnRecord

Обновление значения уже существующего тега в Korto Record

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификатор записи во внешней системе	externalRecordID		string	Уникальный идентификатор записи во внешней системе
Уникальное имя тега в Корто	tagName		string	Уникальное имя тега в Корто
Новое значение тега	tagValue		string	Новое значение тега

Возвращаемое значение

Тело

RecordQueryResponseItem

Получение определения Korto Record

Идентификатор операции:

GetRecord

Получение определения записи из Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификаторRecord во внешней системе	externalRecordID		string	Уникальный идентификаторRecord во внешней системе

Возвращаемое значение

Тело

RecordQueryResponseItem

Получение определения тега Korto

Идентификатор операции:

GetTag

Получение определения тега, определенного в Korto

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор тега в Корто	tagID		integer	Уникальный идентификатор тега в Корто
Уникальное имя тега в Корто	tagName		string	Уникальное имя тега в Корто

Возвращаемое значение

Тело

QueryTagsResponse

Скачивание Korto Record

Идентификатор операции:

DownloadRecord

Скачивание содержимого файла записи из Korto

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификатор записи во внешней системе	externalRecordID		string	Уникальный идентификатор записи во внешней системе

Возвращаемое значение

Тело

DownloadUrlMessage

Создание Korto Record

Идентификатор операции:

CreateRecord

Создание новой записи в Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя новой записи	name		string	Имя новой записи
Имя внешней системы	actor		string	Имя внешней системы
Уникальный идентификатор записи во внешней системе	externalid		string	Уникальный идентификатор записи во внешней системе
Уникальный URL-адрес записи во внешней системе	externalurl		string	Уникальный URL-адрес записи во внешней системе
Дата и время создания	createdAt		string	Дата и время создания
Имя создателя	createdBy		string	Имя создателя
Содержимое файла для отправки	file	True	file	Содержимое файла для отправки

Возвращаемое значение

Тело

RecordQueryResponseItem

Создание определения тега Korto

Идентификатор операции:

CreateTag

Создание определения тега в Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальное имя тега	tagName		string	Уникальное имя тега
Тип тега	tagType		integer	SystemTag is 0,LabelTag is 1,UntypedLabelTag is 2,AutoTag is 3,ActionTag is 4
Тип данных, который сохраняет тег	tagValueType		integer	Нет 0,String is 1,Int is 2,Decimal is 3,DateTime is 4,Bool is 5,MasterData is 6

Возвращаемое значение

Тело

QueryTagResponseItem

Удаление Korto Record

Идентификатор операции:

DeleteRecord

Удаление записи из Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификатор записи во внешней системе	externalRecordID		string	Уникальный идентификатор записи во внешней системе

Удаление значения тега Korto Record

Идентификатор операции:

DeleteTagFromRecord

Удаление тега из записи в Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор записи в Корто	recordID		integer	Уникальный идентификатор записи в Корто
Уникальный идентификатор записи во внешней системе	externalRecordID		string	Уникальный идентификатор записи во внешней системе
Уникальное имя тега в Корто	tagName		string	Уникальное имя тега в Корто

Удаление определения тега Корто

Идентификатор операции:

DeleteTag

Удаление определения тега в Корто

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Уникальный идентификатор тега в Корто	tagID		integer	Уникальный идентификатор тега в Корто
Уникальное имя тега в Корто	tagName		string	Уникальное имя тега в Корто

Определения

QueryTagResponseItem

Имя	Путь	Тип	Описание
id	id	integer
имя	name	string
	type	integer
	valueType	integer
синонимыCount	synonymsCount	integer
recordsCount	recordsCount	integer
синонимId	synonymId	integer
createdAt	createdAt	date-time
isPredefined	isPredefined	boolean
обязательно	isRequired	boolean
additionalFormattingType	additionalFormattingType	integer
isRelatedTag	isRelatedTag	boolean

QueryTagsResponse

Имя	Путь	Тип	Описание
	totalItems	integer
данные	data	array of QueryTagResponseItem

RecordQueryResponseItem

Имя	Путь	Тип	Описание
id	id	integer
имя	name	string
version	version	double
versions	versions	array of RecordVersion
tags	tags	array of TagResponseMessage
actor	actor	string
externalId (внешний идентификатор)	externalId	string
контрольная сумма	checksum	string
downloadsCount	downloadsCount	integer
editCount	editCount	integer
создано кем	createdBy	string
createdAt	createdAt	date-time

RecordVersion

Имя	Путь	Тип	Описание
id	id	integer
имя	name	string
version	version	double
actor	actor	string
createdAt	createdAt	date-time
создано кем	createdBy	string
externalId (внешний идентификатор)	externalId	string

TagResponseMessage

Имя	Путь	Тип	Описание
stringValue	stringValue	string
intValue	intValue	integer
decimalValue	decimalValue	double
dateTimeValue	dateTimeValue	date-time
boolValue	boolValue	boolean
valueType	valueType	integer
tagId	tagId	integer
имя	name	string
type	type	integer
retentionMonth	retentionMonth	integer
isPredefined	isPredefined	boolean
обязательно	isRequired	boolean
additionalFormattingType	additionalFormattingType	integer

DownloadUrlMessage

Имя	Путь	Тип	Описание
URL-адрес	url	string