ALVÃO

O Alvao permite automatizar ações no Alvao Service Desk e Asset Management e integrar-se com outras aplicações.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Suporte ALVAO
URL	https://www.alvao.com/en/support-and-services
Email	support@alvao.com

Metadados do conector
Editora	ALVÃO
Sítio Web	https://www.alvao.com
Política de privacidade	https://www.alvao.com/en/privacystatement
Categorias	Colaboração;Operações de TI

Com esse conector, você pode usar o Power Automate, o Power Apps ou os Aplicativos Lógicos do Azure para automatizar ações no Alvao ou para integrar o Alvao a outros aplicativos. O conector permite iniciar automações ligadas não só ao fluxo de trabalho de tickets no Service Desk, mas também ao ciclo de vida dos ativos registrados no Asset Management. As ações do conector permitem mover o fluxo de trabalho de tíquete ou gerenciar o ciclo de vida do ativo.

Pré-requisitos

Você precisará ser um cliente ALVAO (SaaS ou On-prem) com uma versão do ALVAO pelo menos 11.1 e ter a API REST disponível na internet.

Como obter credenciais

Crie uma conta de aplicativo no Alvao WebAppUsers - Administration - .
Defina pelo menos o Name and Surname, User name e habilite a opção Application account - Other applications.
Defina uma palavra-passe para esta conta.
Defina as permissões apropriadas para que a conta funcione com tíquetes ou ativos.
Use o User name e Password desta conta para criar uma conexão com esse conector.

Nota: Você também precisará do URL para sua API REST Alvao que você pode encontrar em Alvao WebAppSettings - Web servicesAdministration - - .

Introdução ao conector

Depois de criar a conexão, você pode usar vários gatilhos ou ações.

Por exemplo, conceda permissão para ler uma pasta no SharePoint usando um fluxo automatizado com base na aprovação de um tíquete no Alvao Service Desk:

Use o gatilho When a ticket transitions to a status e especifique o nome do processo e o estado no qual disparar o fluxo.
Em seguida, adicione a Get Ticket ação e, como entrada, insira o Ticket ID disponível do gatilho.
Em seguida, use, por exemplo, o e-mail do solicitante que você recebeu da ação e use-o para encontrar o usuário no M365 e atribuir-lhe as permissões apropriadas.

Outras ações também podem ajudá-lo com automações na Gestão de Ativos. Por exemplo, ações para criar um ativo, alterar os valores de suas propriedades ou movê-lo dentro do registro. Se você precisar importar regularmente ativos de outro sistema, poderá usar a ação Import objects from CSV.

Problemas conhecidos e limitações

Todos os gatilhos estão disponíveis apenas no ALVAO 11.2 ou superior.
Estas ações só estão disponíveis no ALVAO 11.2 ou superior:
- Criar objeto
- Obter objeto
- Obter objetos
- Atualizar propriedades do objeto
- Mover objetos
- Obter utilizadores
- Importar objetos do CSV
Algumas ações requerem um ID de entidade como entrada, que deve existir dentro do Alvao. Esses IDs geralmente são encontrados no Alvao WebApp no final do URL em suas páginas de detalhes ou edição.

Erros e soluções comuns

403 Proibido - Verifique se a conta do aplicativo usado tem todas as permissões necessárias para executar a ação. Verifique também as credenciais usadas na conexão.
404 Não encontrado - Verifique se todos os parâmetros de entrada estão corretos e se o REST API URL está correto na conexão. Verifique se a ação está disponível na sua versão do ALVAO.

FAQ

Campos personalizados

O conector também suporta leitura e gravação de valores de/para campos personalizados de tíquete. Os campos personalizados não podem ser descritos na definição geral do conector, portanto, você precisa usar as seguintes técnicas para processá-los.

Para ler um valor do campo personalizado de um ticket, use expressões na Get ticket ação. Por exemplo, para ler o valor do campo TicketCategory, use a expressão:

outputs('Get_request')?['body/customItems/TicketCategory/value']

Para escrever um valor no campo personalizado de um ticket, use a Update ticket ação com uma especificação JSON personalizada. Por exemplo, para escrever o valor "falha do monitor" no campo TicketCategory, use esta especificação no Custom Items campo:

