Nó FileInput

Utilize o nó FileInput para processar mensagens que são lidas a partir de arquivos.

Propósito

Uma ou mais mensagens podem ser lidas a partir de um único arquivo e cada mensagem é propagada como uma transação de fluxo separada. A parte de um arquivo que gera uma transação do fluxo de mensagens é chamada de registro. Um arquivo pode ser um registro único ou uma série de registros. As propriedades no nó especificam como o nó FileInput determina os registros em um arquivo.

O nó FileInput está contido no repositório Arquivo da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó FileInput

Estrutura da mensagem

O nó FileInput manipula mensagens nos seguintes domínios de mensagem:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Quando o nó do FileInput propaga uma mensagem, ele armazena informações sobre ela na árvore de mensagens LocalEnvironment.File. Se o arquivo de entrada estiver vazio, a mensagem será propagada (assumindo que ela seja válida). A tabela a seguir lista a estrutura em árvore de mensagens LocalEnvironment.File. Os elementos contêm dados sobre o registro atual.

Nome do Elemento Tipo de Dados do Elemento Descrição
Diretório CHARACTER O caminho de diretório absoluto do diretório de entrada no formato utilizado pelo sistema de arquivos do broker. Por exemplo, em sistemas Windows, ele começa com o prefixo de letra da unidade (como C:).
Nome CHARACTER Nome e extensão do arquivo.
LastModified TIMESTAMP Data e hora da última modificação do arquivo.
TimeStamp CHARACTER Data e hora, na zona Coordinated Universal Time (UTC), que o nó de entrada começou o processamento do arquivo como uma cadeia de caracteres. Esses dados são a cadeia utilizada para criar nomes de archive e de arquivo de restauração, se um registro de data e hora é incluído.
Os seguintes elementos contêm dados sobre o registro atual:
Offset INTEGER O início do registro no arquivo. O primeiro registro inicia no deslocamento 0. Quando o Deslocamento faz parte da árvore de mensagens Fim dos Dados, este valor é o comprimento do arquivo de entrada.
Registro INTEGER O número do registro no arquivo. O primeiro registro é o registro número 1. Quando Registro fizer parte da árvore de mensagens Fim dos Dados, este valor será o número de registros.
Delimitador CHARACTER Os caracteres utilizados para separar esse registro a partir do registro anterior, se Delimitado estiver especificado em Detecção de Registro. O primeiro registro tem um delimitador nulo. Quando o Delimitador fizer parte da árvore de mensagens Fim dos Dados, este valor será o delimitador que seguirá o último registro, se houver.
IsEmpty BOOLEAN Se o registro que é propagado pelo fluxo de mensagens estiver vazio. IsEmpty é configurado como TRUE se o registro atual estiver vazio. Quando IsEmpty fizer parte da árvore de mensagens Fim dos Dados, esta propriedade será sempre configurada como TRUE.

Utilizando este nó em um fluxo de mensagens

O nó FileInput pode ser utilizado em qualquer fluxo de mensagens que deve aceitar mensagens em arquivos. Também é possível consultar as seguintes amostras para ver como utilizar este 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.

Se você configurar um nó Arquivo para usar FTP, sua rede poderá precisar dele para conectar-se a um servidor proxy FTP, em vez de diretamente com o servidor FTP remoto. A maneira como você configura os nós Arquivo para usar um proxy FTP depende de como esse proxy trata os pedidos. Para alguns proxies FTP, é necessário codificar as informações do servidor FTP de destino nas credenciais de logon que você cria com o comando mqsisetdbparms. Por exemplo, alguns proxies FTP suportam os seguintes valores:
Nome de Usuário: FtpTargetHostUsername@ProxyUserName@TargetFtpHostname 
Senha: TargetFtpUserPassword@ProxyUserPassword
Outros proxies podem requerer codificações diferentes ou podem requerer configuração externa ou podem não conseguir usá-las com os nós Arquivo.

Configurando o Nó FileInput

Quando tiver colocado uma instância do nó FileInput em um fluxo de mensagens, você poderá configurá-lo; 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 (as propriedades que não têm um valor-padrão definido) são marcadas com um asterisco.

