Incluindo um elemento de iteração

Em vez de copiar e colar blocos de seu modelo para duplicar as seções, use a propriedade condição do while no elemento Iteração para criar loops em seu modelo.
Restrição: ícone Novo recurso O elemento de iteração está disponível apenas em modelos da versão 2.

Antes de Iniciar

Sobre Esta Tarefa

Iterações trabalham com consultas aplicadas a elas ou aos seus elementos filhos em dois estágios. Primeiro, durante a geração de documento, esses elementos são processados uma vez. Segundo, as condições que são aplicadas ao elemento Iteração são processadas. Se as condições forem verdadeiras, então o elemento Iteração e seus elementos filhos serão processados novamente. As seções continuam sendo processadas até que a condição não seja mais verdadeira.

O conteúdo de um bloco de iteração sempre será publicado pelo menos uma vez, independentemente da instrução do-while.

No primeiro estágio, os dados que são usados na condição devem mudar para que haja um número finito de etapas. Essa condição é o que faz com que o processamento das seções pare e não continue em loop. Na etapa 5 do exemplo abaixo, a condição é que a variável teamList não esteja vazia. Então a condição será verdadeira enquanto houver entradas de dados para a variável teamList. Quando não houver mais entradas de dados, a condição será falsa e a repetição terminará.

Para que consultas sejam executadas várias vezes, inclua um elemento de configuração de origem de dados dinâmica no contêiner de loop para forçar as consultas a serem inicializadas mais de uma vez.

Procedimento

  1. Na visualização Paleta, selecione um elemento ícone Iteração Iteração e arraste-o para o editor de conteúdo do modelo.
    Nota: Não é possível colocar elementos de iteração em páginas master.
  2. Selecione a seção do modelo para duplicar e arraste-o para um elemento Iteração.
  3. Selecione o elemento Iteração.
  4. Na visualização Propriedades, selecione a guia Específico.
  5. No valor condição do while, clique no ícone Configuração.
  6. Selecione a guia Expressão de script. Não é possível inserir o script na guia Valor simples porque ele cria um loop infinito.
  7. Selecione uma variável. Criar um loop com uma variável assegura que o loop seja aplicado um número específico de vezes, ou quantos valores de dados serão aplicados usando essa variável.
  8. Inserir o script.
  9. Clique em OK.
  10. Salve suas alterações.

Exemplo

Criando uma lista de membros da equipe a ser usada:
  1. Crie uma variável externa denominada teamList.
  2. Crie uma variável externa denominada currentMember.
  3. Crie um elemento de tabela e aplique uma condição:
    1. Inclua um elemento Tabela ícone Tabela no editor de conteúdo do modelo.
    2. Insira 1 coluna e 2 linhas.
    3. Clique com o botão direito no elemento Tabela e selecione Dados > Editar condição.
    4. Selecione a variável teamList .
    5. Pela o operando esquerdo, selecione a variável teamList.
    6. Para o operador, selecione Not equal to.
    7. Para o operando direito, não insira um valor.
    8. Clique em Incluir. O resultado do script é: teamList != ""
    9. Clique em OK.
  4. Na primeira célula, inclua um título para a coluna:
    1. Inclua um elemento de texto ícone Texto na célula.
    2. Dê um clique duplo no elemento de texto para abrir o editor de conteúdo.
    3. Insira um nome de título como Lista de membros da equipe.
    4. Clique em OK.
    5. Na visualização Propriedades, selecione a guia Fonte.
    6. Clique na propriedade Negrito.
    7. Selecione Verdadeiro e clique em OK.
  5. Inclua o elemento Iteração:
    1. Arraste o elemento de iteração ícone Iteração da visualização Paleta e insira-o entre as linhas da tabela.
    2. Selecione o elemento Iteração.
    3. Na visualização Propriedades, insira este script para a propriedade condição do while: teamList != ""
    4. Inclua dois elementos de contêiner ícone Contêiner no elemento Iteração. O primeiro contêiner é usado para calcular o primeiro nome da lista a ser usado na linha atual. O segundo contêiner é utilizado para encerrar o loop para que ele não continue desnecessariamente.
    5. Arraste a segunda linha e seu conteúdo no elemento Iteração e coloque-a após os elementos do contêiner.
  6. Designe uma variável para o primeiro elemento do contêiner:
    1. Clique com o botão direito no primeiro elemento do contêiner.
    2. Selecione Dados > Editar designações
    3. Clique em Incluir.
    4. Selecione a variável currentMember e clique em OK.
    5. Selecione a guia Expressão de script.
    6. Selecione a variável teamList e insira o script:
      var pos = teamList.indexOf( ",");
      
      if ( pos >=0)
      {
         // get the first member ( till the first comma)
          teamList.substr( 0, pos);
      }
      else
      {
          // last member
          teamList;
      }
    7. Clique em OK e OK.
  7. Designe uma variável para o segundo elemento de contêiner:
    1. Clique com o botão direito no segundo elemento do contêiner.
    2. Selecione Dados > Editar designações
    3. Clique em Incluir.
    4. Selecione a variável teamList e clique em OK.
    5. Selecione a guia Expressão de script.
    6. Selecione a variável teamList e insira o script:
      var pos = teamList.indexOf( ",");
      
      if ( pos >=0 && pos < teamList.length)
      {
         // get the first author ( till the first comma)
          teamList.substr( pos + 1);
      }
      else
      {
          // last member, remove it
          ""
      }
  8. Arraste a variável currentMember da visualização Esboço para a célula na segunda linha.
  9. Teste a saída.