Configurando como os dados são formatados e calculados

Defina o conteúdo de um elemento de modelo ou seus valores de propriedade para formatação e cálculo de dados.

Sobre Esta Tarefa

É possível definir o conteúdo de um modelo usando valores simples, expressões de dados ou expressões de script.

As expressões de dados e expressões de script têm variáveis internas disponíveis para você selecionar.
Tabela 1. Variáveis internas de Rational Publishing Engine
Variável Descrição
_cell_number O número da célula em uma linha atual. Se o elemento não for uma célula, o valor será 0. Você pode utilizar _cell_number da guia Expressão de dados ou Expressão de script.
_element_id O número de elementos dentro do modelo. Mantido internamente no modelo e usado para depuração. Você pode utilizar _element_id das guias Expressão de dados ou Expressão de script.
_element_level O nível recursivo de um elemento. Se não houver um valor configurado para o elemento na propriedade Nível recursivo na guia Dados, o valor será 1. É possível usar _element_level da guia Expressão de dados ou Expressão de script.
_row_number O número de linhas em uma tabela atual. Se o elemento não estiver contido por um elemento de linha, o valor será 0. Você pode utilizar _row_number da guia Expressão de dados ou Expressão de script.
_sessionInfo Informações de propriedade de tempo de execução na especificação de modelo ou documento. Na guia Expressão de script, selecione a variável _sessionInfo e insira o script. Use aspas vazias sem um valor dentro para gerar o valor padrão para a propriedade na saída. Exemplos de script:

_sessionInfo.getDocspecProperty("property", "");
_sessionInfo.getTemplateProperty("property", "");
_sessionInfo.getDatasourceProperty("data_source_name","property", "");
_sessionInfo.getOutputProperty("output_type","property", "");
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

Para getDocspecProperty, você pode utilizar propriedades de especificação existentes do documento ou propriedades para criar metadados customizados.

_sessionLogger Para fins de depuração, é possível exibir informações customizadas, erro, aviso ou mensagens de depuração no arquivo TEMP\rpe\rpe.log, visualização Console ou visualização Problemas. As mensagens exibidas no local definido no arquivo log4j.properties.

A configuração padrão é exibir mensagens de informações na visualização Console, mas não no arquivo rpe.log.

Na guia Expressão de script, selecione a variável _sessionLogger e insira o script. Você pode gerar entradas de log com um dos métodos a seguir:
  1. _sessionLogger.debug(message)
  2. _sessionLogger.info(message)
  3. _sessionLogger.error(message)
  4. _sessionLogger.warn(message)

Ao decidir o que inserir como message em seu script, considere usar um callout visual, como suas iniciais ou nome de usuário, e usar variáveis de seu modelo para fazer mensagens significativas.

_sessionUtils Na guia Expressão de script, é possível usar essa variável para executar uma função no script chamada tidyXHTML. Essa variável é útil quando você nota blocos de espaço em branco na saída criada pela codificação XHTML inadequada. Com a variável _sessionUtils, um argumento de sequência é processado e o XHTML é limpo para que espaço em branco extra não seja exibido na saída.

Exemplo: _sessionUtils.tidyXHTML(text);

Ao usar a variável _sessionUtils, selecione também as opções Entrada XHTML e Saída XHTML na guia Expressão de script.
Nota: Modelos que incluem essa variável podem ser carregados em versões mais antigas do Rational Publishing Engine, mas os scripts não podem ser avaliados corretamente.

