KORTO V2 （預覽版）

Korto 記錄管理系統 v2.0 的自訂連接器

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	科爾托
URL	https://korto.io/
Email	contact@korto.info

連接器中繼資料
Publisher	科爾托
網站	https://korto.io/
隱私策略	https://korto.io/
類別	內容和文件;資料

使用此連接器可與您的 Korto 記錄管理系統 API v2.0 執行個體通訊。

先決條件

請聯絡我們以取得您的 Korto 應用程式環境實例。設定 Korto 環境後，您將能夠取得必要的 Korto API URL 和 API 金鑰來建立連接器連線。

如何取得認證

對於身份驗證，您需要使用 API 密鑰。您可以在 Korto 應用程式執行個體內的 [管理] 區段中建立金鑰。

開始使用連接器

在此連接器之前，您應該熟悉 Korto 應用程式環境以及 Korto 標籤、記錄和記錄標籤值的概念。支援的標籤操作有：建立標籤定義、取得標籤定義和刪除標籤定義。支援的記錄操作有：建立記錄、取得記錄定義、下載記錄檔案內容和刪除記錄定義。支援的記錄標籤值操作包括：將標籤值新增至記錄、更新記錄上的標籤值以及刪除記錄上的標籤值。

已知問題與限制

目前，沒有報告的問題和限制。

部署指示

請使用這些 Microsoft 指示，將此連接器部署為 Microsoft Power Automate 和 Power Apps 中的自訂連接器。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此 API 的 API 金鑰	對
Korto API URL	字串	Korto 執行個體 API 的完整 URL。	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

Korto Record Tag 增值	從 Korto 中的記錄新增標籤
Korto Record 下載	從 Korto 下載錄製檔案內容
Korto Record 定義 get	從 Korto 取得記錄定義
Korto 標籤定義 create	在 Korto 中建立新的標籤定義
Korto 標籤定義 get	取得 Korto 中定義的標籤定義
Korto 標籤定義刪除	刪除 Korto 中的標籤定義
Korto 記錄刪除	從 Korto 刪除記錄
Korto 記錄創建	在 Korto 中建立新記錄
Korto 記錄標籤值刪除	從 Korto 中的記錄中刪除標籤
Korto 記錄標籤值更新	更新 Korto 記錄上現有標籤的值

Korto Record Tag 增值

作業識別碼：: AddTagToRecord

從 Korto 中的記錄新增標籤

參數

名稱	機碼	類型	Description
Korto 中的唯一記錄 ID	recordID	integer	Korto 中的唯一記錄 ID
外部系統中的唯一記錄 ID	externalRecordID	string	外部系統中的唯一記錄 ID
Korto 中的唯一標籤名稱	tagName	string	Korto 中的唯一標籤名稱
新增標籤的值	tagValue	string	新增標籤的值

傳回

身體: RecordQueryResponseItem

Korto Record 下載

作業識別碼：: DownloadRecord

從 Korto 下載錄製檔案內容

參數

名稱	機碼	必要	類型	Description
Korto 中的唯一記錄 ID	recordID		integer	Korto 中的唯一記錄 ID
外部系統中的唯一記錄 ID	externalRecordID		string	外部系統中的唯一記錄 ID

傳回

身體: DownloadUrlMessage

Korto Record 定義 get

作業識別碼：: GetRecord

從 Korto 取得記錄定義

參數

名稱	機碼	必要	類型	Description
Korto 中的唯一記錄 ID	recordID		integer	Korto 中的唯一記錄 ID
外部系統中的 UniqueRecord ID	externalRecordID		string	外部系統中的 UniqueRecord ID

傳回

身體: RecordQueryResponseItem

Korto 標籤定義 create

作業識別碼：: CreateTag

在 Korto 中建立新的標籤定義

參數

名稱	機碼	類型	Description
標籤的唯一名稱	tagName	string	標籤的唯一名稱
標籤的類型	tagType	integer	SystemTag 為 0，LabelTag 為 1，UntypedLabelTag 為 2，AutoTag 為 3，ActionTag 為 4
標籤儲存的資料類型	tagValueType	integer	None 是 0，String 是 1，Int 是 2，Decimal 是 3，DateTime 是 4，Bool 是 5，MasterData 是 6

傳回

身體: QueryTagResponseItem

Korto 標籤定義 get

作業識別碼：: GetTag

取得 Korto 中定義的標籤定義

參數

