Zeilen hinzufügen - Excel API
PDF4me Zeilen hinzufügen ermöglicht Ihnen das Einfügen JSON Daten als Zeilen in Excel Dokumente mit tabellen- oder koordinatenbasierten Einfügemodi. API Der Dienst unterstützt automatische Typkonvertierung (Zeichenketten in Zahlen/Datumsangaben), kulturspezifisches Parsen, anpassbare Datums- und Zahlenformatierung sowie die Behandlung von Nullwerten. API empfängt Excel Dokumentinhalt und JSON Daten durch REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Diese Lösung eignet sich ideal für die automatisierte Datenbefüllung, Berichtserstellung und Datenbank-zu-Excel-Workflows.
Authentifizierung Ihres API Anfrage
Fügen Sie Ihre API Geben Sie den Schlüssel in der Anfrage ein, um sich mit dem zu authentifizieren. PDF4me REST APIDie
Hauptmerkmale
- Zwei EinfügemodiTabellenbasiert (Übereinstimmung der Überschriften) oder koordinatenbasiert (exakte Zeilen-/Spaltenpositionierung)
- JSON Datenunterstützung: Einzelne Objekte oder Objektarrays einfügen als Excel Zeilen
- Automatische Typumwandlung: Konvertieren JSON Zeichenketten zu Excel Zahlen und Daten
- Formatanpassung: Benutzerdefinierte Datums- und Zahlenformatierungsmuster anwenden
- Kulturförderung: Datumsangaben und Zahlen gemäß den angegebenen Kulturcodes analysieren
- Behandlung von NullwertenNullwerte überspringen oder als leere Zellen einfügen
REST API Endpunkt
- Verfahren: POST
- Endpunkt:
office/ApiV2Excel/ExcelAddRows
REST API Parameter
Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich. Alle Anfragen verwenden dokumentieren, docContent, Und addRowsToExcelActionOperationsspezifische Parameter (jsonInput, worksheetName usw.) sind Eigenschaften des Aktionsobjekts.
Erforderliche Parameter (Stammebene)
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| dokumentieren* | Object | Dokumentenreferenz mit Name (Excel Dateiname) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel Dokumentinhalt kodiert in Base64 | UEsDBBQABgAIAAAA... |
| addRowsToExcelAction* | Object | Aktionskonfiguration. Muss enthalten jsonInput (Zeichenkette): JSON Daten als Array von Objekten oder als einzelnes Objekt | Siehe untenstehendes Nutzlastbeispiel. |
Optionale Parameter (innerhalb von addRowsToExcelAction)
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| Arbeitsblattname | String | Name des Zielarbeitsblatts. Standardwert: „Sheet1“ | Sheet1 |
| Tabellenname | String | Excel Tabellenname für tabellenbasierten Modus; leer = koordinatenbasierter Modus | SalesTable |
| excelRowNumber | Zahl (ganzzahl) | 1-basierte Position innerhalb der Tabelle (nur Tabellenmodus) | 5 |
| insertFromRow | Zahl (ganzzahl) | 1-basierte Startzeile (nur im Koordinatenmodus) | 10 |
| insertFromColumn | Zahl (ganzzahl) | 1-basierte Startspalte (nur Koordinatenmodus) | 3 |
| KonvertierenNumerischUndDatum | Boolean | Automatische Typkonvertierung. Standardwert: true | true |
| Datumsformat | String | Excel Datumsformatmuster. Standard: "yyyy-MM-dd" | MM/dd/yyyy |
| numerisches Format | String | Excel Numerisches Formatmuster. Standardwert: "N2" | #,##0.00 |
| ignoreNullValues | Boolean | Nullwerte überspringen. Standardwert: false | false |
| Attributtitel ignorieren | Boolean | Header-Abgleich ohne Berücksichtigung der Groß-/Kleinschreibung. Standardwert: false | true |
| Kulturname | String | Kultur für die Datums-/Zahlenanalyse. Standardwert: "en-US" | en-US |
Ausgabe
Der API gibt zurück Excel Dokument als ein Base64-kodierte Zeichenkette in JSON Format (Dokument, Dateiname, Erfolg, Fehlermeldung).
Beispielanfrage
Kopfzeile
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Nutzlast (Basis)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}