Incluindo um elemento de contêiner

Um elemento de contêiner é diferente de um parágrafo. Diferente de parágrafos, os contêineres não têm rodapé no documento de saída. Então você pode definir condições, executar cálculos ou identificar dados em um grupo de elementos sem afetar a formatação da saída.
Dica: Se você tiver um parágrafo existente que não precise preservar sua formatação e desejar converter em um elemento de contêiner, consulte a seção Convertendo um parágrafo em um elemento de contêiner na parte inferior deste tópico.

Sobre Esta Tarefa

Você pode executar as seguintes tarefas com contêineres:
  • Arraste um elemento de contêiner em qualquer um dos seguintes elementos:
    • Contêiners
    • Listas
    • Listar Itens
    • Parágrafos
    • Iterações
    • Tabelas (Tables)
    • Linhas
    • Células
  • Arraste um contêiner para outro contêiner quando esse contêiner incluir apenas elementos que são permitidos em um contêiner. Por exemplo, é possível arrastar um contêiner para outro contêiner que esteja em um elemento de linha. No entanto, se o contêiner tiver um elemento de parágrafo, ele não poderá ser arrastado para outro contêiner que esteja em um elemento de linha porque as linhas não podem conter parágrafos.
  • Arraste um contêiner para outro contêiner que esteja limitado por consultas. Por exemplo, é possível arrastar um contêiner em outro contêiner na raiz do modelo ou arrastar um contêiner para um contêiner dentro de um parágrafo.
Não é possível executar as seguintes tarefas com contêineres:
  • Arraste os contêineres em elementos diferentes de contêineres, listas, detalhes da lista, parágrafos, iterações, tabelas, linhas ou células. Por exemplo, você não pode arrastar um contêiner em um elemento de texto.
  • Arraste um contêiner incluído em uma tabela, linha ou elemento de célula fora desse tipo de elemento. Por exemplo, se uma linha tiver um elemento de contêiner, o elemento de contêiner não poderá ser movido para uma linha diferente na tabela. No geral, não arraste um contêiner incluído em um elemento fora desse tipo de elemento.
  • Configure a propriedade uma vez por tabela para true para um elemento de linha quando a linha estiver dentro de um elemento de contêiner.
Iterando em contêineres
  • Quando você usa um iterativo, pode usá-lo dentro do contêiner. Um iterador ajuda a mudar o elemento de formatação facilmente e também torna o modelo mais uniforme. Para tabelas, a vantagem é que você pode evitar ver linhas vazias na saída quando coloca uma condição na linha que esteja baseada nos atributos do contêiner pai. Você também pode evitar ver linhas com número ímpar de células.
  • Quando as tabelas estiverem sendo usadas, você poderá colocar a consulta em contêineres que hospedam linhas ou em contêineres dentro de células, dependendo de onde você precisa iterar. Quando não estiver usando tabelas, poderá colocar todas as consultas em contêineres e depois, dentro desses contêineres, poderá colocar os elementos de renderização, como parágrafos, hiperlinks e texto.
    Importante: Depois de incluir um contêiner para uma tabela, linha ou elemento de célula, você não poderá mover essa consulta para fora do elemento de tabela. Os contêineres são manipulados de forma diferente dentro de tabelas e o contexto não se aplica fora de um elemento de tabela. Use elementos do contêiner novos quando necessário.

Procedimento

  1. Inclua um elemento de contêiner no editor de conteúdo de modelo usando um dos seguintes métodos:
    • Na visualização Paleta, selecione um elemento ícone Contêiner Contêiner e arraste-o para o editor de conteúdo do modelo.
    • Na área do editor, clique com o botão direito e selecione Inserir > ícone Contêiner Contêiner.
    • Na visualização Esboço, clique em Conteúdo e selecione Inserir > ícone Contêiner Contêiner.
  2. Selecione o elemento do contêiner.
  3. Na visualização Propriedades, modifique as propriedades do contêiner.
  4. Clique em Arquivo > Salvar como ou clique no ícone Salvar.

O que Fazer Depois

Iterando em um contêiner
Uma função Loop inclui as capacidades do while loop para IBM® Rational Publishing Engine, que permite que ações sejam executadas repetidamente. É possível configurar a propriedade do while do contêiner para true, para que o contêiner e todos os seus filhos sejam avaliados novamente.
Convertendo um parágrafo em um elemento de contêiner
A partir da liberação da versão 1.3, é possível converter um parágrafo em um elemento de contêiner. Quando um parágrafo é convertido, você não pode transformar o contêiner recém-convertido de volta para um parágrafo, a menos que imediatamente desfaça a mudança. Embora todos os dados no parágrafo, incluindo consultas, designações, condições e filtros, sejam preservados, a formatação definida no parágrafo não é preservada no contêiner recém-convertido.
  1. Para converter um parágrafo em um contêiner no editor de conteúdo do modelo:
    • Na área do editor ou na visualização Esboço, clique com o botão direito no elemento de parágrafo e selecione Converter > Contêiner.
  2. (Opcionalmente) Após a etapa anterior, você tem apenas uma única oportunidade de desfazer a conversão:
    • Na área do editor ou na visualização Esboço, clique com o botão direito no elemento de contêiner recém-convertido e selecione Desfazer criar contêiner.