Criando condições para elementos de modelo

Use o editor de condição para definir uma expressão JavaScript com os atributos de dados e variáveis acessíveis no contexto atual.

Procedimento

  1. Clique com o botão direito em um elemento e selecione Dados > Editar condição.
  2. Na janela Configurar condição para elemento atual, expanda Variáveis e Atributos.
    Dica: Apenas consultas e atributos de primeiro nível de uma consulta podem ser exibidos como disponíveis. Para níveis secundários, você deve incluir outra consulta para um elemento e incluir a condição para esse elemento.
  3. Insira o código JavaScript usando uma destas opções:
    • Escreva um script manualmente nessa janela
    • Copie e cole um script de um editor externo para esta janela
    • Clique em Incluir script e selecione um arquivo de seu computador, de um servidor remoto ou do Document Builder
    • Use o editor de condição:
      1. Selecione um atributo ou variável para o Operando esquerdo.
        Nota: Se você usar as ferramentas na janela Configurar condição para elemento atual, qualquer atributo ou variável de dados que é utilizada será automaticamente selecionada na visualização em árvore. Se você inserir a condição manualmente, deverá selecionar manualmente o atributo ou variável de dados.
      2. Selecione um Operador.
      3. Selecione um atributo ou variável para o Operando direito nos menus suspensos.
        Nota: Quando o operando esquerdo e o operando direito de uma condição tiverem o mesmo nome de atributo, mas pertencerem a duas consultas diferentes, a condição não funcionará. Você deve configurar aliases diferentes para os dois atributos para que a condição funcione.
      4. Clique em Incluir. A condição selecionada é incluída na caixa de texto.
  4. Opcional: Selecione a opção Entrada XHTML para permitir que as tags XHTML que estão contidas no script sejam editadas. Se você estiver copiando rich text ou estiver usando rich text nas condições, deverá selecionar a opção Entrada XHTML.
    Importante: XHTML inválido causa falha de geração de documento. Verifique se o seu XHTML é válido antes de salvar suas mudanças.
  5. Opcional: Clique em Testar e Executar para testar a condição antes de aplicá-la ao elemento atual. Se o script for executado corretamente, exibirá true. Se o script não for executado corretamente, false será exibido.
  6. Clique em OK.

Resultados

Quando você aplica uma condição para um elemento, o elemento é exibido com um ícone ícone Condição no editor de conteúdo do modelo:

ícone Condições em um elemento de parágrafo

Exemplos: Construindo condições com o editor de condição

Revise esses exemplos para ajudá-lo a construir suas próprias condições com o editor de condição.

Objetos que possuem títulos de objetos em um esquema do Rational DOORS:
  • Expanda Atributos > query.
  • Selecione [Object Heading] Object_Heading.
  • Para o operando esquerdo, selecione [Object Heading] Object_Heading.
  • Para o operador, selecione Not equal to.
  • Para o operando direito, não insira qualquer valor.
  • Clique em Incluir. O JavaScript é exibido como Object_Heading! = "".
Requisitos de alta prioridade em um esquema REST:
  1. Expanda Atributos > query.
  2. Selecione Prioridade.
  3. Para o operando esquerdo, selecione Priority.
  4. Para o Operador, selecione Equals.
  5. Para o operando direito, insira High.
  6. Clique em Incluir. O JavaScript é exibido como Priority == "High".
Remova os valores duplicados de um atributo criando uma variável e configurando essa condição no elemento:
  1. Expanda Variáveis > variable.
  2. Selecione variable.
  3. Para o operando esquerdo, selecione variable.
  4. Para o Operador, selecione Equals.
  5. Para o operando direito, não insira qualquer valor.
  6. Clique em Incluir. O JavaScript é exibido como variable == "".

O que Fazer Depois

Se você descobrir que uma variável não está avaliando corretamente, verifique se a variável é uma sequência literal true ou false, como variable == "true".

Em alguns casos, o valor de uma variável é avaliada para um valor booleano, em vez do valor de sequência literal. Exemplo: variable == "true " será incorretamente avaliado como false se a variável for o booleano true e não a sequência " true ". Em vez de observar a existência de qualquer valor, a palavra true não será localizada nos dados como um valor. Esse problema ocorre quando uma variável vem de um cálculo e não de uma especificação de documento na qual ela foi fornecida quando o relatório foi configurado ou de um modelo que foi especificado como o valor padrão da variável.

Para assegurar que a variável seja avaliada corretamente, revise sua condição usando uma destas opções:
  • Opção 1: Ativar a condição para manipular a sequência literal e o valor booleano.

    (variable == boolean_true_or_false) || ( variable == "string")

    Exemplo: (variable == true) || ( variable == "true")

  • Opção 2: Se você souber de antemão que a variável deve ser avaliada como um booleano ou valor de sequência, poderá projetar a condição em antecipação a esse tipo de valor.
    • Valor booleano: variable == boolean_true_or_false

      Exemplo: variable == true

    • Valor de sequência: variable == "string"

      Exemplo: variable == "true"

Criando um alias para atributos com os mesmos nomes

Em um filtro ou condição com script, quando o operando esquerdo e o operando direito de uma condição estiverem com o mesmo nome de atributo, mas pertencerem a duas consultas diferentes, a condição não funcionará. Você terá que definir aliases diferentes para os dois atributos para que a condição funcione.

Antes de Iniciar

Edite as preferências do Document Studio:
  1. Rational Publishing Engine Document Studio, clique em Janela > Preferências.
  2. Expanda RPE e clique em Design de documento.
  3. No campo Usar anotações de esquema para exibição, selecione Não e clique em OK.

Procedimento

Para diferenciar atributos com o mesmo nome, você pode usar o recurso Alias para eliminar ambiguidades. Quando você estiver incluindo a condição que verifica se a descrição do módulo é igual à descrição de DOORSObject, clique com o botão direito no atributo para configurar o alias.

Resultados

Agora o atributo Query/Object/Object Text é conhecido como $1_Object Text e a condição pode ser processada corretamente.

O que Fazer Depois

Dica: Para examinar como a condição será aplicada aos dados, clique em Testar. Na janela Testar, clique em Executar.