Propriedades do Campo

Quando um campo é selecionado na guia Layout do Esquema ou um tipo de campo é selecionado na guia Biblioteca de Tipos, as seguintes seções de propriedades são exibidas na área de janela:
  • Propriedades Básicas
  • Preenchimento e Corte
  • Delimitadores
  • Propriedades Posicionais

Propriedades Básicas

As Propriedades Básicas de um campo são definidas na tabela a seguir:

Propriedade Descrição
Nome Especifica o nome deste campo.
Atenção: O nome do campo deve ser um nome de nó válido.
Tipo Opcional: Especifica o tipo de campo usado como uma base para o campo. A lista Tipo estará ativa apenas se um tipo de campo tiver sido criado.
Atenção: A seleção de um novo tipo pode reconfigurar algumas das propriedades existentes do campo com as novas configurações.
Reconfigurar Reconfigura as propriedades que foram configuradas localmente para esse campo para os valores do tipo selecionado.
Tipo Especifica um dos seguintes tipos de dados para o campo:
  • cadeia -  texto na codificação especificada
  • booleano - true ou false
  • número inteiro - qualquer número inteiro
  • numérico- qualquer número decimal
Ocorrências Opcionais Para dados delimitados, esta caixa de opção especifica que ambos, o campo e seu delimitador, podem ser omitidos dos dados. Para dados posicionais, não há nenhum delimitador, portanto, apenas o campo é realmente omitido. Se o campo puder ser vazio, mas o delimitador precisar estar presente, o campo será considerado necessário e esta caixa de opção não deverá ser selecionada.
Atenção: Ao especificar a propriedade opcional de um campo, tome cuidado para não criar uma gramática ambígua para o Esquema de Arquivo Simples.Para obter informações adicionais, consulte Especificando Campos e Registros Opcionais.
Mínimo de Repetições Especifica o número mínimo de ocorrências do campo.
Máximo de Repetições Controla as repetições neste campo único. Selecione uma das seguintes opções:
  • Desvinculado - Especifica que esse campo pode ser repetido qualquer número de vezes.
  • Intervalo - Especifica o número máximo de repetições para esse campo. As ocorrências reais do campo podem ser menores ou iguais a esse número.
Nota: Múltiplas ocorrências serão permitidas apenas quando o nó-pai tiver especificado um delimitador de repetição.

Preenchimento e Corte

Com relação a se os dados são cortados ou preenchidos, isto dependerá das seguintes condições:
  • Na atividade Ler Arquivo Simples, ao converter dados de Arquivo Simples em dados XML, os caracteres do campo Arquivo Simples são cortados antes de serem colocados no campo XML correspondente.
  • Na atividade Gravar Arquivo Simples, ao converter dados XML em Dados de Arquivo Simples, os caracteres do elemento são preenchidos antes de serem colocados no campo Arquivo Simples correspondente.

As propriedades Preenchimento e Corte de um campo são definidas na tabela a seguir:

Propriedade Descrição
Caractere de Preenchimento/Corte Especifica o caractere único usado para preencher o comprimento de, ou ser cortado de, um campo.
No campo de texto Caractere da área de janela, insira um caractere único usando uma das seguintes ações:
  • Digite o caractere.
  • Digite o valor Unicode. Por exemplo, insira /u0020 para o caractere de espaço.
  • Clique em [...] para procurar um caractere. A caixa de diálogo Seleção de Caractere é aberta listando as opções de caracteres válidas para delimitadores. Na coluna Exibir, o caractere ou um mnemônico que representa o caractere é exibido. Além disso, o valor hexadecimal e o ponto de código Unicode correspondentes para o caractere são exibidos. Selecione um caractere e clique em OK.Se o caractere selecionado não tiver um símbolo visual, um mnemônico ou o valor Unicode poderá ser mostrado para esse caractere. Para obter informações adicionais sobre qualquer um destes caracteres, consulte os conjuntos de caracteres Basic Latin e Latin-1 Supplement em: http://www.unicode.org/charts/
