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:

Figura 1. Um Arquivo Simples de 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

  1. 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:
    1. 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 Caminho de Criação Padrão atual é mostrado na parte inferior 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.

    2. 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

    3. Copie o arquivo FlatFileSchemasExample.zip do diretório FlatFileSchema para o diretório Caminho de Criação Padrão.
    4. Extraia o conteúdo do arquivo FlatFileSchemasExample.zip para o diretório Caminho de Criação Padrão.
  2. Abra o projeto FlatFileSchemasExample:
    1. Selecione Arquivo > Abrir Projeto... no menu da barra de ferramentas do Studio. A caixa de diálogo Abrir é mostrada.
    2. Procure e abra o diretório FlatFileSchemasExample.
    3. Clique no arquivo FlatFileSchemasExample.sp3 e clique em Abrir. O projeto é exibido.
  3. 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.
  4. Teste o Esquema de Arquivo Simples vegPO:
    1. Na área de janela de teste, clique em Procurar. A caixa de diálogo Abrir Arquivo de Dados de Teste de Amostra é aberta.
    2. 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

    3. Clique em Abrir. Os dados de entrada do arquivo vegPO.txt são mostrados na área de janela esquerda da guia Testar.
    4. Clique no ícone Testar (Ícone Testar ). Na área de janela de resultados (localizada no lado direito da área de janela de teste) o resultado da conversão é exibido como dados XML.
  5. Na guia Layout do Esquema, clique no nó-raiz vegPO. O nó-raiz vegPO é exibido com as seguintes propriedades:
    1. A propriedade Estrutura é igual a Delimitada - A estrutura do nó-raiz é delimitada.
    2. O delimitador de Filho é igual Fim da Linha- Os registros-filhos são delimitados por um fim de linha.
    3. A Posição do Delimitador de Filho é igual a Após - Os delimitadores são esperados após cada registro
    4. O delimitador de Repetição é igual a Fim da Linha- Os registros de repetição também são delimitados pelo fim da linha.
  6. 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:
    Figura do cabeçalho VegPO

    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:

    VegPO mostrando um conjunto de elementos de repetição que contém três registros-filhos de tipos diferentes.

    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

  7. 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.
  8. 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:
    Grupo order do vegPO

    O seguinte ícone representa um registro baseado em um tipo de registro:

    Ícone de registro baseado no tipo.

    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.
    O relacionamento de repetição entre o grupo orders e o tipo de grupo order é mostrado na figura a seguir:
    Padrão de repetição do vegPO
  9. 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:
      ID de teste do VegPO
      Esse realce indica que a primeira linha de cada registro de repetição está designada ao registro id.
  10. 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:
      Figura indica que a segunda linha de cada registro (a linha shipDate) é destacada.
      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.
  11. 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:
  12. 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:
      A figura mostra que a terceira linha do registro de repetição (mostrando o nome da verdura e o peso em libras) está realçada.
      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.
  13. 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:
    Esta figura mostra que os valores designados ao campo name estão realçados.