Procedimento

  1. No editor de conteúdo do modelo, dê um clique duplo no elemento de texto. A janela Configurar conteúdo do elemento atual é aberta.
  2. Especifique o conteúdo usando uma das opções a seguir:
    • Para usar um valor simples, clique na guia Valor simples e insira um valor.
    • Para usar uma expressão de dados, clique na guia Expressão de dados e:
      • Expanda Variáveis e selecione uma variável para usar.
      • Expanda Atributos e selecione atributos de dados para usar.
    • Para usar uma expressão de script, clique na guia Expressão de script.
      • Expanda Variáveis, selecione uma variável e insira o código JavaScript que pode usar as variáveis no contexto atual.
      • Expanda Atributos, selecione um atributo e insira o código JavaScript que pode usar os atributos de dados no contexto atual.
      • Se você copiou o script a partir de XHTML, pode selecionar a opção Entrada XHTML para permitir que as tags XHTML contidas no script sejam editadas.
      • Se você estiver gerando o modelo na saída XHTML, pode selecionar a opção Saída XHTML para analisar o script e renderizar o script como rich text.
      Por exemplo, para selecionar os atributos como número absoluto, nome e valor, insira o código JavaScript como:
      "object:"+Absolute Number+
      "attribute"+name+
      "value"+_value
      Dica: Se você tiver um modelo muito complexo, poderá descrever cada bloco no modelo usando as propriedades Nome e Descrição. Os campos de nome e descrição são vazios por padrão, o nome de conteúdo é exibido no modelo e o conteúdo da descrição pode ser exibido no campo de sugestão do elemento de modelo. Isso pode ajudar outros a reutilizar o modelo.

      Você também tem a opção de importar um script existente ou trabalhar no editor JavaScript em vez da guia Expressão de script:

    1. Se você estiver incluindo um novo script de outro arquivo, clique em Incluir script e selecione um arquivo de seu computador, de um servidor remoto ou do componente Document Builder. Clique em OK.
      Dica: É possível reutilizar funções JavaScript em diferentes partes do modelo configurando uma propriedade Script da biblioteca no código de script. Para configurar a propriedade Script da biblioteca, vá para a visualização Propriedades do elemento Código JavaScript e selecione a guia Específico, ative a caixa de seleção Script da biblioteca. Para obter mais informações sobre a propriedade de script da biblioteca, consulte propriedades do elemento de código JavaScript.

      Para arquivos selecionados de seu computador ou de um servidor remoto, uma cópia do código JavaScript de seu arquivo selecionado é aberta no editor JavaScript.

      Para arquivos selecionados do Document Builder, a janela Utilizar referência de script é aberta. Você deve escolher se incluir JavaScript como um link de referência no modelo:
    • Se você selecionar Sim, o link para o arquivo JavaScript (.js) será integrado em uma identificação <Script>. Por exemplo, o link de referência a seguir é incluído no editor JavaScript que você não deve modificar:
      <Script src= "library://api/scripts/51"></Script>
      Lembre-se: Quando você executa a geração de documentos a partir do modelo, e tem um JavaScript como um link de referência no modelo, o Document Builder deve estar ativo e conectado ao Documento Studio. Para obter detalhes, consulte o tópico Conectando-se ao componente Document Builder.
    • Se você selecionar Não, uma cópia do código JavaScript do seu arquivo selecionado será aberto no editor JavaScript.
    1. Clique em Abrir no editor para inserir o script em um editor Eclipse JavaScript. O script é aberto em uma nova guia do editor como um arquivo temporário .js, de forma que você possa editar o JavaScript e gerenciar o script por meio das opções na visualização Esboço. Depois de editar o script, salve suas mudanças e feche a guia do editor temporário JavaScript para retornar à janela Código de entrada para elemento de código JavaScript.
    2. Clique em Script de teste para validar o código.
    3. Clique em OK para salvar as mudanças e sair da janela.
  3. Clique em OK para salvar suas mudanças.

Exemplo

Exemplo de uso de expressão de dados
Para exibir números de linhas gerados automaticamente em suas tabelas:
  1. Arraste um elemento de tabela no editor.
  2. Insira as 3 linhas e 3 colunas para a tabela e clique em OK.
  3. Arraste um elemento de texto em cada célula.
  4. Selecione a primeira célula na primeira linha.
  5. Na visualização Propriedades, selecione a guia Conteúdo e clique em ícone Configuração. Clicar duas vezes no elemento também abre a mesma janela.
  6. Clique na guia Expressão de dados e selecione _row_number. Em seguida, clique em OK.
  7. Repita a primeira célula na segunda e terceira linhas.
  8. Remova as bordas das células de número de linha:
    1. Mantenha a tecla CTRL selecionada e selecione a primeira célula em cada linha. Quando tiver vários elementos selecionados, poderá editar as propriedades de todos eles ao mesmo tempo.
    2. Na visualização de propriedades, selecione a guia Borda.
    3. Para a propriedade Estilo, selecione nenhum.
  9. Salve o modelo.
  10. Teste o modelo gerando a saída. A primeira célula inclui o número da linha e não tem bordas ao redor:
    Exemplo de saída
  11. No modelo, conclua a inclusão de atributos de seu esquema de origem de dados para as células restantes para concluir a tabela.