Configure o nó FileInput:

  1. Opcional: Na guia Descrição , digite uma Descrição curta, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, digite os diretório e o arquivos a serem processados pelo nó FileInput, junto com o que fazer com qualquer arquivo duplicado encontrado.
    • Em Diretório de Entrada, especifique o diretório a partir do qual o nó FileInput obtém arquivos. Especifique o diretório como um caminho de diretório absoluto ou relativo. Se o caminho de diretório for relativo, ele será baseado no diretório especificado na variável de ambiente MQSI_FILENODES_ROOT_DIRECTORY. Um exemplo nos sistemas Windows é C:\fileinput. Um exemplo nos sistemas UNIX é /var/fileinput.

      O nó FileInput cria um subdiretório mqsitransitin no diretório de entrada especificado para suspender e bloquear os arquivos de entrada enquanto eles estão sendo processados. Se um grupo de execução que processa arquivos nesse diretório de entrada for removido, verifique se no subdiretório mqsitransitin há arquivos parcialmente processados ou não processados. Mova esses arquivos de volta para o diretório de entrada (e remova o prefixo UUID do grupo de execução dos nomes dos arquivos) para que possam ser processados por um grupo de execução diferente. Para obter informações adicionais sobre o subdiretório mqsitransitin, consulte Como Múltiplos Nós de Arquivos Compartilham o Acesso a Arquivos no mesmo Diretório.

    • Selecione Incluir subdiretórios locais se quiser que os arquivos na estrutura de diretório no Diretório de entrada sejam processados. O broker deve ter acesso ao diretório de nível superior especificado; se o broker não tiver acesso a um subdiretório específico, esse subdiretório não será procurado e uma mensagem será gravada para rastreio do usuário. Os arquivos são processados de acordo com sua idade, ou seja, os mais antigos são processados primeiro, independentemente de onde aparecerem na estrutura de diretório. A decisão sobre os arquivos serem processados ou ignorados é determinada, primeiramente, de acordo com o nome do arquivo ou padrão e, em segundo lugar, de acordo com o padrão de exclusão do arquivo.

      Se você selecionar ambas as propriedades, Incluir subdiretórios locais e Transferência Remota, apenas os subdiretórios do sistema local serão procurados em relação a arquivos a serem processados. Considerando o sistema remoto, apenas o diretório de nível superior especificado é procurado em relação a arquivos a serem processados.

    • Em Nome ou Padrão de Arquivo, especifique um padrão para o nome do arquivo. Esse é um nome de arquivo ou uma sequência de caracteres (um padrão) que corresponde a um nome de arquivo. Um padrão é uma seqüência que contém pelo menos um dos seguintes caracteres curinga:
      Caractere curinga Descrição Exemplo
      * Qualquer seqüência de zero ou mais caracteres *.xml atende a todos os nomes de arquivo com uma extensão xml
      ? Qualquer caractere único f??????.csv atende a todos os nomes de arquivo que consistem em uma letra f seguida por seis caracteres e a seqüência .csv.
      Para um arquivo ser processado, seu nome deve corresponder ao padrão.

      Se você especificar um padrão de nome de arquivo que contenha caracteres curingas, o nó FileInput copia os caracteres no nome do arquivo correspondentes aos caracteres curingas, juntos com todos os caracteres intermediários, para o elemento LocalEnvironment.Wildcard.WildcardMatch. Consulte a seção Padrões de Nomes de Arquivos para obter mais informações.

    • Em Padrão de exclusão do arquivo, especifique um padrão para nomes de arquivos que você deseja excluir do processamento. Especifique um nome de arquivo ou uma sequência de caracteres (um padrão) que corresponda a um nome de arquivo. Um padrão é uma sequência que contém pelo menos um dos caracteres curinga detalhados em Caracteres Curinga. Para que um arquivo seja excluído do processamento, seu nome deve corresponder ao padrão.
    • Selecione Ação no Processamento Bem-sucedido para especificar a ação que o nó FileInput realiza depois do processamento bem-sucedido do arquivo. A ação pode ser mover o arquivo para o subdiretório de archive, aumentar o nome do arquivo com um registro de data e hora e mover o arquivo de origem para o subdiretório de archive ou excluir o arquivo.
      • Se você selecionar Mover para o Subdiretório de Archive, o arquivo de origem será movido para o subdiretório de archive do diretório de entrada. O nome do subdiretório é mqsiarchive. Por exemplo, se o diretório de entrada for /var/fileinput, o caminho absoluto do subdiretório de archive será /var/fileinput/mqsiarchive. Se esse diretório não existir, o intermediário cria o mesmo ao tentar mover um arquivo para ele pela primeira vez.
      • Se você selecionar Incluir Registro de Data e Hora e Mover para o Subdiretório de Archive, a data e hora atuais serão incluídos no nome do arquivo e o arquivo então será movido para mqsiarchive.
      • Se você selecionar Excluir, o arquivo será excluído depois do processamento bem-sucedido.
      O nó FileInput grava uma mensagem no rastreio do usuário, se o rastreio do usuário estiver em operação, sempre que processar um arquivo.
    • Selecione Substituir Arquivos Duplicados no Archive se você quiser substituir um arquivo no subdiretório de archive pelo arquivo de mesmo nome processado com sucesso. Se você não configurar essa opção, e um arquivo com o mesmo nome já existir no subdiretório de archive, o nó lançará uma exceção quando ele tentar mover o arquivo processado com sucesso.
  3. Na guia Análise de Mensagem de Entrada, defina os valores para as propriedades que o nó utiliza para determinar como analisar a mensagem de entrada.
    • Em Domínio de Mensagem, selecione o nome do analisador que você está utilizando, na lista fornecida. O padrão é BLOB. Você pode escolher a partir das seguintes opções:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      Também é possível especificar um analisador definido pelo usuário, se apropriado.
    • Se você estiver usando o analisador DFDL, MRM ou XMLNSC no modo de validação, selecione o modelo de mensagem relevante na lista. Essa lista é preenchida com conjuntos de mensagens disponíveis quando você seleciona MRM ou XMLNSC como o domínio de mensagem ou com arquivos de esquema DFDL disponíveis ao selecionar DFDL como o domínio de mensagem.
    • Se você estiver utilizando o analisador DFDL ou MRM, selecione a mensagem correta na lista em Mensagem. Essa lista é preenchida com mensagens definidas no modelo de mensagem que você selecionou.
    • Se você estiver utilizando o analisador MRM, selecione o formato da mensagem a partir da lista em Formato Físico. Essa lista inclui todos os formatos físicos definidos para este modelo de mensagem.
    • Especifique o ID do conjunto de caracteres codificado pela mensagem no ID do Conjunto de Caracteres Codificados pela Mensagem.
    • Selecione a codificação da mensagem na lista em Codificação da Mensagem ou especifique um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados.
  4. Na subguia Opções do Analisador:
    • Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para fazer com que a mensagem inteira seja analisada imediatamente, configure esta propriedade como Imediata ou Concluída. Consulte Analisando On Demand para obter detalhes adicionais.
    • Se você está utilizando o analisador XMLNSC, configure os valores para as propriedades que determinam como o analisador XMLNSC opera. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
  5. Na guia Consulta, insira um valor para o Intervalo de Consulta. Essa propriedade controla a freqüência com que o nó FileInput acessa o sistema de arquivos procurando arquivos para processar.

    Depois da varredura inicial do diretório quando um fluxo é iniciado, sempre que o diretório não contiver nenhum arquivo que corresponda ao padrão de entrada, o nó FileInput aguardará um período definido por essa propriedade. Este processo evita a necessidade do nó FileInput estar continuamente acessando o sistema de arquivos e consumindo grandes quantidades de recurso do sistema.

    Quanto menor o conjunto de valores nesta propriedade, mais rapidamente o nó FileInput descobre arquivos que estão no diretório de entrada. Entretanto, um valor menor aumenta o uso dos recursos do sistema. Um valor maior reduz o uso de recursos do sistema, mas à custa de o nó FileInput descobrir arquivos para processar com menor rapidez.

    Não utilize essa propriedade como um meio de regular o trabalho ou programar o processamento. Se você desejar que o nó FileInput monitore o diretório de entrada apenas para períodos selecionados, inicie e pare o fluxo de mensagens nos horários apropriados.

    Se você selecionar a propriedade Transferência Remota e configurar a propriedade Atraso de Varredura na guia FTP, o valor configurado para o Atraso da Varredura substituirá o conjunto de valores para o Intervalo de Consulta.

  6. Utilize a guia Tentar Novamente para definir como o processamento de nova tentativa é executado quando um fluxo de mensagens falha:
    • O Mecanismo de Nova Tentativa determina a ação que ocorre se o fluxo falha:
      • Selecione Falha para o nó reportar uma falha sem nenhuma tentativa de repetição.
      • Selecione Nova Tentativa Curta para o nó para tentar novamente antes de relatar uma falha se a condição persistir. O número de vezes que ele tenta novamente é especificado em Limite de Nova Tentativa.
      • Selecione Nova Tentativa Breve e Nova Tentativa Longa para o nó tentar novamente, primeiro utilizando o valor em Limite de Nova Tentativa como o número de tentativas que o nó deve fazer. Se a condição persistir depois que o valor Limite de Repetições foi alcançado, o nó utilizará o valor de Intervalo de Repetições Longas entre as tentativas.
    • Especifique um valor para a propriedade Limite de Repetições. O número de vezes que o nó tenta a transação de fluxo novamente se a propriedade Mecanismo de Nova Tentativa estiver configurada como Nova Tentativa Breve ou Nova Tentativa Breve e Nova Tentativa Longa.
    • Especifique um valor para a propriedade Intervalo de Repetições Curtas. O período de tempo, em segundos, a aguardar entre novas tentativas curtas.
    • Especifique um valor para a propriedade Intervalo de Repetições Longas. O período de tempo para aguardar entre as tentativas de repetição longa até que uma mensagem seja bem-sucedida, o fluxo de mensagens seja interrompido ou implementado novamente. A propriedade do broker MinLongRetryInterval define o valor mínimo que o Intervalo de Repetições Longas pode executar. Se o valor for menor do que o mínimo, será utilizado o valor do broker.
    • Especifique um valor para a propriedade Ação no Arquivo com Falha para determinar o que o nó deve fazer com o arquivo de entrada depois que todas as tentativas de processar seu conteúdo falharem:
      • Mover para Subdiretório de Restauração. O arquivo é movido para o subdiretório de restauração do diretório de entrada. O nome deste subdiretório é mqsibackout. Se o diretório de entrada for /var/fileinput, o caminho absoluto do subdiretório de restauração será /var/fileinput/mqsibackout. Se esse subdiretório não existir, o intermediário o criará quando tentar pela primeira vez mover o arquivo para lá. Se o arquivo não puder ser movido para esse subdiretório, talvez porque um arquivo com o mesmo nome já exista aqui, o nó inclui a data e hora atuais no nome do arquivo e faz uma segunda tentativa de mover o arquivo. Se essa segunda tentativa falhar, o nó irá parar de processar. As mensagens BIP3331 e BIP3325 são emitidas. Resolva problema com o subdiretório ou arquivo antes de tentar reiniciar o fluxo de mensagens.
      • Excluir. O arquivo é excluído após falha do processamento.
      • Incluir Registro de Data e Hora e Mover para Subdiretório de Restauração. A data e a hora atuais são incluídas no nome do arquivo e, em seguida, o arquivo é movido para o subdiretório de restauração.
  7. Utilize a guia Registros e Elementos para especificar como cada arquivo é interpretado como registros:
    • Utilize a propriedade Detecção de Registro para determinar como o arquivo é dividido em registros, cada um gerando uma única mensagem. Escolha a partir das seguintes opções:
      • Arquivo Inteiro especifica que todo o arquivo é um único registro.
      • Comprimento Fixo especifica que cada registro é um número fixo de bytes em comprimento. Cada registro deve conter o número de bytes especificado na propriedade Comprimento, exceto possivelmente um registro final menor no arquivo.
      • Selecione Delimitado se os registros que você está processando forem separados, ou finalizados, por um final de linha do DOS ou UNIX ou por uma seqüência de bytes do delimitador definido pelo usuário. Especifique o delimitador e tipo de delimitador nas propriedades Delimitador e Tipo de Delimitador.
      • Selecione Seqüência de Registros Analisados se o arquivo contiver uma seqüência de um ou mais registros que foram reconhecidos de forma serializada pelo analisador especificado em Domínio de Mensagem. O nó propaga cada registro reconhecido como uma mensagem separada. Se você selecionar a opção Detecção de Registro o analisador especificado no Domínio de Mensagem deverá ser XMLNSC ou MRM (formato físico CWF ou TDS).
    • Se você especificou Comprimento Fixo na propriedade Detecação de Registro, use Comprimento para especificar o comprimento necessário do registro de saída em bytes. Esse valor deve estar no intervalo de 1 byte até 100 MB. O padrão é 80 bytes.

      Se especificar Arquivo Inteiro, Comprimento Fixo ou Delimitado em Detecção de Registro, um limite de 100 MB se aplica ao comprimento dos registros. Se você especificar Seqüência de Registros Analisados em Detecção de Registro, o nó FileInput não determina nem limita o comprimento de um registro. Os nós que são recebidos no fluxo de mensagens podem tentar determinar o comprimento do registro ou processar um registro longo. Se você tiver a intenção de processar registros grandes dessa forma, assegure que seu intermediário tenha memória suficiente. Talvez seja necessário aplicar técnicas do fluxo descritas na amostra Sistema de Mensagens Grande para fazer melhor uso da memória disponível.

    • Se tiver especificado Delimitado em Detecção de Registro, utilize Delimitador para especificar o delimitador a ser utilizado. Escolha entre:
      • Final da Linha do DOS ou UNIX que, nos sistemas UNIX, especifica o caractere de avanço de linha (<LF>, X'0A') e, nos sistemas Windows, especifica um caractere de retorno de carro seguido por um caractere de avanço de linha (<CR><LF>, X'0D0A'). O nó trata ambas cadeias como delimitadores, independentemente do sistema no qual o intermediário está em execução. Se ambas estiverem no mesmo arquivo, o nó reconhecerá ambas como delimitadores. O nó não reconhece X'15' que, nos sistemas z/OS, é o byte 'newline'; especifique um valor Delimitador Customizado nessa propriedade e um valor 15 na propriedade Delimitador Customizado se seu arquivo de entrada for codificado utilizando novas linhas EBCDIC de um sistema z/OS.
      • Delimitador Customizado, que permite que uma seqüência de bytes seja especificada em Delimitador Customizado
    • Em Delimitador Customizado, o byte ou os bytes do delimitador a serem utilizados quando Delimitador Customizado estiver definido na propriedade Delimitador. Especifique esse valor como uma cadeia de dígitos hexadecimal com números pares. O padrão é X'0A' e o comprimento máximo da cadeia é 16 bytes (representados por 32 dígitos hexadecimais).
    • Se tiver especificado Delimitado em Detecção de Registro, utilize Tipo de Delimitador para especificar o tipo de delimitador. Os valores permitidos são:
      • Infix. Se você selecionar este valor, cada delimitador separa dois registros. Se o arquivo termina com um delimitador, o conteúdo do arquivo de comprimento zero seguindo o delimitador final ainda é propagado como uma mensagem embora ela não contenha nenhum dado.
      • Sufixo. Se você especificar este valor, cada delimitador terminará um registro. Se o arquivo terminar com um delimitador, nenhum registro de saída é propagado depois do delimitador. Se o arquivo não terminar com um delimitador, ele será processado como se um delimitador seguisse os bytes finais do arquivo. Sufixo é o valor padrão.
    • O nó FileInput considera cada ocorrência do delimitador no arquivo de entrada como se estivesse separando (Prefixo) ou terminando (Sufixo) cada registro. Se o arquivo começar com um delimitador, o nó tratará o conteúdo do arquivo (comprimento zero) precedendo aquele delimitador como um registro e propagará um registro vazio para o fluxo. O delimitador nunca é incluído na mensagem propagada.
  8. Utilize a guia Validação para fornecer validação com base no conjunto de mensagens para mensagens predefinidas. 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.
  9. Na guia FTP, selecione a propriedade Transferência Remota se você desejar que o nó leia arquivos de um servidor FTP ou SFTP usando as seguintes propriedades:
    • Em Protocolo de Transferência, especifique o protocolo que deve ser usado para transferência de arquivos remota. Os valores possíveis são FTP e SFTP.
    • Em Servidor e Porta Remotos, forneça o endereço IP e o número da porta do servidor FTP ou SFTP a serem utilizados. Utilize uma das seguintes sintaxes:
      • IP_address_or_URL
      • IP_address_or_URL:port_number
      Se você especificar o endereço IP no formato IPv6, assegure de colocá-lo entre colchetes, como no exemplo a seguir:
      • [12a::13bd:24cd]
      • [12a::13bd:24cd]:123 em que 123 é o número da porta
      Se você estiver utilizando FTP e não especificar um número de porta, 21 será assumido. Se você estiver usando SFTP e não especificar um número de porta, um número de porta igual a 22 será assumido. Entretanto, se um serviço configurável FtpServer for definido, você poderá inserir o nome do serviço configurável neste campo. Para obter informações sobre como uma definição de serviço configurável FtpServer e as propriedades nesta guia interagem, consulte Propriedades de Serviço Configurável FtpServer.
    • Na Identidade de Segurança, especifique o nome de uma identidade de segurança que foi definida utilizando o comando mqsisetdbparms. O identificador de usuários e a senha que devem ser usados para efetuar logon no servidor FTP ou SFTP são obtidos desta definição, cujo nome deve ter o prefixo ftp::. O valor desta propriedade é substituído pelo valor na propriedade securityIdentity do serviço configurável FtpServer, se ele estiver configurado.
    • Em Diretório do Servidor, especifique o diretório no servidor FTP ou SFTP a partir do qual transferir arquivos. O padrão é um ponto (.) que significa o diretório padrão após o logon. Se você especificar um caminho relativo, o diretório será baseado no diretório padrão após o logon de FTP ou SFTP. Certifique-se de que a sintaxe do caminho esteja em conformidade com os padrões de sistema de arquivos no servidor FTP ou SFTP. O valor nesta propriedade é substituído pelo valor na propriedade remoteDirectory do serviço configurável FtpServer, se ele estiver configurado.

      Se você selecionar ambas as propriedades, Transferência Remota e Incluir subdiretórios locais, apenas os subdiretórios do sistema local serão procurados em relação a arquivos a serem processados. Considerando o sistema remoto, apenas o diretório de nível superior especificado é procurado em relação a arquivos a serem processados.

    • Em Modo de Transferência, especifique como os arquivos são transferidos. Selecione Binário se o conteúdo do arquivo não tiver sido transformado. Selecione ASCII se o arquivo tiver que ser transmitido como ASCII. O valor desta propriedade é substituído pelo valor na propriedade transferMode do serviço configurável FtpServer, se ele estiver configurado.

      Esta propriedade é válida somente quando FTP é selecionado como o protocolo para transferência remota. Se você especificou SFTP como o protocolo, a propriedade do modo Modo de Transferência será ignorada e a codificação Binário será usada.

    • Em Atraso de Varredura, especifique o atraso, em segundos, entre as varreduras de diretório. O padrão é 60 segundos. O conjunto de valores nesta propriedade substitui o conjunto de valores para o intervalo de sondagem na guia Sondagem quando a propriedade Transferência Remota é selecionada. O valor desta propriedade é substituído pelo valor na propriedade scanDelay do serviço configurável FtpServer, se ele estiver configurado.
  10. Na guia Transações, configure o modo de transação. Embora todas as operações de arquivo sejam não-transacionais, o modo de transação neste nó de entrada determina se o restante dos nós no fluxo devem ser executados sob o ponto de sincronização. Selecione Sim se desejar que as atualizações de fluxo sejam tratadas de modo transacional, se possível, ou Não se não desejar. O padrão para esta propriedade é Não.
  11. Opcional: Na guia Instâncias, configure valores para as propriedades que controlam as instâncias adicionais (encadeamentos) que estão disponíveis para um nó. Para obter detalhes adicionais, consulte Propriedades Configuráveis do Fluxo de Mensagens.

