ALVAO
Alvao le permite automatizar acciones en Alvao Service Desk y Asset Management e integrarlas con otras aplicaciones.
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 | Compatibilidad con ALVAO |
| URL | https://www.alvao.com/en/support-and-services |
| Correo Electrónico | support@alvao.com |
| Metadatos del conector | |
|---|---|
| Publicador | ALVAO |
| Sitio web | https://www.alvao.com |
| Directiva de privacidad | https://www.alvao.com/en/privacystatement |
| Categorías | Colaboración;Operaciones de TI |
Con este conector, puede usar Power Automate, Power Apps o Azure Logic Apps para automatizar acciones en Alvao o para integrar Alvao con otras aplicaciones. El conector permite iniciar automatizaciones vinculadas no solo al flujo de trabajo de vales en service Desk, sino también al ciclo de vida de los recursos registrados en asset Management. Después, las acciones del conector permiten mover el flujo de trabajo del vale o administrar el ciclo de vida de los recursos.
Prerrequisitos
Deberá ser un cliente de ALVAO (SaaS o local) con una versión de ALVAO al menos 11.1 y tener la API REST disponible desde Internet.
Obtención de credenciales
- Cree una cuenta de aplicación en
Alvao WebAppUsers-Administration- . - Establezca al menos y
Name and Surnamehabilite la opciónApplication account-Other applications.User name - Establezca una contraseña en esta cuenta.
- Establezca los permisos adecuados para que la cuenta funcione con vales o recursos.
- Use y
User namePasswordde esta cuenta para crear una conexión a este conector.
Nota: También necesitará la dirección URL de la API REST de Alvao que puede encontrar en
Alvao WebAppSettings-Web servicesAdministration- - .
Introducción al conector
Después de crear la conexión, puede usar varios desencadenadores o acciones.
Por ejemplo, conceda permiso para leer una carpeta en SharePoint mediante un flujo automatizado basado en la aprobación de un vale en alvao Service Desk:
- Use el
When a ticket transitions to a statusdesencadenador y especifique el nombre del proceso y el estado en el que se va a desencadenar el flujo. - A continuación, agregue la
Get Ticketacción y, como entrada, escriba elTicket IDelemento disponible en el desencadenador. - A continuación, use por ejemplo el correo electrónico del solicitante que obtuvo de la acción y úselo para buscar al usuario en M365 y asignarle los permisos adecuados.
Otras acciones también pueden ayudarle con las automatizaciones de Asset Management. Por ejemplo, acciones para crear un recurso, cambiar los valores de sus propiedades o moverlos dentro del registro. Si necesita importar periódicamente recursos desde otro sistema, puede usar la acción Import objects from CSV.
Problemas y limitaciones conocidos
- Todos los desencadenadores solo están disponibles en ALVAO 11.2 o superior.
- Estas acciones solo están disponibles en ALVAO 11.2 o superior:
- Crear objeto
- Obtener objeto
- Obtener objetos
- Actualizar las propiedades del objeto
- Mover objetos
- Obtener usuarios
- Importación de objetos desde CSV
- Algunas acciones requieren un identificador de entidad como entrada, que debe existir en Alvao. Estos identificadores normalmente se encuentran en la aplicación web de Alvao al final de la dirección URL en sus páginas de edición o detalle.
Errores y soluciones comunes
- 403 Prohibido: compruebe si la cuenta de aplicación usada tiene todos los permisos necesarios para realizar la acción. Compruebe también las credenciales usadas en la conexión.
- 404 No encontrado: compruebe que todos los parámetros de entrada son correctos y que la dirección URL de la API REST es correcta en la conexión. Compruebe si la acción está disponible en la versión de ALVAO.
Preguntas más frecuentes
Campos personalizados
El conector también admite la lectura y escritura de valores desde o hacia campos personalizados de vale. Los campos personalizados no se pueden describir en la definición del conector general, por lo que debe usar las siguientes técnicas para procesarlos.
Para leer un valor del campo personalizado de un vale, use expresiones en la Get ticket acción. Por ejemplo, para leer el valor del campo TicketCategory, use la expresión :
outputs('Get_request')?['body/customItems/TicketCategory/value']
Para escribir un valor en el campo personalizado de un vale, use la Update ticket acción con una especificación JSON personalizada. Por ejemplo, para escribir el valor de "monitor failure" en el campo TicketCategory, use esta especificación en el Custom Items campo :
{
"TicketCategory": {
"@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
"name": "TicketCategory",
"value": "monitor failure"
}
}
Nota: El carácter "@" se duplica debido al escape.
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 |
|---|---|---|---|
| Host | cuerda / cadena | Especificar la dirección URL del host de la API REST de ALVAO | Cierto |
| Nombre de usuario | cuerda / cadena | El nombre de usuario de la cuenta de aplicación ALVAO | Cierto |
| Contraseña | securestring | La contraseña de la cuenta de aplicación ALVAO | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar las propiedades del objeto |
Actualiza las propiedades del objeto. |
| Asignar vale al solucionador o al equipo de solucionador |
Asigna vale al solucionador o al equipo de solucionador. |
| Cambio del estado del vale |
Cambia el estado del vale. También se puede usar para resolver o volver a abrir el vale. Se requiere el identificador de estado o el nombre de estado. |
| Creación de un registro en el registro de vales |
Crea un registro en el registro de vales. |
| Crear entrada |
Crea un nuevo vale. |
| Crear objeto |
Crea un nuevo objeto a partir de una plantilla especificada en el objeto especificado. |
| Importación de objetos desde CSV |
Importa objetos proporcionados en formato CSV. Funcionalidad similar a la utilidad ImportUtil. |
| Move (objeto) |
Mueve un objeto a un destino especificado. |
| Mover vale a otro servicio |
Mueve el vale a otro servicio. Se requiere el identificador de servicio o el nombre del servicio. |
| Obtener objeto |
Devuelve el objeto con sus propiedades. |
| Obtener objetos |
Devuelve objetos con sus propiedades según los parámetros de OData. |
| Obtener usuarios |
Devuelve los usuarios y sus propiedades según los parámetros de OData. |
| Obtener vale |
Devuelve las propiedades del vale. |
| Vale de actualización |
Actualiza las columnas de vale. Establezca solo las propiedades que se van a cambiar. Para cambiar el acuerdo de nivel de servicio, establezca slaId o slaName. Para cambiar el solicitante, establezca solo el identificador del solicitante o todos los datos del solicitante (usuario no registrado). |
Actualizar las propiedades del objeto
Actualiza las propiedades del objeto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Objeto
|
objectId | True | integer |
Seleccione el objeto o escriba su identificador (tblNode.intNodeId). |
|
Nombre
|
name | string |
Seleccione la propiedad del objeto . |
|
|
Importancia
|
value | string |
Especifique el valor de la propiedad . |
Asignar vale al solucionador o al equipo de solucionador
Asigna vale al solucionador o al equipo de solucionador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
|
Identificador del solucionador
|
solverId | integer |
Nuevo identificador de solucionador (tPerson.iPersonId). |
|
|
Identificador de equipo de Solver
|
solverTeamId | integer |
Nuevo identificador de equipo del solucionador (tRole.iPersonId). |
|
|
Message
|
messageForSolverHtml | string |
Mensaje para solver o para el equipo de solucionador en HTML. |
|
|
Bytes de contenido
|
contentBytes | string |
Contenido codificado en Base64. |
|
|
Tipo de contenido
|
contentType | string |
Tipo de contenido, por ejemplo, image/png. |
|
|
Nombre de contenido
|
name | string |
Nombre del contenido. |
Devoluciones
- response
- string
Cambio del estado del vale
Cambia el estado del vale. También se puede usar para resolver o volver a abrir el vale. Se requiere el identificador de estado o el nombre de estado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
|
Id. de estado
|
stateId | integer |
Nuevo identificador de estado (TicketState.id). |
|
|
Nombre de estado
|
stateName | string |
Nuevo nombre de estado. |
|
|
Comentario
|
commentHtml | string |
Comentario en HTML. |
|
|
Comentario para aprobadores
|
commentForApprovers | string |
Comentario para aprobadores en HTML. |
|
|
Comentario para los solicitantes
|
commentForRequesters | string |
Comentario para los solicitantes en HTML. |
|
|
Bytes de contenido
|
contentBytes | string |
Contenido codificado en Base64. |
|
|
Tipo de contenido
|
contentType | string |
Tipo de contenido, por ejemplo, image/png. |
|
|
Nombre de contenido
|
name | string |
Nombre del contenido. |
Devoluciones
- response
- string
Creación de un registro en el registro de vales
Crea un registro en el registro de vales.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
|
Asunto
|
subject | True | string |
Asunto del registro. |
|
Contenido html
|
contentHtml | string |
Contenido del registro en Html. |
|
|
Contenido de texto sin formato
|
contentPlain | string |
Contenido del registro en texto sin formato. |
|
|
Kind
|
kind | True | string |
Tipo de registro. |
|
Nombre del remitente
|
from | string |
Nombre del remitente. |
|
|
Desde correo electrónico
|
emailFrom | string |
Correo electrónico del remitente. |
|
|
Para
|
emailTo | string |
Destinatarios del mensaje separados por punto y coma. |
|
|
Copiar
|
emailCc | string |
Destinatarios del mensaje separados por punto y coma. |
|
|
Id. de persona
|
fromPersonId | integer |
Id. de persona del autor (tPerson.iPersonId). |
|
|
Id. de persona
|
toPersonId | integer |
Id. de persona del receptor (tPerson.iPersonId). |
|
|
Fecha de creación
|
created | string |
Fecha y hora en la que se debe crear el registro. Deje vacío para actual. |
|
|
Mostrar al solicitante
|
showToRequester | boolean |
Decida si el solicitante debe ver el registro. |
|
|
Bytes de contenido
|
contentBytes | string |
Contenido codificado en Base64. |
|
|
Tipo de contenido
|
contentType | string |
Tipo de contenido, por ejemplo, image/png. |
|
|
Nombre de contenido
|
name | string |
Nombre del contenido. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de registro
|
id | integer |
Id. de registro de registro (tAct.iActId). |
|
Asunto
|
subject | string |
Asunto del registro. |
|
Contenido html
|
contentHtml | string |
Registro del contenido del registro en HTML. |
|
Contenido de texto sin formato
|
contentPlain | string |
Registrar contenido del registro en texto sin formato. |
|
Fecha de creación
|
created | string |
Fecha de creación del registro. |
|
Kind
|
kind | string |
Tipo de registro de registro. |
|
Nombre del remitente
|
from | string |
Nombre del autor del registro. |
|
Desde correo electrónico
|
emailFrom | string |
Correo electrónico del autor del registro. |
|
Para
|
emailTo | string |
Los receptores de registros registran correos electrónicos. |
|
Copiar
|
emailCc | string |
Los receptores de registros registran correos electrónicos. |
|
Id. de persona
|
fromPersonId | integer |
Id. del remitente del registro de registro (tPerson.iPersonId). |
|
Id. de persona
|
toPersonId | integer |
Id. del receptor del registro de registro (tPerson.iPersonId). |
|
Id. de mensaje
|
messageId | string |
Id. de mensaje de registro de registro. |
|
Attachments
|
attachments | array of object |
Datos adjuntos del registro de registros. |
|
Nombre de datos adjuntos
|
attachments.name | string |
Nombre de datos adjuntos. |
|
Id. de datos adjuntos
|
attachments.id | integer |
Id. de datos adjuntos (tDocument.iDocumentId). |
|
Vínculo de datos adjuntos
|
attachments.link | string |
Vínculo a los datos adjuntos. |
Crear entrada
Crea un nuevo vale.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de servicio
|
serviceId | True | integer |
Identificador del servicio de vales (tHdSection.iHdSectionId). |
|
Nombre
|
name | True | string |
Nombre del vale. |
|
Description
|
descriptionHtml | string |
Descripción del vale en HTML. |
|
|
Id. de Acuerdo de Nivel de Servicio
|
slaId | integer |
Id. de Acuerdo de Nivel de Servicio (tSla.iSlaId). |
|
|
Priority
|
priority | string |
Prioridad del vale. |
|
|
Impacto
|
impact | string |
Impacto del vale. |
|
|
Urgencia
|
urgency | string |
Urgencia del vale. |
|
|
Número de dispositivo
|
deviceNumber | string |
Número de dispositivo del vale. |
|
|
Organización relacionada
|
relatedOrganization | string |
Nombre de la organización relacionada con el vale. |
|
|
Solicitado para el identificador de persona
|
requestedForPersonId | integer |
Se solicitó para el identificador de persona (tPerson.iPersonId). |
|
|
identificación
|
id | integer |
Id. del solicitante (tPerson.iPersonId). |
|
|
Nombre
|
name | string |
Nombre del solicitante. |
|
|
Correo electrónico
|
string |
Correo electrónico del solicitante. |
||
|
Correo electrónico 2
|
email2 | string |
Correo electrónico del solicitante 2. |
|
|
Teléfono
|
phone | string |
Teléfono del solicitante. |
|
|
Teléfono 2
|
phone2 | string |
Teléfono del solicitante 2. |
|
|
Teléfono móvil
|
mobilePhone | string |
Teléfono móvil solicitante. |
|
|
Departamento
|
department | string |
Departamento del solicitante. |
|
|
Oficina
|
office | string |
Oficina del solicitante. |
|
|
Puesto de trabajo
|
workPosition | string |
Puesto de trabajo del solicitante. |
|
|
Organización
|
organization | string |
Organización del solicitante. |
|
|
Otros contactos
|
otherContacts | string |
Solicitar otros contactos. |
|
|
Objetos
|
objects | array of integer |
Vínculos a objetos. |
|
|
Bytes de contenido
|
contentBytes | string |
Contenido codificado en Base64. |
|
|
Tipo de contenido
|
contentType | string |
Tipo de contenido, por ejemplo, image/png. |
|
|
Nombre de contenido
|
name | string |
Nombre del contenido. |
|
|
Elementos personalizados
|
customItems | object |
Entradas personalizadas (tHdTicketCust). |
Devoluciones
- Body
- SD.Ticket
Crear objeto
Crea un nuevo objeto a partir de una plantilla especificada en el objeto especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Template
|
templateObjectId | True | integer |
Seleccione la plantilla de objeto o escriba su identificador (tblNode.intNodeId). |
|
Objeto primario
|
parentObjectId | integer |
Seleccione el objeto primario o escriba su identificador (tblNode.intNodeId). |
Devoluciones
- Body
- AM.Object
Importación de objetos desde CSV
Importa objetos proporcionados en formato CSV. Funcionalidad similar a la utilidad ImportUtil.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
CSV
|
contentCsv | True | string |
Contenido CSV que se va a importar. |
|
Tipo de objeto
|
objectTypeId | integer |
Tipo de objetos importados. |
|
|
Formato datetime
|
dateTimeFormat | string |
Formato datetime en cadenas de texto (por ejemplo, dd/MM/aaaa). |
|
|
Separador
|
separator | string |
Separador de columna usado en el CSV importado. |
|
|
Omitir errores
|
skipErrors | boolean |
Si está habilitado, los datos se importan incluso si hay un error en una de las entradas. |
|
|
Propiedades importantes
|
keyFields | string |
Campos clave usados para identificar y actualizar objetos existentes (por ejemplo, número de serie, modelo). |
|
|
Objeto primario
|
createUnderObjectId | integer |
Objeto primario para crear nuevos objetos. |
|
|
Actualizar objetos descartados
|
updateDiscardedObjects | boolean |
Si está habilitado, los objetos descartados también se buscan y actualizan en la importación. |
Devoluciones
- Body
- AM.ImportCsvResponse
Move (objeto)
Mueve un objeto a un destino especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Objeto
|
objectId | True | integer |
Seleccione el objeto o escriba su identificador (tblNode.intNodeId). |
|
Objeto destination
|
parentObjectId | integer |
Seleccione el objeto de destino o escriba su identificador (tblNode.intNodeId). |
Mover vale a otro servicio
Mueve el vale a otro servicio. Se requiere el identificador de servicio o el nombre del servicio.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
|
Id. de servicio
|
serviceId | integer |
Nuevo identificador de servicio (tHdSection.iHdSectionId). |
|
|
Nombre del servicio
|
serviceName | string |
Nuevo nombre de servicio. |
|
|
Identificador del solucionador
|
newSolverId | integer |
Nuevo identificador de solucionador (tPerson.iPersonId). |
|
|
Identificador de equipo de Solver
|
newSolverTeamId | integer |
Nuevo identificador de equipo del solucionador (tRole.iPersonId). |
|
|
Comentario
|
commentHtml | string |
Comentario en HTML. |
|
|
Bytes de contenido
|
contentBytes | string |
Contenido codificado en Base64. |
|
|
Tipo de contenido
|
contentType | string |
Tipo de contenido, por ejemplo, image/png. |
|
|
Nombre de contenido
|
name | string |
Nombre del contenido. |
Devoluciones
- response
- string
Obtener objeto
Devuelve el objeto con sus propiedades.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Objeto
|
objectId | True | integer |
Seleccione el objeto o escriba su identificador (tblNode.intNodeId). |
Devoluciones
- Body
- AM.ObjectExpanded
Obtener objetos
Devuelve objetos con sus propiedades según los parámetros de OData.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Arriba
|
$top | integer |
Especifique el número de objetos que desea devolver. |
|
|
Search
|
$search | string |
Especifique la condición de búsqueda de texto completo. OData $search. |
|
|
Filter
|
$filter | string |
Especifique el filtro, por ejemplo, Nombre eq "Leche". OData $filter. |
|
|
Ordenar por
|
$orderBy | string |
Especifique el orden. OData $orderBy. |
Devoluciones
Obtener usuarios
Devuelve los usuarios y sus propiedades según los parámetros de OData.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Arriba
|
$top | integer |
Especifique el número de objetos que desea devolver. |
|
|
Search
|
$search | string |
Especifique la condición de búsqueda de texto completo. OData $search. |
|
|
Filter
|
$filter | string |
Especifique el filtro, por ejemplo, correo electrónico eq "james.smith@contoso.com". OData $filter. |
|
|
Ordenar por
|
$orderBy | string |
Especifique el orden. OData $orderBy. |
Devoluciones
Obtener vale
Devuelve las propiedades del vale.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
Devoluciones
- Body
- SD.Ticket
Vale de actualización
Actualiza las columnas de vale. Establezca solo las propiedades que se van a cambiar. Para cambiar el acuerdo de nivel de servicio, establezca slaId o slaName. Para cambiar el solicitante, establezca solo el identificador del solicitante o todos los datos del solicitante (usuario no registrado).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de vale
|
ticketId | True | integer |
Especifique el identificador del vale (tHdTicket.iHdTicketId). |
|
Nombre
|
name | string |
Nombre del vale. |
|
|
Priority
|
priority | string |
Prioridad del vale. |
|
|
Impacto
|
impact | string |
Impacto del vale. |
|
|
Urgencia
|
urgency | string |
Urgencia del vale. |
|
|
Id. de Acuerdo de Nivel de Servicio
|
slaId | integer |
Id. de Acuerdo de Nivel de Servicio (tSla.iSlaId). |
|
|
Nombre del Acuerdo de Nivel de Servicio
|
slaName | string |
Nombre del Acuerdo de Nivel de Servicio del vale. |
|
|
Número de dispositivo
|
deviceNumber | string |
Número de dispositivo del vale. |
|
|
Organización relacionada
|
relatedOrganization | string |
Nombre de la organización relacionada con el vale. |
|
|
Fecha de destino interna
|
internalTargetDate | date-time |
Fecha de destino interna del vale. |
|
|
Destino interno
|
internalTarget | string |
Destino interno del vale. |
|
|
Nombre
|
name | string |
Nombre del solicitante. |
|
|
Correo electrónico
|
string |
Correo electrónico del solicitante. |
||
|
Correo electrónico 2
|
email2 | string |
Correo electrónico del solicitante 2. |
|
|
Teléfono
|
phone | string |
Teléfono del solicitante. |
|
|
Teléfono 2
|
phone2 | string |
Teléfono del solicitante 2. |
|
|
Teléfono móvil
|
mobilePhone | string |
Teléfono móvil solicitante. |
|
|
Departamento
|
department | string |
Departamento del solicitante. |
|
|
Oficina
|
office | string |
Oficina del solicitante. |
|
|
Puesto de trabajo
|
workPosition | string |
Puesto de trabajo del solicitante. |
|
|
Organización
|
organization | string |
Organización del solicitante. |
|
|
Otros contactos
|
otherContacts | string |
Los demás contactos del solicitante. |
|
|
Elementos personalizados
|
customItems | object |
Entradas personalizadas (tHdTicketCust). |
Desencadenadores
| Cuando se cambia un valor de campo de vale |
Esta operación se desencadena cuando se cambia un valor de campo de vale determinado. |
| Cuando se cambia un valor de una propiedad de objeto |
Esta operación se desencadena cuando se cambia un valor de una propiedad de objeto determinada. |
| Cuando se crea un objeto |
Esta operación se desencadena cuando se crea un objeto de un tipo determinado. |
| Cuando se mueve un objeto |
Esta operación se desencadena cuando un objeto de un tipo determinado se mueve a una posición diferente en el árbol de objetos. |
| Cuando un vale cambia a un estado |
Esta operación se desencadena cuando un vale pasa a un estado determinado. |
Cuando se cambia un valor de campo de vale
Esta operación se desencadena cuando se cambia un valor de campo de vale determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Campo
|
fieldId | True | integer |
Seleccione un campo de vale. |
|
Proceso
|
process | string |
Escriba el nombre del proceso para el que desea desencadenar este flujo. |
|
|
Service
|
service | string |
Escriba el nombre del servicio para el que desea desencadenar este flujo. |
Devoluciones
Cuando se cambia un valor de una propiedad de objeto
Esta operación se desencadena cuando se cambia un valor de una propiedad de objeto determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Propiedad
|
propertyKindId | integer |
Seleccione la propiedad del objeto para el que desea desencadenar este flujo. |
|
|
Valor nuevo
|
newValue | string |
Escriba el nuevo valor de la propiedad para la que desea desencadenar este flujo. Por ejemplo, PC123, 1,45, 14. 4. 2024. |
|
|
Tipo de objeto
|
kindId | integer |
Seleccione el tipo del objeto para el que desea desencadenar este flujo. |
|
|
Objeto primario
|
parentObjectId | integer |
Seleccione el objeto primario para cuyo subárbol desea desencadenar este flujo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de objeto
|
objectId | integer |
Id. de objeto (tblNode.intNodeId). |
|
Id. de propiedad
|
propertyId | integer |
Id. de propiedad cambiado (tblProperty.intPropertyId). |
Cuando se crea un objeto
Esta operación se desencadena cuando se crea un objeto de un tipo determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Kind
|
kindId | integer |
Seleccione el tipo del objeto para el que desea desencadenar este flujo. |
|
|
Objeto primario
|
parentObjectId | integer |
Seleccione el objeto primario para cuyo subárbol desea desencadenar este flujo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de objeto
|
objectId | integer |
Id. de objeto (tblNode.intNodeId). |
Cuando se mueve un objeto
Esta operación se desencadena cuando un objeto de un tipo determinado se mueve a una posición diferente en el árbol de objetos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Kind
|
kindId | integer |
Seleccione el tipo del objeto para el que desea desencadenar este flujo. |
|
|
Movido desde
|
fromObjectId | integer |
Seleccione el objeto de origen para cuyo subárbol desea desencadenar este flujo. |
|
|
Movido a
|
toObjectId | integer |
Seleccione el objeto de destino para cuyo subárbol desea desencadenar este flujo. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de objeto
|
objectId | integer |
Id. de objeto (tblNode.intNodeId). |
|
Id. de objeto primario antiguo
|
oldParentObjectId | integer |
Id. de objeto primario antiguo (tblNode.intNodeId). |
Cuando un vale cambia a un estado
Esta operación se desencadena cuando un vale pasa a un estado determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Proceso
|
process | True | string |
Escriba el nombre del proceso para el que desea desencadenar este flujo. |
|
Estado del vale
|
status | True | string |
Escriba el nombre del estado del vale. La transición de vale a este estado desencadenará este flujo. |
|
Service
|
service | string |
Escriba el nombre del servicio para el que desea desencadenar este flujo. |
Devoluciones
Definiciones
SD. Boleto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Id. de vale (tHdTicket.iHdTicketId). |
|
Nombre
|
name | string |
Nombre del vale. |
|
Etiqueta de mensaje
|
messageTag | string |
Etiqueta de mensaje de vale. |
|
Id. de Acuerdo de Nivel de Servicio
|
slaId | integer |
Id. de Acuerdo de Nivel de Servicio (tSla.iSlaId). |
|
Nombre del Acuerdo de Nivel de Servicio
|
slaName | string |
Nombre del Acuerdo de Nivel de Servicio. |
|
Priority
|
priority | string |
Prioridad del vale. |
|
Impacto
|
impact | string |
Impacto del vale. |
|
Urgencia
|
urgency | string |
Urgencia del vale. |
|
Número de dispositivo
|
deviceNumber | string |
Número de dispositivo del vale. |
|
Organización relacionada
|
relatedOrganization | string |
Nombre de la organización relacionada con el vale. |
|
Fecha de destino interna
|
internalTargetDate | date-time |
Fecha de destino interna del vale. |
|
Destino interno
|
internalTarget | string |
Destino interno del vale. |
|
Id. del solicitante
|
requesterId | integer |
Id. del solicitante (tPerson.iPersonId). |
|
Nombre del solicitante
|
requesterName | string |
Nombre del solicitante. |
|
Solicitado para id.
|
requestedForId | integer |
Solicitado para id. (tPerson.iPersonId). |
|
Solicitado para el nombre
|
requestedForName | string |
Solicitado para el nombre. |
|
Identificador del solucionador
|
solverId | integer |
Identificador del solucionador de vales (tPerson.iPersonId). |
|
Nombre del solucionador
|
solverName | string |
Nombre del solucionador de vales. |
|
Identificador de equipo de Solver
|
solverTeamId | integer |
Identificador del equipo del solucionador de vales (tRole.iRoleId). |
|
Nombre del equipo de Solver
|
solverTeamName | string |
Nombre del equipo del solucionador de vales. |
|
Id. de servicio
|
serviceId | integer |
Identificador del servicio de vales (tHdSection.iHdSectionId). |
|
Nombre del servicio
|
serviceName | string |
Nombre del servicio de vales. |
|
Nombre del proceso
|
processName | string |
Nombre del proceso de servicio. |
|
Id. de estado
|
stateId | integer |
Id. de estado del vale (TicketState.id). |
|
Nombre del estado
|
stateName | string |
Nombre del estado del vale. |
|
Fecha de creación
|
createdDate | date-time |
Fecha de creación del vale. |
|
Fecha de resolución
|
resolvedDate | date-time |
Fecha de resolución de vales. |
|
Fecha de cierre
|
closedDate | date-time |
Fecha de cierre del billete. |
|
Id. de acto inicial
|
initialActId | integer |
Id. de acto inicial (tAct.iActId). |
|
Fecha de eliminación
|
removedDate | date-time |
Fecha de eliminación del vale. |
|
En aprobación
|
inApproval | boolean |
Si el vale está en proceso de aprobación. |
|
Fecha límite
|
dueDate | date-time |
Fecha de vencimiento del billete. |
|
Objetos
|
objects | array of object |
Vínculos a objetos. |
|
identificación
|
objects.objectId | integer |
Id. de objeto (tblNode.intNodeId). |
|
Elementos personalizados
|
customItems | object |
Entradas personalizadas (tHdTicketCust). |
Webhook.UpdatedTicket
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de vale
|
requestId | integer |
Identificador del vale (tHdTicket.iHdTicketId). |
|
Id. de persona
|
personId | integer |
Id. de la persona que realizó el cambio (tPerson.iPersonId). |
AM. Objeto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Id. de objeto (tblNode.intNodeId). |
|
Nombre
|
name | string |
Nombre del objeto. |
|
Ruta
|
path | string |
Ruta de acceso del objeto en el árbol. |
|
Nombre completo
|
fullName | string |
Nombre de objeto con ruta de acceso en el árbol. |
|
Identificador de tipo
|
kindId | integer |
Id. de tipo de objeto (tblKind.intKindId). |
|
Nombre del tipo
|
kindName | string |
Nombre del tipo de objeto. |
|
Oculto
|
hidden | boolean |
Si el objeto está oculto. |
|
Id. de objeto primario
|
parentObjectId | integer |
Identificador de objeto primario (tblNode.intNodeId). |
AM. ObjectExpanded
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Id. de objeto (tblNode.intNodeId). |
|
Nombre
|
name | string |
Nombre del objeto. |
|
Ruta
|
path | string |
Ruta de acceso del objeto en el árbol. |
|
Nombre completo
|
fullName | string |
Nombre de objeto con ruta de acceso en el árbol. |
|
Identificador de tipo
|
kindId | integer |
Id. de tipo de objeto (tblKind.intKindId). |
|
Nombre del tipo
|
kindName | string |
Nombre del tipo de objeto. |
|
Oculto
|
hidden | boolean |
Si el objeto está oculto. |
|
Id. de objeto primario
|
parentObjectId | integer |
Identificador de objeto primario (tblNode.intNodeId). |
|
Propiedades
|
properties | array of object |
Propiedades del objeto . |
|
identificación
|
properties.id | integer |
Id. de propiedad (tblProperty.intPropertyId). |
|
Nombre
|
properties.name | string |
Nombre de la propiedad. |
|
Importancia
|
properties.value | string |
Valor de propiedad. |
|
Orden de nombres
|
properties.nameOrder | integer |
Orden de nombre de propiedad. |
AM. ObjectsExpandedApiResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of AM.ObjectExpanded |
AM. ImportCsvResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Recuento total de registros
|
recordsTotalCount | integer |
Recuento total de registros en CSV. |
|
Recuento de registros procesados
|
recordsProcessedCount | integer |
Recuento de registros procesados. |
|
Recuento de registros omitidos
|
recordsSkippedCount | integer |
Recuento de registros omitidos. |
|
Recuento de registros con errores
|
recordsFailedCount | integer |
Recuento de registros con errores. |
|
Número de objetos creados
|
objectsCreatedCount | integer |
Recuento de objetos creados. |
|
Recuento de objetos actualizados
|
objectsUpdatedCount | integer |
Recuento de objetos actualizados. |
|
Log
|
log | string |
Importar registro que contiene información detallada. |
Common.Person
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
name | string |
Nombre de usuario y apellido. |
|
Correo electrónico
|
string |
Correo electrónico de usuario. |
|
|
Correo electrónico 2
|
email2 | string |
Correo electrónico de usuario 2. |
|
Teléfono de trabajo
|
phone | string |
Teléfono de trabajo del usuario. |
|
Teléfono de trabajo 2
|
phone2 | string |
Teléfono de trabajo del usuario 2. |
|
Teléfono móvil
|
mobilePhone | string |
Teléfono móvil del usuario. |
|
Departamento
|
department | string |
Departamento de usuario. |
|
Oficina
|
office | string |
Oficina del usuario. |
|
Position
|
workPosition | string |
Puesto de trabajo del usuario. |
|
Organización
|
organization | string |
Organización del usuario. |
|
Otros contactos
|
otherContacts | string |
Otros contactos del usuario. |
|
Id. de usuario
|
id | integer |
Id. de usuario (tPerson.iPersonId). |
|
Nombre de usuario (para sistemas más antiguos)
|
sAMAccountName | string |
Nombre de usuario que admite la versión anterior de Windows. |
|
Nombre de usuario
|
login | string |
Nombre de usuario. |
|
Creado
|
createdDate | date-time |
Fecha de creación del usuario. |
|
Is System
|
isSystem | boolean |
Si el usuario es el sistema Alvao. |
|
Está oculto
|
isHidden | boolean |
Si el usuario está oculto en menús. |
|
Se comparte
|
isShared | boolean |
Si el usuario es una cuenta compartida. |
|
Está deshabilitado
|
isDisabled | boolean |
Si el usuario es una cuenta deshabilitada. |
|
Es invitado
|
isGuest | boolean |
Indica si el usuario es el usuario invitado. |
|
Is App
|
isApp | boolean |
Si el usuario es una cuenta de aplicación. |
|
Quitado
|
removedDate | date-time |
Fecha de eliminación del usuario. |
|
Id. de administrador
|
managerId | integer |
Identificador del administrador de usuarios (tPerson.iPersonId). |
|
Id. de sustitución
|
substituteId | integer |
Identificador de sustitución de usuario (tPerson.iPersonId). |
|
Número personal
|
personalNumber | string |
Número personal de usuario. |
|
Id. de idioma preferido
|
localeId | integer |
Identificador de idioma preferido por el usuario. |
|
Zona horaria
|
timezone | string |
Zona horaria del usuario. |
|
Elementos personalizados
|
customItems | object |
Elementos personalizados de usuario (tPersonCust). |
|
AD GUID
|
adGuid | string |
GUID de AD de usuario. |
|
Nombre
|
firstName | string |
Nombre de usuario. |
|
Apellido
|
lastName | string |
Apellidos del usuario. |
|
SID
|
sid | string |
SID de usuario. |
|
Ruta de acceso de AD
|
adPath | string |
Ruta de acceso de AD de usuario. |
|
Identificador de Azure
|
azureAdObjectId | string |
Identificador de Azure de usuario |
Common.UsersApiResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of Common.Person |
cuerda / cadena
Este es el tipo de datos básico "string".