Ir para o conteúdo

Atividade de Envio JMS

Introdução

Uma atividade JMS Send, usando sua conexão JMS, envia mensagens para uma fila ou tópico JMS e se destina a ser usado como destino em uma operação.

Crie uma Atividade de Envio JMS

Uma instância de uma atividade JMS Send é criada a partir de uma conexão JMS usando seu tipo de atividade Send.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade JMS Send existente pode ser editada nestes locais:

Configurar uma Atividade de Envio JMS

Siga estas etapas para configurar uma atividade JMS Send:

Etapa 1: Insira um Nome e Especifique as Configurações

Nesta etapa, forneça um nome para a atividade e especifique as configurações das mensagens que estão sendo enviadas. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade de envio JMS

Dica

Campos com ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade JMS Send e não deve conter barras / ou dois pontos :.

  • Tipo de Destino: Selecione o destino das mensagens que estão sendo enviadas, entre Fila ou Tópico.

    • Fila: Selecione para enviar uma mensagem para uma fila.

    • Tópico: Selecione para enviar uma mensagem para um tópico.

  • Nome da Fila / Nome do Tópico: Dependendo do Tipo de Destino, insira o nome da fila ou tópico para onde a mensagem será enviada.

    Nota

    Ao usar o IBM MQ como o provedor JMS, o Nome da fila ou Nome do tópico deve corresponder ao nome de uma fila ou tópico existente na instância do IBM MQ ou um erro ocorrerá ocorrer. Ao usar o Active MQ como provedor JMS, uma fila ou tópico será criado se não houver uma fila ou tópico existente com um nome correspondente ao nome inserido.

  • Tipo de mensagem: Especifique o tipo de mensagem a ser usado, Texto ou Byte.

  • Modo de entrega: Especifique o modo de entrega a ser usado, Persistente ou Não persistente. Se Persistente for selecionado, as mensagens serão persistidas em um disco ou banco de dados para que sobrevivam à reinicialização do broker. Se Não persistente for selecionado, todas as mensagens em trânsito serão perdidas durante a reinicialização do broker.

  • Prioridade: Insira a prioridade da mensagem usando números inteiros de 0 (mais baixo) para 9 (Altíssima). o valor padrão é 4.

  • Tempo de vida (milissegundos): Insira o tempo em milissegundos que as mensagens devem permanecer na fila ou tópico. o valor padrão é 0, o que significa que a mensagem permanecerá na fila ou no tópico indefinidamente.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revise os Esquemas de Dados

Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint serão exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade de envio JMS

  • Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    Os esquemas de dados de solicitação e resposta consistem nestes nós e campos:

    Nó/campo do esquema de solicitação Descrição
    sendMessageRequest Nó que representa a solicitação de mensagem
    messageBody O corpo da mensagem JMS
    replyTo O destino da resposta
    JMSCorrelationID O ID de correlação (se um ID de correlação não for inserido, um será gerado automaticamente em tempo de execução)
    customMessageProperties Nó que representa as propriedades da mensagem customizada
    customMessagePropertyString Nó que representa o conteúdo das propriedades da mensagem customizada que está na forma de uma string
    item Nó que representa a mensagem com propriedades customizadas
    name O nome da propriedade customizada
    value O valor da propriedade customizada
    customMessagePropertyInteger Nó que representa as propriedades da mensagem customizada que estão na forma de um número inteiro
    item Nó que representa o conteúdo das propriedades da mensagem customizada
    name O nome da propriedade customizada
    value O valor da propriedade customizada
    customMessagePropertyFloat Nó que representa as propriedades da mensagem customizada que estão na forma de um float
    item Nó que representa o conteúdo das propriedades da mensagem customizada
    name O nome da propriedade customizada
    value O valor da propriedade customizada
    customMessagePropertyDouble Nó que representa as propriedades da mensagem customizada que estão na forma de um duplo
    item Nó que representa o conteúdo das propriedades da mensagem customizada
    name O nome da propriedade customizada
    value O valor da propriedade customizada
    customMessagePropertyBoolean Nó que representa as propriedades da mensagem customizada que estão na forma de um booleano
    item Nó que representa o conteúdo das propriedades da mensagem customizada
    name O nome da propriedade customizada
    value O valor da propriedade customizada
    Nó/campo do esquema de resposta Descrição
    sendMessageResponse Nó representando a resposta
    isSent Booleano representando o status da mensagem com true indicando que a mensagem foi enviada
    JMSCorrelationID String contendo o ID de correlação
    errorDetails Nó que representa os detalhes do erro
    errorCode String contendo qualquer código de erro aplicável
    errorMsg String contendo qualquer mensagem de erro aplicável

  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para regenerar esquemas do endpoint JMS. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos

Depois de configurar uma atividade JMS Send, conclua a configuração da operação incluindo e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu Ações da atividade em Noções básicas do conector.

As atividades JMS Send podem ser usadas como destino com estes padrões de operação:

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e execute a operação e validar o comportamento verificando os logs de operação.