Terminais e Propriedades

Os terminais do nó FileInput 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. 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.
Saída 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ó. 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).

Propriedades de Descrição:

Propriedade M P Default Descrição
Nome de nó Não Não FileInput O nome do nó.
Short description Não Não Nenhuma Uma breve descrição do nó.
Descrição Longa Não Não Nenhuma Texto que descreve a finalidade do nó no fluxo de mensagens.

Propriedades Básicas:

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Diretório de entrada Sim Sim Nenhuma O caminho do diretório a partir do qual os arquivos de entrada são processados. O diretório deve estar em um sistema de arquivos ao qual o broker tem acesso. Se o diretório de entrada não existir, nenhum arquivo será processado. O nó FileInput verifica se o diretório de entrada existe em intervalos que são definidos pela propriedade Atraso da Varredura. O diretório de entrada deve existir, mesmo se você estiver processando arquivos sobre FTP ou SFTP.

O nó FileInput cria um subdiretório mqsitransitin no diretório de entrada especificado. O subdiretório mqsitransitin mantém e bloqueia arquivos de entrada enquanto eles estão sendo processados. Se um grupo de execução que processa arquivos neste diretório de entrada for removido, verifique o subdiretório mqsitransitin para obter arquivos parcialmente processados ou não processados. Mova quaisquer arquivos desse tipo de volta para o diretório de entrada (e remova o prefixo de UUID do grupo de execução dos nomes de arquivo) para que eles possam ser processados por um grupo de execução diferente.

