Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Aggiungi immagine a intestazione e piè di pagina - Excel API

PDF4me Aggiungi immagine Intestazione Piè di pagina consente di aggiungere intestazioni e piè di pagina di immagini personalizzabili Excel documenti con controllo completo di posizionamento e formattazione. Questo API processi di servizio Excel file e aggiunge intestazioni o piè di pagina di immagini con controllo del posizionamento (intestazione/piè di pagina), allineamento orizzontale (sinistra, centro, destra), destinazione del foglio di lavoro (fogli specifici o tutti i fogli) e margini di pagina in centimetri. API riceve Excel contenuto del documento e dati dell'immagine tramite REST API chiamate, utilizzando Base64 codifica per trasmissione sicura. Con supporto per PNG, JPG, JPEGGrazie al supporto per i formati immagine GIF, questa soluzione è ideale per il branding aziendale, i report professionali e i flussi di lavoro di automazione dei documenti.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog →

Autenticazione del tuo API Richiesta​

Includi il tuo API chiave nella richiesta di autenticazione con il PDF4me REST API.

Get your api Key

Caratteristiche principali​

  • Posizionamento dell'intestazione o del piè di pagina: Scegli se inserire le immagini nell'intestazione o nel piè di pagina del documento
  • Controllo della posizione: Allinea le immagini a sinistra, al centro o a destra nell'area dell'intestazione/piè di pagina
  • Obiettivo del foglio di lavoro: Applicare immagini a fogli di lavoro specifici per nome o indice, oppure a tutti i fogli di lavoro
  • Personalizzazione del margineConfigura i margini superiore, inferiore, sinistro e destro della pagina in centimetri
  • Supporto per i formati immagine: PNG, JPG, JPEGe formati GIF

REST API Punto finale​

IL PDF4me REST API utilizza standard HTTP metodi per interagire con le risorse. Tutte le operazioni di intestazione/piè di pagina dell'immagine per Excel vengono eseguite tramite un singolo endpoint:

  • Metodo: POST
  • Punto finale: office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API Parametri​

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. Tutte le richieste utilizzano documento, docContent, Contenuto dell'immagine (livello radice), e addImageHeaderFooterToExcelActionAltre opzioni sono proprietà dell'oggetto azione.

Parametri richiesti (livello radice)​

ParametroTipoDescrizioneEsempio
documento*ObjectRiferimento al documento. Deve contenere Nome (corda): Excel nome del file con estensione .xlsx o .xls{ "Name": "data.xlsx" }
docContent*String Base64)Excel contenuto del documento codificato in Base64UEsDBBQABgAIAAAA...
Contenuto dell'immagine*String Base64)Contenuto del file immagine codificato in Base64. Supporta PNG, JPG, JPEGformati GIFiVBORw0KGgoAAAANS...
addImageHeaderFooterToExcelAction*ObjectConfigurazione dell'azione (posizione, selezione del foglio di lavoro, margini, ecc.)Vedi l'esempio di payload qui sotto

Parametri opzionali (all'interno di addImageHeaderFooterToExcelAction)​

ParametroTipoDescrizioneEsempio
isHeaderBooleanSelezione del posizionamento. true = Aggiungi l'immagine all'intestazione del documento (impostazione predefinita), false = Aggiungi immagine al piè di pagina del documentotrue
posizioneStringAllineamento orizzontale nell'intestazione/piè di pagina. Sinistra, Centro, O Giusto. Predefinito: "Centrato". Non distingue tra maiuscole e minuscole.Center
worksheetNamesArray (corda[])Array di nomi di fogli di lavoro a cui applicare l'immagine. Se sia worksheetNames che worksheetIndexes sono vuoti, l'immagine viene applicata a tutti i fogli di lavoro.["Sheet1", "Report"]
Indici dei fogli di lavoroArray (int[])Array di indici dei fogli di lavoro (basati su 1). Se sia worksheetNames che worksheetIndexes sono vuoti, si applica a tutti i fogli di lavoro.[1, 2]
margine superioreNumero (doppio)Margine superiore della pagina in centimetri. Valore predefinito: 1,91.9
margine inferioreNumero (doppio)Margine inferiore della pagina in centimetri. Valore predefinito: 1,91.9
margine sinistroNumero (doppio)Margine sinistro della pagina in centimetri. Valore predefinito: 1,91.9
margine di profittoNumero (doppio)Margine destro della pagina in centimetri. Valore predefinito: 1,91.9
Nome della culturaStringCodice culturale per l'elaborazione dei documenti (ad esempio, "en-US", "de-DE", "fr-FR")en-US

Nota: Se entrambi worksheetNames E Indici dei fogli di lavoro sono vuoti o nulli, l'immagine verrà applicata a tutti i fogli di lavoro nel Excel file.

Produzione​

IL PDF4me Aggiungi immagine Intestazione Piè di pagina REST API restituisce il Excel documento come Base64-stringa codificata in JSON formato, non come dati binari.

Elaborazione sincrona (impostazione predefinita)

IL API elabora la richiesta e restituisce:

Codice di stato: 200 OK

Content-Type: application/json

Corpo della risposta:

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

Campi di risposta:

  • documento (stringa): La Excel documento con intestazione/piè di pagina immagine applicata, codificato come Base64 corda
  • Nome file (stringa): L'output Excel nome del file
  • successo (booleano): Indica se la richiesta è andata a buon fine
  • messaggio di errore (stringa o null): Dettagli dell'errore quando il successo è falso

Come si usa:

  1. Estrarre il document campo dal JSON risposta (Base64)
  2. decodificare il Base64 stringa per ottenere il binario Excel dati del documento
  3. Salva o elabora il Excel file secondo necessità

Esempio (JavaScript):

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

Esempio di richiesta​

Intestazione​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

  • Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
  • IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
  • Esempio: se il tuo API la chiave è abc123, codificalo in Base64 e utilizzare Authorization: Basic YWJjMTIz

Carico utile​

Esempio di base (solo campi obbligatori):

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

Esempio avanzato (con tutti i campi opzionali):

{
 "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"
 }
}

Esempi di codice​

IL PDF4me Aggiungi intestazione e piè di pagina dell'immagine Excel REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C# Esempio (CSharp)

Completo C# implementazione per aggiungere intestazioni/piè di pagina delle immagini a Excel Documenti:

Casi d'uso e applicazioni industriali​

Casi d'uso in ambito finanziario e contabile.

  • BilanciAggiungere il logo aziendale nelle intestazioni dei report trimestrali
  • Rapporti di bilancioInserire i loghi dei dipartimenti nei fogli di lavoro del budget.
  • Documenti di revisione: Applicare filigrane con il logo della società di revisione nei piè di pagina
  • Note speseAggiungere il logo aziendale nelle intestazioni delle richieste di rimborso spese.

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started