{
  "TicketCategory": {
    "@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
    "name": "TicketCategory",
    "value": "monitor failure"
  }
}

Nota: O caractere "@" é dobrado por causa da fuga.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:


Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Host	cadeia (de caracteres)	Especifique o URL do host da sua API REST ALVAO	Verdade
Nome de utilizador	cadeia (de caracteres)	O nome de usuário para a conta do aplicativo ALVAO	Verdade
Palavra-passe	securestring	A senha para a conta de aplicativo ALVAO	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Alterar o estado do ticket	Altera o estado do ticket. Pode ser usado também para resolver ou reabrir o bilhete. É necessário ID do Estado ou Nome do Estado.
Atribuir ticket à equipe do solucionador ou do solucionador	Atribui ticket para a equipe do solucionador ou solucionador.
Atualizar pedido	Atualiza colunas de tíquetes. Defina apenas as propriedades a serem alteradas. Para alterar o SLA, defina slaId ou slaName. Para alterar o solicitante, defina apenas a ID do solicitante ou todos os dados no solicitante (usuário não registrado).
Atualizar propriedades do objeto	Atualiza as propriedades do objeto.
Criar objeto	Cria um novo objeto a partir do modelo especificado em objeto especificado.
Criar pedido de suporte	Cria novo ticket.
Criar registro no registro de tíquetes	Cria registro no registro de tíquetes.
Importar objetos do CSV	Importa objetos fornecidos no formato CSV. Funcionalidade semelhante ao utilitário ImportUtil.
Mover objeto	Move um objeto para um destino especificado.
Mover ticket para outro serviço	Move o ticket para outro serviço. É necessário o ID do Serviço ou o Nome do Serviço.
Obter bilhete	Retorna propriedades de tíquete.
Obter objeto	Retorna o objeto com suas propriedades.
Obter objetos	Retorna objetos com suas propriedades de acordo com parâmetros OData.
Obter utilizadores	Retorna usuários e suas propriedades de acordo com parâmetros OData.

Alterar o estado do ticket

ID da Operação:: ChangeTicketState

Altera o estado do ticket. Pode ser usado também para resolver ou reabrir o bilhete. É necessário ID do Estado ou Nome do Estado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).
ID do Estado	stateId		integer	Novo ID de estado (TicketState.id).
Nome do Estado	stateName		string	Novo nome do estado.
Comment	commentHtml		string	Comente em HTML.
Comentário Para Aprovadores	commentForApprovers		string	Comentário para aprovadores em HTML.
Comentário Para solicitantes	commentForRequesters		string	Comentário para solicitantes em HTML.
Bytes de conteúdo	contentBytes		string	Conteúdo codificado em Base64.
Tipo de conteúdo	contentType		string	Tipo de conteúdo, por exemplo, imagem/png.
Nome do conteúdo	name		string	Nome do conteúdo.

Devoluções

response: string

Atribuir ticket à equipe do solucionador ou do solucionador

ID da Operação:: AssignTicketToSolverOrSolverTeam

Atribui ticket para a equipe do solucionador ou solucionador.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).
Solver ID	solverId		integer	Novo ID do solucionador (tPerson.iPersonId).
ID da Equipa do Solver	solverTeamId		integer	Novo ID da equipe do solucionador (tRole.iPersonId).
Message	messageForSolverHtml		string	Mensagem para o solucionador e/ou para a equipe do solucionador em HTML.
Bytes de conteúdo	contentBytes		string	Conteúdo codificado em Base64.
Tipo de conteúdo	contentType		string	Tipo de conteúdo, por exemplo, imagem/png.
Nome do conteúdo	name		string	Nome do conteúdo.

Devoluções

response: string

Atualizar pedido

ID da Operação:: UpdateTicket