Preencher no Comprimento Especifica o comprimento final dos dados para o campo ao converter dados XML em Dados de Arquivo Simples na atividade Gravar Arquivo Simples. Os caracteres de preenchimento especificados são incluídos nos dados para o campo até esse comprimento. Geralmente, o tamanho do preenchimento é igual ao campo.
Nota: Este valor especificado nesse campo não é usado ao cortar dados de Arquivo Simples para dados XML na atividade Ler Arquivo Simples.
Justificação Especifica qual lado do campo é preenchido ou cortado:
  • À Esquerda - Quando a opção À Esquerda é especificada, a ação que ocorre dependerá se o campo for lido ou gravado:
    • Atividade Ler Arquivo Simples - Quando o campo é lido, os caracteres de corte especificados são cortados do final do campo. Por exemplo, se o caractere de corte for igual a um caractere de hífen, o Comprimento do Campo será igual a 10 e o campo de entrada do Arquivo Simples será igual a ---1234---. O resultado é o seguinte elemento XML: <element>---1234</element>.
    • Atividade Gravar arquivo simples - Quando o campo é gravado, o preenchimento é incluído depois dos dados do campo.Por exemplo, se o caractere de preenchimento for igual a um caractere de hífen, Preencher no comprimento será igual a 10 e o elemento XML de entrada será igual a <element>1234</element>; o resultado será o campo Arquivo simples a seguir: 1234------.
 
  • À Direita - Quando a opção À Direita é especificada, a ação que ocorre dependerá se o campo for lido ou gravado:
    • Atividade Ler Arquivo Simples - Quando o campo é lido, os caracteres de preenchimento são cortados do início do campo. Por exemplo, se o caractere de corte for igual a um caractere de hífen, o Comprimento do Campo será igual a 10 e o campo de entrada do Arquivo Simples será igual a ---1234---. O resultado é o seguinte elemento XML: <element>1234---</element>.
    • Atividade Gravar Arquivo Simples - Quando o campo é gravado, o preenchimento é incluído antes dos dados do campo. Por exemplo, se o caractere de preenchimento for igual a um caractere de hífen, Preencher no Comprimento será igual a 10 e o elemento XML de entrada será igual a <element>1234</element>, o resultado é o seguinte campo Arquivo Simples: ------1234.

Delimitadores

O Escape e os Delimitadores de Encapsulação de um campo são definidos na tabela a seguir. Estas propriedades serão usadas apenas se o registro pai tiver a opção Delimitado selecionada para a propriedade Estrutura.

Propriedade Descrição
Caractere de Escape Especifica o caractere único usado para escape de delimitadores nos dados do campo. Durante o tempo de execução, o Integration Appliance analisa o caractere diretamente após esse delimitador como um caractere, não como um delimitador.
No campo de texto Caractere da área de janela, insira um caractere único usando uma das seguintes ações:
  • Digite o caractere.
  • Digite o valor Unicode do caractere. Por exemplo, insira /u0020 para o caractere de espaço.
  • Clique em [...] para procurar um caractere. A caixa de diálogo Seleção de Caractere é aberta listando as opções de caracteres válidas para delimitadores. Na coluna Exibir, o caractere ou um mnemônico que representa o caractere é exibido. Além disso, o valor hexadecimal e o ponto de código Unicode correspondentes para o caractere são exibidos. Selecione um caractere e clique em OK.Se o caractere selecionado não tiver um símbolo visual, um mnemônico ou o valor Unicode poderá ser mostrado para esse caractere. Para obter informações adicionais sobre qualquer um destes caracteres, consulte os conjuntos de caracteres Basic Latin e Latin-1 Supplement em: http://www.unicode.org/charts/
 

Por exemplo, como o seguinte registro é analisado quando nenhum caractere de escape está definido e o delimitador do registro é um caractere dois-pontos?

135:Exploração de Cavernas: O que Você Realmente Precisa Saber:10

O registro anterior seria analisado nos 4 campos a seguir:
  • 135
  • Exploração de Cavernas
  • O que Você Realmente Precisa Saber
  • 10
Se não desejar que o título Exploração de Cavernas O que Você Realmente Precisa Saber seja dividido em dois campos, será possível especificar um caractere de escape de barra invertida e prefaciar o caractere dois-pontos com um caractere de barra invertida, conforme mostrado no seguinte registro:

135:Exploração de Cavernas/: O que Você Realmente Precisa Saber:10

Quando esse registro de Arquivo Simples é analisado com o caractere de escape antes do caractere dois-pontos, o título não é dividido em duas seções, mesmo que o registro use o caractere dois-pontos como um delimitador.

Posição Dinâmica Especifica a posição do caractere, iniciando em 1, em que o caractere de escape é definido no primeiro registro.O caractere de escape é determinado no tempo de execução usando o caractere localizado na posição do caractere especificada. Por exemplo, como o seguinte registro é analisado quando nenhum caractere de encapsulação está definido e o delimitador do registro é um caractere dois-pontos?