inputDirectory
Incluir subdiretórios locais Sim Sim Falso Determina se todos os subdiretórios no diretório de entrada especificado também devem ser procurados em relação a arquivos a serem processados. Se você selecionar essa propriedade e a propriedade Transferência Remota, apenas o diretório de nível superior especificado no sistema remoto será procurado em relação a arquivos. recursiveDirectories
Nome do arquivo ou padrão Sim Sim * Um nome de arquivo ou cadeia contendo caracteres curinga opcionais (* ou ?) identificando o arquivo, ou os arquivos, para processamento a partir do diretório de entrada. filenamePattern
Padrão de exclusão de arquivo Não Sim Nenhuma Uma sequência simples contendo caracteres curinga opcionais (* e ?) que identificam arquivos a serem excluídos do processamento. excludePattern
Ação no processamento com êxito Sim Não Exclusã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:
  • Mover para Subdiretório de Archive
  • Incluir Registro de Data e Hora e Mover para Subdiretório de Archive
  • Exclusão
 
Substituir arquivos de archive duplicados Sim Não Não selecionada Esta propriedade controla se o nó substitui os arquivos archive existentes pelo mesmo nome que o arquivo de entrada. Ela se aplica apenas quando a Ação no Processamento Bem-sucedido não é Excluir.  