Atualiza colunas de tíquetes. Defina apenas as propriedades a serem alteradas. Para alterar o SLA, defina slaId ou slaName. Para alterar o solicitante, defina apenas a ID do solicitante ou todos os dados no solicitante (usuário não registrado).

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).
Nome	name		string	Nome do bilhete.
Priority	priority		string	Prioridade do bilhete.
Impacto	impact		string	Impacto do bilhete.
Urgência	urgency		string	Urgência do bilhete.
SLA ID	slaId		integer	ID do SLA do ticket (tSla.iSlaId).
Nome do SLA	slaName		string	Nome do SLA do ticket.
Número do dispositivo	deviceNumber		string	Número do dispositivo do bilhete.
Organização relacionada	relatedOrganization		string	Nome da organização relacionada ao ticket.
Data-alvo interna	internalTargetDate		date-time	Data-alvo interna do ticket.
Alvo Interno	internalTarget		string	Alvo interno do ticket.
Nome	name		string	Nome do solicitante.
E-mail	email		string	E-mail do solicitante.
Correio Eletrónico 2	email2		string	E-mail do solicitante 2.
Telemóvel	phone		string	Telefone do solicitante.
Telefone 2	phone2		string	Telefone do solicitante 2.
Telemóvel	mobilePhone		string	Telefone celular solicitante.
Departamento	department		string	Departamento solicitante.
Office	office		string	Escritório do solicitante.
Posto de Trabalho	workPosition		string	Posição de trabalho solicitante.
Organização	organization		string	Organização do solicitante.
Outros contactos	otherContacts		string	Outros contatos do solicitante.
Itens personalizados	customItems		object	Itens personalizados de ticket (tHdTicketCust).

Atualizar propriedades do objeto

ID da Operação:: UpdateObjectProperties

Atualiza as propriedades do objeto.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Objeto	objectId	True	integer	Selecione o objeto ou insira sua ID (tblNode.intNodeId).
Nome	name		string	Selecione a propriedade do objeto.
Valor	value		string	Especifique o valor da propriedade.

Criar objeto

ID da Operação:: CreateObject

Cria um novo objeto a partir do modelo especificado em objeto especificado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Template	templateObjectId	True	integer	Selecione o modelo de objeto ou insira sua ID (tblNode.intNodeId).
Objeto pai	parentObjectId		integer	Selecione o objeto pai ou insira sua ID (tblNode.intNodeId).

Devoluções

Body: AM.Object

Criar pedido de suporte

ID da Operação:: CreateTicket

Cria novo ticket.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do serviço	serviceId	True	integer	ID do serviço de ticket (tHdSection.iHdSectionId).
Nome	name	True	string	Nome do bilhete.
Description	descriptionHtml		string	Descrição do ticket em HTML.
SLA ID	slaId		integer	ID do SLA do ticket (tSla.iSlaId).
Priority	priority		string	Prioridade do bilhete.
Impacto	impact		string	Impacto do bilhete.
Urgência	urgency		string	Urgência do bilhete.
Número do dispositivo	deviceNumber		string	Número do dispositivo do bilhete.
Organização relacionada	relatedOrganization		string	Nome da organização relacionada ao ticket.
Pedido de identificação pessoal	requestedForPersonId		integer	Solicitado para ID de pessoa (tPerson.iPersonId).
ID	id		integer	ID do solicitante (tPerson.iPersonId).
Nome	name		string	Nome do solicitante.
E-mail	email		string	E-mail do solicitante.
Correio Eletrónico 2	email2		string	E-mail do solicitante 2.
Telemóvel	phone		string	Telefone do solicitante.
Telefone 2	phone2		string	Telefone do solicitante 2.
Telemóvel	mobilePhone		string	Telefone celular solicitante.
Departamento	department		string	Departamento solicitante.
Office	office		string	Escritório do solicitante.
Posto de Trabalho	workPosition		string	Posição de trabalho solicitante.
Organização	organization		string	Organização do solicitante.
Outros Contactos	otherContacts		string	Solicitante de outros contatos.
Objects	objects		array of integer	Links para objetos.
Bytes de conteúdo	contentBytes		string	Conteúdo codificado em Base64.
Tipo de conteúdo	contentType		string	Tipo de conteúdo, por exemplo, imagem/png.
Nome do conteúdo	name		string	Nome do conteúdo.
Itens personalizados	customItems		object	Itens personalizados de ticket (tHdTicketCust).

Devoluções