135:Exploração de Cavernas: O que Você Realmente Precisa Saber:10

O registro anterior seria analisado nos 4 campos a seguir:
  • 135
  • Exploração de Cavernas
  • O que Você Realmente Precisa Saber
  • 10
Se não desejar que o título Exploração de Cavernas O que Você Realmente Precisa Saber seja dividido em dois campos, será possível especificar uma Posição Dinâmica de 11 e incluir um caractere de barra invertida antes do caractere dois-pontos, conforme mostrado no seguinte registro:

135:Exploração de Cavernas/: O que Você Realmente Precisa Saber:10

O caractere de escape é agora igual ao 11º caractere no registro: o caractere de barra invertida. Agora, quando esse registro de Arquivo Simples é analisado com o caractere de escape igual ao caractere de barra invertida, o caractere dois-pontos após Exploração de Cavernas não quebra esse campo em duas seções, mesmo que o registro use o caractere dois-pontos como um delimitador.

Padrão de Gravação Especifica o caractere de escape a ser usado ao gravar este campo como dados de Arquivo Simples. Padrão de Gravação é apenas usado na atividade Gravar Arquivo Simples ao converter dados XML em dados de Arquivo Simples. Padrão de Gravação não é usado ao converter dados de Arquivo Simples em dados XML na atividade Ler Arquivo Simples.
No campo de texto Padrão de Gravação da área de janela, insira um caractere único usando uma das seguintes ações:
  • Digite o caractere.
  • Digite o valor Unicode do caractere. Por exemplo, insira /u0020 para o caractere de espaço.
  • Clique em [...] para procurar um caractere. A caixa de diálogo Seleção de Caractere é aberta listando as opções de caracteres válidas para delimitadores. Na coluna Exibir, o caractere ou um mnemônico que representa o caractere é exibido. Além disso, o valor hexadecimal e o ponto de código Unicode correspondentes para o caractere são exibidos. Selecione um caractere e clique em OK.Se o caractere selecionado não tiver um símbolo visual, um mnemônico ou o valor Unicode poderá ser mostrado para esse caractere. Para obter informações adicionais sobre qualquer um destes caracteres, consulte os conjuntos de caracteres Basic Latin e Latin-1 Supplement em: http://www.unicode.org/charts/

Por exemplo, você desejou incluir uma barra invertida como caractere de escape para o caractere dois pontos no elemento XML <title>Exploração de Cavernas: O Que Você Realmente Precisa Saber</title>. ao convertê-lo em dados de Arquivo Simples, especifique uma barra invertida no campo Padrão de Gravação.O resultado de tempo de execução para esse campo é a seguinte cadeia:

Exploração de Cavernas\: O que Você Realmente Precisa Saber

A posição do caractere especificada no campo Posição Dinâmica não é usada quando um elemento XML é convertido em dados de Arquivo Simples.

Caractere de Encapsulação Especifica um caractere delimitador para encapsular dados no campo, porque o campo pode conter caractere(s) que está(ão) sendo usado(s) para delimitar este campo no registro pai.
No campo de texto Caractere da área de janela, insira um caractere único usando uma das seguintes ações:
  • Digite o caractere.
  • Digite o valor Unicode do caractere. Por exemplo, insira /u0020 para o caractere de espaço.
  • Clique em [...] para procurar um caractere. A caixa de diálogo Seleção de Caractere é aberta listando as opções de caracteres válidas para delimitadores. Na coluna Exibir, o caractere ou um mnemônico que representa o caractere é exibido. Além disso, o valor hexadecimal e o ponto de código Unicode correspondentes para o caractere são exibidos. Selecione um caractere e clique em OK.Se o caractere selecionado não tiver um símbolo visual, um mnemônico ou o valor Unicode poderá ser mostrado para esse caractere. Para obter informações adicionais sobre qualquer um destes caracteres, consulte os conjuntos de caracteres Basic Latin e Latin-1 Supplement em: http://www.unicode.org/charts/
 

Por exemplo, como o seguinte registro é analisado quando nenhum caractere de encapsulação está definido e o delimitador do registro é um caractere dois-pontos?

135:Exploração de Cavernas: O que Você Realmente Precisa Saber:10

O registro anterior seria analisado nos 4 campos a seguir
  • 135
  • Exploração de Cavernas
  • O que Você Realmente Precisa Saber
  • 10
