--- sourceDocument: Capacidades da Now Platform da Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Capacidades da Now Platform da Yokohama ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Criação de uma atividade JMS # Criação de uma atividade JMS {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura 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. {#t_CreateAJMSActivity__ul_mgt_1yv_rs} 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](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). 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](https://servicenow-prod.fluidtopics.net/EsbacqHEUE7KSn5BMEHpJA#t_ConfigureAnInstanceToUseJMS "Configure seu sistema para usar o Java Messaging Service (JMS) com uma atividade JMS de personalizada da Orquestração."). 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](https://www.servicenow.com/docs/access?context=create-custom-activities&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Esta ação cria uma atividade personalizada usando um modelo. 4. Depois de configurar as [propriedades gerais](https://servicenow-prod.fluidtopics.net/1UjFRbbKboyY5Zc2E4CIWg "Os seguintes campos de propriedade geral são comuns a todos os modelos de designer de atividades.") e [criar variáveis de entrada](https://servicenow-prod.fluidtopics.net/Vmd4tof2SU2d891ouFr3mA#CreateInputVariables "Crie as variáveis a serem passadas para a atividade no formulário de Entradas do designer de atividades."), 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. {#t_CreateAJMSActivity__ul_e31_chy_ds} | | 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 | |-|-| {#t_CreateAJMSActivity__choicetable_py3_zmj_4y} {#t_CreateAJMSActivity__steps_jbm_5qy_ds} ## O que Fazer Depois * Use o [mapeamento automático](https://servicenow-prod.fluidtopics.net/pOj5hFNcSh91pTEAZFUlbw "Você pode mapear valores de parâmetro em uma carga de teste para variáveis na guia Saídas automaticamente.") 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](https://servicenow-prod.fluidtopics.net/sXKmOLhX4OS_OSSbELtjlw#t_CreateAnOutputVariable "O formulário de Saídas no designer contém um construtor de variável para criar estruturas de dados de objetos e matrizes.") e [regras de análise](https://servicenow-prod.fluidtopics.net/OHRZm7~d7NBO7ww7dBD0DQ#t_CreateAParsingRule "Preencha as variáveis de saída definidas em uma atividade personalizada com dados de carga retornados de um teste de entradas em um host externo ou endpoint.")manualmente {#t_CreateAJMSActivity__ul_u45_vbq_xz} ## Criação de uma conexão JMS para uma Orquestração atividade {#ariaid-title2} 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 ServerPropriedades. 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 ServerArquivos 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. | |-|-| {#t_ConfigureAnInstanceToUseJMS__choicetable_yqs_2c4_5y} 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çãoCredenciais e ConexõesFá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. | |-|-| {#t_ConfigureAnInstanceToUseJMS__choicetable_gqc_pd4_5y} 6. Navegar até OrquestraçãoCredenciais. 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](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) [Credenciais JMS](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). 8. Clique em Enviar. Tudo pronto para criar uma atividade JMS personalizada. ## Parâmetros de execução do modelo JMS {#ariaid-title3} 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.{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r__entry__4} | 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](https://servicenow-prod.fluidtopics.net/rg38bYgvEJwXabeJWDvNSg "Os recursos do MID Server definem as funções específicas de um MID Server dentro de um intervalo de endereços IP."). 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); | [Tabela 1. Parâmetros de execução do JDBC] {#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r} ## Parâmetros de pós-processamento do modelo JMS {#ariaid-title4} Use esses parâmetros para criar um script de pós-processamento. {#r_JMSTemplatePostProcessParams__table_grr_t2v_cr__entry__4} | 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. | [Tabela 2. Parâmetros de pós-processamento JMS] {#r_JMSTemplatePostProcessParams__table_grr_t2v_cr}