Body: SD.Ticket

Criar registro no registro de tíquetes

ID da Operação:: CreateRecordInTicketLog

Cria registro no registro de tíquetes.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).
Assunto	subject	True	string	Assunto dos autos.
Conteúdo HTML	contentHtml		string	Conteúdo do registo em Html.
Conteúdo de texto simples	contentPlain		string	Conteúdo do registo em texto simples.
Variante	kind	True	string	Tipo de registro.
Do nome	from		string	Nome do remetente.
Do E-mail	emailFrom		string	E-mail do remetente.
Para	emailTo		string	Destinatários da mensagem separados por ponto-e-vírgula.
Copiar	emailCc		string	Destinatários da mensagem separados por ponto-e-vírgula.
Da ID da Pessoa	fromPersonId		integer	ID da pessoa do autor (tPerson.iPersonId).
Para identificação pessoal	toPersonId		integer	ID da pessoa do destinatário (tPerson.iPersonId).
Data de criação	created		string	Data e hora em que deve ser criado o registo. Deixe vazio para a corrente.
Mostrar ao solicitante	showToRequester		boolean	Decida se o solicitante deve ver o registro.
Bytes de conteúdo	contentBytes		string	Conteúdo codificado em Base64.
Tipo de conteúdo	contentType		string	Tipo de conteúdo, por exemplo, imagem/png.
Nome do conteúdo	name		string	Nome do conteúdo.

Devoluções

Name	Caminho	Tipo	Description
ID do Registo	id	integer	ID do registro de log (tAct.iActId).
Assunto	subject	string	Assunto do registro de log.
Conteúdo HTML	contentHtml	string	Registre o conteúdo do registro em HTML.
Conteúdo de texto simples	contentPlain	string	Registre o conteúdo do registro em texto sem formatação.
Data de criação	created	string	Data de criação do registo de registo.
Variante	kind	string	Tipo de registro de log.
Do nome	from	string	Nome do autor do registro de log.
Do E-mail	emailFrom	string	E-mail do autor do registro de log.
Para	emailTo	string	Registrar e-mails de destinatários de registros.
Copiar	emailCc	string	Registrar e-mails de destinatários de registros.
Da ID da Pessoa	fromPersonId	integer	ID do remetente do registro de log (tPerson.iPersonId).
Para identificação pessoal	toPersonId	integer	ID do recetor do registro de log (tPerson.iPersonId).
ID da mensagem	messageId	string	ID da mensagem de registro de log.
Attachments	attachments	array of object	Registrar anexos de registro.
Nome do anexo	attachments.name	string	Nome do anexo.
ID do anexo	attachments.id	integer	ID do anexo (tDocument.iDocumentId).
Link do anexo	attachments.link	string	Link para o anexo.

Importar objetos do CSV

ID da Operação:: ImportObjectsFromCsv

Importa objetos fornecidos no formato CSV. Funcionalidade semelhante ao utilitário ImportUtil.

Parâmetros

Name	Chave	Necessário	Tipo	Description
CSV	contentCsv	True	string	Conteúdo CSV a importar.
Tipo de objeto	objectTypeId		integer	O tipo de objetos importados.
Formato Data/Hora	dateTimeFormat		string	Formato datetime em cadeias de texto (por exemplo, dd/MM/aaaa).
Separador	separator		string	O separador de coluna usado no CSV importado.
Ignorar erros	skipErrors		boolean	Se habilitado, os dados serão importados mesmo se houver um erro em uma das entradas.
Principais propriedades	keyFields		string	Campos-chave usados para identificar e atualizar objetos existentes (por exemplo, número de série, modelo).
Objeto pai	createUnderObjectId		integer	Objeto pai para criar novos objetos.
Atualizar objetos descartados	updateDiscardedObjects		boolean	Se habilitado, os objetos descartados também são pesquisados e atualizados na importação.

Devoluções

Body: AM.ImportCsvResponse

Mover objeto

ID da Operação:: MoveObject

Move um objeto para um destino especificado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Objeto	objectId	True	integer	Selecione o objeto ou insira sua ID (tblNode.intNodeId).
Objeto de destino	parentObjectId		integer	Selecione o objeto de destino ou insira sua ID (tblNode.intNodeId).

