Flujo de trabajo K2 (versión preliminar)
Use el servicio K2 Workflow API para trabajar de forma remota con flujos de trabajo y tareas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | 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 | Estándar | 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 | Estándar | 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 | |
|---|---|
| URL | https://portal.k2.com/ticket/default |
| Metadatos del conector | |
|---|---|
| Publicador | K2 |
| Sitio web | https://www.k2.com |
| Directiva de privacidad | https://www.k2.com/legal/privacy-policy |
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 |
|---|---|---|---|
| K2 URL | cuerda / cadena | Dirección URL de K2 (ejemplo: https://[K2ID].onk2.com). | Cierto |
| Nombre de usuario | securestring | El nombre de usuario de esta API | Cierto |
| Contraseña | securestring | La contraseña de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Acción (tarea) |
Realiza una acción de flujo de trabajo. |
| Asignar tarea |
Asigna una tarea al usuario actual. |
| Finalizar evento de servidor |
Enviar una respuesta de finalización a una tarea asincrónica del servidor que espera una respuesta |
| Get Server (evento) |
Obtiene un evento de servidor por número de serie. |
| Iniciar flujo de trabajo |
Crea e inicia una nueva instancia de flujo de trabajo. |
| Obtener acciones de tarea |
Obtiene una lista de acciones para la tarea. |
| Obtener flujo de trabajo |
Obtiene una definición de flujo de trabajo por identificador. |
| Obtener flujos de trabajo |
Obtenga una lista de flujos de trabajo disponibles. |
| Obtener tarea |
Obtiene una tarea por número de serie. |
| Obtener tareas |
Obtenga una lista de tareas disponibles para el usuario conectado. |
| Tarea De reactivación |
Despierta una tarea de sueño. |
| Tarea de redirección |
Envía una tarea a otra persona. |
| Tarea de suspensión |
Suspende una tarea durante un período de tiempo, ya sea el número de segundos o hasta una fecha. |
| Tarea Release |
Libera una tarea. |
Acción (tarea)
Realiza una acción de flujo de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
|
Acción personalizada
|
customAction | True | string |
Acción de tarea, definida por el flujo de trabajo. |
|
Nombre del campo XML
|
name | string |
Nombre de un campo XML. |
|
|
Valor del campo XML
|
value | string |
Valor del campo XML. |
|
|
Referencias de elementos
|
ItemReferences | object |
Los campos Referencia de elemento de la instancia de flujo de trabajo. |
|
|
Campos de datos
|
DataFields | object |
Campos de datos de la instancia de flujo de trabajo. |
Asignar tarea
Asigna una tarea al usuario actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
Devoluciones
- response
- object
Finalizar evento de servidor
Enviar una respuesta de finalización a una tarea asincrónica del servidor que espera una respuesta
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie de eventos del servidor
|
serialNumber | True | string |
Número de serie del evento de servidor. Por ejemplo: 1234_5678 |
|
Nombre del campo XML
|
name | string |
Nombre de un campo XML. |
|
|
Valor del campo XML
|
value | string |
Valor del campo XML. |
|
|
Referencias de elementos
|
ItemReferences | object |
Los campos Referencia de elemento de la instancia de flujo de trabajo. |
|
|
Campos de datos
|
DataFields | object |
Campos de datos de la instancia de flujo de trabajo. |
Get Server (evento)
Obtiene un evento de servidor por número de serie.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie de eventos del servidor
|
serialNumber | True | string |
Número de serie del evento de servidor. Por ejemplo: 1234_5678. |
Devoluciones
Iniciar flujo de trabajo
Crea e inicia una nueva instancia de flujo de trabajo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
id | True | integer |
Especifique un identificador de flujo de trabajo para iniciar la instancia. |
|
Detalles de la instancia de flujo de trabajo
|
instance | True | dynamic |
Enviar objeto de instancia de flujo de trabajo para iniciar el flujo de trabajo. |
Devoluciones
- response
- integer
Obtener acciones de tarea
Obtiene una lista de acciones para la tarea.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
Devoluciones
- Body
- TaskActionsResponse
Obtener flujo de trabajo
Obtiene una definición de flujo de trabajo por identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
id | True | integer |
Identificador del flujo de trabajo. |
Devoluciones
- Body
- WorkflowDataResponse
Obtener flujos de trabajo
Obtenga una lista de flujos de trabajo disponibles.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de flujo de trabajo
|
type | string |
Tipo de flujo de trabajo. Inicial o propiedad. |
Devoluciones
Obtener tarea
Obtiene una tarea por número de serie.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
Devoluciones
- Body
- Task
Obtener tareas
Obtenga una lista de tareas disponibles para el usuario conectado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
All, Allocated, Sleeping, SharedFrom, SharedTo
|
state | string |
Devuelve la lista de tareas del usuario conectado. |
Devoluciones
- Body
- TasksResponse
Tarea De reactivación
Despierta una tarea de sueño.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
Devoluciones
- response
- object
Tarea de redirección
Envía una tarea a otra persona.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
|
Información de redireccionamiento
|
RedirectTo | True | string |
Persona a la que se redirige la tarea. |
Tarea de suspensión
Suspende una tarea durante un período de tiempo, ya sea el número de segundos o hasta una fecha.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
|
Suspensión para
|
SleepFor | integer |
Número de segundos para dormir una tarea. |
|
|
Suspensión hasta
|
SleepUntil | date-time |
Fecha y hora de reactivación de la tarea. Formato: aaaa-MM-ddTHH:mm:ss:fffZ UTC |
Tarea Release
Libera una tarea.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de serie
|
serialNumber | True | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
Definiciones
ServerEventDataResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de serie de eventos del servidor
|
serialNumber | string |
Número de serie del evento de servidor. Por ejemplo: 1234_5678 |
|
Id. de flujo de trabajo de eventos del servidor
|
workflowID | integer |
Identificador del flujo de trabajo asociado al evento de servidor. |
|
Nombre del flujo de trabajo de eventos del servidor
|
workflowName | string |
Nombre del flujo de trabajo asociado al evento de servidor. |
|
Nombre para mostrar del flujo de trabajo de eventos del servidor
|
workflowDisplayName | string |
Nombre para mostrar del flujo de trabajo asociado al evento de servidor. |
|
Categoría de flujo de trabajo de eventos de servidor
|
workflowCategory | string |
Categoría del flujo de trabajo asociado al evento de servidor. |
|
Id. de instancia de flujo de trabajo de eventos del servidor
|
workflowInstanceID | integer |
Identificador de instancia del flujo de trabajo asociado al evento de servidor. |
|
Folio de flujo de trabajo de eventos del servidor
|
workflowInstanceFolio | string |
La folio de la instancia de flujo de trabajo asociada al evento de servidor. |
|
Id. de instancia de actividad de evento del servidor
|
activityInstanceID | integer |
Identificador de instancia de actividad del evento de servidor. |
|
Id. de destino de la actividad de eventos del servidor
|
activityInstanceDestinationID | integer |
Identificador de destino de la instancia de actividad del evento de servidor. |
|
Nombre de la actividad de evento del servidor
|
activityName | string |
Nombre de la actividad del evento de servidor. |
|
Nombre del evento de servidor
|
eventName | string |
Nombre del evento del servidor. |
|
Descripción del evento de servidor
|
eventDescription | string |
Descripción del evento del servidor. |
|
originador
|
originator | User | |
|
eventInstance
|
eventInstance | EventInstanceWrapper | |
|
Campos de datos de actividad de eventos del servidor
|
dataFields | object |
Campos de datos de la actividad. |
|
Campos XML de actividad de eventos de servidor
|
xmlFields | array of UserDefinedXmlField |
Campos XML de la actividad. |
|
Referencias de elementos de evento de servidor
|
itemReferences | object |
Referencias de elemento de la instancia de flujo de trabajo. |
|
Cadena de campos de datos de flujo de trabajo de eventos de servidor
|
workflowInstanceDataFieldsString | string |
Representación de cadena de los campos de datos de la instancia de flujo de trabajo. |
|
Cadena de referencias de elemento de evento de servidor
|
itemReferencesString | string |
Cadena que representa las referencias de elemento de la instancia de flujo de trabajo. |
|
viewFlowURL
|
viewFlowURL | string |
EventInstance
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Fecha de inicio de la instancia de evento
|
StartDate | date-time |
Fecha y hora en que se inició la instancia de evento. |
|
Duración esperada de la instancia de evento
|
ExpectedDuration | integer |
Duración esperada de la instancia de evento. |
|
Prioridad de instancia de evento
|
Priority | integer |
Prioridad de la instancia de evento. |
|
Metadatos de instancia de evento
|
MetaData | string |
Metadatos de la instancia de evento. |
|
Descripción de la instancia de evento
|
Description | string |
Descripción de la instancia de evento. |
|
Nombre de instancia de evento
|
Name | string |
Nombre de la instancia de evento. |
|
Id. de instancia de evento
|
ID | integer |
Identificador de la instancia de evento. |
UserDefinedXmlField
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre del campo XML
|
name | string |
Nombre de un campo XML. |
|
Valor del campo XML
|
value | string |
Valor del campo XML. |
TareasResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento de tareas
|
itemCount | integer |
Recuento de tareas devueltas. |
|
Tasks
|
tasks | array of TaskLite |
Una o varias tareas. |
TaskLite
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de serie de tarea
|
serialNumber | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
|
Estado de la tarea
|
status | string |
Estado de la tarea. Por ejemplo: Open, Completed, Sleep, Allocated, Available |
|
Fecha de inicio de la tarea
|
taskStartDate | date-time |
Fecha de inicio de la tarea. |
|
Duración de suspensión de tareas
|
sleepUntil | date-time |
Fecha y hora en que se reactivará la tarea. |
|
Prioridad de tarea
|
priority | integer |
Prioridad de la tarea. |
|
Dirección URL del formulario de tareas
|
formURL | string |
Dirección URL del formulario de la tarea. |
|
Dirección URL del flujo de vista de tareas
|
viewFlowURL | string |
Dirección URL del flujo de vista de la tarea. |
|
Id. de flujo de trabajo de tarea
|
workflowID | integer |
Identificador del flujo de trabajo asociado a la tarea. |
|
Nombre del flujo de trabajo de tareas
|
workflowName | string |
Nombre del flujo de trabajo asociado a la tarea. |
|
Nombre para mostrar del flujo de trabajo de tareas
|
workflowDisplayName | string |
Nombre para mostrar del flujo de trabajo asociado a la tarea. |
|
Categoría de flujo de trabajo de tareas
|
workflowCategory | string |
Categoría del flujo de trabajo asociado a la tarea. |
|
Id. de instancia de flujo de trabajo de tarea
|
workflowInstanceID | integer |
Identificador de instancia del flujo de trabajo asociado a la tarea. |
|
Folio de flujo de trabajo de tareas
|
workflowInstanceFolio | string |
La folio de la instancia de flujo de trabajo asociada a la tarea. |
|
Id. de instancia de tarea
|
activityInstanceID | integer |
Identificador de instancia de actividad de la tarea. |
|
Id. de destino de la actividad de tarea
|
activityInstanceDestinationID | integer |
Identificador de destino de la instancia de actividad de la tarea. |
|
Nombre de la actividad de tarea
|
activityName | string |
Nombre de la actividad de la tarea. |
|
Nombre del evento de tarea
|
eventName | string |
Nombre del evento de la tarea. |
|
Descripción del evento de tarea
|
eventDescription | string |
Descripción del evento de la tarea. |
|
originador
|
originator | User | |
|
Acciones
|
actions | TaskActionsResponse | |
|
Instrucciones de tareas
|
instruction | string |
Las instrucciones asociadas a la tarea. |
Usuario
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre de usuario
|
username | string |
Nombre de usuario de la persona. |
|
FQN de usuario
|
fqn | string |
Nombre completo de la persona. Por ejemplo: bob@denallix.com, K2:Denallix\Bob |
|
Email de usuario
|
string |
Dirección de correo electrónico de la persona. |
|
|
Administrador de usuarios
|
manager | string |
Gerente de la persona. |
|
Nombre para mostrar del usuario
|
displayName | string |
Nombre para mostrar de la persona. |
TaskActionsResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Acciones no accesibles
|
nonBatchableActions | array of string |
Lista de acciones que no se pueden realizar sin asignar la tarea. |
|
Acciones por lotes
|
batchableActions | array of string |
Lista de acciones que se pueden realizar sin asignar la tarea. |
|
Acciones del sistema
|
systemActions | array of string |
Lista de acciones del sistema. |
Tarea
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de serie de tarea
|
serialNumber | string |
Número de serie de la tarea. Por ejemplo: 1234_5678 |
|
Estado de la tarea
|
status | string |
Estado de la tarea. Por ejemplo: Open, Completed, Sleep, Allocated, Available |
|
Fecha de inicio de la tarea
|
taskStartDate | date-time |
Fecha de inicio de la tarea. |
|
Duración de suspensión de tareas
|
sleepUntil | date-time |
Fecha y hora en que se reactivará la tarea. |
|
Prioridad de tarea
|
priority | integer |
Prioridad de la tarea. |
|
Dirección URL del formulario de tareas
|
formURL | string |
Dirección URL del formulario de la tarea. |
|
Dirección URL del flujo de vista de tareas
|
viewFlowURL | string |
Dirección URL del flujo de vista de la tarea. |
|
Id. de flujo de trabajo de tarea
|
workflowID | integer |
Identificador del flujo de trabajo asociado a la tarea. |
|
Nombre del flujo de trabajo de tareas
|
workflowName | string |
Nombre del flujo de trabajo asociado a la tarea. |
|
Nombre para mostrar del flujo de trabajo de tareas
|
workflowDisplayName | string |
Nombre para mostrar del flujo de trabajo asociado a la tarea. |
|
Categoría de flujo de trabajo de tareas
|
workflowCategory | string |
Categoría del flujo de trabajo asociado a la tarea. |
|
Id. de instancia de flujo de trabajo de tarea
|
workflowInstanceID | integer |
Identificador de instancia del flujo de trabajo asociado a la tarea. |
|
Folio de flujo de trabajo de tareas
|
workflowInstanceFolio | string |
La folio de la instancia de flujo de trabajo asociada a la tarea. |
|
Id. de instancia de tarea
|
activityInstanceID | integer |
Identificador de instancia de actividad de la tarea. |
|
Id. de destino de tarea
|
activityInstanceDestinationID | integer |
Identificador de destino de la instancia de actividad de la tarea. |
|
Nombre de la actividad de tarea
|
activityName | string |
Nombre de la actividad de la tarea. |
|
Nombre del evento de tarea
|
eventName | string |
Nombre del evento de la tarea. |
|
Descripción del evento de tarea
|
eventDescription | string |
Descripción del evento de la tarea. |
|
originador
|
originator | User | |
|
Acciones
|
actions | TaskActionsResponse | |
|
Campos de datos de flujo de trabajo de tareas
|
workflowInstanceDataFields | object |
Campos de datos de la instancia de flujo de trabajo. |
|
Campos de datos de actividad de tareas
|
activityDataFields | object |
Campos de datos de la actividad. |
|
Campos XML de flujo de trabajo de tareas
|
workflowInstanceXmlFields | array of UserDefinedXmlField |
Campos XML de la instancia de flujo de trabajo. |
|
Referencias de elementos de tarea
|
itemReferences | object |
Referencias de elemento de la instancia de flujo de trabajo. |
|
instrucción
|
instruction | string | |
|
Cadena de campos de datos de flujo de trabajo de tareas
|
workflowInstanceDataFieldsString | string |
Representación de cadena de los campos de datos de la instancia de flujo de trabajo. |
|
Cadena de referencias de elemento de tarea
|
itemReferencesString | string |
Cadena que representa las referencias de elemento de la instancia de flujo de trabajo. |
WorkflowLabelsResponse[WorkflowLabel]
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Número de elementos
|
itemCount | integer |
Número de flujos de trabajo. |
|
Workflows
|
workflows | array of WorkflowLabel |
Lista de flujos de trabajo. |
WorkflowLabel
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de flujo de trabajo
|
id | integer |
Identificador del flujo de trabajo. |
|
Versión predeterminada del flujo de trabajo
|
defaultVersionId | integer |
Versión predeterminada del flujo de trabajo. |
|
Nombre del flujo de trabajo
|
name | string |
Nombre del flujo de trabajo. |
|
Carpeta de flujo de trabajo
|
folder | string |
Carpeta de flujo de trabajo. |
|
Nombre del sistema de flujo de trabajo
|
systemName | string |
Nombre del sistema de flujo de trabajo. |
WorkflowDataResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
workflowInfo
|
workflowInfo | WorkflowDefinition | |
|
Esquema de flujo de trabajo
|
workflowSchema | string |
Esquema del flujo de trabajo. |
WorkflowDefinition
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre del flujo de trabajo
|
name | string |
El nombre del flujo de trabajo. |
|
Descripción del flujo de trabajo
|
description | string |
La descripción del flujo de trabajo. |
|
Carpeta de flujo de trabajo
|
folder | string |
Carpeta (categoría) del flujo de trabajo. |
|
Nombre del sistema de flujo de trabajo
|
systemName | string |
Nombre del sistema del flujo de trabajo. |
|
Duración esperada del flujo de trabajo
|
expectedDuration | integer |
Duración esperada del flujo de trabajo. |
EventInstanceWrapper
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
EventInstance
|
EventInstance | EventInstance | |
|
Descripción de la instancia de evento
|
Description | string |
Descripción de la instancia de evento. |
|
Duración esperada de la instancia de evento
|
ExpectedDuration | integer |
Duración esperada de la instancia de evento. |
|
Id. de instancia de evento
|
ID | integer |
Identificador de la instancia de evento. |
|
Metadatos de instancia de evento
|
MetaData | string |
Metadatos de la instancia de evento. |
|
Nombre de instancia de evento
|
Name | string |
Nombre de la instancia de evento. |
|
Prioridad de instancia de evento
|
Priority | integer |
Prioridad de la instancia de evento. |
|
Fecha de inicio de la instancia de evento
|
StartDate | date-time |
Fecha y hora en que se inició la instancia de evento. |
entero
Este es el tipo de datos básico "entero".
objeto
Este es el tipo 'objeto'.