ALVAO
O Alvao permite automatizar ações no Alvao Service Desk e no Asset Management e integrar com outros aplicativos.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao ALVAO |
| URL | https://www.alvao.com/en/support-and-services |
| support@alvao.com |
| Metadados do conector | |
|---|---|
| Publicador | ALVAO |
| Site | 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 integrar o Alvao a outros aplicativos. O conector permite iniciar automações vinculadas não apenas ao fluxo de trabalho de tíquetes no Service Desk, mas também ao ciclo de vida dos ativos registrados no Gerenciamento de Ativos. Em seguida, as ações do conector permitem mover o fluxo de trabalho do 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
- Criar uma conta de aplicativo em
Alvao WebAppUsers-Administration- . - Defina pelo menos a opção
Name and Surnamee habilite a opçãoOther applicationsApplication account- .User name - Defina uma senha para essa conta.
- Defina as permissões apropriadas para que a conta funcione com tíquetes ou ativos.
- Use a
User nameconta ePasswordessa conta para criar uma conexão com esse conector.
Observação: você também precisará da URL para sua API REST do Alvao na qual você pode encontrar
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
When a ticket transitions to a statusgatilho e especifique o nome do processo e o estado no qual disparar o fluxo. - Em seguida, adicione a ação
Get Tickete, conforme a entrada, insira oTicket IDdisponível do gatilho. - Em seguida, use, por exemplo, o email do solicitante que você recebeu da ação e use-o para localizar o usuário no M365 e atribuir-lhe permissões apropriadas.
Outras ações também podem ajudá-lo com automações no Gerenciamento 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 e limitações conhecidos
- Todos os gatilhos só estão disponíveis no ALVAO 11.2 ou superior.
- Essas 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 usuários
- Importar objetos do CSV
- Algumas ações exigem uma ID de entidade como entrada, que deve existir no Alvao. Essas IDs geralmente são encontradas no Alvao WebApp no final da URL em seus detalhes ou páginas de edição.
Erros e soluções comuns
- 403 Proibido – Verifique se a conta de aplicativo usada 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 a URL da API REST está correta na conexão. Verifique se a ação está disponível em sua versão do ALVAO.
perguntas frequentes
Campos Personalizados
O conector também dá suporte à leitura e gravação de valores de/para campos personalizados de tíquete. Campos personalizados não podem ser descritos na definição geral do conector, portanto, você precisa usar as técnicas a seguir para processá-los.
Para ler um valor do campo personalizado de um tíquete, use expressões na ação Get ticket . Por exemplo, para ler o valor do campo TicketCategory, use a expressão:
outputs('Get_request')?['body/customItems/TicketCategory/value']
Para gravar um valor no campo personalizado de um tíquete, use a ação Update ticket com uma especificação JSON personalizada. Por exemplo, para gravar o valor de "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"
}
}
Observação: o caractere "@" é duplicado devido ao escape.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 | Especificar a URL do host da API REST do ALVAO | Verdade |
| Nome de usuário | cadeia | O nome de usuário da conta de aplicativo ALVAO | Verdade |
| Senha | secureString | A senha da conta do aplicativo ALVAO | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Alterar o estado do tíquete |
Altera o estado do tíquete. Ele também pode ser usado para resolver ou reabrir o tíquete. A ID de Estado ou o Nome do Estado são necessários. |
| Atribuir tíquete à equipe de solucionador ou solucionador |
Atribui tíquete à equipe de solucionador ou solucionador. |
| Atualizar pedido |
Atualiza colunas de tíquete. Defina apenas as propriedades a serem alteradas. Para alterar o SLA, defina slaId ou slaName. Para alterar o conjunto de solicitantes, 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 do modelo especificado em um objeto especificado. |
| Criar registro no log de tíquetes |
Cria o registro no log de tíquetes. |
| Criar tíquete |
Cria um novo tíquete. |
| Importar objetos do CSV |
Importa objetos fornecidos no formato CSV. Funcionalidade semelhante ao utilitário ImportUtil. |
| Mover o tíquete para outro serviço |
Move o tíquete para outro serviço. A ID do Serviço ou o Nome do Serviço são necessários. |
| Mover objeto |
Move um objeto para um destino especificado. |
| Obter objeto |
Retorna o objeto com suas propriedades. |
| Obter objetos |
Retorna objetos com suas propriedades de acordo com os parâmetros OData. |
| Obter tíquete |
Retorna as propriedades do tíquete. |
| Obter usuários |
Retorna usuários e suas propriedades de acordo com os parâmetros OData. |
Alterar o estado do tíquete
Altera o estado do tíquete. Ele também pode ser usado para resolver ou reabrir o tíquete. A ID de Estado ou o Nome do Estado são necessários.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
|
ID do Estado
|
stateId | integer |
Nova ID de estado (TicketState.id). |
|
|
Nome do Estado
|
stateName | string |
Novo nome de estado. |
|
|
Comment
|
commentHtml | string |
Comente em HTML. |
|
|
Comentário para aprovadores
|
commentForApprovers | string |
Comente para aprovadores em HTML. |
|
|
Comentário para solicitantes
|
commentForRequesters | string |
Comente 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. |
Retornos
- response
- string
Atribuir tíquete à equipe de solucionador ou solucionador
Atribui tíquete à equipe de solucionador ou solucionador.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
|
Solver ID
|
solverId | integer |
Nova ID do solucionador (tPerson.iPersonId). |
|
|
ID da equipe do Solver
|
solverTeamId | integer |
Nova ID da equipe do solver (tRole.iPersonId). |
|
|
Message
|
messageForSolverHtml | string |
Mensagem para o solucionador e/ou para a equipe do solver 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. |
Retornos
- response
- string
Atualizar pedido
Atualiza colunas de tíquete. Defina apenas as propriedades a serem alteradas. Para alterar o SLA, defina slaId ou slaName. Para alterar o conjunto de solicitantes, defina apenas a ID do Solicitante ou todos os dados no solicitante (usuário não registrado).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
|
Nome
|
name | string |
Nome do tíquete. |
|
|
Priority
|
priority | string |
Prioridade de tíquete. |
|
|
Impacto
|
impact | string |
Impacto do tíquete. |
|
|
Urgência
|
urgency | string |
Urgência do tíquete. |
|
|
SLA ID
|
slaId | integer |
TÍquete SLA ID (tSla.iSlaId). |
|
|
Nome do SLA
|
slaName | string |
Nome do Tíquete SLA. |
|
|
Número do dispositivo
|
deviceNumber | string |
Número do dispositivo de tíquete. |
|
|
Organização relacionada
|
relatedOrganization | string |
Nome da organização relacionada ao tíquete. |
|
|
Data de destino interna
|
internalTargetDate | date-time |
Data de destino interna do tíquete. |
|
|
Destino Interno
|
internalTarget | string |
Destino interno do tíquete. |
|
|
Nome
|
name | string |
Nome do solicitante. |
|
|
Email
|
string |
Email do solicitante. |
||
|
Email 2
|
email2 | string |
Email do solicitante 2. |
|
|
Telefone
|
phone | string |
Telefone solicitante. |
|
|
Telefone 2
|
phone2 | string |
Telefone do solicitante 2. |
|
|
Telefone celular
|
mobilePhone | string |
Telefone celular solicitante. |
|
|
Departamento
|
department | string |
Departamento solicitante. |
|
|
Office
|
office | string |
Escritório do solicitante. |
|
|
Posição de trabalho
|
workPosition | string |
Posição de trabalho do solicitante. |
|
|
Organização
|
organization | string |
Organização solicitante. |
|
|
Outros contatos
|
otherContacts | string |
Outros contatos do solicitante. |
|
|
Itens Personalizados
|
customItems | object |
Itens personalizados de tíquete (tHdTicketCust). |
Atualizar propriedades do objeto
Atualiza as propriedades do objeto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Object
|
objectId | True | integer |
Selecione o objeto ou insira sua ID (tblNode.intNodeId). |
|
Nome
|
name | string |
Selecione a propriedade do objeto. |
|
|
Value
|
value | string |
Especifique o valor da propriedade. |
Criar objeto
Cria um novo objeto do modelo especificado em um objeto especificado.
Parâmetros
| Nome | Chave | Obrigató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). |
Retornos
- Corpo
- AM.Object
Criar registro no log de tíquetes
Cria o registro no log de tíquetes.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
|
Assunto
|
subject | True | string |
Assunto do registro. |
|
Conteúdo html
|
contentHtml | string |
Conteúdo do registro em Html. |
|
|
Conteúdo de texto sem formatação
|
contentPlain | string |
Conteúdo do registro em texto sem formatação. |
|
|
Variante
|
kind | True | string |
Tipo de registro. |
|
Nome do Remetente
|
from | string |
Nome do remetente. |
|
|
Por email
|
emailFrom | string |
Email do remetente. |
|
|
Para
|
emailTo | string |
Destinatários da mensagem separada por um ponto-e-vírgula. |
|
|
Copiar
|
emailCc | string |
Destinatários da mensagem separada por um ponto-e-vírgula. |
|
|
Da ID da Pessoa
|
fromPersonId | integer |
ID da pessoa do autor (tPerson.iPersonId). |
|
|
ID de Pessoa
|
toPersonId | integer |
ID da pessoa do receptor (tPerson.iPersonId). |
|
|
Data de criação
|
created | string |
Data e hora em que deve ser o registro criado. 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. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Registro
|
id | integer |
ID do registro de log (tAct.iActId). |
|
Assunto
|
subject | string |
Assunto do registro de log. |
|
Conteúdo html
|
contentHtml | string |
Registrar conteúdo de log em HTML. |
|
Conteúdo de texto sem formatação
|
contentPlain | string |
Registrar conteúdo em log em texto sem formatação. |
|
Data de criação
|
created | string |
Data de criação do registro de log. |
|
Variante
|
kind | string |
Tipo de registro de log. |
|
Nome do Remetente
|
from | string |
Nome do autor do registro de log. |
|
Por email
|
emailFrom | string |
Email do autor do registro de log. |
|
Para
|
emailTo | string |
E-mails de receptores de registro de log. |
|
Copiar
|
emailCc | string |
E-mails de receptores de registro de log. |
|
Da ID da Pessoa
|
fromPersonId | integer |
ID do remetente do registro de log (tPerson.iPersonId). |
|
ID de Pessoa
|
toPersonId | integer |
ID do receptor do registro de log (tPerson.iPersonId). |
|
ID da mensagem
|
messageId | string |
ID da mensagem de registro de log. |
|
Attachments
|
attachments | array of object |
Anexos de registro de log. |
|
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. |
Criar tíquete
Cria um novo tíquete.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Serviço
|
serviceId | True | integer |
ID do serviço de tíquete (tHdSection.iHdSectionId). |
|
Nome
|
name | True | string |
Nome do tíquete. |
|
Description
|
descriptionHtml | string |
Descrição do tíquete em HTML. |
|
|
SLA ID
|
slaId | integer |
TÍquete SLA ID (tSla.iSlaId). |
|
|
Priority
|
priority | string |
Prioridade de tíquete. |
|
|
Impacto
|
impact | string |
Impacto do tíquete. |
|
|
Urgência
|
urgency | string |
Urgência do tíquete. |
|
|
Número do dispositivo
|
deviceNumber | string |
Número do dispositivo de tíquete. |
|
|
Organização relacionada
|
relatedOrganization | string |
Nome da organização relacionada ao tíquete. |
|
|
ID da pessoa solicitada
|
requestedForPersonId | integer |
Solicitado para ID de pessoa (tPerson.iPersonId). |
|
|
ID
|
id | integer |
ID do solicitante (tPerson.iPersonId). |
|
|
Nome
|
name | string |
Nome do solicitante. |
|
|
Email
|
string |
Email do solicitante. |
||
|
Email 2
|
email2 | string |
Email do solicitante 2. |
|
|
Telefone
|
phone | string |
Telefone solicitante. |
|
|
Telefone 2
|
phone2 | string |
Telefone do solicitante 2. |
|
|
Celular
|
mobilePhone | string |
Telefone celular solicitante. |
|
|
Departamento
|
department | string |
Departamento solicitante. |
|
|
Office
|
office | string |
Escritório do solicitante. |
|
|
Posição de trabalho
|
workPosition | string |
Posição de trabalho do solicitante. |
|
|
Organização
|
organization | string |
Organização solicitante. |
|
|
Outros Contatos
|
otherContacts | string |
Solicitar outros contatos. |
|
|
Objetos
|
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 tíquete (tHdTicketCust). |
Retornos
- Corpo
- SD.Ticket
Importar objetos do CSV
Importa objetos fornecidos no formato CSV. Funcionalidade semelhante ao utilitário ImportUtil.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
CSV
|
contentCsv | True | string |
Conteúdo CSV a ser importado. |
|
Tipo de objeto
|
objectTypeId | integer |
O tipo de objetos importados. |
|
|
Formato datetime
|
dateTimeFormat | string |
Formato datetime em cadeias de texto (por exemplo, dd/MM/yyyyy). |
|
|
Separador
|
separator | string |
O separador de coluna usado no CSV importado. |
|
|
Ignorar erros
|
skipErrors | boolean |
Se habilitados, os dados serão importados mesmo se houver um erro em uma das entradas. |
|
|
Propriedades de chave
|
keyFields | string |
Campos de 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 habilitados, os objetos descartados também são pesquisados e atualizados na importação. |
Retornos
- Corpo
- AM.ImportCsvResponse
Mover o tíquete para outro serviço
Move o tíquete para outro serviço. A ID do Serviço ou o Nome do Serviço são necessários.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
|
ID do Serviço
|
serviceId | integer |
Nova ID de serviço (tHdSection.iHdSectionId). |
|
|
Nome do serviço
|
serviceName | string |
Novo nome de serviço. |
|
|
Solver ID
|
newSolverId | integer |
Nova ID do solucionador (tPerson.iPersonId). |
|
|
ID da equipe do Solver
|
newSolverTeamId | integer |
Nova ID da equipe do solver (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. |
Retornos
- response
- string
Mover objeto
Move um objeto para um destino especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Object
|
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). |
Obter objeto
Retorna o objeto com suas propriedades.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Object
|
objectId | True | integer |
Selecione o objeto ou insira sua ID (tblNode.intNodeId). |
Retornos
- Corpo
- AM.ObjectExpanded
Obter objetos
Retorna objetos com suas propriedades de acordo com os parâmetros OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
TOP
|
$top | integer |
Especifique o número de objetos que você deseja retornar. |
|
|
Pesquisa
|
$search | string |
Especifique a condição de pesquisa de texto completo. OData $search. |
|
|
Filter
|
$filter | string |
Especifique o filtro, por exemplo, Nome eq 'Milk'. OData $filter. |
|
|
Ordenar por
|
$orderBy | string |
Especifique a ordem. OData $orderBy. |
Retornos
Obter tíquete
Retorna as propriedades do tíquete.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
Especifique a ID do tíquete (tHdTicket.iHdTicketId). |
Retornos
- Corpo
- SD.Ticket
Obter usuários
Retorna usuários e suas propriedades de acordo com os parâmetros OData.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
TOP
|
$top | integer |
Especifique o número de objetos que você 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. |
|
|
Ordenar por
|
$orderBy | string |
Especifique a ordem. OData $orderBy. |
Retornos
- Corpo
- Common.UsersApiResponse
Gatilhos
| Quando um objeto é criado |
Essa operação é disparada quando um objeto de um determinado tipo é criado. |
| Quando um objeto é movido |
Essa operação é disparada quando um objeto de determinado tipo é movido para uma posição diferente na árvore de objetos. |
| Quando um tíquete faz a transição para um status |
Essa operação é disparada quando um tíquete faz a transição para um determinado status. |
| Quando um valor de campo de tíquete é alterado |
Essa operação é disparada quando um determinado valor de campo de tíquete é alterado. |
| Quando um valor de uma propriedade de objeto é alterado |
Essa operação é disparada quando um valor de uma determinada propriedade de objeto é alterado. |
Quando um objeto é criado
Essa operação é disparada quando um objeto de um determinado tipo é criado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Variante
|
kindId | integer |
Selecione o tipo do objeto para o qual você deseja disparar esse fluxo. |
|
|
Objeto Pai
|
parentObjectId | integer |
Selecione o objeto pai para cuja subárvore você deseja disparar esse fluxo. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do objeto
|
objectId | integer |
ID do objeto (tblNode.intNodeId). |
Quando um objeto é movido
Essa operação é disparada quando um objeto de determinado tipo é movido para uma posição diferente na árvore de objetos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Variante
|
kindId | integer |
Selecione o tipo do objeto para o qual você deseja disparar esse fluxo. |
|
|
Movido de
|
fromObjectId | integer |
Selecione o objeto de origem para cuja subárvore você deseja disparar esse fluxo. |
|
|
Movido para
|
toObjectId | integer |
Selecione o objeto de destino para cuja subárvore você deseja disparar esse fluxo. |
Retornos
| Nome | 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 tíquete faz a transição para um status
Essa operação é disparada quando um tíquete faz a transição para um determinado status.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Processo
|
process | True | string |
Insira o nome do processo para o qual você deseja disparar esse fluxo. |
|
Status do tíquete
|
status | True | string |
Insira o nome do status do tíquete. A transição de tíquete para esse status disparará esse fluxo. |
|
Service
|
service | string |
Insira o nome do serviço para o qual você deseja disparar esse fluxo. |
Retornos
- Corpo
- Webhook.UpdatedTicket
Quando um valor de campo de tíquete é alterado
Essa operação é disparada quando um determinado valor de campo de tíquete é alterado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Campo
|
fieldId | True | integer |
Selecione um campo de tíquete. |
|
Processo
|
process | string |
Insira o nome do processo para o qual você deseja disparar esse fluxo. |
|
|
Service
|
service | string |
Insira o nome do serviço para o qual você deseja disparar esse fluxo. |
Retornos
- Corpo
- Webhook.UpdatedTicket
Quando um valor de uma propriedade de objeto é alterado
Essa operação é disparada quando um valor de uma determinada propriedade de objeto é alterado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Propriedade
|
propertyKindId | integer |
Selecione a propriedade do objeto para o qual você deseja disparar esse fluxo. |
|
|
Novo Valor
|
newValue | string |
Insira o novo valor da propriedade para a qual você deseja disparar esse fluxo. Por exemplo, PC123, 1,45, 14. 4 2024. |
|
|
Tipo de objeto
|
kindId | integer |
Selecione o tipo do objeto para o qual você deseja disparar esse fluxo. |
|
|
Objeto Pai
|
parentObjectId | integer |
Selecione o objeto pai para cuja subárvore você deseja disparar esse fluxo. |
Retornos
| Nome | 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
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | integer |
ID do tíquete (tHdTicket.iHdTicketId). |
|
Nome
|
name | string |
Nome do tíquete. |
|
Marca de mensagem
|
messageTag | string |
Marca de mensagem de tíquete. |
|
SLA ID
|
slaId | integer |
ID de SLA (tSla.iSlaId). |
|
Nome do SLA
|
slaName | string |
Nome do SLA. |
|
Priority
|
priority | string |
Prioridade de tíquete. |
|
Impacto
|
impact | string |
Impacto do tíquete. |
|
Urgência
|
urgency | string |
Urgência do tíquete. |
|
Número do dispositivo
|
deviceNumber | string |
Número do dispositivo de tíquete. |
|
Organização relacionada
|
relatedOrganization | string |
Nome da organização relacionada ao tíquete. |
|
Data de destino interna
|
internalTargetDate | date-time |
Data de destino interna do tíquete. |
|
Destino Interno
|
internalTarget | string |
Destino interno do tíquete. |
|
ID do solicitante
|
requesterId | integer |
ID do solicitante (tPerson.iPersonId). |
|
Nome do solicitante
|
requesterName | string |
Nome do solicitante. |
|
Solicitação de ID
|
requestedForId | integer |
Solicitado para ID (tPerson.iPersonId). |
|
Solicitado para nome
|
requestedForName | string |
Solicitado para o nome. |
|
Solver ID
|
solverId | integer |
ID do solucionador de tíquetes (tPerson.iPersonId). |
|
Nome do solucionador
|
solverName | string |
Nome do solucionador de tíquetes. |
|
ID da equipe do Solver
|
solverTeamId | integer |
ID da equipe do solucionador de tíquetes (tRole.iRoleId). |
|
Nome da equipe do Solver
|
solverTeamName | string |
Nome da equipe do solucionador de tíquetes. |
|
ID do Serviço
|
serviceId | integer |
ID do serviço de tíquete (tHdSection.iHdSectionId). |
|
Nome do serviço
|
serviceName | string |
Nome do serviço de tíquete. |
|
Nome do Processo
|
processName | string |
Nome do processo de serviço. |
|
Status ID
|
stateId | integer |
ID do status do tíquete (TicketState.id). |
|
Nome do Status
|
stateName | string |
Nome do status do tíquete. |
|
Data de criação
|
createdDate | date-time |
Data da criação do tíquete. |
|
Data de resolução
|
resolvedDate | date-time |
Data da resolução do tíquete. |
|
Data de Encerramento
|
closedDate | date-time |
Data do fechamento do tíquete. |
|
ID do Ato Inicial
|
initialActId | integer |
ID do ato inicial (tAct.iActId). |
|
Data removida
|
removedDate | date-time |
Data da remoção do tíquete. |
|
Em Aprovação
|
inApproval | boolean |
Se o tíquete está em processo de aprovação. |
|
Data de vencimento
|
dueDate | date-time |
Data de conclusão do tíquete. |
|
Objetos
|
objects | array of object |
Links para objetos. |
|
ID
|
objects.objectId | integer |
ID do objeto (tblNode.intNodeId). |
|
Itens Personalizados
|
customItems | object |
Itens personalizados de tíquete (tHdTicketCust). |
Webhook.UpdatedTicket
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tíquete
|
requestId | integer |
ID do tíquete (tHdTicket.iHdTicketId). |
|
ID da pessoa
|
personId | integer |
ID da pessoa que fez a alteração (tPerson.iPersonId). |
SOU. Objeto
| Nome | 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. |
|
ID do tipo
|
kindId | integer |
ID do tipo objeto (tblKind.intKindId). |
|
Nome do Tipo
|
kindName | string |
Nome do tipo objeto. |
|
Oculto
|
hidden | boolean |
Se o objeto está oculto. |
|
ID do objeto pai
|
parentObjectId | integer |
ID do objeto pai (tblNode.intNodeId). |
SOU. ObjectExpanded
| Nome | 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. |
|
ID do tipo
|
kindId | integer |
ID do tipo objeto (tblKind.intKindId). |
|
Nome do Tipo
|
kindName | string |
Nome do tipo objeto. |
|
Oculto
|
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. |
|
Value
|
properties.value | string |
Valor da propriedade. |
|
Ordem do Nome
|
properties.nameOrder | integer |
Ordem do nome da propriedade. |
SOU. ObjectsExpandedApiResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of AM.ObjectExpanded |
SOU. ImportCsvResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem total de registros
|
recordsTotalCount | integer |
Contagem total de registros em CSV. |
|
Contagem de registros processados
|
recordsProcessedCount | integer |
Contagem de registros 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 atualizados
|
objectsUpdatedCount | integer |
Contagem de objetos atualizados. |
|
Log
|
log | string |
Importar log contendo informações detalhadas. |
Common.Person
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
name | string |
Nome de usuário e sobrenome. |
|
Email
|
string |
Email do usuário. |
|
|
Email 2
|
email2 | string |
Email do usuário 2. |
|
Telefone De Trabalho
|
phone | string |
Telefone de trabalho do usuário. |
|
Telefone comercial 2
|
phone2 | string |
Telefone de trabalho do usuário 2. |
|
Celular
|
mobilePhone | string |
Telefone celular do usuário. |
|
Departamento
|
department | string |
Departamento de usuário. |
|
Office
|
office | string |
Office do usuário. |
|
Cargo
|
workPosition | string |
Posição de trabalho do usuário. |
|
Organização
|
organization | string |
Organização do usuário. |
|
Outros Contatos
|
otherContacts | string |
Usuário outros contatos. |
|
ID do Usuário
|
id | integer |
ID do usuário (tPerson.iPersonId). |
|
Nome de usuário (para sistemas mais antigos)
|
sAMAccountName | string |
Nome de usuário que dá suporte à versão anterior do Windows. |
|
Nome de usuário
|
login | string |
Nome de usuário do usuário. |
|
Criado
|
createdDate | date-time |
Data criada pelo usuário. |
|
É o Sistema
|
isSystem | boolean |
Se o usuário é o Sistema Alvao. |
|
Está oculto
|
isHidden | boolean |
Se o usuário está oculto nos menus. |
|
É Compartilhado
|
isShared | boolean |
Se o usuário é uma conta compartilhada. |
|
Está desabilitado
|
isDisabled | boolean |
Se o usuário é uma conta desabilitada. |
|
É Convidado
|
isGuest | boolean |
Se o usuário é o usuário convidado. |
|
É o aplicativo
|
isApp | boolean |
Se o usuário é uma conta de aplicativo. |
|
Removido
|
removedDate | date-time |
Data de remoção do usuário. |
|
ID do gerente
|
managerId | integer |
ID do gerenciador de usuários (tPerson.iPersonId). |
|
ID de substituição
|
substituteId | integer |
ID de substituto do usuário (tPerson.iPersonId). |
|
Número Pessoal
|
personalNumber | string |
Número pessoal do usuário. |
|
ID de idioma preferencial
|
localeId | integer |
ID de idioma preferencial 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. |
|
Primeiro Nome
|
firstName | string |
Nome do usuário. |
|
Apelido
|
lastName | string |
Sobrenome do usuário. |
|
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 de usuário |
Common.UsersApiResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of Common.Person |
cadeia
Esse é o tipo de dados básico 'string'.