Exemplo de Grupo
Sobre Esta Tarefa
Este exemplo mostra um Esquema de Arquivo Simples que analisa um conjunto de repetição de registros usando grupos. Cada conjunto do registro de repetição contém registros de tipos diferentes, conforme mostrado nos seguintes dados de Arquivo Simples da entrada de exemplo:

Nestes dados de exemplo, o primeiro, segundo e terceiro registros do conjunto de repetição são, cada um deles, um tipo diferente de registro. Além disso, este exemplo mostra como os tipos armazenados na guia Biblioteca de Tipos são usados em um Esquema de Arquivo Simples. Neste exemplo, você visualiza e testa um Esquema de Arquivo Simples existente, em vez de criar o Esquema de Arquivo Simples a partir do início.
Para abrir, visualizar e testar o Esquema de Arquivo Simples usado para analisar os dados de entrada exibidos em Figura 1:
Procedimento
- Neste exemplo, o Esquema de Arquivo Simples já está construído
no projeto FlatFileSchemasExample. Para visualizar
o Esquema de Arquivo Simples, você deve primeiro extrair o projeto
FlatFileSchemasExample:
- Localize o Caminho de Criação Padrão definido
no Studio - o diretório no qual novos projetos são criados. Para visualizar
o Caminho de Criação Padrão atual, selecione Arquivo > Preferências... no menu da barra de ferramentas do Studio. O diálogo Preferências é
aberto. O atual Caminho de Criação Padrão é mostrado no final da área de janela. Por padrão, o Caminho de Criação
Padrão está localizado no seguinte diretório:
C:\Documents and Settings\myLogin\My Documents
Em que myLogin representa seu nome de login do Windows.
- Localize o arquivo FlatFileSchemasExample.zip que
contém os arquivos que compõem o projeto FlatFileSchemasExample.
Se você aceitou os padrões durante a instalação do Studio, esse
arquivo está localizado no seguinte diretório:
C:\Arquivos de Programas\IBM\WebSphere Cast Iron Studio 3.X\Samples\FlatFileSchema
- Copie o arquivo FlatFileSchemasExample.zip do diretório FlatFileSchema para o diretório Caminho de Criação Padrão.
- Extraia o conteúdo do arquivo FlatFileSchemasExample.zip para o diretório Caminho de Criação Padrão.
- Localize o Caminho de Criação Padrão definido
no Studio - o diretório no qual novos projetos são criados. Para visualizar
o Caminho de Criação Padrão atual, selecione Arquivo > Preferências... no menu da barra de ferramentas do Studio. O diálogo Preferências é
aberto. O atual Caminho de Criação Padrão é mostrado no final da área de janela. Por padrão, o Caminho de Criação
Padrão está localizado no seguinte diretório:
- Abra o projeto FlatFileSchemasExample:
- Selecione Arquivo > Abrir Projeto... no menu da barra de ferramentas do Studio. A caixa de diálogo Abrir é mostrada.
- Procure e abra o diretório FlatFileSchemasExample.
- Clique no arquivo FlatFileSchemasExample.sp3 e clique em Abrir. O projeto é exibido.
- Abra o Esquema de Arquivo Simples vegPO pré-construído. Na pasta Esquemas de Arquivo Simples da guia Projeto, clique duas vezes no Esquema de Arquivo Simples vegPO. Os nós do Esquema de Arquivo Simples vegPO são exibidos na guia Layout do Esquema e as propriedades do nó-raiz vegPO são mostradas na área de janela direita.
- Teste o Esquema de Arquivo Simples vegPO:
- Na área de janela de teste, clique em Procurar. A caixa de diálogo Abrir Arquivo de Dados de Teste de Amostra é aberta.
- Procure o arquivo vegPO.txt que
contém os dados de entrada.Se você aceitou os padrões durante a instalação do Studio, esse
arquivo está localizado no seguinte diretório:
C:\Arquivos de Programas\IBM\WebSphere Cast Iron Studio 3.X\Samples\FlatFileSchema
- Clique em Abrir. Os dados de entrada do arquivo vegPO.txt são mostrados na área de janela esquerda da guia Testar.
- Clique no ícone Testar (
). Na área de janela de resultados, o resultado da conversão é exibido como dados XML.
- Na guia Layout do Esquema, clique no
nó-raiz vegPO. O nó-raiz vegPO é
exibido com as seguintes propriedades:
- A propriedade Estrutura é igual a Delimitada - A estrutura do nó-raiz é delimitada.
- O delimitador de Filho é igual Fim da Linha- Os registros-filhos são delimitados por um fim de linha.
- A Posição do Delimitador de Filho é igual a Após - Os delimitadores são esperados após cada registro
- O delimitador de Repetição é igual a Fim da Linha- Os registros de repetição também são delimitados pelo fim da linha.
- Na guia Layout do Esquema, clique
no nó orderingStore. A primeira linha dos dados de
entrada é destacada na área de janela de teste, conforme mostrado na
figura a seguir:
O primeiro registro do Esquema de Arquivo Simples vegPO é um registro de cabeçalho chamado orderingStore que ocorre apenas uma vez. Na guia Layout do Esquema, os campos e o registro que compõem o registro orderingStore são exibidos como filhos. Esta primeira linha é analisada nos campos e registros que compõem o registro orderingStore.
Após o primeiro registro de cabeçalho, os conjuntos de elementos de repetição são iniciados. Cada conjunto de elementos de repetição contém três registros-filhos de tipos diferentes, conforme mostrado na figura a seguir:
Um registro de repetição que contém registros-filhos de tipos diferentes pode ser modelado no Editor de Esquema de Arquivo Simples usando grupos. Os grupos são necessários apenas quando os dados não fornecem nenhum delimitador ou estrutura adicional para marcar claramente o início e fim das repetições que contêm mais de um registro. Os delimitadores para as repetições são herdados do registro pai ou do nó-raiz. Neste exemplo, para o nó-raiz vegPO, o delimitador de repetição é configurado como fim da linha. O nó do grupo orders usa o delimitador de fim da linha para analisar seus registros de repetição
- Na guia Layout do Esquema, clique no
nó do grupo orders. Observe as seguintes mudanças
gráficas nas áreas de janela:
- Na subárea de janela esquerda da área de janela de teste, todas as linhas após a linha de cabeçalho são destacadas. Esse realce indica que após a análise, todos os dados após o primeiro registro são designados ao nó do grupo orders.
- Na área de janela Propriedades Básicas, as Ocorrências do grupo orders são Desvinculadas. Esta configuração significa que pode haver uma ou mais instâncias deste grupo.
- Na área de janela Propriedades Básicas, para o grupo orders, o Tipo é igual a order. Essa configuração significa que o grupo orders está baseado no tipo de grupo order. O conteúdo e as propriedades do tipo de grupo order são definidos na guia Biblioteca de Tipos.
- Selecione a guia Biblioteca de Tipos. Os
tipos de registro e os tipos de grupo usados no Esquema de Arquivo Simples vegPO são
exibidos. O tipo de grupo order contém
esses registros, conforme mostrado na figura a seguir:
O seguinte ícone representa um registro baseado em um tipo de registro:
O grupo orders com o tipo de grupo order define um conjunto de registros de repetição de diferentes registros devido às seguintes características:
- Pode haver de uma a várias instâncias do grupo orders.
- O tipo de grupo order contém três registros de tipos diferentes.
- O grupo orders está baseado no tipo de grupo order, ou herda dele.
- Na guia Biblioteca de Tipos, clique no nó do registro id do
tipo de grupo order. Observe as seguintes
mudanças gráficas nas áreas de janela:
- Na área de janela Propriedades Básicas, o Tipo do registro id é igual ao tipo de registro denominado orderID. Essa configuração significa que o registro id está baseado no tipo de registro orderID.
- Na subárea de janela esquerda da área de janela de teste, a
primeira linha de cada registro de repetição é destacada conforme mostrado
na figura a seguir:Esse realce indica que a primeira linha de cada registro de repetição está designada ao registro id.
- Na guia Biblioteca de Tipos, clique no nó do registro shipdate do
tipo de grupo order. Observe as seguintes
mudanças gráficas nas áreas de janela:
- Na área de janela Propriedades Básicas, o Tipo do registro shipdate é igual ao tipo de registro denominado shippingDate. Essa configuração significa que o registro shipdate está baseado no tipo de registro shippingDate.
- Na área de janela Propriedades Básicas, a Estrutura do registro shipdate é Posicional. Essa configuração significa que os campos-filhos do registro shipDate são determinados por sua posição e comprimento no registro e não por delimitadores.
- Na subárea de janela esquerda da área de janela de teste, a
segunda linha de cada registro de repetição é destacada conforme mostrado
na figura a seguir: Esse realce indica que a segunda linha de cada registro de repetição está designada ao registro shipDate. O registro shipDate contém três campos-filhos posicionais (month, day e year) que são herdados do tipo de registro shippingDate.
- Na Biblioteca de Tipos, clique no nó do campo month do
tipo de registro shippingDate.
Na subárea de janela esquerda da área de janela de teste, os valores
designados ao campo month são destacados, conforme
mostrado na figura a seguir:
- Na Biblioteca de Tipos, clique no nó do registro contents do
tipo de grupo order. Observe as seguintes
mudanças gráficas nas áreas de janela:
- Na área de janela Propriedades Básicas, o Tipo do registro contents é igual ao tipo de registro denominado orderContent. Essa configuração significa que o registro contents está baseado no tipo de registro orderContent.
- Na subárea de janela esquerda da área de janela de teste, a
terceira linha de cada registro de repetição é destacada, conforme
mostrado na figura a seguir: O tipo de registro orderContent contém o registro vegetables. O registro vegetables contém um conjunto de registros de repetição vegetable. O registro vegetable contém um campo name e um campo pounds.
- Na Biblioteca de Tipos, clique no nó do registro name do
tipo de registro orderContent. Na subárea de janela
esquerda da área de janela de teste, os valores designados ao campo
name são destacados conforme mostrado na figura a
seguir: