Aggiungi righe - Excel API
PDF4me Aggiungi righe consente di inserire JSON dati come righe in Excel documenti con modalità di inserimento basate su tabelle o coordinate. Questo API Il servizio supporta la conversione automatica del tipo (stringhe in numeri/date), l'analisi specifica della cultura, la formattazione personalizzabile di date e numeri e la gestione dei valori nulli. API riceve Excel contenuto del documento e JSON dati attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per l'inserimento automatico dei dati, la generazione di report e i flussi di lavoro da database a Excel.
Autenticazione del tuo API Richiesta
Includi il tuo API chiave nella richiesta di autenticazione con il PDF4me REST API.
Caratteristiche principali
- Modalità di inserimento doppie: Basato su tabella (corrispondenza dell'intestazione) o basato su coordinate (posizionamento esatto di riga/colonna)
- JSON Supporto dati: Inserire singoli oggetti o array di oggetti come Excel file
- Conversione automatica del tipo: Converti JSON corde a Excel numeri e date
- Personalizzazione del formato: Applica modelli di formattazione personalizzati per date e numeri
- Supporto culturale: Analizza date e numeri in base ai codici cultura specificati
- Gestione dei valori nulli: Ignora i valori nulli o inseriscili come celle vuote
REST API Punto finale
- Metodo: POST
- Punto finale:
office/ApiV2Excel/ExcelAddRows
REST API Parametri
Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. Tutte le richieste utilizzano documento, docContent, E addRowsToExcelActionI parametri specifici dell'operazione (jsonInput, worksheetName, ecc.) sono proprietà dell'oggetto azione.
Parametri richiesti (livello radice)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| documento* | Object | Riferimento al documento con Nome Excel nome del file) | { "Name": "data.xlsx" } |
| docContent* | String Base64) | Excel contenuto del documento codificato in Base64 | UEsDBBQABgAIAAAA... |
| addRowsToExcelAction* | Object | Configurazione dell'azione. Deve contenere jsonInput (corda): JSON dati come array di oggetti o singolo oggetto | Vedi l'esempio di payload qui sotto |
Parametri opzionali (all'interno di addRowsToExcelAction)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| Nome del foglio di lavoro | String | Nome del foglio di lavoro di destinazione. Predefinito: "Sheet1" | Sheet1 |
| nometabella | String | Excel nome della tabella per la modalità basata su tabelle; vuoto = modalità basata su coordinate | SalesTable |
| excelRowNumber | Numero (int) | posizione basata su 1 all'interno della tabella (solo modalità tabella) | 5 |
| insertFromRow | Numero (int) | Riga iniziale basata su 1 (solo modalità coordinate) | 10 |
| insertFromColumn | Numero (int) | Colonna iniziale basata su 1 (solo modalità coordinate) | 3 |
| convertNumericoEData | Boolean | Conversione automatica del tipo. Predefinito: true | true |
| formato data | String | Excel Formato data. Predefinito: "yyyy-MM-dd" | MM/dd/yyyy |
| Formato numerico | String | Excel Modello di formato numerico. Predefinito: "N2" | #,##0.00 |
| ignoreNullValues | Boolean | Ignora i valori nulli. Predefinito: false | false |
| ignora i titoli degli attributi | Boolean | Corrispondenza dell'intestazione senza distinzione tra maiuscole e minuscole. Predefinito: falso | true |
| Nome della cultura | String | Cultura per l'analisi di date/numeri. Predefinito: "en-US" | en-US |
Produzione
IL API restituisce il Excel documento come Base64-stringa codificata in JSON formato (documento, nomefile, successo, messaggiodierrore).
Esempio di richiesta
Intestazione
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carico utile (base)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}