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".
Por Que e Quando Desempenhar Esta Tarefa
- Abra a visualização Explorador de Relatório. Clique em .
- 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.
- Abra a visualização Explorador de Dados. Clique em .
- 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.
- 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.
- 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 ($).
- 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:
- Navegue para selecionar um dos modelos especificados na origem de dados que você está utilizando.
- 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 (>).
- 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.
- 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.
- Clique em Avançar.
- 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:
- Clique em Procurar para exibir o tipo a ser procurado.
- Selecione uma entrada na árvore a ser utilizada como uma coluna de tabela e clique no botão de seta direita (>).
- 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.
- Ajuste os valores para Consulta e Tipo para cada coluna conforme necessário.
- Depois de configurar a tabela, clique em Concluir. A janela Editar Conjunto de Dados é aberta.
- 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.
- É 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.