Criando Conjuntos de Dados de EMF

Um conjunto de dados de Eclipse Modeling Framework (EMF) é um banco de dados no formato de tabela cujas linhas e colunas são mapeadas de uma origem de dados de EMF. O conjunto de dados é formatado para que você possa utilizar as Business Intelligence and Reporting Tools (BIRT) para gerar relatórios a partir dele.

Antes de Iniciar

A origem de dados que você utilizar deve existir antes de iniciar essa tarefa. Para criar uma nova origem de dados, consulte a tarefa relacionada "Criando Origens de Dados de EMF".

Procedimento

  1. Abra a visualização Explorador de Relatório. Clique em Janela > Mostrar Visualização > Outro > Geração de Relatórios > Explorador de Relatório.
  2. Na visualização Explorador de Relatório, clique com o botão direito do mouse em um design de relatório; em seguida, clique em Abrir.
  3. Abra a visualização Explorador de Dados. Clique em Janela > Mostrar Visualização > Outro > Design de Relatório > Explorador de Dados.
  4. Na visualização Explorador de Dados, clique com botão direito do mouse em Conjuntos de Dados; em seguida, clique em Novo Conjunto de Dados.

    Se você quiser unir dados a partir de várias tabelas, poderá clicar também em Novo Conjuntos de Dados Unidos. Para obter informações adicionais, consulte o tópico "Como unir conjuntos de dados" no Guia de campo para o BIRT.

  5. Digite um nome para o conjunto de dados, selecione Conjunto de Dados dE EMF como o tipo, seleciona uma origem de dados e clique em Avançar.
  6. Na página Parâmetros de Consulta, liste todos os parâmetros de consulta necessários para definir consultas no conjunto de dados; em seguida, clique em Avançar. Utilize esta página para incluir, remover, reordenar e renomear parâmetros. Os parâmetros nesta página são identificados pelo nome interno do parâmetro. O nome interno é o nome que você utiliza nas expressões XPath, portanto ele deve estar de acordo com as convenções de nomenclatura do XPath para as variáveis; deve iniciar com uma letra ou sublinhado (_) e pode conter qualquer seqüência de letras, dígitos ou caracteres de sublinhado. As alterações feitas nesta página também aparecem na página Parâmetros; consulte a etapa 10.

    Os parâmetros são uma ferramenta flexível e poderosa permite a inclusão de muitos tipos especiais de informações nos relatórios. Para obter informações sobre como utilizar parâmetros, consulte o conceito relacionado "Parâmetros nos conjuntos de dados de EMF e de UML".

    Nota: Depois de definir um parâmetro, você poderá consultá-lo nas consultas de mapeamento de linha e de mapeamento de coluna utilizando seu nome interno precedido por um cifrão ($).
  7. Defina o mapeamento da linha para o conjunto de dados. Defina uma coleta de elementos que forma as linhas de uma tabela e que especifica os tipos de elementos. Para definir o mapeamento da linha, conclua as seguintes etapas:
    1. Navegue para selecionar um dos modelos especificados na origem de dados que você está utilizando.
    2. Para definir o mapeamento da linha, especifique a expressão XPath. Por exemplo, para mapear todas as classes no modelo, a expressão é //Class, e o tipo é Class.
      Nota: Ao gravar as expressões XPath de mapeamento de linha, lembre-se de que a raiz é a instância de recurso. Para obter informações adicionais, sobre a sintaxe XPath, consulte os links relacionados no final deste tópico.
      É possível digitar a expressão diretamente ou construí-la a partir de elementos na estrutura EMF, que você inclui no campo Expressão selecionando um nó na estrutura EMF e, em seguida, clicando no botão de seta direita (>).
    3. Se a expressão começar a partir de um parâmetro como um contexto, e não da raiz do recurso, você poderá desmarcar a caixa de opção Avaliar para cada modelo da instância de origem de dados. Isso pode melhorar o desempenho, pois a expressão não precisa ser executada para cada recurso.
    4. Selecione um elemento na estrutura EMF que tem o tipo necessário para a expressão XPath; em seguida clique no botão de seta direita (>) para o campo Tipo. Por exemplo, para //Class, o tipo de resultado é Class.
    5. Clique em Avançar.
  8. Defina as colunas da tabela para seu conjunto de dados. Para expressões XPath de definição de coluna, a raiz é um objeto do tipo que você especificou para o tipo de retorno na etapa anterior. É possível definir colunas digitando os valores para elas diretamente na matriz ou executando as seguintes etapas:
    1. Clique em Procurar para exibir o tipo a ser procurado.
    2. Selecione uma entrada na árvore a ser utilizada como uma coluna de tabela e clique no botão de seta direita (>).
    3. Especifique todas as colunas necessárias. É possível excluir as colunas ou alterar sua ordem ao clicar nos botões à direita da matriz Mapeamento da Coluna.
    4. Ajuste os valores para Consulta e Tipo para cada coluna conforme necessário.
  9. Depois de configurar a tabela, clique em Concluir. A janela Editar Conjunto de Dados é aberta.
  10. Se o conjunto de dados incluir parâmetros, utilize a página Parâmetros da janela Editar Conjunto de Dados para concluir a definição dos parâmetros. Especifique o nome de exibição, que é inicialmente configurado como o nome interno; o tipo, que é inicialmente configurado como String; a direção, que é inicialmente configurada como Input; e o nome do parâmetro de relatório, se houver, a ser ligado ao parâmetro do conjunto de dados. Ao ligar os valores a um parâmetro do conjunto de dados na página Ligação de Propriedade, utilize o nome de exibição do parâmetro.
  11. É possível continuar a editar, clique em Visualizar Resultados para verificar seu trabalho ou clique em OK para fechar a janela.
    Nota: Para modificar seu conjunto de dados a qualquer momento, na visualização Explorador de Dados, clique com o botão direito do mouse no conjunto de dados e, em seguida, clique em Editar.

O que Fazer Depois

Agora você pode utilizar o recurso do BIRT para concluir o design do relatório, incorporando elementos do conjunto de dados. Para obter informações, consulte o Guia de Campo para o BIRT.
Nota: Algumas informações, como links para a documentação Eclipse ou guias do desenvolvedor, estão disponíveis apenas a partir dos tópicos de ajuda instalados com o produto.

Feedback