Saltar al contenido principal

Agregar filas a Excel en Power Automate: JSON a Excel con PDF4me

PDF4me Excel - Agregar filas es un Power Automate acción que inserta un JSON objeto o matriz como nuevas filas en un Excel Libro de trabajo, ya sea en modo basado en tablas con coincidencia automática de encabezados o en modo basado en coordenadas con posicionamiento exacto de celdas. Úselo para escribir resultados de consultas de bases de datos, envíos de formularios o API respuestas directamente en un Excel informe.

Lo que hace esta acción

PDF4me Excel - Agregar filas escribe JSON Inserta datos de fila en un libro de trabajo existente, haciendo coincidir las propiedades con los encabezados cuando se especifica el nombre de la tabla, o apuntando a coordenadas exactas cuando se deja vacío. Las opciones Convertir numérico y fecha, Patrón de formato de fecha, Patrón de formato numérico y Nombre de cultura controlan cómo se escriben y formatean los valores insertados.

Entradas de blog relacionadas
Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.
Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.
Visita el blog

¿Cómo autentico mi Power Automate ¿Fluir?

Cada PDF4me acción en Power Automate requiere una conexión válida. Cree o seleccione una que contenga su PDF4me API clave para que el flujo pueda autenticarse Excel solicitudes de inserción de filas de forma segura.

Datos importantes que no debes perderte

El nombre de la tabla es el interruptor de modo
Un nombre de tabla no vacío activa la inserción basada en tabla con coincidencia de encabezado y número de fila de Excel para la posición. Déjelo vacío para la inserción basada en coordenadas usando Insertar desde fila e Insertar desde columna. Combinar ambos conjuntos de parámetros en una misma llamada genera un error.
El campo de datos está etiquetado JSON Datos de fila
Acepta uno solo JSON Un objeto para una fila o una matriz de objetos para insertar varias filas en una sola llamada. Los nombres de las propiedades controlan la coincidencia de encabezados en el modo de tabla.
La conversión de tipos necesita que el interruptor esté activado.
El formato de fecha, el formato numérico y el nombre de la configuración regional solo se aplican cuando la opción Convertir numérico y fecha está habilitada. Si no se activa, todos los valores se muestran como texto sin formato.
Power Automate PDF4me Excel - Acción Agregar filas configurada con Contenido del archivo, Nombre del archivo, Datos de fila JSON, Nombre de la hoja de cálculo Hoja1, Insertar desde la fila 6, Insertar desde la columna 2 y parámetros avanzados Convertir numérico y fecha, Patrón de formato de fecha yyyy-MM-dd y Patrón de formato numérico N2

Mapea el contenido y el nombre del archivo, configura los datos de la fila JSON, elige un nombre de tabla o inserta desde una fila/columna, y luego expande los parámetros avanzados para la conversión de tipo y el formato.

Parámetros

Requerido: El contenido del archivo, el nombre del archivo y los datos de la fila JSON deben proporcionarse siempre. El nombre de la tabla y el número de fila de Excel solo se aplican a la inserción basada en tablas. Las opciones "Insertar desde fila" e "Insertar desde columna" solo se aplican a la inserción basada en coordenadas y se rechazan si también se especifica el nombre de la tabla.

