Use o nó FTEInput para receber arquivos usando o WebSphere MQ File Transfer Edition.
Este tópico contém as seguintes seções:
É possível usar o nó FTEInput para estender o suporte ao WebSphere Message Broker Versão 8.0 para processamento do arquivo através de sua integração com o WebSphere MQ File Transfer Edition. O WebSphere MQ File Transfer Edition é um produto de transferência de arquivos gerenciado que usa WebSphere MQ como o transporte.
O nó FTEInput está contido no repositório Arquivo 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.
Os terminais do nó FTEInput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Falha | 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. As mensagens propagadas neste terminal não são validadas, mesmo que você tenha especificado, utilizando a propriedade Validar, que a validação deve ocorrer. |
Out | O terminal de saída para o qual uma mensagem será roteada se ela tiver sido extraída com sucesso do arquivo de entrada. Se não ocorrerem erros no nó de entrada, uma mensagem recebida de um recurso externo será sempre enviada para o terminal Out primeiro. |
Fim dos Dados | O terminal de saída para o qual a mensagem Fim de Dados é roteada depois que todas as mensagens em um arquivo forem processadas. A transação do fluxo de mensagens Fim de Dados será iniciada somente se o terminal estiver anexado. |
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).
Quando o nó FTEInput propaga uma mensagem, ele armazena informações sobre ele nas árvores de mensagens LocalEnvironment.FTE e LocalEnvironment.FTE.Transfer. Se o arquivo de entrada estiver vazio, a mensagem será propagada (assumindo que ela seja válida). Se você especificar um padrão de nome de arquivo que contenha caracteres curingas na propriedade Filtro do nome de arquivo, o nó FTEInput copia os caracteres no nome de arquivo que correspondem aos curingas, juntamente com todos os caracteres intermediários, para a árvore de mensagens LocalEnvironment.Wildcard.WildcardMatch. Consulte a seção Usando Variáveis de Ambiente Locais com Nós de Arquivo para obter informações adicionais.
Propriedades de Descrição
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | Entrada FTE | 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. |
Propriedades básicas
Propriedade | M | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Filtro de diretório | Não | Sim | Nenhum | O diretório de destino do WebSphere MQ File Transfer Edition a partir do qual os arquivos de entrada são processados. | inputDirectory |
Filtro de nome de arquivo | Sim | Sim | * | Um nome de arquivo ou cadeia contendo caracteres curinga opcionais (* ou ?) identificando o arquivo ou arquivos a serem processados a partir do diretório de Entrada. | filenamePattern |
Ação no processamento com êxito | Sim | Não | Nenhuma Ação | A ação executada pelo nó no arquivo após o processamento bem-sucedido
do conteúdo. As opções válidas são:
|
Propriedades Análise de Mensagem de Entrada
Propriedade | M | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Domínio de Mensagens | Não | Não | Nenhum | O domínio utilizado para analisar a mensagem que chega. | |
Conjunto de Mensagens | Não | Não | Nenhum | O nome ou identificador do conjunto de mensagens no qual a mensagem que chega está definida. Se você configurar esta propriedade e, em seguida, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto do conjunto de mensagens. |
|
Tipo de Mensagem | Não | Não | Nenhum | O nome da mensagem que chega. | |
Formato de Mensagem | Não | Não | Nenhum | O nome do formato físico da mensagem que chega. | |
ID do conjunto de caracteres codificados de mensagens | Sim | Sim | Sistema Intermediário Padrão | O ID do conjunto de caracteres codificados utilizados para interpretar os bytes do arquivo que está sendo lido. | messageCodedCharSetIdProperty |
Codificação de mensagens | Sim | Sim | Sistema Intermediário Determinado | O esquema de codificação para números usado para interpretar bytes do arquivo que está sendo lido. 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. | messageEncodingProperty |
Propriedades Opções do Analisador
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Cronometragem de análise | Não | Não | On Demand | Especifica quando uma mensagem de entrada é analisada. Os valores válidos são:
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 | Desmarcada | Especifica se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do esquema XML. |
Utilizar analisador compacto XMLNSC para domínio XMLNS | Não | Não | Desmarcada | Especifica se o Analisador Compacto XMLNSC
é usado para mensagens no Domínio XMLNS. 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 um dos itens a seguir é XMLNS:
|
Reter conteúdo misto | Não | Não | Desmarcada | Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para 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 | Não | Não | Desmarcada | Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para 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 | Não | Não | Desmarcada | Especifica se o analisador XMLNSC cria elementos na árvore de mensagens para instruções de processamento em uma 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 | Em Branco | Especifica uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC. 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. |
Propriedades Tentar Novamente
Propriedade | M | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Tentar mecanismo novamente | Sim | Não | Failure | Como o nó manipula uma falha de fluxo. As opções válidas são:
|
|
Tentar limite novamente | Sim | Sim | 0 | O número de vezes para tentar a transação do fluxo novamente quando o valor da propriedade Mecanismo de Nova Tentativa é Nova Tentativa Curta. | retryThreshold |
Intervalo de Repetição curto (segundos) | Não | Sim | 0 | O intervalo, em segundos, entre cada nova tentativa se a propriedade Limite de Nova Tentativa não for zero. | shortRetryInterval |
Intervalo de Repetição longo (segundos) | Não | Sim | 300 | O intervalo entre novas tentativas, se a propriedade Tentar Mecanismo Novamente for Nova Tentativa Curta e Longa e o limite de novas tentativas tiver se exaurido. | longRetryInterval |
Ação no arquivo com falha | Sim | Sim | Nenhuma Ação | A ação que o nó executa com o arquivo de entrada
se todas as tentativas de processar o conteúdo do arquivo de entrada falharem.
As opções válidas são:
|
Propriedades Registros e Elementos
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Detecção de registro | Sim | Não | Arquivo Inteiro | O mecanismo utilizado para identificar registros no arquivo de entrada. As opções válidas são:
|
Comprimento | Sim | Não | 80 | O comprimento de cada registro, em bytes, quando a detecção de registroComprimento Fixo está selecionada. |
Delimitador | Sim | Não | Final de linha do DOS ou do UNIX | O tipo de bytes do delimitador que separa ou finaliza cada registro quando a detecção
de registro Delimitado está selecionada. As opções válidas são:
|
Delimitador customizado | Não | Não | Nenhum | Os bytes do delimitador, expressos em hexadecimal, quando a detecção de registro Delimitado e Delimitador Customizado estão selecionados. Esta propriedade é obrigatória somente se a propriedade Delimitador estiver configurada como Delimitador Customizado. |
Tipo de delimitador | Sim | Não | Postfix | A posição do delimitador quando a detecção de registro Delimitado
for selecionada. As opções válidas são:
|
Propriedades de validação
Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.
Propriedade | M | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Validate | Não | Sim | Nenhuma | 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. Os valores válidos são:
|
Propriedades Transações
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Não | Não | Não | O modo de transação neste nó de entrada determina se
o restante dos nós no fluxo são executados no ponto de sincronização. As opções válidas são:
|
Propriedades de Instâncias.
Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens.
Propriedade | M | A | O 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.
|
componentLevel |
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 | 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. |