KORTO V2 (versión preliminar)
Conector personalizado a un sistema de administración de registros korto v2.0
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Korto |
| URL | https://korto.io/ |
| Correo Electrónico | contact@korto.info |
| Metadatos del conector | |
|---|---|
| Publicador | Korto |
| Sitio web | https://korto.io/ |
| Directiva de privacidad | https://korto.io/ |
| Categorías | Contenido y archivos; Datos |
Use este conector para comunicarse con la instancia de Korto Record Management Systems API v2.0.
Prerrequisitos
Póngase en contacto con nosotros para obtener su instancia del entorno de la aplicación Korto. Después de configurar el entorno de Korto, podrá obtener la dirección URL y la clave de API de Korto necesarias para crear la conexión del conector.
Obtención de credenciales
Para la autenticación, debe usar una clave de API. Puede crear claves en la sección Administrador, dentro de la instancia de la aplicación Korto.
Introducción al conector
Antes de usar este conector, debe ser farmiliar con el entorno de la aplicación Korto y los conceptos de etiquetas, registros y valores de etiqueta de registro de Korto. Las operaciones de etiquetas admitidas son: crear una definición de etiqueta, obtener la definición de etiqueta y eliminar una definición de etiqueta. Las operaciones de registro admitidas son: crear un registro, obtener la definición de registro, descargar el contenido del archivo de registro y eliminar una definición de registro. Las operaciones de valor de etiqueta de registro admitidas son: agregar un valor de etiqueta a un registro, actualizar un valor de etiqueta en un registro y eliminar un valor de etiqueta en un registro.
Problemas y limitaciones conocidos
Actualmente, no hay problemas y limitaciones notificados.
Instrucciones de implementación
Use estas instrucciones de Microsoft para implementar este conector como un conector personalizado en Microsoft Power Automate y Power Apps.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | Cierto |
| Korto API URL | cuerda / cadena | Dirección URL completa a la API de instancia de Korto. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización del valor de etiqueta de registro de Korto |
Actualizar un valor de una etiqueta ya existente en un registro korto |
| Agregar valor de etiqueta de registro korto |
Agregar una etiqueta desde un registro en Korto |
| Creación de la definición de etiqueta Korto |
Creación de una nueva definición de etiqueta en Korto |
| Descarga de Korto Record |
Descargar el contenido del archivo de registro de Korto |
| Eliminación de la definición de etiqueta korto |
Eliminar una definición de etiqueta en Korto |
| Eliminación de registros de Korto |
Eliminar un registro de Korto |
| Eliminación del valor de etiqueta de registro de Korto |
Eliminar una etiqueta de un registro en Korto |
| Korto Record create |
Crear un nuevo registro en Korto |
| Obtención de la definición de etiqueta korto |
Obtener una definición de una etiqueta definida en Korto |
| Obtención de la definición de registro de Korto |
Obtener una definición de registro de Korto |
Actualización del valor de etiqueta de registro de Korto
Actualizar un valor de una etiqueta ya existente en un registro korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
Identificador de registro único en el sistema externo
|
externalRecordID | string |
Identificador de registro único en el sistema externo |
|
|
Nombre de etiqueta único en Korto
|
tagName | string |
Nombre de etiqueta único en Korto |
|
|
Nuevo valor de etiqueta
|
tagValue | string |
Nuevo valor de etiqueta |
Devoluciones
Agregar valor de etiqueta de registro korto
Agregar una etiqueta desde un registro en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
Identificador de registro único en el sistema externo
|
externalRecordID | string |
Identificador de registro único en el sistema externo |
|
|
Nombre de etiqueta único en Korto
|
tagName | string |
Nombre de etiqueta único en Korto |
|
|
Valor de la etiqueta agregada
|
tagValue | string |
Valor de la etiqueta agregada |
Devoluciones
Creación de la definición de etiqueta Korto
Creación de una nueva definición de etiqueta en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre único de la etiqueta
|
tagName | string |
Nombre único de la etiqueta |
|
|
Tipo de una etiqueta
|
tagType | integer |
SystemTag es 0,LabelTag es 1,UntypedLabelTag es 2,AutoTag es 3,ActionTag es 4 |
|
|
Tipo de datos que almacena una etiqueta
|
tagValueType | integer |
None is 0,String is 1,Int is 2,Decimal is 3,DateTime is 4,Bool is 5,MasterData is 6 |
Devoluciones
- Body
- QueryTagResponseItem
Descarga de Korto Record
Descargar el contenido del archivo de registro de Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
Identificador de registro único en el sistema externo
|
externalRecordID | string |
Identificador de registro único en el sistema externo |
Devoluciones
- Body
- DownloadUrlMessage
Eliminación de la definición de etiqueta korto
Eliminar una definición de etiqueta en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de la etiqueta en Korto
|
tagID | integer |
Identificador único de la etiqueta en Korto |
|
|
Nombre único de la etiqueta en Korto
|
tagName | string |
Nombre único de la etiqueta en Korto |
Eliminación de registros de Korto
Eliminar un registro de Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
Identificador de registro único en el sistema externo
|
externalRecordID | string |
Identificador de registro único en el sistema externo |
Eliminación del valor de etiqueta de registro de Korto
Eliminar una etiqueta de un registro en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
Identificador de registro único en el sistema externo
|
externalRecordID | string |
Identificador de registro único en el sistema externo |
|
|
Nombre de etiqueta único en Korto
|
tagName | string |
Nombre de etiqueta único en Korto |
Korto Record create
Crear un nuevo registro en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del nuevo registro
|
name | string |
Nombre del nuevo registro |
|
|
Nombre del sistema externo
|
actor | string |
Nombre del sistema externo |
|
|
Identificador de registro único en el sistema externo
|
externalid | string |
Identificador de registro único en el sistema externo |
|
|
Dirección URL de registro única en el sistema externo
|
externalurl | string |
Dirección URL de registro única en el sistema externo |
|
|
Fecha y hora de la creación
|
createdAt | string |
Fecha y hora de la creación |
|
|
Nombre del creador
|
createdBy | string |
Nombre del creador |
|
|
El contenido del archivo que se va a cargar
|
file | True | file |
El contenido del archivo que se va a cargar |
Devoluciones
Obtención de la definición de etiqueta korto
Obtener una definición de una etiqueta definida en Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de la etiqueta en Korto
|
tagID | integer |
Identificador único de la etiqueta en Korto |
|
|
Nombre único de la etiqueta en Korto
|
tagName | string |
Nombre único de la etiqueta en Korto |
Devoluciones
- Body
- QueryTagsResponse
Obtención de la definición de registro de Korto
Obtener una definición de registro de Korto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de registro único en Korto
|
recordID | integer |
Identificador de registro único en Korto |
|
|
UniqueRecord ID en el sistema externo
|
externalRecordID | string |
UniqueRecord ID en el sistema externo |
Devoluciones
Definiciones
QueryTagResponseItem
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
nombre
|
name | string | |
|
|
type | integer | |
|
|
valueType | integer | |
|
synonymsCount
|
synonymsCount | integer | |
|
recordsCount
|
recordsCount | integer | |
|
synonymId
|
synonymId | integer | |
|
createdAt
|
createdAt | date-time | |
|
isPredefined
|
isPredefined | boolean | |
|
esRequerido
|
isRequired | boolean | |
|
additionalFormattingType
|
additionalFormattingType | integer | |
|
isRelatedTag
|
isRelatedTag | boolean |
QueryTagsResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
totalItems | integer | |
|
datos
|
data | array of QueryTagResponseItem |
RecordQueryResponseItem
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
nombre
|
name | string | |
|
version
|
version | double | |
|
versiones
|
versions | array of RecordVersion | |
|
tags
|
tags | array of TagResponseMessage | |
|
actor
|
actor | string | |
|
ID externo
|
externalId | string | |
|
checksum
|
checksum | string | |
|
downloadsCount
|
downloadsCount | integer | |
|
editCount
|
editCount | integer | |
|
createdBy
|
createdBy | string | |
|
createdAt
|
createdAt | date-time |
RecordVersion
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
nombre
|
name | string | |
|
version
|
version | double | |
|
actor
|
actor | string | |
|
createdAt
|
createdAt | date-time | |
|
createdBy
|
createdBy | string | |
|
ID externo
|
externalId | string |
TagResponseMessage
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
stringValue
|
stringValue | string | |
|
intValue
|
intValue | integer | |
|
decimalValue
|
decimalValue | double | |
|
dateTimeValue
|
dateTimeValue | date-time | |
|
boolValue
|
boolValue | boolean | |
|
valueType
|
valueType | integer | |
|
tagId
|
tagId | integer | |
|
nombre
|
name | string | |
|
type
|
type | integer | |
|
retentionMonth
|
retentionMonth | integer | |
|
isPredefined
|
isPredefined | boolean | |
|
esRequerido
|
isRequired | boolean | |
|
additionalFormattingType
|
additionalFormattingType | integer |
DownloadUrlMessage
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
URL
|
url | string |