Ir para o conteúdo

Atividade JMS Send

Introdução

Uma atividade JMS Send, utilizando sua conexão JMS, envia mensagens para uma fila ou tópico JMS e é destinada a ser usada como um alvo em uma operação.

Criar uma atividade JMS Send

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 tela de design ou copie o tipo de atividade e cole-o na tela de design. Para mais detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade JMS Send existente pode ser editada a partir destes locais:

Configurar uma atividade JMS Send

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 para as mensagens que estão sendo enviadas. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Configuração da atividade JMS Send passo 1

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de 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, sendo um de Queue ou Topic.

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

    • Topic: 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 onde a mensagem deve ser enviada.

  • Tipo de mensagem: Especifique o tipo de mensagem a ser utilizada, sendo um de Text ou Byte.

  • Modo de entrega: Especifique o modo de entrega a ser utilizado, sendo um de Persistent ou Non-persistent. Se Persistent for selecionado, as mensagens são persistidas em um disco ou banco de dados para que sobrevivam a uma reinicialização do broker. Se Non-persistent for selecionado, todas as mensagens em trânsito são perdidas durante uma reinicialização do broker.

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

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

  • Configurações opcionais: Clique para expandir esta configuração opcional (visível apenas quando Use JNDI Lookup está selecionado na conexão):

    • Criar Destino se a Busca Falhar: Quando selecionado, e a fila ou tópico especificado não existir, uma nova fila ou tópico com o nome especificado é criado. Quando não selecionado (padrão), ocorrerá um erro quando a fila ou tópico especificado não existir.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

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

Configuração da atividade JMS Send etapa 2

  • 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 nos seguintes nós e campos:

    Nó/Campo do Esquema de Solicitação Descrição
    sendMessageRequest Nó representando 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 é gerado automaticamente em tempo de execução)
    customMessageProperties Nó representando as propriedades de mensagem personalizadas
    customMessagePropertyString Nó representando o conteúdo das propriedades de mensagem personalizadas que estão na forma de uma string
    item Nó representando a mensagem com propriedades personalizadas
    name O nome da propriedade personalizada
    value O valor da propriedade personalizada
    customMessagePropertyInteger Nó representando as propriedades de mensagem personalizadas que estão na forma de um inteiro
    item Nó representando o conteúdo das propriedades de mensagem personalizadas
    name O nome da propriedade personalizada
    value O valor da propriedade personalizada
    customMessagePropertyFloat Nó representando as propriedades de mensagem personalizadas que estão na forma de um float
    item Nó representando o conteúdo das propriedades de mensagem personalizadas
    name O nome da propriedade personalizada
    value O valor da propriedade personalizada
    customMessagePropertyDouble Nó representando as propriedades de mensagem personalizadas que estão na forma de um double
    item Nó representando o conteúdo das propriedades de mensagem personalizadas
    name O nome da propriedade personalizada
    value O valor da propriedade personalizada
    customMessagePropertyBoolean Nó representando as propriedades de mensagem personalizadas que estão na forma de um booleano
    item Nó representando o conteúdo das propriedades de mensagem personalizadas
    name O nome da propriedade personalizada
    value O valor da propriedade personalizada
    Node/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ó representando 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 ou na palavra Atualizar 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 para esta 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Enviar do JMS, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações de menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Conceitos básicos de conectores.

Atividades JMS Enviar podem ser usadas como um alvo com esses padrões de operação:

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

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.