Itens de linha e tabelas
Muitos dos documentos que você criará com Portant possuem linhas que precisam se repetir: um orçamento com uma lista de produtos, uma fatura com horas cobráveis, uma proposta com opções de pacotes, uma revisão trimestral com uma linha por negócio. Os itens de linha tratam de tudo isso.
Esta é a página central para tudo relacionado a tabelas repetidas, ordenação de linhas e agrupamento de registros em um único documento. Os guias específicos por fonte (itens de linha de negócios do HubSpot, agrupamento de dados do Google Sheets, arrays em payloads de webhook) todos remetem a esta página para que o comportamento fique em um único lugar.
O que "itens de linha" significa no Portant
Uma tag comum como {{Customer Name}} insere um único valor no documento. Uma tag de item de linha segue a mesma lógica, mas fica dentro de uma linha de tabela. Quando o Portant executa o fluxo de trabalho, ele replica essa linha uma vez para cada item de linha na fonte.
Assim, uma única linha de template como esta:
| {{Item}} | {{Quantity}} | {{Unit Price}} | {{Line Total}} |
torna-se algo assim no resultado:
| Widget A | 2 | $50.00 | $100.00 |
| Widget B | 1 | $250.00 | $250.00 |
| Widget C | 5 | $20.00 | $100.00 |
A linha acima e a linha abaixo da linha de item de linha permanecem em seus lugares. Portanto, você pode inserir uma linha de cabeçalho acima (com os nomes das colunas) e uma linha de totais abaixo com fórmulas como {{=SUM(Line Total)}}. Ambas permanecem no lugar enquanto a linha do meio se expande.
Nesta seção
- Tabelas repetidas explica como uma única linha de tags se expande em várias linhas durante a mesclagem.
- Ordenar e classificar linhas aborda como controlar a ordem em que as linhas aparecem no resultado.
- Agrupar linhas em um único documento aborda como combinar vários registros de fonte em um único resultado.
Onde os itens de linha aparecem no Portant
Fontes diferentes utilizam termos ligeiramente distintos para a mesma ideia. Os guias abaixo são receitas específicas por fonte que se baseiam nas regras descritas acima:
- HubSpot. Add multiple line items into a single document para orçamentos, contratos e faturas criados a partir de itens de linha de negócios.
- Google Sheets. Group rows into one document quando várias linhas da planilha pertencem ao mesmo registro (por exemplo, múltiplas linhas de fatura que compartilham um mesmo número de fatura).
- Webhooks. Group webhook events into one document quando um array no payload deve gerar um único documento.
- Casos de uso. Quotes, Proposals e Invoices dependem todos de itens de linha para listar produtos, serviços ou cobranças.
Relacionados
- Tags
- Fórmulas de tags para totais como SUM, AVG, MIN, MAX
- Lógica condicional para documentos para ocultar seções de um documento para registros específicos