Agregar filas - Excel API
PDF4me Agregar filas te permite insertar JSON datos como filas en Excel documentos con modos de inserción basados en tablas o coordenadas. API El servicio admite la conversión automática de tipos (cadenas a números/fechas), análisis específico de la cultura, formato de fecha y numérico personalizable y manejo de valores nulos. API recibe Excel contenido del documento y JSON datos a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Esta solución es ideal para la introducción automatizada de datos, la generación de informes y los flujos de trabajo de bases de datos a Excel.
Autenticando su API Pedido
Incluye tu API clave en la solicitud para autenticarse con el PDF4me REST API.
Características principales
- Modos de inserción duales: Basado en tablas (coincidencia de encabezados) o basado en coordenadas (posicionamiento exacto de filas/columnas)
- JSON Soporte de datos: Insertar objetos individuales o matrices de objetos como Excel filas
- Conversión automática de tipos: Convertir JSON cadenas a Excel números y fechas
- Personalización de formatoAplicar patrones de formato numérico y de fecha personalizados
- Apoyo culturalAnalizar fechas y números según los códigos culturales especificados.
- Manejo de valores nulos: Omitir valores nulos o insertar como celdas vacías
REST API Punto final
- Método: POST
- Punto final:
office/ApiV2Excel/ExcelAddRows
REST API Parámetros
Importante: Los parámetros marcados con un asterisco (*) son obligatorios. Todas las solicitudes utilizan documento, docContent, y acción addRowsToExcelLos parámetros específicos de la operación (jsonInput, worksheetName, etc.) son propiedades del objeto de acción.
Parámetros requeridos (nivel raíz)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| documento* | Object | Referencia del documento con Nombre (Excel Nombre del archivo) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel contenido del documento codificado en Base64 | UEsDBBQABgAIAAAA... |
| acción addRowsToExcel* | Object | Configuración de acción. Debe contener Entrada json (cadena): JSON datos como una matriz de objetos o un solo objeto | Consulte el ejemplo de carga útil a continuación. |
Parámetros opcionales (dentro de addRowsToExcelAction)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Nombre de la hoja de cálculo | String | Nombre de la hoja de cálculo de destino. Predeterminado: "Hoja1" | Sheet1 |
| nombre de la tabla | String | Excel nombre de la tabla para el modo basado en tablas; vacío = modo basado en coordenadas | SalesTable |
| Número de fila de Excel | Número (int) | Posición basada en 1 dentro de la tabla (solo en modo tabla) | 5 |
| insertardesdefila | Número (int) | Fila de inicio basada en 1 (solo en modo de coordenadas) | 10 |
| insertarDesdeColumna | Número (int) | Columna de inicio basada en 1 (solo en modo de coordenadas) | 3 |
| convertirNúmeroYFecha | Boolean | Conversión automática de tipos. Predeterminado: verdadero | true |
| formato de fecha | String | Excel Patrón de formato de fecha. Predeterminado: "aaaa-MM-dd" | MM/dd/yyyy |
| formato numérico | String | Excel Patrón de formato numérico. Predeterminado: "N2" | #,##0.00 |
| ignorar valores nulos | Boolean | Omitir valores nulos. Valor predeterminado: falso | false |
| ignorarAttributeTitles | Boolean | Coincidencia de encabezados sin distinción entre mayúsculas y minúsculas. Valor predeterminado: falso | true |
| Nombre de la cultura | String | Cultura para el análisis de fechas/números. Predeterminado: "en-US" | en-US |
Producción
El API devuelve el Excel documento como un Base64cadena codificada en JSON formato (documento, nombrearchivo, éxito, mensaje de error).
Ejemplo de solicitud
Encabezamiento
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carga útil (básica)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}