Zum Hauptinhalt springen

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.

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog

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)

ParameterTypBeschreibungBeispiel
dokumentieren*ObjectDokumentenreferenz mit Name (Excel Dateiname){ "Name": "data.xlsx" }
docContent*String (Base64)Excel Dokumentinhalt kodiert in Base64UEsDBBQABgAIAAAA...
addRowsToExcelAction*ObjectAktionskonfiguration. Muss enthalten jsonInput (Zeichenkette): JSON Daten als Array von Objekten oder als einzelnes ObjektSiehe untenstehendes Nutzlastbeispiel.

Optionale Parameter (innerhalb von addRowsToExcelAction)

ParameterTypBeschreibungBeispiel
ArbeitsblattnameStringName des Zielarbeitsblatts. Standardwert: „Sheet1“Sheet1
TabellennameStringExcel Tabellenname für tabellenbasierten Modus; leer = koordinatenbasierter ModusSalesTable
excelRowNumberZahl (ganzzahl)1-basierte Position innerhalb der Tabelle (nur Tabellenmodus)5
insertFromRowZahl (ganzzahl)1-basierte Startzeile (nur im Koordinatenmodus)10
insertFromColumnZahl (ganzzahl)1-basierte Startspalte (nur Koordinatenmodus)3
KonvertierenNumerischUndDatumBooleanAutomatische Typkonvertierung. Standardwert: truetrue
DatumsformatStringExcel Datumsformatmuster. Standard: "yyyy-MM-dd"MM/dd/yyyy
numerisches FormatStringExcel Numerisches Formatmuster. Standardwert: "N2"#,##0.00
ignoreNullValuesBooleanNullwerte überspringen. Standardwert: falsefalse
Attributtitel ignorierenBooleanHeader-Abgleich ohne Berücksichtigung der Groß-/Kleinschreibung. Standardwert: falsetrue
KulturnameStringKultur 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}]"
}
}

Codebeispiele

Hilfe erhalten