Tags de Parâmetros

Os componentes usam parâmetros, como ID de visualização, cadeia e números para incluir informações nos relatórios. Esses parâmetros são especificados usando as tags fp:*Param.
Cada componente possui tags obrigatórias e opcionais. Todas as tags de parâmetro possuem atributos.
Tabela 1. Tags e Atributos de Parâmetros
Nome Descrição
Tags de Parâmetros
fp:attrParam Especifica um atributo. Por exemplo, Status no módulo Requisitos.
fp:checkboxParam Contém um valor booleano de true ou false.
fp:critParam Contém um valor de número inteiro. Por exemplo, (..., -2, -1, 0, 1, 2, ....).
fp:memberParam Especifica um membro. Por exemplo, Admin.
fp:stringParam Contém um valor de cadeia.
fp:viewParam Especifica uma visualização. Por exemplo, "Todos os requisitos"
Atributos de Tags de Parâmetros
changeable Um atributo obrigatório que determina quando o parâmetro é alterado e se aplica a todas as tags *Param. O atributo possui quatro valores:
  • Modelo: Alterado quando o tipo de relatório é criado ou editado.
  • Tempo de Execução: Alterado quando o relatório é criado.
  • Nunca: Nunca pode ser alterado e será usado se um valor já for conhecido quando o modelo for criado. O valor é lido a partir do atributo defaultvalue.
  • Buscar: O valor é buscado automaticamente. O valor buscado é determinado pelo valor do atributo "name":
    • currentdate: A data atual.
    • currenttime: O horário atual
    • currentuser: O Usuário que efetuou login
    • fortune: Um "biscoito da sorte", que é novo a cada momento. Esse valor é usado se arquivos .jar extras forem incluídos.
    • numpages: O número de páginas no relatório. Este valor é usado nos cabeçalhos e rodapés.
    • workspacename: O nome da área de trabalho.
    • pageno: O número da página atual. Este valor é usado nos cabeçalhos e rodapés.
id Um atributo obrigatório que especifica o ID do parâmetro e se aplica a todas as tags *Param. Cada parâmetro possui um ID exclusivo. É possível usar o mesmo ID para vários parâmetros.

Apenas o primeiro parâmetro fica visível na interface com o usuário. Os outros parâmetros copiam seus valores a partir do primeiro parâmetro. Essa convenção é útil se as mesmas informações forem exibidas em vários cabeçalhos ou se a mesma visualização for usada em vários componentes.

name Um atributo obrigatório que especifica o nome do parâmetro e se aplica a todas as tags *Param. Em uma tag do componente, o nome é o identificador exclusivo usado ao procurar parâmetros. Os nomes comuns são: viewId, attrId, elementId, pageno.
masterid O ID para o parâmetro que controla o parâmetro. Esse atributo é obrigatório, mas pode não ser usado dependendo do componente. Esse atributo se aplica ao attrParam. Normalmente, o parâmetro principal é um viewParam. Você deve configurar o parâmetro principal primeiro ou não poderá saber quais atributos ou elementos estão disponíveis.
type Determina o tipo de atributo que é permitido para esse parâmetro. Esse atributo é obrigatório, mas pode não ser usado dependendo do componente. Esse atributo se aplica ao attrParam. É possível usar os seguintes tipos de atributos:
  • choice: Para atributos de opção
  • number: Para atributos de número inteiro e flutuação
  • numbertext: Para atributos de número inteiro, flutuação e matriz
  • link: Para atributos de link e lista de links
  • all: Para todos os tipos de atributos
defaultvalue O parâmetro é configurado para o valor-padrão na primeira vez que o tipo de relatório é criado ou editado, ou na primeira vez que o relatório é gerado. Esse atributo é opcional e se aplica a todas as tags *Param. O valor-padrão é uma cadeia vazia:defaultvalue="".
descr A descrição do parâmetro. Esse atributo é opcional. A descrição é exibida quando o tipo de relatório é criado ou editado, ou quando o relatório é gerado. O valor-padrão não usa uma descrição: descr="".

Feedback