As propriedades de Análise de Mensagem de Entrada do nó FileInput estão descritas na seguinte tabela:

Propriedade M P 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, o padrão 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 de modelo de mensagem disponível para o domínio de mensagem selecionado.
Message Não Não Não selecionada 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 Não selecionada O nome do formato físico da mensagem. Se estiver utilizando o analisador MRM ou IDOC, selecione da lista o formato físico da mensagem que chega. 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 precisar 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 Sim Não Sistema Intermediário Padrão O ID do conjunto de caracteres codificados utilizados para interpretar os bytes do arquivo que está sendo lido. A propriedade do comando mqsiapplybaroverride é messageCodedCharSetIdProperty.
Codificação de mensagens Sim Não Sistema Intermediário Determinado O esquema de codificação para números e caracteres grandes utilizado para interpretar bytes do arquivo que está sendo lido. Os valores válidos são Determinado pelo Sistema do Intermediário 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.

Propriedades de Opções do Analisador:

Propriedade M P Default Descrição
Cronometragem de análise (Parse timing) Não Não On Demand Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são:
  • On Demand
  • Imediato
  • 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 Não selecionada Esta propriedade controla 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 Não selecionada 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 for XMLNS:
  • O cabeçalho MQRFH2 de entrada.
  • A propriedade Análise da Mensagem de Entrada, Domínio de Mensagem.