Se não desejar que o título Exploração de Cavernas O Que Você Realmente Precisa Saber seja dividido em dois campos, será possível especificar o caractere de encapsulação como aspas duplas e delimitar o título do manual com aspas duplas conforme mostrado no registro a seguir:

135:"Exploração de Cavernas: O que Você Realmente Precisa Saber":10

Agora, quando este registro de Arquivo Simples é analisado com o caractere de encapsulação configurado como aspas duplas, os dois pontos após Exploração de Cavernas não dividem este campo em duas seções, embora o registro pai use os dois pontos como um delimitador. O Integration Appliance lê todos os caracteres entre dois delimitadores de encapsulação como caracteres, em vez de delimitadores.

Posição Dinâmica Especifica a posição do caractere, iniciando em 1, em que o delimitador é definido no primeiro registro.O delimitador de encapsulação é determinado no tempo de execução usando o caractere localizado na posição do caractere especificada

Por exemplo, como o seguinte registro é analisado quando nenhum caractere de encapsulação está definido e o delimitador do registro é um caractere dois-pontos?

135:Exploração de Cavernas: O que Você Realmente Precisa Saber:10

O registro anterior seria analisado nos 4 campos a seguir:
  • 135
  • Exploração de Cavernas
  • O que Você Realmente Precisa Saber
  • 10
Se não desejar que o título Exploração de Cavernar O Que Você Realmente Precisa Saber seja dividido em dois campos, será possível especificar a Posição Dinâmica como 5 e delimitar o título do manual com aspas duplas e conforme mostrado no registro a seguir:

135:"Exploração de Cavernas: O que Você Realmente Precisa Saber":10

O caractere de encapsulação é igual ao 5º caractere no registro: o caractere de aspas duplas. Agora, quando este registro de Arquivo Simples é analisado com o caractere encapsulação igual ao caractere de aspas duplas, os dois pontos após Exploração de Cavernas não divide este campo em duas seções, embora o registro use os dois pontos como um delimitador. O Integration Appliance lê todos os caracteres entre dois delimitadores de encapsulação como caracteres e não delimitadores.

Padrão de Gravação Especifica o caractere de encapsulação a ser usado ao gravar este campo como dados de Arquivo Simples. Padrão de Gravação é apenas usado na atividade Gravar Arquivo Simples ao converter dados XML em dados de Arquivo Simples. Padrão de Gravação não é usado ao converter dados de Arquivo Simples em dados XML na atividade Ler Arquivo Simples.
No campo de texto Padrão de Gravação da área de janela, insira um caractere único usando uma das seguintes ações:
  • Digite o caractere.
  • Digite o valor Unicode do caractere. Por exemplo, insira /u0020 para o caractere de espaço.
  • Clique em [...] para procurar um caractere. A caixa de diálogo Seleção de Caractere é aberta listando as opções de caracteres válidas para delimitadores. Na coluna Exibir, o caractere ou um mnemônico que representa o caractere é exibido. Além disso, o valor hexadecimal e o ponto de código Unicode correspondentes para o caractere são exibidos. Selecione um caractere e clique em OK.Se o caractere selecionado não tiver um símbolo visual, um mnemônico ou o valor Unicode poderá ser mostrado para esse caractere. Para obter informações adicionais sobre qualquer um destes caracteres, consulte os conjuntos de caracteres Basic Latin e Latin-1 Supplement em: http://www.unicode.org/charts/.
 

Por exemplo, você desejou encapsular os dados localizados no elemento XML <title>Exploração de Cavernas: O Que Você Realmente Precisa Saber</title> com aspas duplas ao convertê-los em dados do Arquivo Simples, especifique as aspas duplas no campo Gravar Padrão. O resultado de tempo de execução para este campo é a sequência a seguir:

"Exploração de Cavernas: O que Você Precisa Saber"

A posição do caractere especificada no campo Posição Dinâmica não é usada quando um elemento XML é convertido em dados de Arquivo Simples.

Propriedades Posicionais

As Propriedades Posicionais de um campo são definidas na tabela a seguir. Estas propriedades estarão ativas apenas se o registro pai tiver a opção Posicional selecionada para a propriedade Estrutura.

Campo Descrição
Deslocamento de Campo Especifica o número de caracteres a serem ignorados, iniciando no final do campo anterior até atingir o início deste campo.
Comprimento do Campo Especifica o comprimento dos dados para este campo.