...
- Na página Aplicativos conectados , clique em Criar operação , como mostrado abaixo.
- A página Criar operação é exibida.
- Na guia Detalhes da operação , adicione detalhes da operação:
- Digite o nome da operação.
- Selecione um dos WSDL adicionados para o aplicativo.
- Selecione o método de vinculação. Os métodos de vinculação são preenchidos automaticamente com base no WSDL selecionado
- Selecione a operação. O sistema exibe automaticamente as operações suportadas para o WSDL selecionado e o método de vinculação
- Especifique o tempo limite (em milissegundos) da operação. Essa é a quantidade de tempo de espera por uma resposta do serviço web ao invocar uma solicitação de saída. O valor padrão é 10000 milissegundos, 10 segundos; o valor mínimo é 1000 milissegundos; e o valor máximo permitido é 3 minutos, 180000 milissegundos.
- Clique em Avançar para especificar os detalhes da Configuração da solicitação . A página Configuração da solicitação é exibida, como mostrado abaixo.
- Cabeçalhos: cabeçalhos são, em sua maioria, classificados como cabeçalhos de solicitação. Será necessário definir os cabeçalhos de solicitação quando você estiver enviando a solicitação. Os cabeçalhos especificados no nível da instância são preenchidos automaticamente. Você pode substituir a configuração definida no nível da instância ou continuar usando a mesma
- Ignorar cabeçalho global: se precisar substituir a configuração definida no nível da instância, selecione Ignorar cabeçalhos globais e você poderá adicionar a variável e os valores específicos da operação.
- Insira o Campo externo e o Valor.
- Insira o Campo externo e o Valor.
- Carga de saída: a carga de solicitação que deve ser passada ao aplicativo externo. FormData é a codificação padrão que um formulário da web usa para transferir dados. A área da caixa de texto aceita pares de chave-valor simples e JSON complexo/aninhado.
- Clique em Avançar para criar a Configuração de resposta. A seção Configuração de resposta é usada para processar os dados ou a resposta recebidos do serviço web externo.
- Mapeamento de entrada: nessa seção, você pode transformar os dados recebidos como uma resposta e atribuí-los aos atributos de usuário Local, Global e Personalizado. Esses dados, por sua vez, podem ser usados na criação de habilidades, como operações de terceiros, avaliação de regras, definição de respostas de bot, atribuição de valores aos atributos personalizados do usuário. Existem duas maneiras de configurar os atributos.
- Definir atributo: usado para armazenar informações em um atributo. Selecione Definir Atributo .
- Transformar: as funções de transformação são usadas quando as informações recebidas da integração devem ser convertidas antes de serem usadas em uma operação ou na habilidade.
Por exemplo, extrair o número do ticket do identificador de ticket recebido de um sistema ITSM e fornecê-lo a um cliente. A Luma fornece uma variedade de funções de transformação para permitir que os desenvolvedores de habilidades manipulem os dados conforme necessário, como dividir, cortar, subsequência de caracteres, substituir, data e hora personalizadas, etc.
Para definir o mapeamento de entrada, siga as etapas abaixo:- Adicionar tipo de expressão e expressão: representam o tipo (valor ou JSON) e o caminho do local do valor a ser atribuído ao atributo
- Use Tipo de expressão → Valor quando um valor tiver que ser atribuído ao atributo; por ex.: @{response.body}, @{response.code}.
- Use Tipo de expressão → JSONPath quando um valor da resposta JSON recebida tiver que ser atribuído ao atributo; por exemplo, quando Expressão apontar para um caminho JSON
- Use Tipo de expressão → JSONPath indireto quando um valor de um atributo do tipo JSON tiver que ser atribuído ao atributo, por exemplo, quando Expressão apontar para um atributo que mantém um caminho JSON, como @{local.items}→$.[*].TicketIdentifier
- Use Tipo de expressão → XPath quando um valor tiver que ser atribuído ao atributo, isto é, quando Expressão apontar para um caminho, por exemplo, //AddResponse/AddResult
- Definir saída para atributo: usado para armazenar os dados.
- Escopo: representa o escopo do atributo a ser usado para manter os valores de entrada
- Use Global para atribuir valor a um atributo global a ser usado na habilidade. Embora os atributos sejam disponibilizados para uso de outras habilidades, o valor fica retido durante a execução da habilidade.
- Use Local para criar e definir o valor para um atributo local. Esses atributos são válidos e estão disponíveis somente durante a execução da habilidade. O valor da variável local é retido entre os prompts e é usado para passar dados entre várias integrações, mensagens de usuário ou regras. Se usado após uma resposta do bot, o valor no atributo Local será perdido.
- Use Personalizado do usuário para atribuir valor a um atributo personalizado do usuário. Esses atributos retêm os valores atribuídos, a não ser que sejam substituídos.
- Atributo: nome do atributo
- Tipo de dado: representa o tipo de dado do valor. Inteiro, Longo, Booleano, etc.
- Escopo: representa o escopo do atributo a ser usado para manter os valores de entrada
Para usar a função Transformação, use Transformar em Definir atributo. Para obter mais informações sobre como usar as funções de transformação,
consulteconsulte Usando funções de transformação
Info - Quando uma operação é adicionada ao fluxo de conversa de uma habilidade, os atributos locais criados nas operações podem ser usados para criar a habilidade. Um atributo local pode ser referido como @{local.}
- Use atributos do tipo XML para armazenar dados XML recebidos da integração. Para se referir a uma lista/matriz de valores em um caminho XML, use o atributo do tipo LISTA.
- A expressão INDIRECT JSONPATH & INDIRECT XPATH pode ser usada para atribuir valores a atributos do tipo JSON e XML.
- Adicionar tipo de expressão e expressão: representam o tipo (valor ou JSON) e o caminho do local do valor a ser atribuído ao atributo
- Tratamento de erros: essa seção é usada para definir o comportamento e a resposta do bot para o usuário quando a execução da operação resulta em um erro. Você pode criar várias regras de tratamento de erros a partir das operações de serviço web.
- Selecione uma das opções a seguir de modo a definir uma regra para enviar a mensagem de erro. A mensagem de erro será enviada apenas se as condições especificadas forem validadas:
- Fazer a correspondência de qualquer condição abaixo: uma das condições especificadas deve corresponder para análise da mensagem de erro.
- Fazer a correspondência de todas as condições abaixo: todas as condições especificadas devem ser validadas para análise da mensagem de erro.
- Definir critérios personalizados: é possível definir critérios personalizados com base em condições determinadas para análise da mensagem de erro, se validada.
Por exemplo, 1 e 2 ou 3. A primeira e a segunda condição devem corresponder ou apenas a terceira condição deve corresponder. Você pode inserir apenas números, e, ou, (,) (,)
Especifique @response.StatusCode no campo Chave seguido por um operador. Veja a seguir uma lista de operadores suportados.- Igual a
- É diferente de
- É superior a
- É superior ou igual a
- É inferior a
- É inferior ou igual a
- Começa com
- Não começa com
- Termina com
- Não termina com
- Contém
- Não contém
- Está vazio
- Não está vazio
- corresponde ao padrão
- Sem tratamento dos dados: essa seção é usada para definir o comportamento e a resposta do bot ao usuário quando a execução da operação não retorna dados. Você pode criar várias regras para tratamento de cenários sem dados a partir das operações do serviço web. Siga os valores de retorno da API dos sistemas externos dos quais você recebe os dados e, proporcionalmente, escreva/avalie os valores na seção Regras/condições.
- Tratamento bem-sucedido: essa seção é usada para definir o comportamento e a resposta do bot ao usuário quando a execução da operação é bem-sucedida. Crie várias regras de tratamento bem-sucedido a partir das operações de serviço web.
- Mapeamento de entrada: nessa seção, você pode transformar os dados recebidos como uma resposta e atribuí-los aos atributos de usuário Local, Global e Personalizado. Esses dados, por sua vez, podem ser usados na criação de habilidades, como operações de terceiros, avaliação de regras, definição de respostas de bot, atribuição de valores aos atributos personalizados do usuário. Existem duas maneiras de configurar os atributos.
...
- No menu Tenant , clique em Integrações.
- Todos os aplicativos conectados são listados como mostrado abaixo, onde a opção de edição está disponível.
- Clique no botão Editar . A página Aplicativo conectado é exibida.
- Aqui, podemos editar os detalhes como tipo de integração, instância padrão, operação de logon e operação de logoff.
As operações de logon de logon e logoff são úteis quando uma funcionalidade/operação exige uma condição de pré-logon e pós-logoff.
Por exemplo, as operações de logon e logoff podem ser usadas para controle de sessão. Ao executar uma operação por meio de uma habilidade, a operação de logon geraria um token e reservaria a sessão. Após a conclusão da tarefa, a operação de logoff vai liberar a sessão. Isso garante a utilização ideal das sessões alocadas ao usuário da API. Depois de selecionar as operações necessárias, clique em Atualizar para salvar as alterações.
...