Criação de uma atividade JMS

Crie uma atividade JMS personalizada para recuperar ou enviar mensagens para sistemas externos usando o Java Messaging Service.

Antes de Iniciar

Funções necessárias: activity_creator ou workflow_admin

Por Que e Quando Desempenhar Esta Tarefa

A atividade JMS oferece suporte a provedores JMS de terceiros cuja aplicação do cliente JMS é gravado com um padrão Java EE típico e pode oferecer suporte a estas operações:

• Usando JNDI para encontrar um objeto ConnectionFactory.
• Usando JNDI para encontrar um ou mais objetos de destino.
• Usando a ConnectionFactory para criar um objeto de conexão JMS.
• Usando a conexão JMS para criar um ou mais objetos de sessão JMS.
• Usando uma sessão JMS e os destinos para criar os objetos MessageProducer e MessageConsumer.
• Iniciando a conexão JMS para habilitar a entrega ou o consumo de mensagens.

Nota:

O designer de atividades JMS foi testado com os provedores JMS ActiveMQ e Tibco EMS. Ao se conectar a um provedor JMS, consulte a documentação do usuário de terceiros.

Procedimento

1. Crie ou verifique sua credencial JMS.
   Suas credenciais JMS devem ter permissão para o banco de dados de destino e configuração apropriada para a conexão JMS correspondente. As credenciais devem ser configuradas antes de criar uma atividade JMS.
2. Crie ou verifique sua conexão JMS.
   Sua conexão JMS deve ser configurada com credenciais JMS válidas antes que você possa criar uma atividade JMS.
3. Crie uma atividade personalizada.
   Esta ação cria uma atividade personalizada usando um modelo.
4. Depois de configurar as propriedades gerais e criar variáveis de entrada, configure o Comando de Execução JMS.

   Opção	Descrição
   Configurar suas credenciais	Preencha os campos necessários para sua conexão com o banco de dados.
   Connection Factory	Nome da Fábrica da Conexão JMS. É necessário criar ou verificar sua conexão JMS. Esta configuração vincula o nome da Fábrica de Contexto Inicial ao URL do provedor JMS.
   Tipo de destino	Tipo de destino usado para esta mensagem: Fila: a mensagem é colocada em fila para comunicações ponto a ponto. Nota: A operação GET só é compatível com o tipo de destino de Fila. Tópico: a mensagem é usada para comunicação de publicação e assinatura.
   Nome do destino	Nome da fila ou destino do tópico que está configurado no provedor JMS.
   Tipo da Mensagem	O valor do tipo de mensagem JMS. Somente mensagens de texto são compatíveis. A fila ou o destino do tópico deve ser configurado para receber ou enviar somente mensagens de texto. Outros tipos de mensagem são descartados, pois a Atividade JMS não pode processá-los.
   Operação	A operação programática a ser executada no destino. As opções são PUT ou GET.
   Tempo limite (Secs)	Tempo permitido para aguardar uma mensagem na fila de mensagens antes que ela atinja o tempo limite, em segundos. O padrão é 30.
   Cabeçalhos com mensagem personalizada	Os valores de cabeçalho personalizados em um formato de par de nome/valor, que está disponível no destino JMS. Nota: Isso só é compatível com uma operação PUT.
   Carga da mensagem	Conteúdo da mensagem real ou carga enviada para o destino JMS. Nota: Isso só é compatível com uma operação PUT.
   Marcador de credencial	Um marcador para uma credencial individual para qualquer atividade em um fluxo de trabalho da Orquestração.
   Requer recursos do MID Server	MID Server a ser usado, por recursos

O que Fazer Depois

• Use o mapeamento automático para gerar saídas e regras de análise
• Se você não usar o mapeamento automático, poderá criar variáveis de saída e regras de análisemanualmente

Criação de uma conexão JMS para uma Orquestração atividade

Configure seu sistema para usar o Java Messaging Service (JMS) com uma atividade JMS de personalizada da Orquestração.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

O MID Server deve ter connection factories JMS corretos para a sua organização. Configure esses valores no mid.property.jms.command.allowed_factory_namespropriedade, encontrada em MID Server > Propriedades. Os valores padrão desta propriedade podem ser alterados para qualquer valor ou lista separada por vírgulas de valores que o provedor JMS de terceiros divulga.

Procedimento

1. Navegar até MID Server > Arquivos JAR.
2. Clique em Novo e adicione.

   Opção	Descrição
   Nome	Um nome exclusivo e descritivo para identificar o arquivo na instância.
   Versão	Um número de versão para o arquivo, se houver uma disponível.
   Fonte	Local do arquivo JAR para fins de referência. As informações de origem não são usadas pelo sistema.
   Descrição	Descrição resumida do arquivo JAR e seu propósito na instância.

