Freigeben über


KORTO V2 (Preview)

Custom connector to a Korto record management system v2.0

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Korto
URL https://korto.io/
Email contact@korto.info
Connector Metadata
Publisher Korto
Website https://korto.io/
Privacy policy https://korto.io/
Categories Content and Files;Data

Use this connector to communicate with your instance of the Korto Record Management Systems API v2.0.

Prerequisites

Contact us to get your instance of the Korto application environment. After setting up your Korto environment, you'll be able to get the necessary Korto API URL and API Key to create the connector connection.

How to get credentials

For authentication, you need to use an API Key. You can create keys in the Admin section, within your Korto application instance.

Get started with your connector

Before using this connector, you should be farmiliar with the Korto application environment and the concepts of Korto tags, records and record tag values. Supported tag operations are: create a tag definition, get the tag definition and delete a tag definition. Supported record operations are: create a record, get the record definition, download the record file content and delete a record definition. Supported record tag value operations are: add a tag value to a record, update a tag value on a record and delete a tag value on a record.

Known issues and limitations

Currently, there are no reported issues and limitations.

Deployment Instructions

Please use these Microsoft instructions to deploy this connector as a custom connector in Microsoft Power Automate and Power Apps.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True
Korto API URL string Full URL to your Korto instance API. True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Korto Record create

Create a new Record in Korto

Korto Record definition get

Get a Record definition from Korto

Korto Record delete

Delete a Record from Korto

Korto Record download

Download the Record file content from Korto

Korto Record Tag value add

Add a Tag from a Record in Korto

Korto Record Tag value delete

Delete a Tag from a Record in Korto

Korto Record Tag value update

Update a value of an already existing Tag on a Korto Record

Korto Tag definition create

Create a new Tag definition in Korto

Korto Tag definition delete

Delete a Tag definition in Korto

Korto Tag definition get

Get a definition of a Tag defined in Korto

Korto Record create

Create a new Record in Korto

Parameters

Name Key Required Type Description
Name of the new Record
name string

Name of the new Record

Name of the external system
actor string

Name of the external system

Unique Record ID in the external system
externalid string

Unique Record ID in the external system

Unique Record URL in the external system
externalurl string

Unique Record URL in the external system

Date and time of the creation
createdAt string

Date and time of the creation

Creator name
createdBy string

Creator name

The file content to upload
file True file

The file content to upload

Returns

Korto Record definition get

Get a Record definition from Korto

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

UniqueRecord ID in the external system
externalRecordID string

UniqueRecord ID in the external system

Returns

Korto Record delete

Delete a Record from Korto

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

Unique Record ID in the external system
externalRecordID string

Unique Record ID in the external system

Korto Record download

Download the Record file content from Korto

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

Unique Record ID in the external system
externalRecordID string

Unique Record ID in the external system

Returns

Korto Record Tag value add

Add a Tag from a Record in Korto

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

Unique Record ID in the external system
externalRecordID string

Unique Record ID in the external system

Unique Tag name in Korto
tagName string

Unique Tag name in Korto

The value of the added Tag
tagValue string

The value of the added Tag

Returns

Korto Record Tag value delete

Delete a Tag from a Record in Korto

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

Unique Record ID in the external system
externalRecordID string

Unique Record ID in the external system

Unique Tag name in Korto
tagName string

Unique Tag name in Korto

Korto Record Tag value update

Update a value of an already existing Tag on a Korto Record

Parameters

Name Key Required Type Description
Unique Record ID in Korto
recordID integer

Unique Record ID in Korto

Unique Record ID in the external system
externalRecordID string

Unique Record ID in the external system

Unique Tag name in Korto
tagName string

Unique Tag name in Korto

New Tag value
tagValue string

New Tag value

Returns

Korto Tag definition create

Create a new Tag definition in Korto

Parameters

Name Key Required Type Description
Unique name of the Tag
tagName string

Unique name of the Tag

Type of a Tag
tagType integer

SystemTag is 0,LabelTag is 1,UntypedLabelTag is 2,AutoTag is 3,ActionTag is 4

Type of data a Tag is storing
tagValueType integer

None is 0,String is 1,Int is 2,Decimal is 3,DateTime is 4,Bool is 5,MasterData is 6

Returns

Korto Tag definition delete

Delete a Tag definition in Korto

Parameters

Name Key Required Type Description
Unique ID of the Tag in Korto
tagID integer

Unique ID of the Tag in Korto

Unique name of the Tag in Korto
tagName string

Unique name of the Tag in Korto

Korto Tag definition get

Get a definition of a Tag defined in Korto

Parameters

Name Key Required Type Description
Unique ID of the Tag in Korto
tagID integer

Unique ID of the Tag in Korto

Unique name of the Tag in Korto
tagName string

Unique name of the Tag in Korto

Returns

Definitions

QueryTagResponseItem

Name Path Type Description
id
id integer
name
name string
type integer
valueType integer
synonymsCount
synonymsCount integer
recordsCount
recordsCount integer
synonymId
synonymId integer
createdAt
createdAt date-time
isPredefined
isPredefined boolean
isRequired
isRequired boolean
additionalFormattingType
additionalFormattingType integer
isRelatedTag
isRelatedTag boolean

QueryTagsResponse

Name Path Type Description
totalItems integer
data
data array of QueryTagResponseItem

RecordQueryResponseItem

Name Path Type Description
id
id integer
name
name string
version
version double
versions
versions array of RecordVersion
tags
tags array of TagResponseMessage
actor
actor string
externalId
externalId string
checksum
checksum string
downloadsCount
downloadsCount integer
editCount
editCount integer
createdBy
createdBy string
createdAt
createdAt date-time

RecordVersion

Name Path Type Description
id
id integer
name
name string
version
version double
actor
actor string
createdAt
createdAt date-time
createdBy
createdBy string
externalId
externalId string

TagResponseMessage

Name Path Type Description
stringValue
stringValue string
intValue
intValue integer
decimalValue
decimalValue double
dateTimeValue
dateTimeValue date-time
boolValue
boolValue boolean
valueType
valueType integer
tagId
tagId integer
name
name string
type
type integer
retentionMonth
retentionMonth integer
isPredefined
isPredefined boolean
isRequired
isRequired boolean
additionalFormattingType
additionalFormattingType integer

DownloadUrlMessage

Name Path Type Description
url
url string