Compartilhar via


Tíquete do Tesseron (versão prévia)

Esse conector permite que você use o Tíquete do Tesseron para criar, editar e pesquisar tíquetes.

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 Tesseron
URL https://www.docs.tesseron.de
Email development@llnet.de
Metadados do conector
Publicador Tesseron por Luithle + Luithle GmbH
Site da Web https://www.tesseron.de
Política de privacidade https://www.llnet.de/data-protection/
Categorias Operações de TI; Comunicação

Esse conector permite que você crie, edite e pesquise tíquetes em sua Instância do Tesseron. Crie, atualize e recupere todas as informações dos tíquetes. Integre o Tesseron aos seus fluxos e automatize seus processos de negócios.

Pré-requisitos

Você precisará do seguinte para continuar:

  • Uma instância do Tesseron
  • Um usuário licenciado do Tesseron
  • Uma chave de API (Serviço: Tíquete)

Obtendo credenciais

A autenticação é feita por meio de uma chave de API. Forneça a chave de API e os parâmetros de conexão da URL da instância.

Operações com suporte

O conector dá suporte às seguintes operações:

  • Criar tíquete: criar um tíquete na instância do Tesseron
  • Criar Posição do Tíquete: adicionar uma nova posição ao seu tíquete (informações, relatório final, reabrir)
  • Obter tíquete: receber todas as informações de tíquete com um tíquete ou número de referência
  • Tíquete de Pesquisa: receber um número de tíquete fornecendo um número de referência
  • Pesquisar tíquete por parâmetro: receber informações de tíquete fornecendo uma consulta de pesquisa
  • GetTicketFieldGroupConfig: Configurações do grupo de campos Recieve com base no tipo de tíquete, ID do tíquete ou id de configurações.
  • GetAllTicketTypes: receber todos os tipos de tíquetes existentes
  • GetAllAreas: receba todas as áreas de tíquete.
  • GetAllStartAreas: Receba todas as áreas iniciais para ingressos.

Instruções de implantação

Como a API Rest do Tesseron usa chaves de API para validar o usuário, primeiro você precisa entrar em contato com o administrador do sistema para criar uma chave de API para o usuário. Depois que isso for concluído, você poderá criar sua conexão do Tesseron.

  1. Verifique os direitos do usuário Com esse conector, você poderá executar ações de ativo em sua instância do Tesseron. Portanto, você precisa ter os direitos de usuário obrigatórios.

  2. Aplique-se à chave de API atualmente, as chaves de API só podem ser criadas pelo administrador do sistema. Portanto, solicite sua chave de API do administrador do sistema.

  3. Criar uma nova conexão

    • Fornecer a URL da instância do Tesseron
    • Insira sua chave de API do Tesseron

Problemas e limitações conhecidos

  • Direitos de usuário suficientes são obrigatórios.

Erros e soluções comuns

perguntas frequentes

Há algum custo extra usando esse conector? Não

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
URL da Instância cadeia URL da instância do Tesseron Verdade
API-Key secureString Seu API-Key do Tesseron (Serviço: Tíquete) Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Adicionar ativos a tíquetes

Adicionar ativos a tíquetes existentes

Criar posição do tíquete

CreateTicketPosition

Criar tíquete

CreateTicket

Obter configuração de grupo de campos de tíquete

Obter configuração de grupo de campos de tíquete

Obter informações sobre tíquetes

Obter informações sobre tíquetes

Obter tipos de tíquete

Obtenha todos os tipos de tíquete.

Obter todas as áreas

Obtenha todas as áreas.

Obter todas as áreas iniciais

Obtenha todas as áreas iniciais.

Pesquisar tíquete

Pesquisar o número do tíquete

Pesquisar tíquete por parâmetro

Pesquisar com uma cadeia de caracteres de pesquisa

Adicionar ativos a tíquetes

Adicionar ativos a tíquetes existentes

Parâmetros

Nome Chave Obrigatório Tipo Description
Número de referência
referenceNumber True string

Especificar o tíquete ou o número de referência

Ativos relacionados
RelatedAssetIds True array of integer

Especifique os ativos relacionados.

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Código de status
StatusCode integer

O código de status

Criar posição do tíquete

CreateTicketPosition

Parâmetros

Nome Chave Obrigatório Tipo Description
Número de referência
referenceNumber True string

Especificar o tíquete ou o número de referência

Texto de posição
ticketPositionText True string

Insira o texto da posição do tíquete

Tipo de Posição
TicketPositionType True integer

Especificar o tipo de posição

Visibilidade
TicketPositionVisibility True integer