ParámetroRequeridoLo que haceEjemplo
File ContentRequiredBase64 content of the source Excel workbook, mapped from SharePoint, OneDrive, or another prior action.[File Content from Get File]
File NameRequiredExcel filename including extension (.xlsx or .xls), used for processing and output identification.data.xlsx
JSON Row DataRequiredJSON object or array of objects to insert. Each object becomes one row, property names match table headers in table mode.[{"Name":"John","Age":30}]
Worksheet NameOptionalName of the worksheet to insert into. Defaults to Sheet1 if left blank.Sheet1
Table NameOptionalName of an Excel table for table-based insertion. Leave empty to use coordinate-based insertion instead.SalesTable
Excel Row NumberConditional1-based position within the table, table mode only. Ignored in coordinate mode.5
Insert From RowConditional1-based worksheet row where insertion starts, coordinate mode only. Errors if Table Name is also set.10
Insert From ColumnConditional1-based worksheet column where insertion starts, coordinate mode only. Errors if Table Name is also set.3
Convert Numeric And DateOptionalEnables automatic conversion of JSON numbers to Excel numeric values and date-like strings to Excel dates. Default true.true
Date Format PatternOptionalExcel date format applied when Convert Numeric And Date is enabled. Default yyyy-MM-dd.MM/dd/yyyy
Numeric Format PatternOptionalExcel numeric format applied when Convert Numeric And Date is enabled. Default N2.#,##0.00
Ignore Null ValuesOptionalSkips inserting a value for any JSON property that is null when enabled. Default false, which inserts nulls as empty cells.false
Ignore Attribute TitlesOptionalMakes JSON property name matching case-insensitive against table headers when enabled. Default false.true
Culture NameOptionalCulture code used to parse incoming date and number strings before conversion. Default en-US.en-US

Campos de salida

CampoTipoLo que contiene
documentBase64The Excel workbook with the new rows inserted.
SuccessBooleantrue if insertion completed, false if the action failed.
ErrorMessageStringError description, null when Success is true.
ErrorsArrayDetailed error objects with Code and Message, empty when Success is true.

¿Qué significan los mensajes de error comunes?

Mensaje de errorCausaSolución
JSON input is requiredJSON Row Data is null or empty.Provide a valid JSON object or array.
Invalid JSON structureMalformed JSON syntax.Fix the JSON formatting before mapping it in.
Worksheet not foundThe named worksheet does not exist in the workbook.Use an existing worksheet name or leave it blank for the first sheet.
Table not foundThe named table does not exist, table mode only.Use an existing Excel table name.
ExcelRowNumber must be greater than 0Excel Row Number is less than 1 in table mode.Set Excel Row Number to 1 or higher.
InsertFromRow and InsertFromColumn are ignored when TableName is specifiedCoordinate parameters were set alongside Table Name.Clear Table Name for coordinate mode, or clear the coordinate fields for table mode.
No valid data found in JSON inputJSON Row Data was an empty array or had no parseable objects.Provide at least one valid object in the JSON payload.

¿Cómo configuro Agregar filas en? Power Automate¿

  1. Agregar PDF4meExcel - Agregar filas a tu Power Automate fluir.
  2. Mapa Contenido del archivo y Nombre del archivo de una acción anterior (SharePoint, OneDriveo un conector de base de datos).
  3. Colocar JSON Datos de fila a su objeto o matriz de objetos.
  4. Colocar Nombre de la tabla para inserción basada en tabla, o déjelo en blanco y configure Insertar desde fila / Insertar desde columna para inserción basada en coordenadas.
  5. Expandir Parámetros avanzados para habilitar Convertir números y fechas y configure el formato. Ejecute el flujo, el libro de trabajo actualizado se devolverá como documento.

Configuraciones típicas

Ejemplos de flujo de trabajoCommon Power Automate flow patterns using Add Rows.
Importación de datos de ventas diarias (modo tabla)
  1. Un disparador programado ejecuta una consulta SQL para obtener los registros de ventas del día.
  2. Los resultados se convierten en una matriz JSON que coincide con los encabezados de columna de la tabla de ventas.
  3. La función Obtener archivo recupera la plantilla de informe de ventas con el nombre de tabla "DailySales".
  4. Agregar filas inserta la matriz con la opción Convertir numérico y fecha habilitada y el patrón de formato numérico establecido para moneda.
  5. El informe actualizado se envía por correo electrónico a los gerentes de ventas.