Reter conteúdo misto Não Não Não selecionada Esta propriedade controla 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 Não selecionada 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 Não selecionada Esta propriedade controla 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 Essa propriedade é utilizada para especificar 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.

Propriedade de Sondagem:

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Intervalo de sondagem (segundos) Sim Sim 5 O intervalo de sondagem em segundos. waitInterval

Propriedades de Nova Tentativa:

Propriedade M P Default 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:
  • Failure
  • Repetição Curta
  • Repetição Curta e Longa
 
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ções curtas Não Sim 0 O intervalo, em segundos, entre cada nova tentativa se a propriedade Tentar Limite Novamente não for zero. shortRetryInterval
Intervalo de repetições longas 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 Mover para o Subdiretório de Restauraçã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:
  • Mover para o Subdiretório de Restauração
  • Exclusão
  • Incluir Registro de Data e Hora e Mover para Subdiretório de Restauração
 

Propriedades de Registros e Elementos:

Propriedade M P Default 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:
  • Arquivo Inteiro

    Ao configurar essa propriedade como Arquivo Inteiro, os arquivos maiores de 2 Gb não são suportados.

  • Comprimento Fixo
  • Delimitado
  • Seqüência de Registro Analisado
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:
  • Final de linha do DOS ou do UNIX
  • Delimitador Customizado
