KORTO V2 （预览版）
Korto 记录管理系统 v2.0 的自定义连接器
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Korto |
| URL | https://korto.io/ |
| contact@korto.info |
| 连接器元数据 | |
|---|---|
| 发布者 | Korto |
| 网站 | https://korto.io/ |
| 隐私策略 | https://korto.io/ |
| 类别 | 内容和文件;数据 |
使用此连接器与 Korto Record Management Systems API v2.0 实例通信。
先决条件
请与我们联系 以获取 Korto 应用程序环境的实例。 设置 Korto 环境后，你将能够获取必要的 Korto API URL 和 API 密钥来创建连接器连接。
如何获取凭据
若要进行身份验证，需要使用 API 密钥。 可以在 Korto 应用程序实例的“管理”部分创建密钥。
连接器入门
使用此连接器之前，应使用 Korto 应用程序环境和 Korto 标记、记录和记录标记值的概念。 支持的标记作包括：创建标记定义、获取标记定义和删除标记定义。 支持的记录作包括：创建记录、获取记录定义、下载记录文件内容并删除记录定义。 支持的记录标记值作包括：向记录添加标记值、更新记录上的标记值并删除记录上的标记值。
已知问题和限制
目前，没有报告的问题和限制。
部署说明
请使用 这些Microsoft说明 将此连接器部署为 Microsoft Power Automate 和 Power Apps 中的自定义连接器。
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | 此 API 的 API 密钥 | True |
| Korto API URL | 字符串 | Korto 实例 API 的完整 URL。 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| Korto Record create |
在 Korto 中创建新记录 |
| Korto Record delete |
从 Korto 中删除记录 |
| Korto Record Tag 值删除 |
从 Korto 中的记录中删除标记 |
| Korto Record Tag 值更新 |
更新 Korto Record 上已存在的标记的值 |
| Korto Record Tag 值添加 |
从 Korto 中的记录添加标记 |
| Korto Record 下载 |
从 Korto 下载记录文件内容 |
| Korto 标记定义创建 |
在 Korto 中创建新的标记定义 |
| Korto 标记定义删除 |
在 Korto 中删除标记定义 |
| 获取 Korto Record 定义 |
从 Korto 获取记录定义 |
| 获取 Korto 标记定义 |
获取 Korto 中定义的标记的定义 |
Korto Record create
在 Korto 中创建新记录
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
新记录的名称
|
name | string |
新记录的名称 |
|
|
外部系统的名称
|
actor | string |
外部系统的名称 |
|
|
外部系统中的唯一记录 ID
|
externalid | string |
外部系统中的唯一记录 ID |
|
|
外部系统中的唯一记录 URL
|
externalurl | string |
外部系统中的唯一记录 URL |
|
|
创建日期和时间
|
createdAt | string |
创建日期和时间 |
|
|
创建者名称
|
createdBy | string |
创建者名称 |
|
|
要上传的文件内容
|
file | True | file |
要上传的文件内容 |
返回
Korto Record delete
从 Korto 中删除记录
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中的唯一记录 ID
|
externalRecordID | string |
外部系统中的唯一记录 ID |
Korto Record Tag 值删除
从 Korto 中的记录中删除标记
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中的唯一记录 ID
|
externalRecordID | string |
外部系统中的唯一记录 ID |
|
|
Korto 中的唯一标记名称
|
tagName | string |
Korto 中的唯一标记名称 |
Korto Record Tag 值更新
更新 Korto Record 上已存在的标记的值
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中的唯一记录 ID
|
externalRecordID | string |
外部系统中的唯一记录 ID |
|
|
Korto 中的唯一标记名称
|
tagName | string |
Korto 中的唯一标记名称 |
|
|
新建标记值
|
tagValue | string |
新建标记值 |
返回
Korto Record Tag 值添加
从 Korto 中的记录添加标记
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中的唯一记录 ID
|
externalRecordID | string |
外部系统中的唯一记录 ID |
|
|
Korto 中的唯一标记名称
|
tagName | string |
Korto 中的唯一标记名称 |
|
|
已添加标记的值
|
tagValue | string |
已添加标记的值 |
返回
Korto Record 下载
从 Korto 下载记录文件内容
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中的唯一记录 ID
|
externalRecordID | string |
外部系统中的唯一记录 ID |
返回
- Body
- DownloadUrlMessage
Korto 标记定义创建
在 Korto 中创建新的标记定义
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
标记的唯一名称
|
tagName | string |
标记的唯一名称 |
|
|
标记的类型
|
tagType | integer |
SystemTag 为 0，LabelTag 为 1，UntypedLabelTag 为 2，AutoTag 为 3，ActionTag 为 4 |
|
|
标记正在存储的数据类型
|
tagValueType | integer |
无为 0，字符串为 1，Int 为 2，十进制为 3，DateTime 为 4，Bool 为 5，MasterData 为 6 |
返回
- Body
- QueryTagResponseItem
Korto 标记定义删除
在 Korto 中删除标记定义
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中标记的唯一 ID
|
tagID | integer |
Korto 中标记的唯一 ID |
|
|
Korto 中标记的唯一名称
|
tagName | string |
Korto 中标记的唯一名称 |
获取 Korto Record 定义
从 Korto 获取记录定义
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中的唯一记录 ID
|
recordID | integer |
Korto 中的唯一记录 ID |
|
|
外部系统中 UniqueRecord ID
|
externalRecordID | string |
外部系统中 UniqueRecord ID |
返回
获取 Korto 标记定义
获取 Korto 中定义的标记的定义
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Korto 中标记的唯一 ID
|
tagID | integer |
Korto 中标记的唯一 ID |
|
|
Korto 中标记的唯一名称
|
tagName | string |
Korto 中标记的唯一名称 |
返回
- Body
- QueryTagsResponse
定义
QueryTagResponseItem
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | integer | |
|
姓名
|
name | string | |
|
|
type | integer | |
|
|
valueType | integer | |
|
synonymsCount
|
synonymsCount | integer | |
|
recordsCount
|
recordsCount | integer | |
|
synonymId
|
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 | double | |
|
版本
|
versions | array of RecordVersion | |
|
tags
|
tags | array of TagResponseMessage | |
|
参与者
|
actor | string | |
|
externalId
|
externalId | string | |
|
校验和
|
checksum | string | |
|
downloadsCount
|
downloadsCount | integer | |
|
editCount
|
editCount | integer | |
|
createdBy
|
createdBy | string | |
|
createdAt
|
createdAt | date-time |
RecordVersion
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | integer | |
|
姓名
|
name | string | |
|
版本
|
version | double | |
|
参与者
|
actor | string | |
|
createdAt
|
createdAt | date-time | |
|
createdBy
|
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 | integer | |
|
retentionMonth
|
retentionMonth | integer | |
|
isPredefined
|
isPredefined | boolean | |
|
必填项
|
isRequired | boolean | |
|
additionalFormattingType
|
additionalFormattingType | integer |
DownloadUrlMessage
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
网址
|
url | string |