Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Bildkopf und -fuß hinzufügen - Excel API

PDF4me Bild hinzufügen Kopf-Fußzeile ermöglicht es Ihnen, anpassbare Bildkopf- und -fußzeilen hinzuzufügen Excel Dokumente mit umfassender Positionierungs- und Formatierungskontrolle. API Serviceprozesse Excel Dateien und fügt Bildkopf- oder -fußzeilen mit Platzierungssteuerung (Kopf-/Fußzeile), horizontaler Ausrichtung (links, zentriert, rechts), Arbeitsblattausrichtung (bestimmte Blätter oder alle Blätter) und Seitenrändern in Zentimetern hinzu. API empfängt Excel Dokumentinhalte und Bilddaten durch REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Mit Unterstützung für PNG, JPG, JPEGDiese Lösung unterstützt unter anderem GIF-Bildformate und eignet sich ideal für Corporate Branding, professionelle Berichte und Workflows zur Dokumentenautomatisierung.

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

Get your api Key

Hauptmerkmale​

  • Platzierung von Kopf- oder FußzeileWählen Sie aus, ob Bilder im Kopf- oder Fußbereich des Dokuments platziert werden sollen.
  • Positionssteuerung: Bilder im Kopf-/Fußbereich links, zentriert oder rechtsbündig ausrichten
  • Arbeitsblatt-Zielgruppen: Bilder bestimmten Arbeitsblättern anhand ihres Namens oder Index oder allen Arbeitsblättern zuweisen
  • Margenanpassung: Konfigurieren Sie die oberen, unteren, linken und rechten Seitenränder in Zentimetern
  • Unterstützung für Bildformate: PNG, JPG, JPEGund GIF-Formate

REST API Endpunkt​

Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Bildkopf-/fußzeilenoperationen für Excel werden über einen einzigen Endpunkt durchgeführt:

  • Verfahren: POST
  • Endpunkt: office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API Parameter​

Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich. Alle Anfragen verwenden dokumentieren, docContent, Bildinhalt (Wurzelebene) und addImageHeaderFooterToExcelActionAndere Optionen sind Eigenschaften des Aktionsobjekts.

Erforderliche Parameter (Stammebene)​

ParameterTypBeschreibungBeispiel
dokumentieren*ObjectDokumentenreferenz. Muss enthalten Name (Zeichenkette): Excel Dateiname mit der Erweiterung .xlsx oder .xls{ "Name": "data.xlsx" }
docContent*String (Base64)Excel Dokumentinhalt kodiert in Base64UEsDBBQABgAIAAAA...
Bildinhalt*String (Base64)Bilddateiinhalt kodiert in Base64Unterstützt PNG, JPG, JPEG, GIF-FormateiVBORw0KGgoAAAANS...
addImageHeaderFooterToExcelAction*ObjectAktionskonfiguration (Position, Arbeitsblattausrichtung, Ränder usw.)Siehe untenstehendes Nutzlastbeispiel.

Optionale Parameter (innerhalb von addImageHeaderFooterToExcelAction)​

ParameterTypBeschreibungBeispiel
isHeaderBooleanAuswahl der Praktikumsplätze. true = Bild zur Dokumentkopfzeile hinzufügen (Standard), false = Bild zur Dokumentfußzeile hinzufügentrue
PositionStringHorizontale Ausrichtung innerhalb der Kopf-/Fußzeile. Links, Center, oder RechtsStandardeinstellung: „Zentriert“. Groß-/Kleinschreibung wird nicht beachtet.Center
ArbeitsblattnamenArray (string[])Array mit den Namen der Arbeitsblätter, auf die das Bild angewendet werden soll. Wenn sowohl worksheetNames als auch worksheetIndexes leer sind, wird das Bild auf alle Arbeitsblätter angewendet.["Sheet1", "Report"]
ArbeitsblattindizesArray (int[])Array von Arbeitsblattindizes (beginnend bei 1). Wenn sowohl worksheetNames als auch worksheetIndexes leer sind, gilt dies für alle Arbeitsblätter.[1, 2]
obere MargeZahl (doppelt)Oberer Seitenrand in Zentimetern. Standardwert: 1,91.9
unterer RandZahl (doppelt)Unterer Seitenrand in Zentimetern. Standardwert: 1,91.9
linker RandZahl (doppelt)Linker Seitenrand in Zentimetern. Standardwert: 1,91.9
rechter RandZahl (doppelt)Rechter Seitenrand in Zentimetern. Standardwert: 1,91.9
KulturnameStringKulturcode für die Dokumentenverarbeitung (z. B. „en-US“, „de-DE“, „fr-FR“)en-US