Delimitador customizado Não Não   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 está selecionada. As opções válidas são:
  • Postfix
  • Infix
Essa propriedade é ignorada, a menos que a propriedade Delimitador seja configurada para Delimitador Customizado.
Ignorar primeiro registro Sim Não FALSE Ignore o primeiro registro no arquivo. O nó FileInput lerá o primeiro registro no arquivo, mas não propagará o registro para o terminal de Saída. Os registros serão propagados normalmente, do segundo registro em diante. Use essa opção quando o primeiro registro for um cabeçalho que não precisa ser processado. Não é válido usar essa opção ao usar o arquivo todo.

Propriedades de Validação:

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

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhuma
  • Conteúdo e Valor (Content and Value)
  • Conteúdo
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:
  • Rastreio do Usuário
  • Local Error Log
  • Exceção
  • Lista de Exceções (Exception List)
 

Propriedades de FTP:

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Transferência Remota Não Sim Não selecionada Esta propriedade define se o nó usa as propriedades de transferência de arquivos remota listadas na guia FTP e lê arquivos a partir de um servidor FTP ou SFTP. Se você selecionar essa propriedade e a propriedade Incluir subdiretórios locais, apenas o diretório de nível superior especificado no sistema remoto será procurado em relação a arquivos. fileFtp
Protocolo de Transferência Não Sim FTP Esta propriedade especifica o protocolo a ser usado para transferência remota. Os valores válidos são:
  • FTP
  • SFTP
