WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

PHPCompute

Utilize o nó PHPCompute para roteae e transformar uma mensagem que chega, utilizando linguagem script PHP.

O suporte para a linguagem de script PHP está disponível para todos os sistemas operacionais nos quais o WebSphere Message Broker é suportado.

Finalidade

O nó PHPCompute pode utilizar a linguagem script PHP para rotear e transformar mensagens que chegam.

Utilizando esse nó, é possível atingir os seguintes objetivos:

  • Examine uma mensagem que chega e, dependendo do seu conteúdo, propague-a inalterada ao temrinal de saída do nó.
  • Alterar parte de uma mensagem recebida e propagá-la alterada para o terminal de saída utilizando PHP.
  • Criar e construir uma nova mensagem de saída que seja independente da mensagem de entrada utilizando PHP.

O nó PHPCompute está contido no repositório Transformação da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

ìcone do nó PHPCompute

Utilizando o Nó PHPCompute em um Fluxo de Mensagens

Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Especificando PHP

Crie instruções PHP para customizar o comportamento do nó PHPCompute. Por exemplo, é possível customizar o nó para criar uma ou mais mensagens de saída utilizando novos dados ou o conteúdo de uma mensagem de entrada ou banco de dados (inalterado ou modificado). Por exemplo, talvez você queira modificar um valor na mensagem de entrada, incluindo um valor de um banco de dados e armazenar o resultado em um campo na mensagem de saída.

Crie as instruções PHP que deseja em um arquivo de script PHP e assegure que ele exista na área de trabalho antes de associá-la ao nó PHPCompute.

Se o arquivo de script PHP necessário existir, importe-o na área de trabalho antes de associá-lo ao nó PHPCompute (consulte Importando Arquivos do Sistema de Arquivos para o WebSphere Message Broker Toolkit).

Se um arquivo PHP não existir para esse nó, crie um na pasta do projeto com uma extensão do arquivo de .php (por exemplo, myfile.php). Para obter informações adicionais sobre como criar um arquivo de script PHP, consulte Criando código PHP para um nó PHPCompute.

O nó PHPCompute fornece suporte para Protocolo Simples de Gerenciamento de Rede SNMPSimple Network Management (SNMP). Os arquivos Management Information Base (MIB) são instalados durante a instalação do WebSphere Message Broker, e seu local é especificado pela variável de ambiente MIBDIRS.

Configurando o Nó PHPCompute

Quando tiver colocado uma instância do nó PHPCompute em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais sobre como configurar nós, consulte Configurando um Nó do Fluxo de Mensagens.

As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário inserir um valor (aquelas que não possuem um valor-padrão definido) são marcadas com um asterisco nessa visualização.

Para configurar o nó PHPCompute:

  1. Opcional: na guia Descrição, digite uma descrição curta e/ou longa. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, utilize a propriedade script PHP para especificar o nome do arquivo PHP. Selecione a propriedade Invocar método 'evaluate()' na definição de classe PHP se o código no arquivo script PHP incluir um método avaliar.
  3. Na guia Opções de Analisador, selecione a propriedade Utilizar analisador compacto XMLNSC para domínio XMLNS para especificar que o Analisador Compacto XMLNSC é utilizado para mensagens no Dominio XMLNS.
  4. Na guia Validação, especifique as propriedade de validação do nó do analisador. Para obter informações adicionais sobre validação, consulte Validando Mensagens. Para obter mais informações sobre como completar essa guia, consulte Propriedades da Guia Validação.

Terminais e Propriedades

Os terminais do nó PHPCompute são descritos na tabela a seguir.

Terminal Tipo Descrição
Entrada Dados de entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Out dados de saída O terminal de saída para o qual a mensagem transformada será roteada.
Failure dados de saída O terminal de saída para o qual a mensagem será roteada se for detectado um defeito durante o cálculo. Mesmo se a propriedade Validar for configrada, mensagens propagadas ao terminal Failure do nó não são validadas.
* (dinâmico) Saída Dinâmica Zero ou mais terminais de saída dinâmica podem ser criados para suportar o roteamento de mensagens.

É possível definir terminais de saída dinâmicos adicionais no nó PHPCompute . Nem todos os terminais de saída dinâmicos criados em um nó PHPCompute precisam ser mapeados para uma expressão na tabela de filtros. Se um terminal de saída dinâmico não for mapeado, mensagens nunca serão propagadas a ele. Várias expressões podem ser mapeadas para o mesmo terminal de saída dinâmico único. Não existe nenhum terminal de saída dinâmico para o qual a mensagem é transmitida diretamente. Para obter informações adicionais utilizando os terminais dinâmicos, consulte Utilizando Terminais Dinâmicos.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó PHPCompute são descritas na tabela a seguir:
Propriedade M A Padrão Descrição
Nome de nó Não Não PHPCompute O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó PHPCompute são descritas na tabela a seguir:

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
PHP script Sim Sim   Uma cadeia contendo o nome do arquivo script PHP . ScriptName

As propriedades Opções de Analisador do nó PHPCompute são descritas na tabela a seguir.

Propriedade M A Padrão Descrição
Utilizar analisador compacto XMLNSC para domínio XMLNS Não Não Falso Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você configurar esta propriedade, os dados da mensagem aparecerão em XMLNSC nos nós que estão conectados ao terminal de saída quando o cabeçalho MQRFH2 de entrada ou a propriedade de Análise da Mensagem de Entrada, Domínio de Mensagem, for XMLNS.

As propriedades Validação do nó PHPCompute são descritas na tabela a seguir.

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M A Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Não Nenhum(a) Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhum(a)
  • Conteúdo e Valor
  • Content
  • Herdar
validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são:
  • Rastreio do Usuário
  • Registro de Erros Local
  • Exceção
  • Lista de Exceções
 
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:01


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac69250_