Registro de respuestas de formularios (modo de coordenadas)
  1. El envío de un formulario de Microsoft Forms activa el flujo.
  2. El escenario crea un objeto JSON a partir de las respuestas enviadas.
  3. La función Obtener archivo recupera el libro de trabajo del registro de respuestas.
  4. Agregar filas inserta en la siguiente fila disponible usando Insertar desde fila e Insertar desde columna, dejando el Nombre de la tabla en blanco.
  5. El registro actualizado se guarda de nuevo en SharePoint.
Exportación de oportunidades de CRM
  1. Un disparador semanal consulta nuevas oportunidades de un CRM conector.
  2. Los registros se convierten en una matriz JSON con nombres de campo flexibles.
  3. La función Agregar filas inserta datos en una tabla "Oportunidades" con la opción Ignorar títulos de atributos habilitada para la coincidencia de encabezados sin distinción entre mayúsculas y minúsculas.
  4. El informe completado se distribuye al equipo de ventas.

Consejos prácticos

Never set Table Name and Insert From Row together
The two parameter sets belong to different insertion modes. Setting both returns an error, clear one set before running.
JSON Row Data accepts a single object or an array
A bare object inserts one row, an array inserts one row per object. Choose the shape that matches how many rows you are writing.
Excel Row Number is 1-based within the table
Row 1 in table mode is the first data row after the header, not the header itself. Set it accordingly when targeting a specific position.
Culture Name affects parsing, not just display
Set Culture Name to match how your source data formats dates and decimals (for example de-DE for comma decimals), otherwise conversion can misread values.
Ignore Attribute Titles solves case-mismatch headaches
If your JSON property names differ in case from the Excel table headers, enable Ignore Attribute Titles instead of renaming every header or every JSON key.

Hoja de trucos

CampoValor
ActionExcel - Add Rows
Mode switchTable Name set = table mode, empty = coordinate mode
JSON Row Data shapeSingle object or array of objects
Default worksheetSheet1
Type conversion toggleConvert Numeric And Date = true (default)
Default date/numeric formatyyyy-MM-dd / N2
Default cultureen-US
Outputdocument (Base64 workbook) + Success + ErrorMessage + Errors

Preguntas frecuentes

How do I insert JSON data into Excel in Power Automate?+
Add the PDF4me Excel - Add Rows action, map File Content and File Name from a prior action, set JSON Row Data to your JSON payload, then choose Table Name for table-based insertion or Insert From Row and Insert From Column for coordinate-based insertion.
What is the difference between table-based and coordinate-based insertion?+
Table-based insertion is used when Table Name is provided, JSON property names are matched to the Excel table headers and Excel Row Number sets the position within the table. Coordinate-based insertion is used when Table Name is empty, Insert From Row and Insert From Column set the exact worksheet cell where insertion starts, with no header matching.
Can I insert more than one row at once?+
Yes. Pass a JSON array of objects in JSON Row Data and every object becomes its own inserted row. A single JSON object inserts exactly one row.
What happens if I mix table-based and coordinate-based parameters?+
Setting Insert From Row or Insert From Column while Table Name is also set returns an error, since the two parameter sets belong to different insertion modes. Use one mode's parameters at a time.
How does automatic type conversion work?+
With Convert Numeric And Date enabled, JSON numbers become Excel numeric values formatted with Numeric Format Pattern, and date-like strings become Excel DateTime values formatted with Date Format Pattern. Culture Name controls how the incoming values are parsed before conversion. See <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings" target="_blank" rel="noopener noreferrer">Microsoft's numeric format string reference</a> and <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for details.

Casos de uso y aplicaciones en la industria

  • Informes del embudo de ventas: Insertar datos de oportunidades de CRM en los embudos de ventas de Excel
  • Seguimiento de clientes potenciales: Agregar nuevos clientes potenciales desde formularios a hojas de seguimiento de Excel
  • Análisis de campañas: Obtener los resultados de las campañas de marketing a partir de las API de análisis.
  • Listas de clientesExportar datos de clientes desde bases de datos a listas de clientes en Excel.

Acciones relacionadas

La misma tarea en otras plataformas

Obtén ayuda