3. Clique no ícone do clipe de papel na faixa e anexe o arquivo jar do driver JMS.
   O arquivo jar do driver JMS deve estar disponível como parte da instalação do provedor JMS. Poucos fornecedores de JMS os disponibilizam como um produto separado. Consulte a documentação do provedor JMS para determinar quais arquivos jar do driver do cliente JMS exigem que as aplicações cliente se conectem ao provedor JMS. Por exemplo, se você estiver tentando se conectar ao ActiveMQ V5.10 (provedor JMS), será necessário o arquivo ativemq-all-5.10.1.jar.
4. Navegar até Orquestração > Credenciais e Conexões > Fábrica da Conexão JMS.
5. Clique em Novo, adicione o seguinte e clique em Enviar.

   Opção	Descrição
   Nome	Nome exclusivo desta fábrica de conexão.
   Fábrica de Contexto Inicial	Nome da classe JNDI que é usada para criar o InitialContext. Nota: Por exemplo, para conectar-se ao ActiveMQ V5.10 (JMS Provider), o valor é org.apache.activemq.jndi.ActiveMQInitialContextFactory.
   URL do Provedor	Local da instalação do provedor JMS em execução. Nota: Por exemplo, para se conectar a ActiveMQ V5.1: tcp://ipAddressOrHostName:61616.

6. Navegar até Orquestração > Credenciais.
7. Clique em Novo, selecione Credenciais JMSe forneça o nome de usuário e a senha que o MID precisa usar para se comunicar com o provedor JMS.
   Para obter mais informações, consulte Credenciais JMS Credenciais JMS.
8. Clique em Enviar.
   Tudo pronto para criar uma atividade JMS personalizada.

Parâmetros de execução do modelo JMS

Você usa parâmetros de execução para criar o script do processo de entrada no formulário de pré-processamento.

É necessário usar o prefixo executionParam. com todas as variáveis nesta tabela.

Tabela 1. Parâmetros de execução do JDBC

Nome	Variável	Tipo	Uso
Jms ds	jms_ds	Referência	Fonte de dados JMS selecionada.
Tipo de destino	destination_type	Enumerado
Nome do destino	destination_name	Cadeia de caracteres
Tipo de mensagem	message_type	Enumerado
Operação	operação	Enumerado
Tempo limite	time_out	Inteiro	Período de espera para que a consulta retorne resultados.
Cabeçalhos personalizados	custom_headers	Matriz de objetos JavaScript
Carga da mensagem	message_payload	Cadeia de caracteres
Marcador de credencial	credential_tag	Cadeia de caracteres	Lista de recursos MID Server exigidos.
MidCapabilities	midCapabilities	Cadeia de caracteres (separados por vírgulas)
ValueCapabilities	valueCapabilities	Matriz de hashmap	Valores de recursos usados para selecionar o MID Server. Para obter mais informações, consulte Recursos do MID Server. Se houver recursos adicionais atribuídos por valor, use este exemplo para personalizar a seleção do MID Server: var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability);

Parâmetros de pós-processamento do modelo JMS

Use esses parâmetros para criar um script de pós-processamento.

Tabela 2. Parâmetros de pós-processamento JMS

Nome	Variável	Tipo	Uso
Status	status	Cadeia de caracteres	Status da operação (Put ou Get) no destino JMS.
StandardHeaders	standardHeaders	Cadeia de caracteres	Todos os cabeçalhos padrão, conforme especificado pelo JMS, que são obtidos como parte da mensagem JMS durante uma operação Get. Este campo é aplicável somente para operações Get.
CustomHeaders	customHeaders	Cadeia de caracteres	Todos os cabeçalhos personalizados adicionados por um aplicativo de produção ou de publicação que são obtidos como parte da mensagem JMS durante uma operação Get. Este campo é aplicável somente para operações Get.
MessagePayload	messagePayload	Cadeia de caracteres	Carga da mensagem obtida como parte da mensagem JMS durante uma operação Get. Este campo é aplicável somente para operações Get.
EccSysID	eccSysID	Cadeia de caracteres	Contém o ID de referência associado à mensagem de entrada da Fila do ECC retornada pela atividade.
ErrorMessages	errorMessages	Cadeia de caracteres	Contém qualquer mensagem de erro retornada do comando do JMS. Este valor será nulo se não houver mensagens de erro.