Mover ticket para outro serviço

ID da Operação:: MoveTicketToAnotherService

Move o ticket para outro serviço. É necessário o ID do Serviço ou o Nome do Serviço.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).
ID do serviço	serviceId		integer	Novo ID de serviço (tHdSection.iHdSectionId).
Nome do serviço	serviceName		string	Novo nome do serviço.
Solver ID	newSolverId		integer	Novo ID do solucionador (tPerson.iPersonId).
ID da Equipa do Solver	newSolverTeamId		integer	Novo ID da equipe do solucionador (tRole.iPersonId).
Comment	commentHtml		string	Comente em HTML.
Bytes de conteúdo	contentBytes		string	Conteúdo codificado em Base64.
Tipo de conteúdo	contentType		string	Tipo de conteúdo, por exemplo, imagem/png.
Nome do conteúdo	name		string	Nome do conteúdo.

Devoluções

response: string

Obter bilhete

ID da Operação:: GetTicket

Retorna propriedades de tíquete.

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do bilhete	ticketId	True	integer	Especifique o ID do bilhete (tHdTicket.iHdTicketId).

Devoluções

Body: SD.Ticket

Obter objeto

ID da Operação:: GetObject

Retorna o objeto com suas propriedades.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Objeto	objectId	True	integer	Selecione o objeto ou insira sua ID (tblNode.intNodeId).

Devoluções

Body: AM.ObjectExpanded

Obter objetos

ID da Operação:: GetObjects

Retorna objetos com suas propriedades de acordo com parâmetros OData.

Parâmetros

Name	Chave	Tipo	Description
Início	$top	integer	Especifique o número de objetos que deseja retornar.
Pesquisa	$search	string	Especifique a condição de pesquisa de texto completo. OData $search.
Filter	$filter	string	Especificar o filtro, por exemplo, Nome eq «Leite». OData $filter.
Encomendar por	$orderBy	string	Especifique a ordem. OData $orderBy.

Devoluções

Body: AM.ObjectsExpandedApiResponse

Obter utilizadores

ID da Operação:: GetUsers

Retorna usuários e suas propriedades de acordo com parâmetros OData.

Parâmetros

Name	Chave	Tipo	Description
Início	$top	integer	Especifique o número de objetos que deseja retornar.
Pesquisa	$search	string	Especifique a condição de pesquisa de texto completo. OData $search.
Filter	$filter	string	Especifique o filtro, por exemplo, Email eq 'james.smith@contoso.com'. OData $filter.
Encomendar por	$orderBy	string	Especifique a ordem. OData $orderBy.

Devoluções

Body: Common.UsersApiResponse

Acionadores

Quando um objeto é criado	Esta operação é acionada quando um objeto de um determinado tipo é criado.
Quando um objeto é movido	Esta operação é acionada quando um objeto de um determinado tipo é movido para uma posição diferente na árvore de objetos.
Quando um ticket transita para um status	Essa operação é acionada quando um ticket transita para um determinado status.
Quando um valor de campo de ticket é alterado	Esta operação é acionada quando um determinado valor de campo de ticket é alterado.
Quando um valor de uma propriedade de objeto é alterado	Esta operação é acionada quando um valor de uma determinada propriedade de objeto é alterado.

Quando um objeto é criado

ID da Operação:: ObjectCreated

Esta operação é acionada quando um objeto de um determinado tipo é criado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Variante	kindId		integer	Selecione o tipo de objeto para o qual você deseja acionar esse fluxo.
Objeto pai	parentObjectId		integer	Selecione o objeto pai para cuja subárvore você deseja acionar esse fluxo.

Devoluções

Name	Caminho	Tipo	Description
ID do objeto	objectId	integer	ID do objeto (tblNode.intNodeId).

Quando um objeto é movido

ID da Operação:: ObjectMoved

Esta operação é acionada quando um objeto de um determinado tipo é movido para uma posição diferente na árvore de objetos.

Parâmetros