Especificar a visibilidade da posição (todos os usuários/internos)

ID de Configurações do Grupo de Campos
TicketFieldGroupSettingsId string

Especifique o grupo de campos.

ID do Grupo de Campos de Tíquete
TicketFieldGroupId string

Especifique o grupo de campos de tíquete.

Nome
name string

Especifique o nome do campo.

Value
value string

Especifique o valor do campo.

Estacionar até
ParkUntil date-time

Especifique o fim do período de estacionamento.

Motivo do parque
ParkingReason integer

Especificar o motivo

Motivo do parque
ParkingPositionText string

Especifique a reassionamento do parque.

Ação do Parque
AfterParkingAction integer

Especificar a visibilidade da posição (todos os usuários/internos)

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Tíquetes
TicketNumber array of string

Tíquetes

ID da posição do tíquete
TicketPositionNumber string

ID da posição do tíquete criado

TicketStatus
TicketStatus array of object
Número do Tíquete
TicketStatus.TicketNumber string

Número do tíquete

Está estacionado?
TicketStatus.IsParked boolean

Valor se o tíquete solicitado estiver estacionado.

Estacionado de
TicketStatus.ParkedFrom string

Define o início do período de estacionamento.

Estacionado até
TicketStatus.ParkedUntil string

Define o fim do período de estacionamento.

Texto de status do parque
TicketStatus.ParkStatusText string

Define o texto de status do período de estacionamento.

Criar tíquete

CreateTicket

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do tipo tíquete
ticketType True integer

Escolha a ID do tipo tíquete.

Header
ticketHeader True string

Especifique o assunto do tíquete.

Description
ticketText True string

Especifique a descrição do tíquete.

ID da empresa
enterpriseId True integer

Especifique a ID do parceiro de negócios.

ID de contato
contactId integer

Selecione o contato principal.

Ativos relacionados
RelatedAssetIds array of integer

Especifique os ativos relacionados.

ID de Configurações do Grupo de Campos
TicketFieldGroupSettingsId string

Especifique o grupo de campos.

ID do Grupo de Campos de Tíquete
TicketFieldGroupId string

Especifique o grupo de campos de tíquete.

ID de Configurações de Campo
TicketFieldSettingsId string

Especifique a ID das configurações de campo.

Value
value string

Especifique o valor do campo.

Número de referência
referenceNumber string

Especifique o tíquete ou o número de referência.

Etiquetas
tags string

Especifique as marcas separadas por ponto-e-vírgula.

ID do tipo de entrada
entranceType True integer

Especifique o tipo de entrada.

ID da área
areaId True integer

Selecione a área

Opção Lançada
releasedOption True boolean

Especificar se o tíquete é um tíquete liberado

Opção Privada
privateOption True boolean

Especificar se o tíquete é um tíquete privado

Opção interna
internalOption True boolean

Especificar se este é um tíquete interno

Urgência
urgencyType True integer

Selecione a urgência.

Efeitos
effectsType True integer

Selecione os efeitos.

ID do projeto
projectId string

Especificar a ID do projeto do tíquete

ID do contrato de serviço
serviceContractId integer

Insira a ID do contrato de serviço

Editor de tíquetes
delegatedTicketEditor integer

Insira o editor do tíquete

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Tíquetes
TicketNumber array of string

Tíquetes

Número da Posição do Tíquete
TicketPositionNumber string

Número da Posição do Tíquete

Texto sem formatação de posição do tíquete
TicketPositionTextPlain string

Texto sem formatação de posição do tíquete

TicketStatus
TicketStatus array of object
Está estacionado?
TicketStatus.IsParked boolean

Valor se o tíquete solicitado estiver estacionado.

Estacionado de
TicketStatus.ParkedFrom string

Define o início do período de estacionamento.

Estacionado até
TicketStatus.ParkedUntil string

Define o fim do período de estacionamento.

Texto de status do parque
TicketStatus.ParkStatusText string

Define o texto de status do período de estacionamento.

Obter configuração de grupo de campos de tíquete

Obter configuração de grupo de campos de tíquete

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do tipo tíquete
TicketTypeId True integer

Insira a ID do tipo de tíquete

ID do tíquete
TicketId string

Insira a ID do tíquete

ID de Configurações do Grupo de Campos
FieldGroupSettingsId string

Insira a ID de configurações do grupo de campos

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

ID de configurações
TicketFieldGroupSettingsId string

ID de Configurações do Grupo de Campos

ID do grupo
Group ID string

ID do grupo de campos

Nome
Name string

Nome do Grupo de Campos

Fields
Fields array of object

Campos do grupo de campos

