Use o nó EntradaSCA com o nó RespostaSCA para processar mensagens a partir do WebSphere Process Server.
Se você usar componentes de serviço no WebSphere Process Server, será possível usar esse nó para iniciar um serviço fornecido pelo WebSphere Message Broker. O fluxo age como um terminal SCA para ser usado pelo componente de serviço por meio de uma ligação de importação.
O nó EntradaSCA está contido no repositório SCA da paleta do nó do fluxo de mensagens 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.
É possível acessar a operação que está sendo chamada em um pedido de entrada no seguinte local no ambiente local:
LocalEnvironment.SCA.Input.Operation
É possível acessar as informações do Cabeçalho SOAP que estão presentes em um pedido de entrada a partir do seguinte local no ambiente local:
LocalEnvironment.SCA.Input.Binding.WebServices.SOAP.Header
Também é possível acessar as informações de contexto SOAP que estão presentes em um pedido de entrada no ambiente local. O contexto SOAP é armazenado no seguinte local:
LocalEnvironment.SCA.Input.Binding.WebServices.SOAP.Context
Certifique-se de que o conjunto de mensagens contenha uma definição SCA do Broker com uma extensão .insca com a qual o nó EntradaSCA será configurado.
As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário inserir um valor (propriedades que não possuem um valor-padrão definido) são marcadas com um asterisco.
Se você especificar a propriedade Definição SCA do Broker digitando um nome de arquivo, ou selecionando uma definição SCA do Broker usando o recurso Pesquisar, em um nó EntradaSCA que já possui terminais configurados, os terminais dinâmicos existentes serão substituídos. Se você especificar um nome de arquivo que não é válido, os terminais dinâmicos existentes anteriormente serão removidos e nenhum terminal será incluído.
Se uma definição SCA do Broker for arrastada para um nó EntradaSCA que já possui terminais dinâmicos configurados, uma caixa de diálogo será exibida permitindo que você confirme se deseja substituir os terminais dinâmicos existentes pelos terminais dinâmicos que podem ser gerados a partir da definição SCA do Broker. Se você optar por substituir os terminais dinâmicos existentes, quaisquer conexões existentes configuradas para esses terminais também serão excluídas. É possível especificar para que essa caixa de diálogo não seja exibida novamente.
Se você arrastar uma definição SCA do Broker para um nó EntradaSCA que já possui um terminal de Saída, nenhum terminal dinâmico que for gerado a partir da definição SCA do Broker será incluído e o nó continuará a operação com seu terminal de Saída.
A tabela a seguir descreve os terminais do nó EntradaSCA.
Terminal | Descrição |
---|---|
Failure | O terminal de saída para o qual a mensagem recebida é propagada quando uma falha (como uma falha de validação de mensagem) é detectada |
Out | O terminal de saída para o qual a mensagem será roteada se você tiver selecionado Rotear para terminal de saída comum na propriedade Roteamento de Mensagem. |
Catch | O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção de recebimento de dados e capturada por este nó. |
* (dinâmico) | (Aplicável apenas quando o Tipo de Ligação é Serviços da Web.) Um terminal dinâmico é gerado para cada operação suportada pelo tipo de porta e implementada pela ligação importada. O terminal de operação dinâmica para o qual a mensagem SCA é roteada depende da operação definida na mensagem SCA quando ela é recebida. |
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).
A tabela a seguir descreve as propriedades de Descrição do nó EntradaSCA.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | O tipo de nó | O nome do nó. |
Descrição curta | Não | Não | Nenhum | Uma breve descrição do nó. |
Descrição Longa | Não | Não | Nenhum | Texto que descreve a finalidade do nó no fluxo de mensagens. |
A tabela a seguir descreve as propriedades Básicas do nó EntradaSCA.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Definição do SCA do Broker | Sim | Não | <Nenhum> | Este tipo de propriedade é String. O nome da definição SCA do Broker que contém propriedades de configuração para o nó EntradaSCA. |
Roteamento de Mensagens | Sim | Não | Rotear cada operação para seu próprio terminal | Esta propriedade determina se um terminal de Saída
comum deve ser usado ou se cada operação deve ser roteada
para seu próprio terminal.
|
A tabela a seguir descreve as propriedades de Ligação do nó EntradaSCA; a ligação localizada na definição SCA do Broker é definida aqui.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tipo de Ligação | Sim | Não | Derivado da definição SCA do Broker | Este tipo de propriedade é String. Seu valor deriva da definição SCA do Broker. |
A tabela a seguir descreve as propriedades de Serviço da Web do nó EntradaSCA. Estas propriedades serão relevantes apenas se o Tipo de Ligação for Serviços da Web.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do arquivo do WSDL | Sim | Não | <Nenhum> | Este tipo de propriedade é String. Um valor é fornecido para esta propriedade quando o arquivo de configuração WSDL é analisado. |
Espaço de nomes de destino | Não | Não | Derivado da definição SCA do Broker | Este tipo de propriedade é String. Espaço de nomes de destino exibe o espaço de nomes do arquivo WSDL selecionado. |
Tipo de porta | Sim | Não | O valor-padrão é o tipo de porta da definição SCA do Broker. | Este tipo de propriedade
é String. Esta propriedade
é somente leitura. Condições de erro:
|
Ligação importada | Sim | Não | Derivado da definição SCA do Broker. | Este tipo de propriedade
é String. A caixa Ligação Importada lista todas as ligações SOAP
que estão associadas ao tipo de porta selecionado. As ligações são listadas na ordem na qual são exibidas no arquivo WSDL.
Por padrão, a primeira ligação apontada pela porta
na definição SCA do Broker é selecionada. Esta propriedade é atualizada
toda vez que o valor de Tipo de Porta é
alterado e uma mensagem de informação é exibida especificando que as mudanças
correspondentes devem ser feitas no sistema do WebSphere Process Server. Condições de erro:
|
Porta de serviço | Sim | Não | Derivado da definição SCA do Broker | Este tipo de propriedade
é String. A caixa Porta de Serviço lista todas as portas de serviço
que apontam para a ligação selecionada. A porta de serviço
referenciada na definição SCA do Broker é selecionada por padrão. Esta propriedade é atualizada toda vez que o valor de ligação selecionado é alterado
e uma mensagem de informação é exibida especificando que as mudanças
correspondentes devem ser feitas no sistema do WebSphere Process Server. Condições
de erro:
|
Seletor URL | Sim | Sim | Derivado da definição SCA do Broker | Este tipo de propriedade é String. Seletor de URL é o seletor de caminho HTTP no qual o nó aceita mensagens de entrada. |
Utilizar HTTPS | Não | Sim | Derivado da definição SCA do Broker | Este tipo de propriedade é Boolean. Seu valor será True se o local do HTTP for um HTTPS; caso contrário, seu valor será False. |
Propagar apenas corpo de SOAP | Não | Não | True | Este tipo de propriedade é Boolean. Selecione a caixa de opção se apenas o corpo da mensagem SOAP deverá ser propagado. |
Utilizar Endereçamento do WS | Não | Não | Falso | Este tipo de propriedade é Boolean. Selecione a caixa de opção se WS-Addressing deverá ser usado. |
A tabela a seguir descreve as propriedades do MQ do nó EntradaSCA. Estas propriedades serão relevantes apenas se o Tipo de Ligação for MQ.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome da fila | Sim | Sim | Derivado da definição SCA do Broker | Este tipo de propriedade é String. O valor desta propriedade pode ser alterado diretamente no nó. Se a propriedade for alterada, uma mensagem de informação será exibida especificando que as mudanças correspondentes deverão ser feitas no sistema do WebSphere Process Server. |
As propriedades Análise de Mensagem de Entrada do nó EntradaSCA são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | Configurado automaticamente de acordo com a ligação definida no nó correspondente. | O domínio utilizado para analisar a mensagem que chega. O domínio é determinado
de acordo com o tipo Tipo de Ligação. Você poderá alterar
essa propriedade se o Tipo de Ligação for
MQ. A propriedade é somente leitura quando o Tipo de Ligação é Serviços da Web. Esta tabela descreve as propriedades Análise de Mensagem de Entrada para o domínio DFDL. É possível localizar descrições das propriedades Análise de Mensagem de Entrada para outros domínios anteriores neste tópico. |
Modelo de mensagem | Não | Não | Selecionado automaticamente de acordo com a definição SCA do Broker escolhida no nó correspondente. | O nome ou local do modelo de mensagem no qual a mensagem recebida é definida. Essa lista é preenchida com todos os arquivos do modelo de mensagem disponível. Você não poderá alterar esta propriedade se o Tipo de Ligação for Serviços da Web. |
Message | Não | Não | Selecionado automaticamente de acordo com a definição SCA do Broker escolhida no nó correspondente. | O nome ou o local de um elemento global que modela um documento de dados inteiro e está contido no arquivo de esquema do modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou. |
Formato Físico | Não | Não | O nome do formato físico da mensagem que chega. Você poderá alterar esta propriedade se o Tipo de Ligação for MQ e o domínio de mensagem for MRM. Você não poderá alterar esta propriedade se o Tipo de Ligação for Serviços da Web. |
A tabela a seguir descreve as propriedades de Opções do Analisador do nó EntradaSCA.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Cronometragem de análise | Não | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são On
Demand,
Imediato e
Completo. Para obter uma descrição completa desta propriedade, consulte Analisando On Demand. |
Construir árvore utilizando tipos de dados de Esquema XML | Não | Não | Selecionados | Esta propriedade controla se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do Esquema XML. |
Reter conteúdo misto (Retain mixed content) | Não | Não | Desmarcada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado. |
Reter comentários (Retain comments) | Não | Não | Desmarcada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado. |
Reter instruções de processamento (Retain processing instructions) | Não | Não | Desmarcada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado. |
Elementos opacos | Não | Não | Branco | Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada. |
A tabela a seguir descreve as propriedades de Validação do nó EntradaSCA. Para obter informações adicionais, consulte Propriedades de Validação.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validar | Não | Sim | Conteúdo e Valor | Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo. |
Ação de falha | Não | Não | Exceção | Essa propriedade controla o que acontecerá se a validação falhar. Você pode definir essa propriedade somente se definir Validar para Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções. |
As propriedades de Segurança do nó são descritas na tabela a seguir. Configure valores para estas propriedades para controlar a extração de uma identidade de uma mensagem (quando um perfil de segurança estiver associado ao nó). Para obter informações adicionais sobre estas propriedades, consulte Identidade, Configurando a Extração de uma Identidade ou Token de Segurança, Visão Geral de Segurança do Fluxo de Mensagens e Configurando a Segurança do Fluxo de Mensagens.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tipo de token de identidade | Não | Não | Nenhum(a) | Essa propriedade especifica o tipo de token de identidade presente na mensagem de entrada. Os valores válidos são: Padrão do Transporte, Nome de Usuário, Nome de Usuário + Senha, Asserção SAML e Certificado X.509. Se esta propriedade não for especificada, a identidade será recuperada do cabeçalho de transporte Basic-Auth e o tipo será configurado como Nome de Usuário. |
Local do token de identidade | Não | Não | Nenhum(a) | Essa propriedade especifica onde, na mensagem, a identidade pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). Se essa propriedade não for especificada, a identidade será recuperada do cabeçalho de transporte MQMD.UserIdentifier. |
Local da senha de identidade | Não | Não | Nenhum(a) | Essa propriedade especifica onde, na mensagem, a senha pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). Se não for especificada, a senha não será configurada. Esta propriedade poderá ser configurada apenas se Tipo de token de identidade estiver configurado como Nome de Usuário + Senha. |
Local de IssuedBy da identidade | Não | Não | Nenhum(a) | Esta propriedade especifica uma cadeia ou expressão de caminho que descreve o emissor da identidade. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou uma cadeia literal. Se você utilizar uma cadeia literal, ela será colocada entre aspas e deverá conter um ponto final (.). O valor especifica o Emissor que é passado para um provedor WS-Trust v1.3 STS. Se essa propriedade não for especificada, o valor MQMD.PutApplName será utilizado. Se você deixar o campo Local issuedBy da Identidade em branco e MQMD.PutApplName também estiver em branco, a cadeia MQ será utilizada. |
Tratar exceções de segurança como exceções normais | Não | Não | False | Esta propriedade especifica se as exceções de segurança (como "Acesso Negado") devem ser tratadas como exceções normais e propagadas para o terminal Failure (se conectado). Esta propriedade é desativada por padrão, assegurando que as exceções de segurança restaurarão a mensagem, mesmo que o terminal Failure esteja conectado. |
A tabela a seguir descreve as propriedades de Instâncias do nó EntradaSCA.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Conjunto de instâncias adicionais | Não | Sim | Utilizar Conjunto Associado ao Fluxo de Mensagens | O conjunto do qual as instâncias adicionais são obtidas.
|
Instâncias Adicionais | Não | Sim | 0 | O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. |
A tabela a seguir descreve as propriedades de Nova Tentativa do nó EntradaSCA.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tentar mecanismo novamente | Não | Não | Failure | Esta propriedade especifica como o processamento de repetição é manipulado
quando uma falha é recuperada para o nó EntradaSCA.
|
Tentar limite novamente | Não | Sim | 0 | O número máximo de vezes que o processamento de repetição é desempenhado para repetição rápida. |
Intervalo de repetições curtas | Não | Sim | 0 | O intervalo entre tentativas de repetições rápidas. |
Intervalo de repetições longas | Não | Sim | 0 | O intervalo entre tentativas de repetições longas. |
A propriedade Transacionalidade do nó EntradaSCA é descrita na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Não | Não | Para MQ, 'sim' | Esta propriedade pode ser 'automático', 'não' ou 'sim'. |
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. |