Notiz: Wenn beide Arbeitsblattnamen Und Arbeitsblattindizes Wenn die Felder leer oder null sind, wird das Bild auf alle Arbeitsblätter angewendet. Excel Datei.

Ausgabe​

Der PDF4me Bild hinzufügen Kopf-Fußzeile REST API gibt zurück Excel Dokument als ein Base64-kodierte Zeichenkette in JSON Format, nicht als Binärdaten.

Synchrone Verarbeitung (Standard)

Der API verarbeitet die Anfrage und gibt Folgendes zurück:

Statuscode: 200 OK

Content-Type: application/json

Antworttext:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}

Antwortfelder:

  • dokumentieren (Zeichenkette): Die Excel Dokument mit angewendeter Bildkopf-/Bildfußzeile, kodiert als Base64 Zeichenkette
  • Dateiname (Zeichenkette): Die Ausgabe Excel Dateiname
  • Erfolg (Boolescher Wert): Gibt an, ob die Anfrage erfolgreich war.
  • Fehlermeldung (Zeichenkette oder null): Fehlerdetails, wenn Erfolg nicht gegeben ist

Anwendungshinweise:

  1. Extrahieren Sie die document Feld vom JSON Antwort (Base64)
  2. Entschlüsseln Sie die Base64 Zeichenkette, um die Binärdatei zu erhalten Excel Dokumentendaten
  3. Speichern oder verarbeiten Sie die Excel Datei nach Bedarf

Beispiel (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const excelBytes = atob(data.document); // Decode Base64
// Save or process excelBytes

Beispielanfrage​

Kopfzeile​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Notiz:

  • Hol dir deins API Schlüssel vom PDF4me Armaturenbrett
  • Der API Der Schlüssel muss sein Base64 kodiert und mit "Basic" präfixiert in der Authorization Überschrift
  • Beispiel: Wenn Ihr API Schlüssel ist abc123, kodieren Sie es zu Base64 und verwenden Authorization: Basic YWJjMTIz

Nutzlast​

Einfaches Beispiel (nur Pflichtfelder):

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {}
}

Erweitertes Beispiel (mit allen optionalen Feldern):

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
 "imageContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
 "addImageHeaderFooterToExcelAction": {
 "isHeader": true,
 "position": "Center",
 "worksheetNames": ["Sheet1", "Report"],
 "worksheetIndexes": [1, 2],
 "topMargin": 1.9,
 "bottomMargin": 1.9,
 "leftMargin": 1.9,
 "rightMargin": 1.9,
 "cultureName": "en-US"
 }
}

Codebeispiele​

Der PDF4me Füge Bildkopf-Fußzeile hinzu Excel REST API Es werden Codebeispiele in verschiedenen Programmiersprachen bereitgestellt. Wählen Sie die Sprache, die am besten zu Ihrer Entwicklungsumgebung passt:

C# (CSharp) Beispiel

Vollständig C# Implementierung zum Hinzufügen von Bildkopf-/fußzeilen zu Excel Dokumente:

Branchenspezifische Anwendungsfälle und Anwendungen​

Anwendungsfälle im Finanz- und Rechnungswesen

  • Finanzberichte: Fügen Sie den Quartalsberichten die Überschriften mit dem Firmenlogo hinzu.
  • Haushaltsberichte: Abteilungslogos in Budgettabellen einfügen
  • Prüfdokumente: Wasserzeichen mit dem Logo der Wirtschaftsprüfungsgesellschaft in den Fußzeilen einfügen
  • Spesenabrechnungen: Firmenlogo-Kopfzeilen für Spesenabrechnungen hinzufügen

Hilfe erhalten​

Get Your API KeyAPI SamplesGetting Started