Name	Chave	Tipo	Description
Variante	kindId	integer	Selecione o tipo de objeto para o qual você deseja acionar esse fluxo.
Movido de	fromObjectId	integer	Selecione o objeto de origem para cuja subárvore você deseja acionar esse fluxo.
Movido para	toObjectId	integer	Selecione o objeto de destino para cuja subárvore você deseja acionar esse fluxo.

Devoluções

Name	Caminho	Tipo	Description
ID do objeto	objectId	integer	ID do objeto (tblNode.intNodeId).
ID do objeto pai antigo	oldParentObjectId	integer	ID do objeto pai antigo (tblNode.intNodeId).

Quando um ticket transita para um status

ID da Operação:: TicketTransitionsToStatus

Essa operação é acionada quando um ticket transita para um determinado status.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Processo	process	True	string	Digite o nome do processo para o qual você deseja acionar esse fluxo.
Estado do bilhete	status	True	string	Digite o nome do status do ticket. A transição de tíquete para esse status acionará esse fluxo.
Serviço	service		string	Insira o nome do serviço para o qual você deseja acionar esse fluxo.

Devoluções

Body: Webhook.UpdatedTicket

Quando um valor de campo de ticket é alterado

ID da Operação:: TicketFieldChanged

Esta operação é acionada quando um determinado valor de campo de ticket é alterado.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Campo	fieldId	True	integer	Selecione um campo de ticket.
Processo	process		string	Digite o nome do processo para o qual você deseja acionar esse fluxo.
Serviço	service		string	Insira o nome do serviço para o qual você deseja acionar esse fluxo.

Devoluções

Body: Webhook.UpdatedTicket

Quando um valor de uma propriedade de objeto é alterado

ID da Operação:: ObjectPropertyChanged

Esta operação é acionada quando um valor de uma determinada propriedade de objeto é alterado.

Parâmetros

Name	Chave	Tipo	Description
Propriedade	propertyKindId	integer	Selecione a propriedade do objeto para o qual você deseja acionar esse fluxo.
Novo Valor	newValue	string	Insira o novo valor da propriedade para a qual você deseja acionar esse fluxo. Por exemplo, PC123, 1.45, 14. 4. 2024.
Tipo de objeto	kindId	integer	Selecione o tipo de objeto para o qual você deseja acionar esse fluxo.
Objeto pai	parentObjectId	integer	Selecione o objeto pai para cuja subárvore você deseja acionar esse fluxo.

Devoluções

Name	Caminho	Tipo	Description
ID do objeto	objectId	integer	ID do objeto (tblNode.intNodeId).
ID da Propriedade	propertyId	integer	ID da propriedade alterada (tblProperty.intPropertyId).

Definições

SD. Bilhete

Name	Caminho	Tipo	Description
ID	id	integer	ID do bilhete (tHdTicket.iHdTicketId).
Nome	name	string	Nome do bilhete.
Tag de mensagem	messageTag	string	Tag de mensagem de ticket.
SLA ID	slaId	integer	ID do SLA (tSla.iSlaId).
Nome do SLA	slaName	string	Nome do SLA.
Priority	priority	string	Prioridade do bilhete.
Impacto	impact	string	Impacto do bilhete.
Urgência	urgency	string	Urgência do bilhete.
Número do dispositivo	deviceNumber	string	Número do dispositivo do bilhete.
Organização relacionada	relatedOrganization	string	Nome da organização relacionada ao ticket.
Data-alvo interna	internalTargetDate	date-time	Data-alvo interna do ticket.
Alvo Interno	internalTarget	string	Alvo interno do ticket.
ID do solicitante	requesterId	integer	ID do solicitante (tPerson.iPersonId).
Nome do solicitante	requesterName	string	Nome do solicitante.
Pedido de identificação	requestedForId	integer	Solicitado para ID (tPerson.iPersonId).
Nome solicitado	requestedForName	string	Pedido de nome.
Solver ID	solverId	integer	ID do solucionador de bilhetes (tPerson.iPersonId).
Nome do Solver	solverName	string	Nome do solucionador de bilhetes.
ID da Equipa do Solver	solverTeamId	integer	ID da equipe do solucionador de tíquetes (tRole.iRoleId).
Nome da Equipa do Solver	solverTeamName	string	Nome da equipa de resolução de bilhetes.
ID do serviço	serviceId	integer	ID do serviço de ticket (tHdSection.iHdSectionId).
Nome do serviço	serviceName	string	Nome do serviço de bilheteria.
Nome do Processo	processName	string	Nome do processo de serviço.
Status ID	stateId	integer	ID do status do ticket (TicketState.id).
Nome do estado	stateName	string	Nome do status do ticket.
Data de criação	createdDate	date-time	Data de criação do bilhete.
Data de resolução	resolvedDate	date-time	Data de resolução do bilhete.
Data de encerramento	closedDate	date-time	Data de fecho dos bilhetes.
ID do Ato Inicial	initialActId	integer	ID do ato inicial (tAct.iActId).
Data de remoção	removedDate	date-time	Data de retirada do bilhete.
Em Aprovação	inApproval	boolean	Se o bilhete está em processo de aprovação.
Data Para Conclusão	dueDate	date-time	Data de vencimento do bilhete.
Objects	objects	array of object	Links para objetos.
ID	objects.objectId	integer	ID do objeto (tblNode.intNodeId).
Itens personalizados	customItems	object	Itens personalizados de ticket (tHdTicketCust).

