Cireson Service Manager Portal
Crear y actualizar elementos de trabajo a través del portal de Cireson para System Center Service Manager
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 | Cireson |
| URL | https://cireson.com |
| Correo Electrónico | support@cireson.com |
| Metadatos del conector | |
|---|---|
| Publicador | Cireson |
| Sitio web | https://cireson.com/ |
| Directiva de privacidad | https://cireson.com/privacy-statement/ |
| Categorías | IA; Sitio web |
Amplíe la inversión en el portal de Cireson Service Manager en el ecosistema M365 con la capacidad de controlar elementos de trabajo desde Power Automate.
Prerrequisitos
Necesitará una licencia activa del portal de Cireson Service Manager y el portal debe estar accesible desde Internet.
Obtención de credenciales
Cree un token de plataforma (API) en el portal de Service Manager como se describe en https://kb.cireson.com/article/user-guide-authentication-tokens-and-knowledge-base-reporting/2507.
Introducción al conector
Se admiten varias operaciones comunes, como:
- Cuando se agrega un nuevo comentario
- Este evento se produce cada vez que se agrega un comentario a cualquier elemento de trabajo. Puede filtrar este evento a comentarios de analistas o comentarios del usuario final.
- Cuando se crea un nuevo elemento de trabajo
- Este evento se produce cada vez que se crea un elemento de trabajo. Puede filtrar este evento por incidente, solicitud de servicio, solicitud de cambio, problema o registro de versión.
- Crear o actualizar un elemento de trabajo
- Esta acción se puede usar para cambiar las propiedades comunes de un elemento de trabajo, como Título, Descripción, Prioridad, Urgencia, así como el Usuario asignado o afectado por su dirección de correo electrónico. Mediante el uso de la dirección de correo electrónico de un usuario, puede vincular otras integraciones de M365 en las que se usa un correo electrónico para identificar a un usuario.
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 |
|---|---|---|---|
| URL del portal | cuerda / cadena | Service Manager Portal URL | Cierto |
| APIKey | securestring | ApiKey para esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar registro de versión |
Actualizar releaseRecord |
| Actualizar solicitud de cambio |
Actualizar solicitud de cambio |
| Actualizar solicitud de servicio |
Actualizar solicitud de servicio |
| Actualizar un incidente |
Actualizar un incidente |
| Agregar comentario al elemento de trabajo |
Agregar comentarios del registro de acciones a un elemento de trabajo |
| Creación de un incidente |
Creación de un incidente |
| Creación de una solicitud de servicio |
Creación de una solicitud de servicio |
| Crear un problema |
Crear un problema |
| Crear un registro de versión |
Crear un registro de versión |
| Crear una solicitud de cambio |
Crear una solicitud de cambio |
| Eliminar elemento de trabajo |
Eliminar elemento de trabajo |
| Obtener elemento de trabajo |
Obtener los datos del elemento de trabajo según el identificador |
| Problema de actualización |
Problema de actualización |
Actualizar registro de versión
Actualizar releaseRecord
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Tipo
|
Type | string |
Tipo |
|
|
Categoría
|
Category | string |
Categoría |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Riesgo
|
Risk | string |
Riesgo |
|
|
Priority
|
Priority | string |
Priority |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Actualizar solicitud de cambio
Actualizar solicitud de cambio
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | string |
Priority |
|
|
Area
|
Area | string |
Area |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Riesgo
|
Risk | string |
Riesgo |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Actualizar solicitud de servicio
Actualizar solicitud de servicio
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | integer |
Priority |
|
|
Classification
|
Classification | string |
Classification |
|
|
Urgencia
|
Urgency | string |
Urgencia |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Fuente
|
Source | string |
Fuente |
|
|
Grupo de soporte técnico
|
SupportGroup | string |
Grupo de soporte técnico |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario afectado
|
RequestedWorkItem | string |
Usuario afectado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Actualizar un incidente
Actualizar un incidente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | integer |
Priority |
|
|
Classification
|
Classification | string |
Classification |
|
|
Urgencia
|
Urgency | string |
Urgencia |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Fuente
|
Source | string |
Fuente |
|
|
Grupo de soporte técnico
|
SupportGroup | string |
Grupo de soporte técnico |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario afectado
|
RequestedWorkItem | string |
Usuario afectado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Agregar comentario al elemento de trabajo
Agregar comentarios del registro de acciones a un elemento de trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
id | True | string |
Id. de elemento de trabajo |
|
Comentario
|
Description | string |
Comentario |
|
|
Agregado por
|
EnteredBy | string |
Agregado por |
|
|
Es privado
|
IsPrivate | boolean |
Es privado |
|
|
Tipo de comentario
|
ActionType | string |
Tipo de comentario |
Devoluciones
Creación de un incidente
Creación de un incidente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | integer |
Priority |
|
|
Classification
|
Classification | True | string |
Classification |
|
Urgencia
|
Urgency | True | string |
Urgencia |
|
Impacto
|
Impact | True | string |
Impacto |
|
Fuente
|
Source | True | string |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | string |
Grupo de soporte técnico |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario afectado
|
RequestedWorkItem | string |
Usuario afectado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Creación de una solicitud de servicio
Creación de una solicitud de servicio
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | string |
Priority |
|
|
Area
|
Area | True | string |
Area |
|
Urgencia
|
Urgency | True | string |
Urgencia |
|
Fuente
|
Source | True | string |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | string |
Grupo de soporte técnico |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario afectado
|
RequestedWorkItem | string |
Usuario afectado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Crear un problema
Crear un problema
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | string |
Priority |
|
|
Fuente
|
Source | string |
Fuente |
|
|
Categoría
|
Category | string |
Categoría |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Urgencia
|
Urgency | string |
Urgencia |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Crear un registro de versión
Crear un registro de versión
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Tipo
|
Type | string |
Tipo |
|
|
Categoría
|
Category | string |
Categoría |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Riesgo
|
Risk | string |
Riesgo |
|
|
Priority
|
Priority | string |
Priority |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Crear una solicitud de cambio
Crear una solicitud de cambio
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | string |
Priority |
|
|
Area
|
Area | string |
Area |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Riesgo
|
Risk | string |
Riesgo |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Eliminar elemento de trabajo
Eliminar elemento de trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje
|
message | string |
Mensaje |
|
correcto
|
success | boolean |
correcto |
|
datos
|
data | string |
datos |
|
excepción
|
exception | string |
excepción |
|
BaseId
|
BaseId | string |
BaseId |
Obtener elemento de trabajo
Obtener los datos del elemento de trabajo según el identificador
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
WorkItemId | True | string |
Id. de elemento de trabajo |
Devoluciones
- Body
- WorkItem_GetResponse
Problema de actualización
Problema de actualización
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de elemento de trabajo
|
Id | True | string |
Id. de elemento de trabajo |
|
Title
|
Title | string |
Title |
|
|
Description
|
Description | string |
Description |
|
|
Priority
|
Priority | string |
Priority |
|
|
Fuente
|
Source | string |
Fuente |
|
|
Categoría
|
Category | string |
Categoría |
|
|
Impacto
|
Impact | string |
Impacto |
|
|
Urgencia
|
Urgency | string |
Urgencia |
|
|
Estado
|
Status | string |
Estado |
|
|
Usuario asignado
|
AssignedWorkItem | string |
Usuario asignado |
Devoluciones
Desencadenadores
| Cuando se agrega un nuevo comentario |
Cuando se agrega un nuevo comentario |
| Cuando se crea un nuevo elemento de trabajo |
Cuando se crea un nuevo elemento de trabajo |
Cuando se agrega un nuevo comentario
Cuando se agrega un nuevo comentario
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de comentario
|
WorkItemClassType | True | string |
Tipo de comentario |
Devoluciones
Cuando se crea un nuevo elemento de trabajo
Cuando se crea un nuevo elemento de trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de elemento de trabajo
|
WorkItemClassType | True | string |
Tipo de clase de elemento de trabajo |
Devoluciones
Definiciones
WorkItem_CreatedSRResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
Title
|
Title | string |
Title |
|
Description
|
Description | string |
Description |
|
Priority
|
Priority | object |
Priority |
|
Classification
|
Classification | object |
Classification |
|
Urgencia
|
Urgency | object |
Urgencia |
|
Impacto
|
Impact | object |
Impacto |
|
Fuente
|
Source | object |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | object |
Grupo de soporte técnico |
|
Estado
|
Status | object |
Estado |
|
Usuario asignado
|
AssignedWorkItem | object |
Usuario asignado |
|
Usuario afectado
|
RequestedWorkItem | object |
Usuario afectado |
WorkItem_CreatedIRResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
Title
|
Title | string |
Title |
|
Description
|
Description | string |
Description |
|
Priority
|
Priority | integer |
Priority |
|
Urgencia
|
Urgency | object |
Urgencia |
|
Impacto
|
Impact | object |
Impacto |
|
Fuente
|
Source | object |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | object |
Grupo de soporte técnico |
|
Estado
|
Status | object |
Estado |
|
Usuario asignado
|
AssignedWorkItem | object |
Usuario asignado |
|
Usuario afectado
|
RequestedWorkItem | object |
Usuario afectado |
WorkItem_GetResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
Title
|
Title | string |
Title |
|
Description
|
Description | string |
Description |
|
Priority
|
PriorityText | string |
Priority |
|
Classification
|
Classification | object |
Classification |
|
Urgencia
|
Urgency | object |
Urgencia |
|
Impacto
|
Impact | object |
Impacto |
|
Fuente
|
Source | object |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | object |
Grupo de soporte técnico |
|
Estado
|
Status | object |
Estado |
|
Usuario asignado
|
AssignedWorkItem | object |
Usuario asignado |
|
Usuario afectado
|
RequestedWorkItem | object |
Usuario afectado |
WorkItem_WebhookResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
Title
|
Title | string |
Title |
|
Description
|
Description | string |
Description |
|
Priority
|
Priority |
Priority |
|
|
Classification
|
Classification | object |
Classification |
|
Urgencia
|
Urgency | object |
Urgencia |
|
Impacto
|
Impact | object |
Impacto |
|
Fuente
|
Source | object |
Fuente |
|
Grupo de soporte técnico
|
SupportGroup | object |
Grupo de soporte técnico |
|
Estado
|
Status | object |
Estado |
|
Usuario asignado
|
AssignedWorkItem | object |
Usuario asignado |
|
Usuario afectado
|
RequestedWorkItem | object |
Usuario afectado |
WorkItem_ActionLogResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
Title
|
Title | string |
Title |
|
Se aplica al vale de problemas
|
AppliesToTroubleTicket |
Entradas del registro de acciones para incidentes y problemas |
|
|
Se aplica a WorkItem
|
AppliesToWorkItem |
Entradas del registro de acciones para workitems |
WorkItem_ActionLogWebhookResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de elemento de trabajo
|
WorkItemID | string |
Id. de elemento de trabajo |
|
Introducido por
|
EnteredBy | string |
Introducido por |
|
Es privado
|
IsPrivate | boolean |
Es privado |
|
Comentario
|
Description | string |
Comentario |
|
Fecha de ingreso
|
EnteredDate | string |
Fecha de ingreso |
|
Fecha de última modificación
|
LastModified | string |
Fecha de última modificación |