Elementos de línea y tablas
Muchos de los documentos que creará con Portant tienen filas que deben repetirse: una cotización con una lista de productos, una factura con horas facturables, una propuesta con opciones de paquetes, una revisión trimestral con una fila por negocio. Los elementos de línea se encargan de todo eso.
Esta es la sección de referencia para todo lo relacionado con tablas repetidas, ordenación de filas y agrupación de registros en un único documento. Las guías específicas por fuente (elementos de línea de negocios en HubSpot, agrupación de datos en Google Sheets, arrays en payloads de Webhook) enlazan a esta página para que el comportamiento quede documentado en un único lugar.
Qué significa "elementos de línea" en Portant
Una etiqueta ordinaria como {{Customer Name}} inserta un único valor en el documento. Una etiqueta de elemento de línea funciona de la misma manera, pero se coloca dentro de una fila de tabla. Cuando Portant ejecuta el flujo de trabajo, duplica esa fila una vez por cada elemento de línea que exista en la fuente.
Así, una sola fila de plantilla como esta:
| {{Item}} | {{Quantity}} | {{Unit Price}} | {{Line Total}} |
se convierte en algo como esto en el resultado:
| Widget A | 2 | $50.00 | $100.00 |
| Widget B | 1 | $250.00 | $250.00 |
| Widget C | 5 | $20.00 | $100.00 |
La fila situada encima y la fila situada debajo de la fila de elementos de línea permanecen en su lugar. Por lo tanto, puede colocar una fila de encabezado arriba (con los nombres de las columnas) y una fila de totales abajo con fórmulas como {{=SUM(Line Total)}}. Ambas permanecen en su lugar mientras la fila central se expande.
En esta sección
- Tablas repetidas explica cómo una sola fila de etiquetas se expande en múltiples filas durante la combinación.
- Ordenar filas cubre el control del orden en que aparecen las filas en el resultado.
- Agrupar filas en un único documento cubre la combinación de varios registros de origen en un único resultado.
Dónde aparecen los elementos de línea en Portant
Las distintas fuentes utilizan terminología ligeramente diferente para la misma idea. Las guías siguientes son recetas específicas por fuente que se basan en las reglas descritas anteriormente:
- HubSpot. Agregar múltiples elementos de línea en un único documento para cotizaciones, contratos y facturas creados a partir de elementos de línea de negocios.
- Google Sheets. Agrupar filas en un único documento cuando varias filas de la hoja pertenecen al mismo registro (por ejemplo, múltiples líneas de factura que comparten un número de factura).
- Webhooks. Agrupar eventos de Webhook en un único documento cuando un array en el payload debe generar un único documento.
- Casos de uso. Cotizaciones, Propuestas y Facturas dependen de los elementos de línea para listar productos, servicios o cargos.
Relacionado
- Etiquetas
- Fórmulas de etiquetas para totales como SUM, AVG, MIN, MAX
- Lógica condicional para documentos para ocultar secciones de un documento en registros específicos