Webhook.UpdatedTicket

Name	Caminho	Tipo	Description
ID do bilhete	requestId	integer	ID do bilhete (tHdTicket.iHdTicketId).
ID da pessoa	personId	integer	ID da pessoa que fez a alteração (tPerson.iPersonId).

AM. Objeto

Name	Caminho	Tipo	Description
ID	id	integer	ID do objeto (tblNode.intNodeId).
Nome	name	string	Nome do objeto.
Caminho	path	string	Caminho do objeto na árvore.
Nome Completo	fullName	string	Nome do objeto com caminho na árvore.
Identificação do tipo	kindId	integer	ID do tipo de objeto (tblKind.intKindId).
Nome do tipo	kindName	string	Nome do tipo de objeto.
Escondido	hidden	boolean	Se o objeto está oculto.
ID do objeto pai	parentObjectId	integer	ID do objeto pai (tblNode.intNodeId).

AM. ObjectExpanded

Name	Caminho	Tipo	Description
ID	id	integer	ID do objeto (tblNode.intNodeId).
Nome	name	string	Nome do objeto.
Caminho	path	string	Caminho do objeto na árvore.
Nome Completo	fullName	string	Nome do objeto com caminho na árvore.
Identificação do tipo	kindId	integer	ID do tipo de objeto (tblKind.intKindId).
Nome do tipo	kindName	string	Nome do tipo de objeto.
Escondido	hidden	boolean	Se o objeto está oculto.
ID do objeto pai	parentObjectId	integer	ID do objeto pai (tblNode.intNodeId).
Propriedades	properties	array of object	Propriedades do objeto.
ID	properties.id	integer	ID da propriedade (tblProperty.intPropertyId).
Nome	properties.name	string	Nome da propriedade.
Valor	properties.value	string	Valor do imóvel.
Ordem de Nome	properties.nameOrder	integer	Ordem do nome da propriedade.

AM. ObjectsExpandedApiResponse

Name	Caminho	Tipo	Description
valor	value	array of AM.ObjectExpanded

AM. ImportCsvResponse

Name	Caminho	Tipo	Description
Contagem Total de Registos	recordsTotalCount	integer	Contagem total de registros em CSV.
Contagem de registros processados	recordsProcessedCount	integer	Contagem de registos processados.
Contagem de registros ignorados	recordsSkippedCount	integer	Contagem de registros ignorados.
Contagem de registros com falha	recordsFailedCount	integer	Contagem de registros com falha.
Contagem de objetos criados	objectsCreatedCount	integer	Contagem de objetos criados.
Contagem de objetos atualizada	objectsUpdatedCount	integer	Contagem de objetos atualizados.
Log	log	string	Log de importação contendo informações detalhadas.

Comum.Pessoa