ID de Configurações de Campo
Fields.TicketFieldSettingsId string

ID de configurações de campo

Nome do campo
Fields.Name string

Nome das configurações de campo

ID do tipo de campo
Fields.FieldType integer

ID do tipo de campo

Valor do campo
Fields.Value string

Valor do campo

Opções
Fields.Options array of object

Opções de campo

Nome da opção
Fields.Options.OptionName string

Nome da opção de campo

Valor da opção
Fields.Options.Value string

Nome da opção de campo

Obter informações sobre tíquetes

Obter informações sobre tíquetes

Parâmetros

Nome Chave Obrigatório Tipo Description
Número de referência
referenceNumber True string

Insira o tíquete ou o número de referência

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Número do Tíquete
TicketNumber string

Número do Tíquete

ID do tipo tíquete
TicketType integer

ID do tipo de tíquete

Nome do Tipo de Tíquete
TicketTypeName string

Nome do tipo de tíquete

Header
TicketHeader string

Assunto do tíquete

Description
TicketText string

Descrição do tíquete

Número de referência
ReferenceNumber string

Número de referência do tíquete

ID do tipo de entrada
EntranceType integer

ID do tipo de entrada do tíquete

Nome do tipo de entrada
EntranceTypeName string

Nome do tipo de entrada do tíquete

ID da área
AreaId integer

ID da área de tíquete

Nome da área
AreaName string

Nome da área do tíquete

ID do projeto
ProjectId string

ID do projeto relacionado

ID da fase do projeto
ProjectPhaseId string

Fase do projeto relacionado

ID da tarefa fase do projeto
ProjectPhaseTaskId string

Tarefa do projeto relacionado

Etiquetas
Tags array of string

Etiquetas

Opção Lançada
ReleasedOption boolean

ReleasedOption

Opção Privada
PrivateOption boolean

PrivateOption

Opção interna
InternalOption boolean

InternalOption

ID de urgência
UrgencyType integer

ID da urgência do tíquete

Nome da urgência
UrgencyTypeName string

Nome da urgência do tíquete

ID de efeitos
EffectsType integer

Efeitos do tíquete

Nome dos efeitos
EffectsTypeName string

Nome dos efeitos do tíquete

ID do contrato de serviço
ServiceContractId integer

ID do contrato relacionado

ID da empresa
EnterpriseId integer

ID da empresa principal de tíquetes

Nome da empresa
EnterpriseName string

Nome da empresa principal do tíquete

ID de contato
ContactId integer

ID do contato principal do tíquete

Nome do contato
ContactName string

Nome do contato principal do tíquete

Grupos de campos
FieldGroups array of object

Especifique grupos de campos para tíquetes cynamic.

Grupo de Campos
FieldGroups.Name string

Especifique o grupo de campos.

Fields
FieldGroups.properties array of object

Especifique os campos que contêm o grupo de campos.

Nome
FieldGroups.properties.name string

Especifique o nome do campo.

Value
FieldGroups.properties.value string

Especifique o valor do campo.

Obter tipos de tíquete

Obtenha todos os tipos de tíquete.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Resposta
ResponseType True integer

Insira o tipo de resposta procurado.

Pesquisa
Search string

Insira uma cadeia de caracteres de pesquisa.

Tamanho da Página
PageSize True integer

Especifique quantos tipos de tíquete você gostaria de receber.

Ignorar
Skip True integer

Especifique quantos tipos de tíquete você deseja ignorar.

Ordem por crescente
OrderByAsc boolean

Especifique quantos tipos de tíquete você deseja ignorar.

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Tipos de tíquete
TicketTypes array of object

Todos os tipos de tíquete

ID do tipo tíquete
TicketTypes.TicketTypeId integer

ID do tipo tíquete

Nome do Tipo de Tíquete (inglês)
TicketTypes.TicketTypeName_en string

Nome do tipo de tíquete em inglês.

Nome do Tipo de Tíquete (alemão)
TicketTypes.TicketTypeName_de string

Nome do tipo de tíquete em alemão.

Descrição do tipo de tíquete (inglês)
TicketTypes.TicketDescrpition_en string

Descrição do tipo de tíquete em inglês.

Descrição do tipo de tíquete (alemão)
TicketTypes.TicketDescrpition_de string

Descrição do tipo de tíquete em alemão.

Obter todas as áreas

Obtenha todas as áreas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Resposta
ResponseType True integer

Insira o tipo de resposta procurado.

Pesquisa
Search string

Insira uma cadeia de caracteres de pesquisa.

Tamanho da Página
PageSize True integer

Especifique quantos tipos de tíquete você gostaria de receber.

