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.
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:
O nó PHPCompute está contido no repositório Transformação da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
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.
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:
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).
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:
|
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:
|
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. |