Parâmetros em Conjuntos de Dados de EMF e UML

Você pode definir parâmetros nos conjuntos de dados de EMF e UML, utilizá-los nas consultas do conjunto de dados para mapeamento de linha e de coluna e ligar valores a eles no design do relatório. É possível usar parâmetros para criar variações em conjuntos de dados genéricos, evitando, assim, a criação de diversos conjuntos de dados praticamente idênticos uns aos outros. Também é possível utilizar parâmetros para unir objetos.

Como utilizar parâmetros para criar variações nos conjuntos de dados genéricos

Você poderá utilizar parâmetros quando necessitar de vários conjuntos de dados que forem idênticos, exceto por uma ligeira variação. Para evitar a criação de vários conjuntos de dados, você pode criar um único conjunto de dados que utiliza um parâmetro para representar a variação e ligar o parâmetro ao valor alterado.

Por exemplo, em vez de possuir um conjunto de dados que obtenha todas as classes nos pacotes denominados A e outro que obtenha todas as classes nos pacotes denominados B, você pode criar um conjunto de dados que obtenha todas as classes nos pacotes denominados $name. É possível ligar, então, $name a A e B. Isso torna seus conjuntos de dados mais concisos e mais reutilizáveis.

Para obter informações adicionais sobre a utilização de parâmetros e sobre a ligação de valores a eles, consulte o Guia de Campo do BIRT.

Como Utilizar Parâmetros para Unir Objetos

Você pode utilizar os parâmetros para unir objetos em conjuntos de dados quando fazer o design de relatórios para modelos EMF e UML. Dependendo do relacionamento entre os objetos, é possível utilizar uma chave para unir os objetos; quando você não utiliza uma chave, pode definir um parâmetro para unir os objetos. Entretanto, você também pode utilizar parâmetros quando uma chave funcionar.

Objetos que você pode unir sem parâmetros

Não é necessário criar parâmetros para unir objetos nas seguintes situações:

Objetos que Requerem Parâmetros ao Uni-los

São necessários parâmetros para unir os objetos nas seguintes situações:
  • Relacionamentos que tiverem multiplicidade 1–para*, em que uma multiplicidade 1 não for navegável
    " "
  • Relacionamentos que tiverem multiplicidade *-para-*
    “ "

Os parâmetros são necessários nessas situações, porque os conjuntos de dados EMF e UML não suportam colunas com multiplicidade maior que * ao utilizar uma coluna em um conjunto de dados que representa o outro terminal do relacionamento. Esses tipos de relacionamentos são muito comuns nos modelos de EMF e UML.

Dicas para unir objetos

Você pode utilizar parâmetros em um conjunto de dados para unir dois objetos relacionados por qualquer tipo de relacionamento no modelo. Para utilizar parâmetros para unir objetos, defina um conjunto de dados que represente um terminal navegável de um relacionamento e defina para ele um parâmetro que represente o objeto no outro terminal do relacionamento. Em seguida, na consulta do mapeamento de linha, utilize este parâmetro como um contexto para navegar dele para os objetos que representam as linhas do conjunto de dados.

Por exemplo, no conjunto de dados que representa classe Y, é possível definir um parâmetro $X que representa um objeto de classe X e, em seguida, especificar sua consulta de mapeamento de linha como expressão XPath $X\y. Dessa maneira, o conjunto de dados representa objetos de tipo Y que estão relacionados de maneira específica a um objeto de contexto do tipo X.

Os parâmetros do conjunto de dados são tipificados com qualquer um dos tipos escalares que as Business Intelligence Reporting Tools (BIRT) suportam. Por exemplo, é possível definir um parâmetro de cadeia $name e, em seguida, gravar a seguinte expressão XPath de mapeamento de linha: Class->ownedAttribute[@name=$name].

Os parâmetros de objeto podem ser representados por um ID escalar que você pode utilizar para resolver o objeto. Nos modelos de e UML, o ID exclusivo de um objeto é seu URI codificado como uma cadeia. Conseqüentemente, você seleciona string como um tipo de parâmetros de URI e os liga às colunas de URI de objeto no tempo de execução.

Como Definir Parâmetros

Para obter informações sobre a definição de parâmetros ao criar um conjunto de dados, consulte os tópicos "Criando Conjuntos de Dados EMF" e "Criando Conjuntos de Dados UML".

Também é possível incluir parâmetros aos conjuntos de dados existentes. No editor do conjunto de dados, você começa com a página Parâmetros de Consulta, não com a página Parâmetros, para definir parâmetros para as consultas de conjunto de dados EMF e UML. Utilize as duas páginas da seguinte maneira:
  • Utilize a página Parâmetros de Consulta 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.
  • Utilize a página Parâmetros para concluir a definição do parâmetro. 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.

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 ($). Ao ligar os valores a um parâmetro do conjunto de dados na página Ligação de Dados, você utiliza o nome de exibição do parâmetro.

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