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