Tabelas repetidas

Uma tabela repetida é uma única linha no seu modelo que se expande em várias linhas quando o Portant executa o fluxo de trabalho. Você projeta uma linha e o Portant a clona para cada item de linha na origem.

Este é o mecanismo por trás de orçamentos, faturas, listas de embalagem, declarações de trabalho e qualquer documento que liste um número variável de itens.

Linha de tabela repetida em um modelo do Portant, expandida em uma linha por item de linha na saída

Como funciona

Uma tag comum é substituída por um único valor. Uma tag de item de linha é substituída por uma lista de valores, um por linha. O Portant verifica onde as tags de item de linha estão posicionadas e se comporta da seguinte maneira:

Se as tags estiverem dentro de uma linha de tabela, o Portant clona essa linha, uma vez por item.
Se as tags estiverem fora de uma tabela, o Portant une os valores em um único bloco de texto.

Portanto, a regra é simples: para repetir linhas, coloque as tags dentro de uma única linha de uma tabela.

Configurando uma linha repetida

Insira uma tabela no seu modelo com quantas colunas forem necessárias.
Opcionalmente, adicione uma linha de cabeçalho no topo com os títulos das colunas (essa linha permanece igual na saída).

Adicione uma linha de tags de item de linha. Por exemplo:

| {{Item Name}} | {{Quantity}} | {{Unit Price}} | {{Line Total}} |

Opcionalmente, adicione uma linha de totais abaixo usando uma fórmula de tag, por exemplo {{=SUM(Line Total)}} na coluna à direita.

Quando o fluxo de trabalho é executado, a linha de tags é substituída por uma linha por item de linha. A linha de cabeçalho e a linha de totais permanecem onde estão. Qualquer conteúdo acima ou abaixo da tabela não é alterado.

O que colocar dentro da linha

Coloque na linha repetida apenas as tags que pertencem ao próprio item de linha. Campos como nome do cliente, endereço ou número do orçamento são campos de nível de documento e devem ser colocados fora da tabela.

Se você misturar os dois, o Portant repetirá o nome do cliente em cada linha, o que raramente é o resultado desejado.

Configurações específicas por origem

O mecanismo é o mesmo em todos os casos, mas a forma como a origem fornece os itens de linha difere:

HubSpot. Cada negócio no HubSpot pode ter vários itens de linha como um objeto conectado. Consulte add multiple line items into a single document (adicionar vários itens de linha em um único documento) para a configuração completa no HubSpot.
Google Sheets. Uma linha repetida é combinada com uma coluna de agrupamento para que o Portant saiba quais linhas pertencem ao mesmo grupo. Consulte Google Sheets data grouping (agrupamento de dados no Google Sheets).
Webhooks. Quando o payload inclui um array de itens, o Portant trata cada elemento do array como um item de linha. Consulte webhook data grouping (agrupamento de dados via Webhook).

Erros comuns

As tags devem estar em uma única linha. Se você distribuir tags de item de linha por duas linhas, o Portant não reconhecerá o padrão repetido.
As linhas de cabeçalho e rodapé podem ser estilizadas de forma independente e não serão clonadas.
Fórmulas como SUM e AVG funcionam apenas com campos que fazem parte do conjunto de itens de linha. Consulte fórmulas de tag.