Ignorar
Skip True integer

Especifique quantos tipos de tíquete você deseja ignorar.

Ordem por crescente
OrderByAsc boolean

Especifique quantos tipos de tíquete você deseja ignorar.

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Areas
Areas array of object

Todas as áreas

ID da área
Areas.AreaId integer

ID da área

Nome da área
Areas.AreaName string

Nome da área

Opções de área
Areas.AreaOptions array of object

Opções de área

Nome do Tipo de Tíquete (inglês)
Areas.AreaOptions.TicketTypeName_en string

Nome do tipo de tíquete em inglês.

Nome do Tipo de Tíquete (alemão)
Areas.AreaOptions.TicketTypeName_de string

Nome do tipo de tíquete em alemão.

Descrição do tipo de tíquete (inglês)
Areas.AreaOptions.TicketDescrpition_en string

Descrição do tipo de tíquete em inglês.

Descrição do tipo de tíquete (alemão)
Areas.AreaOptions.TicketDescrpition_de string

Descrição do tipo de tíquete em alemão.

Obter todas as áreas iniciais

Obtenha todas as áreas iniciais.

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Resposta
ResponseType True integer

Insira o tipo de resposta procurado.

Pesquisa
Search string

Insira uma cadeia de caracteres de pesquisa.

Tamanho da Página
PageSize True integer

Especifique quantos tipos de tíquete você gostaria de receber.

Ignorar
Skip True integer

Especifique quantos tipos de tíquete você deseja ignorar.

Ordem por crescente
OrderByAsc boolean

Especifique quantos tipos de tíquete você deseja ignorar.

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Áreas de Partida
Areas array of object

Todas as áreas iniciais

ID da área
Areas.AreaId integer

ID da área

Nome da área
Areas.AreaName string

Nome da área

Tipos de tíquete
Areas.TicketTypes array of object

Tipos de tíquete

ID do tipo tíquete
Areas.TicketTypes.TicketTypeId integer

ID do tipo tíquete.

Nome do Tipo de Tíquete (inglês)
Areas.TicketTypes.TicketTypeName_en string

Nome do tipo de tíquete em inglês.

Nome do Tipo de Tíquete (alemão)
Areas.TicketTypes.TicketTypeName_de string

Nome do tipo de tíquete em alemão.

Descrição do tipo de tíquete (inglês)
Areas.TicketTypes.TicketDescrpition_en string

Descrição do tipo de tíquete em inglês.

Descrição do tipo de tíquete (alemão)
Areas.TicketTypes.TicketDescrpition_de string

Descrição do tipo de tíquete em alemão.

Pesquisar tíquete

Pesquisar o número do tíquete

Parâmetros

Nome Chave Obrigatório Tipo Description
Número de referência
referencenumber True string

Insira o tíquete ou o número de referência

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

Tíquetes
TicketNumber array of string

Tíquetes

Número da Posição do Tíquete
TicketPositionNumber string

Número da Posição do Tíquete

Número da posição do tíquete
TicketPositionTextPlain string

TicketPositionNumber

TicketStatus
TicketStatus array of object
Está estacionado?
TicketStatus.IsParked boolean

Valor se o tíquete solicitado estiver estacionado.

Estacionado de
TicketStatus.ParkedFrom string

Define o início do período de estacionamento.

Estacionado até
TicketStatus.ParkedUntil string

Define o fim do período de estacionamento.

Texto de status do parque
TicketStatus.ParkStatusText string

Define o texto de status do período de estacionamento.

Pesquisar tíquete por parâmetro

Pesquisar com uma cadeia de caracteres de pesquisa

Parâmetros

Nome Chave Obrigatório Tipo Description
Pesquisa
searchParam True string

Insira a cadeia de caracteres de pesquisa

Take
take True integer

Especificar quantos tíquetes você gostaria de receber

Ignorar
skip True integer

Especificar quantos tíquetes você gostaria de ignorar

Retornos

Nome Caminho Tipo Description
Message
Message string

Message

Êxito
Success boolean

Êxito

ID do tíquete
TicketId integer

ID do tíquete

Número do Tíquete
TicketNumber string

Número do tíquete

Número de referência
ReferenceNumber string

Número de referência do tíquete

Header
TicketHeader string

Cabeçalho de tíquete

Description
TicketText string

Descrição do tíquete

Description
TicketTextPlain string

Descrição do tíquete sem formatação.

Data de Criação
CreationDate string

Data de criação do tíquete.

Data de Criação (texto)
CreationDateText string

Data de criação do tíquete (texto).

Situação
TicketStatus string

Status do tíquete.