remoteTransferType
Servidor e Porta Remotos Não Sim Nenhuma Esta propriedade pode ter um dos seguintes valores:
  • O endereço IP ou nome (e, opcionalmente, o número da porta) de um servidor FTP ou SFTP remoto; por exemplo ftp.server.com:21 ou sftp.server.com:22
  • O nome de um serviço configurável do tipo FtpServer
Se um nome de serviço configurável for especificado, qualquer ou todas as outras propriedades de transfência remotas na guia FTP poderão ser substituídas pelo serviço configurável.
fileFtpServer
Identidade de Segurança Não Sim   O nome da identificação do usuário usada para acessar o servidor FTP ou SFTP. Essa propriedade é substituída pela propriedade securityIdentity, se definida, no serviço configurável FtpServer. fileFtpUser
Diretório do servidor Não Sim "." O diretório no servidor FTP ou SFTP a partir do qual transferir arquivos. Se você especificar esta propriedade como um caminho relativo, ele será relativo para o diretório home após o logon. Essa propriedade é substituída pela propriedade remoteDirectory, se definida, no serviço configurável FtpServer. fileFtpDirectory
Modo de transferência Não Não Binário O modo de transferência de FTP para a transferência de dados de arquivo. Esta propriedade é válida somente quando FTP é selecionado como o protocolo para transferência remota. Os valores válidos são:
  • Binário
  • ASCII
Essa propriedade é substituída pela propriedade transferMode, se definida, no serviço configurável FtpServer.

Se você tiver especificado SFTP como o protocolo para transferência remota, a propriedade Modo de Transferência será ignorada e a codificação Binária será usada.

 
Atraso da varredura Não Sim 60 O atraso, em segundos, entre as varreduras de diretórios remotos. Esta propriedade substitui o conjunto de valores para Intervalo de Sondagem quando a propriedade Transferência Remota é selecionada. Essa propriedade é substituída pela propriedade scanDelay, se definida, no serviço configurável FtpServer.  

Propriedades de Transações:

Propriedade M P Default Descrição
Modo de Transação Não Sim Não O modo de transação neste nó de entrada determina se o restante dos nós no fluxo será executado no ponto de sincronização. As opções válidas são:
  • Sim
  • Não
Propriedades de Instâncias. Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens.
Propriedade M P Default 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.
  • Se você selecionar Utilizar Conjunto Associado ao Fluxo de Mensagens, as instâncias adicionais serão obtidas a partir do conjunto de fluxos de mensagens.
  • Se você selecionar Usar Conjunto Associado ao Nó, instâncias adicionais serão alocadas a partir das instâncias adicionais do nó com base no número especificado na propriedade Instâncias Adicionais.
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
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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:01:55


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | ac55150_