Use o nó .NETInput para recuperar dados de fontes incompatíveis, como MSMQ, arquivos ou bancos de dados, acessando os dados por meio de código .NET.
Este tópico contém as seguintes seções:
O nó .NETInput obtém os dados de uma origem que é especificada por seu criador para iniciar um fluxo de mensagens. As mensagens de saída que você cria no nó .NETInput são formadas por meio de interpretar a informação que é obtida da origem de dados, como aplicativos .NET ou COM.
O nó .NETInput usa qualquer linguagem compatível com Common Language Runtime (CLR) para criar a mensagem, como C#, Visual Basic (VB), F# e C++/CLI.
O desenvolvedor do fluxo de mensagens tem o controle do código .NET, que torna o nó .NETInput flexível para onde ele possa recuperar os dados. Por exemplo, você pode gravar o código .NET que lê mensagens de uma origem do MSMQ, o WebSphere MQ da fila, o sistema de arquivos, ou a partir de um banco de dados. Quando estiver gravando o código para um nó .NETInput, dois modelos serão fornecidos noMicrosoft Visual Studio.
O nó .NETInput está contido no .NET da paleta e é representado no IBM® Integration Toolkit pelo seguinte ícone: 
O nó .NETInput executa apenas nos brokers do Windows. Um erro ocorre se você tentar implementar um fluxo de mensagens que contém um nó .NETInput em um broker que esteja executando em um sistemaWindows. Assegure-se de que o broker esteja sendo executado no Windows antes de implementar o fluxo de mensagens.
Quando você estiver gravando o código para um nó .NETInput , dois modelos serão fornecidos no Microsoft Visual Studio. Esses dois modelos são para dois estilos de interação diferentes:
Você deve associar o nó .NETInput com um conjunto .NET que contenha o código que está controlando a interação do nó .NETInput com a origem de dados ou mensagens, que são propagados através do fluxo de mensagens.
Para informações adicionais, consulte Gravando um Código para um nó .NETInput.
É possível gravar um código para customizar o comportamento do nó .NETInput usando os esqueletos do código de modelo que são fornecidos para Microsoft Visual Studio. O nó .NETInput deve ser configurado com um conjunto .NET que contém o código do nó. O código consiste em uma classe derivada de uma das classes-base abstratas fornecidas (NBPollingConnector ou NBEventConnector) que estão no conjunto IBM.Broker.Plugin.dll .
Apenas uma instância de um determinado nó .NETInput é criada, independentemente do número de encadeamentos que estão em execução no fluxo de mensagens, como resultado de instâncias adicionais, ou vários nós de entrada. Portanto, todo o código do seu código .NET de usuário deve ser thread-safe e reentrante. Para obter mais informações sobre como tornar um nó thread-safe e garantir que as funções implementadas e iniciadas pelas extensões definidas pelo usuário sejam reentrantes, consulte Modelo de Execução de Extensões Definidas pelo Usuário e Considerações sobre Encadeamento para Extensões Definidas pelo Usuário.
O código gravado no nó de Entrada .NET não participa de transações de Barramento de Integração.
Para obter mais informações sobre como criar código .NET para um nó .NETCompute, é possível acessar a documentação do .NET API incluída na instalação do IBM Integration Bus, no local do Menu Iniciar do Windows.
Quando você coloca uma instância do nó .NETInput em um fluxo de mensagens, deve configurá-la; ; consulte Configurando um Nó do Fluxo de Mensagens. Para configurar o nó, arraste um arquivo de conjunto de um explorador de arquivos para o nó, ou clique no botão Procurar . As propriedades do nó são exibidas na visualização Propriedades.
Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
É possível reproduzir os parâmetros e atributos customizados em um nó .NETInput criando um nó Clonado a partir dele. O nó Clonado não possui propriedades especiais de seu próprio, e não pode ser criado a partir da gaveta de paleta. Você pode criar, somente a partir de um existente, configurado no nó .NETInput .
Para criar um nó Clonado, você deve selecionar o nó .NETInput direito do mouse e, em seguida, selecionar Criar Nó Clonado ...
O nó Clonado é salvo no .NET da paleta com o nome dado a ele e é representado no IBM Integration Toolkit pelo seu nó ícone escolhido.
Quando criar uma instância de um nóClonado , ela será configurada com as propriedades e os valores que especificados para o nó .NETInput que foi clonado.
Se você deseja modificar as propriedades ou valores de um nó Clonado , você pode configurá-los. Consulte Configurando um Nó do Fluxo de Mensagens.
É possível configurar uma instância de um nó Clonado quando arrastados para um mapa de dados gráficos. Para configurar o nó, é possível arrastar um arquivo de conjunto de um explorador de arquivos para o nó. As propriedades do nó são exibidas na visualização Propriedades.
Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
Configure as propriedades de validação para definir como as mensagens produzidas pelo nó .NETInput são validadas.
Para obter informações adicionais, consulte o Validando Mensagens e o Propriedades de Validação.
Os terminais do nó .NETInput são descritos na tabela a seguir.
| Terminal | Descrição |
|---|---|
| Failure | O terminal de saída para o qual a mensagem é roteada se ocorrer um erro antes de uma mensagem ser propagada para o terminal de Saída. Mesmo que a propriedade Validação (Validation) esteja definida, as mensagens propagadas para esse terminal não serão validadas. |
| Out | Se não ocorrerem erros no nó de entrada, uma mensagem recebida de um recurso externo será sempre enviada para o terminal Out primeiro. |
| Catch | O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. As exceções serão capturadas somente se o terminal estiver anexado. |
As tabelas a seguir descrevem as propriedades do nó que você pode definir em uma guia especificada. A coluna com título O indica se a propriedade é obrigatória (marcada no kit de ferramentas com um asterisco se precisar inserir um valor quando nenhum padrão está definido). A coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo BAR para implementá-lo).
| Propriedade | M | A | 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 | Uma breve descrição do nó. | |
| Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |
| Propriedade | M | A | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| Nome do conjunto | SIM | SIM | O conjunto que implementa o nó. Use a opção Procurar para selecionar um conjunto, alternativamente, você pode descartar um arquivo .dll do conjunto no nó para concluir automaticamente esta propriedade. | assemblyName | |
| Nome da Classe | Não | SIM | O nome da classe que implementa o nó. Um valor para esta propriedade será necessário apenas se dois ou mais nó forem expostos a partir do mesmo conjunto ou para nomear explicitamente uma subclasse como o nó de implementação. | connectorClassName |
| Propriedades | M | C | Default | Descrição |
|---|---|---|---|---|
| Domínio de mensagem | Não | Não | BLOB | O domínio usado para analisar a mensagem. Se o campo estiver em branco, a falha seráBLOB. |
| Modelo de mensagem | Não | Não | Não Selecionada | O nome do local do arquivo de esquema do modelo de mensagem no qual a mensagem é definida. Essa lista é preenchida com todos os arquivos de esquema do modelo de mensagem disponível para o Domínio de Mensagem que você selecionou. |
| Mensagem | Não | Não | Não Selecionada | O nome ou local da raiz de mensagem em seu arquivo de esquema de 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 | Não Selecionada | O nome do formato físico da mensagem. Se você estiver utilizando o analisador MRM ou IDoc, selecione o formato físico da mensagem que chega na lista. Essa lista inclui todos os formatos físicos que você definiu para o modelo de mensagem selecionado. Se você configurar a propriedade Domínio de Mensagem como DataObject, poderá configurar esta propriedade como XML ou SAP ALE IDoc. Configure esta propriedade como SAP ALE IDoc quando você desejar analisar um fluxo de bits a partir de uma origem externa e gere uma árvore de mensagens. |
| ID do conjunto de caracteres codificados de mensagens | Não | Não | Sistema Broker Padrão | O ID do conjunto de caracteres codificados utilizados para interpretar os bytes do arquivo que estão sendo lidos. A propriedade do comando mqsiapplybaroverride é messageCodedCharSetIdProperty. |
| Codificação de mensagens | Não | Não | Determinado pelo Sistema Broker | O esquema de codificação para números e caracteres grandes que são usados para interpretar bytes do arquivo que estão sendo lidos. Os valores válidos são Determinado pelo Sistema do Broker ou um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados. A propriedade do comando mqsiapplybaroverride é messageEncodingProperty. |
| Propriedade | M | A | Padrão | Descrição |
|---|---|---|---|---|
| Cronometragem de análise | SIM | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores
válidos são On
Demand,
Imediato e
Completo. Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand. |
| Construir árvore utilizando tipos de dados de esquema XML | SIM | Não | Não Selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos da sintaxe na árvore de mensagens com tipos de dados obtidos do esquema XML. Você pode selecionar esta propriedades apenas se configurar a propriedade Validar na guia Validação ou Conteúdo ou Conteúdo e Valor. |
| Utilizar analisador compacto XMLNSC para domínio XMLNS | SIM | Não | Não Selecionada | Essa propriedade controla se o analisador compacto XMLNSC é utilizado para mensagens no domínio XMLNS. Se você definir essa propriedade, os dados da mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o Domínio de Mensagens das propriedades de cabeçalho MQRFH2 de entrada ou Análise da Mensagem de Entrada for XMLNS. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC. |
| Reter conteúdo misto | SIM | Não | Não Selecionada | 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 | SIM | Não | Não Selecionada | 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 | SIM | Não | Não Selecionada | 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 | SIM | Não | Em branco | Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados seletivamente pelo analisador XMLNSC. A análise seletiva 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. |
As propriedades Validação do nó .NETInput são descritas na tabela a seguir. Defina estas propriedade se desejar que o analisador valide o corpo das mensagens em relação ao Modelo da Mensagem. (Se uma mensagem for propagada para o terminal de falha (Failure) do nó, ela não será validada).
Para obter informações adicionais, consulte o Validando Mensagens e o Propriedades de Validação.
| Propriedade | M | A | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| Validar | SIM | SIM | Nenhum(a) | Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo, Conteúdo e Valor e Herdar. | validateMaster |
| Ação de falha | SIM | 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 e Lista de Exceções. |
Para obter uma descrição completa das propriedades de Instâncias, consulte Propriedades Configuráveis do Fluxo de Mensagens.
| Propriedade | M | P | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| 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ó. | additionalInstances |
| Propriedade | M | P | Padrão | Descrição |
|---|---|---|---|---|
| Eventos | Não | Não | Nenhuma | 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. |
As propriedades Microsoft Visual Studio do nó .NETInput são descritas na tabela a seguir. Estas propriedades são enviadas ao tempo de execução como parte da implementação no conector de entrada.
Para obter informações adicionais, consulte Criando Mensagens Usando um Nó .NETInput
| Propriedade | M | A | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| Nome do Projeto do Visual Studio | Não | Não | O Microsoft Visual Studio do projeto ou a solução que contém o código do nó. |
| Propriedade | M | A | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| Nome do AppDomain | Não | SIM | O .NET AppDomain que hospeda o nó. | AppDomain | |
| Versão | Não | SIM | A Versão do Conjunto | AssemblyVersion | |
| Cultura | Não | SIM | A Cultura do Conjunto | AssemblyCulture | |
| Token de chave pública | Não | SIM | O Token Público do Conjunto | AssemblyPublicKeyToken |
| Propriedade | M | A | Padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
|---|---|---|---|---|---|
| Detalhes do Nome de Usuário | Não | Não | O nó fornece uma tabela na qual o usuário pode Incluir, Editar ou Excluir linhas, cada uma fornecendo um par Nome: Valor. |