Uso de conjuntos de subformulários

Um conjunto de subformulários é um agrupamento de dois ou mais subformulários repetitivos ou de várias páginas.

É possível usar o conjunto de subformulários para controlar a ordem na qual os subformulários são renderizados no conjunto, com base na ordem em que os subformulários aparecem no conjunto.

Por exemplo, no formulário de amostra Pedido de compra, é possível ver como os subformulários detailHeader e detail são agrupados em um conjunto de subformulários. O conjunto de subformulários mantém os dois subformulários juntos, de modo que ambos os subformulários para cada item de dados sejam renderizados, ou para que nenhum subformulário seja renderizado caso não existam dados para o subformulário detail.

Ao agrupar subformulários em um conjunto de subformulários, você garante que os subformulários não sejam renderizados dentro do conjunto, a menos que existam dados para a renderização do subformulário.

É possível controlar a ordem em que os subformulários são renderizados em um conjunto selecionando uma destas opções na lista Tipo, localizada na guia Conjunto de subformulários da paleta Objeto:

  • Usar todos os subformulários na ordem

    Todos os subformulários do conjunto aparecerão no documento final e na ordem em que são exibidos na paleta Hierarquia.

  • Selecionar um subformulário das alternativas

    Um subformulário do conjunto é exibido no documento final. Para obter mais informações, consulte Uso de conjuntos de subformulários de escolha.

Ao escolher como renderizar subformulários, lembre-se do seguinte:

  • Se você definir um subformulário para uma contagem mínima de zero, o subformulário não será renderizado se não houver dados para ele.

  • Se um subformulário for definido para um valor de contagem mínima menor que o número de ocorrências reais dos dados, os valores de dados restantes não serão exibidos. De modo oposto, se um subformulário for definido para um valor de contagem máxima maior que o número de ocorrências reais nos dados, o número especificado de subformulários será renderizado, ou seja, alguns objetos no subformulário serão renderizados sem dados e aparecerão em branco.

  • Se desejar, é possível aninhar conjuntos de subformulários em outros conjuntos, em qualquer número de níveis. Entretanto, não é possível colocar objetos individuais, como objetos de linha, círculos ou de campo de texto, dentro de um conjunto de subformulários.

    Inserção de um conjunto de subformulários

    Um conjunto de subformulários é um agrupamento de dois ou mais subformulários que devem ficar juntos. Pode-se usar conjuntos de subformulários para combinar subformulários e controlar a ordem na qual eles são renderizados.

    Antes de criar um conjunto de subformulários, convém considerar a ordem na qual você deseja que o formulário seja renderizado para possibilitar a seleção da opção correta na lista Tipo da guia Subformulário.

    1. Clique com o botão direito do mouse na paleta Hierarquia e selecione Inserir conjunto de subformulários. Um subformulário sem título é adicionado à paleta Hierarquia.

    2. Na paleta Hierarquia, arraste os subformulários desejados para dentro do conjunto de subformulários.

    3. Com o conjunto de subformulários selecionado na paleta Hierarquia ou na paleta Objeto, clique na guia Conjunto de subformulários e, na lista Tipo, selecione a opção desejada.

    4. Clique na guia Vínculo. Se preferir, digite um nome para o conjunto de subformulários na caixa Nome.

    5. Para que o conjunto de subformulários seja repetido de acordo com os dados fornecidos, selecione Repetir o subformulário para cada item de dados e especifique contagens mínimas e máximas, se necessário.

    6. Visualize o projeto para testar o conjunto de subformulários.