名稱	機碼	必要	類型	Description
Korto 中標籤的唯一 ID	tagID		integer	Korto 中標籤的唯一 ID
Korto 中標籤的唯一名稱	tagName		string	Korto 中標籤的唯一名稱

傳回

身體: QueryTagsResponse

Korto 標籤定義刪除

作業識別碼：: DeleteTag

刪除 Korto 中的標籤定義

參數

名稱	機碼	必要	類型	Description
Korto 中標籤的唯一 ID	tagID		integer	Korto 中標籤的唯一 ID
Korto 中標籤的唯一名稱	tagName		string	Korto 中標籤的唯一名稱

Korto 記錄刪除

作業識別碼：: DeleteRecord

從 Korto 刪除記錄

參數

名稱	機碼	必要	類型	Description
Korto 中的唯一記錄 ID	recordID		integer	Korto 中的唯一記錄 ID
外部系統中的唯一記錄 ID	externalRecordID		string	外部系統中的唯一記錄 ID

Korto 記錄創建

作業識別碼：: CreateRecord

在 Korto 中建立新記錄

參數

名稱	機碼	必要	類型	Description
新記錄的名稱	name		string	新記錄的名稱
外部系統的名稱	actor		string	外部系統的名稱
外部系統中的唯一記錄 ID	externalid		string	外部系統中的唯一記錄 ID
外部系統中的唯一記錄 URL	externalurl		string	外部系統中的唯一記錄 URL
創建日期和時間	createdAt		string	創建日期和時間
創作者名稱	createdBy		string	創作者名稱
要上傳的檔案內容	file	True	file	要上傳的檔案內容

傳回

身體: RecordQueryResponseItem

Korto 記錄標籤值刪除

作業識別碼：: DeleteTagFromRecord

從 Korto 中的記錄中刪除標籤

參數

名稱	機碼	類型	Description
Korto 中的唯一記錄 ID	recordID	integer	Korto 中的唯一記錄 ID
外部系統中的唯一記錄 ID	externalRecordID	string	外部系統中的唯一記錄 ID
Korto 中的唯一標籤名稱	tagName	string	Korto 中的唯一標籤名稱

Korto 記錄標籤值更新

作業識別碼：: UpdateTagOnRecord

更新 Korto 記錄上現有標籤的值

參數

名稱	機碼	類型	Description
Korto 中的唯一記錄 ID	recordID	integer	Korto 中的唯一記錄 ID
外部系統中的唯一記錄 ID	externalRecordID	string	外部系統中的唯一記錄 ID
Korto 中的唯一標籤名稱	tagName	string	Korto 中的唯一標籤名稱
新增標籤值	tagValue	string	新增標籤值

傳回

身體: RecordQueryResponseItem

定義

QueryTagResponse項目

名稱	路徑	類型
識別碼	id	integer
名稱	name	string
	type	integer
	valueType	integer
同義詞計數	synonymsCount	integer
記錄計數	recordsCount	integer
同義Id	synonymId	integer
創建於	createdAt	date-time
是預先定義的	isPredefined	boolean
必需的	isRequired	boolean
additionalFormattingType	additionalFormattingType	integer
isRelated標籤	isRelatedTag	boolean

QueryTags回應

名稱	路徑	類型	Description
	totalItems	integer
資料	data	array of QueryTagResponseItem

RecordQuery回應項目

名稱	路徑	類型
識別碼	id	integer
名稱	name	string
版本	version	double
versions	versions	array of RecordVersion
tags	tags	array of TagResponseMessage
執行者	actor	string
externalId（外部識別碼）	externalId	string
總和檢查碼	checksum	string
下載次數計數	downloadsCount	integer
編輯計數	editCount	integer
由...創建	createdBy	string
創建於	createdAt	date-time

記錄版本

名稱	路徑	類型
識別碼	id	integer
名稱	name	string
版本	version	double
執行者	actor	string
創建於	createdAt	date-time
由...創建	createdBy	string
externalId（外部識別碼）	externalId	string

標籤回應訊息

名稱	路徑	類型
字串值	stringValue	string
整數值	intValue	integer
十進制值	decimalValue	double
日期時間值	dateTimeValue	date-time
布爾值	boolValue	boolean
valueType	valueType	integer
標籤Id	tagId	integer
名稱	name	string
型別	type	integer
保留月	retentionMonth	integer
是預先定義的	isPredefined	boolean
必需的	isRequired	boolean
additionalFormattingType	additionalFormattingType	integer

下載網址訊息

名稱	路徑	類型	Description
url	url	string

共用方式為