Name	Caminho	Tipo	Description
Nome	name	string	Nome de utilizador e apelido.
E-mail	email	string	E-mail do usuário.
Correio Eletrónico 2	email2	string	E-mail do usuário 2.
Telefone de trabalho	phone	string	Telefone de trabalho do usuário.
Telefone de trabalho 2	phone2	string	Telefone de trabalho do usuário 2.
Telemóvel	mobilePhone	string	Telemóvel do utilizador.
Departamento	department	string	Departamento de utilizadores.
Office	office	string	Escritório do usuário.
Position	workPosition	string	Posição de trabalho do usuário.
Organização	organization	string	Organização de usuários.
Outros Contactos	otherContacts	string	Usuário outros contatos.
ID de utilizador	id	integer	ID de utilizador (tPerson.iPersonId).
Nome de utilizador (para sistemas mais antigos)	sAMAccountName	string	Nome de utilizador que suporta a versão anterior do Windows.
Nome de utilizador	login	string	Nome de usuário do usuário.
Criado	createdDate	date-time	Data de criação pelo utilizador.
É Sistema	isSystem	boolean	Se o usuário é o Sistema Alvão.
Está escondido	isHidden	boolean	Se o usuário está oculto em menus.
É partilhado	isShared	boolean	Se o usuário é uma conta compartilhada.
Está desativado	isDisabled	boolean	Se o usuário é uma conta desabilitada.
É Convidado	isGuest	boolean	Se o usuário é o usuário convidado.
É App	isApp	boolean	Se o usuário é uma conta de aplicativo.
Removed	removedDate	date-time	Data de remoção do utilizador.
ID do Gestor	managerId	integer	ID do gestor de utilizadores (tPerson.iPersonId).
ID substituto	substituteId	integer	ID substituto do usuário (tPerson.iPersonId).
Número Pessoal	personalNumber	string	Número pessoal do utilizador.
ID do idioma preferido	localeId	integer	ID do idioma preferido do usuário.
Fuso Horário	timezone	string	Fuso horário do usuário.
Itens personalizados	customItems	object	Itens personalizados do usuário (tPersonCust).
AD GUID	adGuid	string	GUID do AD do usuário.
Nome Próprio	firstName	string	Nome do usuário.
Apelido	lastName	string	Apelido do utilizador.
SID	sid	string	SID do usuário.
Caminho do AD	adPath	string	Caminho do AD do usuário.
Azure ID	azureAdObjectId	string	ID do Azure do usuário

Common.UsersApiResponse

Name	Caminho	Tipo	Description
valor	value	array of Common.Person

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.

Partilhar via

ALVÃO

Pré-requisitos

Como obter credenciais

Introdução ao conector

Problemas conhecidos e limitações

Erros e soluções comuns

FAQ

Campos personalizados

A criar uma ligação

Padrão

Limites de Limitação

Ações

Alterar o estado do ticket

Parâmetros

Devoluções

Atribuir ticket à equipe do solucionador ou do solucionador

Parâmetros

Devoluções

Atualizar pedido

Parâmetros

Atualizar propriedades do objeto

Parâmetros

Criar objeto

Parâmetros

Devoluções

Criar pedido de suporte

Parâmetros

Devoluções

Criar registro no registro de tíquetes

Parâmetros

Devoluções

Importar objetos do CSV

Parâmetros

Devoluções

Mover objeto

Parâmetros

Mover ticket para outro serviço

Parâmetros

Devoluções

Obter bilhete

Parâmetros

Devoluções

Obter objeto

Parâmetros

Devoluções

Obter objetos

Parâmetros

Devoluções

Obter utilizadores

Parâmetros

Devoluções

Acionadores

Quando um objeto é criado

Parâmetros

Devoluções

Quando um objeto é movido

Parâmetros

Devoluções

Quando um ticket transita para um status

Parâmetros

Devoluções

Quando um valor de campo de ticket é alterado

Parâmetros

Devoluções

Quando um valor de uma propriedade de objeto é alterado

Parâmetros

Devoluções

Definições

SD. Bilhete

Webhook.UpdatedTicket

AM. Objeto

AM. ObjectExpanded

AM. ObjectsExpandedApiResponse

AM. ImportCsvResponse

Comum.Pessoa

Common.UsersApiResponse

cadeia (de caracteres)