Marca Field FSD

O elemento "field" (campo) especifica um campo único nos dados de entrada ou de saída.

Atributos

• name (nome)

  Especifica o nome do campo. Se o atributo de saída estiver definido como yes (sim), este nome será usado como nome da marca XML na saída e para coincidir a escolha com uma marca XML durante a entrada.

• output (saída)

  Especifica se o campo deverá ser incluído na saída. Os valores válidos para este atributo são:

  • yes (sim)

    o registro gera uma marca na saída

  • no (não)

    o campo simplesmente descreve a estrutura de dados e pode ser usado para ignorar dados.

  O valor default é yes.

• record-sep (sep-registro)

  Especifica uma cadeia de separadores de campo opcional para o campo. Pode ser qualquer valor de cadeia. Estes valores especiais também podem ser usados:

  • \r

    o caractere de retorno de carro

    \n

  • o caractere de alimentador de linha

  • \t

    o caractere de tabulação.

  Os dados têm comprimento fixo. O atributo max-length (comprimento-máx) será usado se nenhum separador de campo for especificado.

  O último campo em um registro usa o separador de registro, não o separador de campo.

• valid-value

  Define um valor fixo para o campo. É utilizado para validar dados simples e também como parte da conciliação de padrão no elemento "choice" (escolha). Se o atributo output (saída) estiver definido como no para os dados simples, o valid-value (valor-válido) será gravado no arquivo simples.

• leading-chars

  Especifica uma cadeia que, se encontrada, deve ser removida do início de um campo. Se o atributo trailing-chars (caracteres-secundários) não estiver especificado, o primeiro desses caracteres será usado para preencher o valor à esquerda se ele for mais curto que o comprimento especificado pelo atributo 'min-length’.

• trailing-chars

  Especifica uma cadeia que, se encontrada, deve ser removida do final de um campo. O primeiro desses caracteres será usado para preencher o valor à esquerda se ele for mais curto que o comprimento especificado pelo atributo 'min-length’.

• output-if-empty (saída-se-vazio)

  Especifica se um campo deve ser gravado, mesmo se estiver vazio. Os valores válidos para este atributo são yes (sim) e no (não). O default é no.

• max-length (comprimento-máx)

  Define o comprimento máximo dos dados. Esse valor especifica a quantidade de dados que devem ser lidos. O valor default é 128.

• min-length (comprimento-mín)

  Define o comprimento mínimo dos dados. Esse valor é usado para validação, para conciliação de padrões pelo elemento "choice" (escolha) e também para enchimento quando os atributos leading-chars ou trailing-chars estiverem especificados. O valor default é 0.

• truncate (truncar)

  Se esse atributo estiver definido como yes (sim), os dados gravados no arquivo de formato simples serão truncados para o max-length (comprimento-máx) especificado. O valor default é no.

• quoted (entre aspas)

  Especifica se devem ser colocadas aspas em volta dos dados. Isso permite que o separador de campo apareça dentro dos dados de saída, já que o processador FSD não procurará em uma cadeia entre aspas referente ao separador de campo. Esse atributo tem os valores:

  • No (não)

    Os dados não são tratados como uma cadeia entre aspas, ou seja, eles serão gravados literalmente dentro e fora do arquivo de formato simples.

  • Yes (sim)

    Os dados são tratados como uma cadeia entre aspas. Ao serem convertidos de formato simples para XML, os dados terão as aspas removidas e as aspas extras serão convertidas em aspas simples.

  Ao serem convertidos de XML para formato de arquivo simples, os dados serão colocados entre aspas. E qualquer aspa existente passará a ter caracteres de escape, ou seja, aspas simples serão convertidas em aspas duplas. Isso significa que " se tornará "", etc.

• Auto

  Esta opção só é aplicável na conversão de dados de arquivo de formato simples delimitado em XML. Se os dados contiverem o separador de campo, eles serão tratados como se a opção 'quoted' (entre aspas) estivesse definida como yes (sim).

  O valor default é auto.