Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Adicionar cabeçalho e rodapé com imagem - Excel API

PDF4me Adicionar Cabeçalho e Rodapé com Imagem Permite adicionar cabeçalhos e rodapés de imagem personalizáveis a Excel Documentos com controle abrangente de posicionamento e formatação. Isto API processos de serviço Excel O editor permite criar arquivos e adicionar cabeçalhos ou rodapés de imagem com controle de posicionamento (cabeçalho/rodapé), alinhamento horizontal (esquerda, centro, direita), direcionamento para planilhas (planilhas específicas ou todas as planilhas) e margens de página em centímetros. API recebe Excel conteúdo do documento e dados de imagem através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para PNG, JPG, JPEGCompatível com formatos de imagem como .jpg e GIF, esta solução é ideal para identidade visual corporativa, relatórios profissionais e fluxos de trabalho de automação de documentos.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue →

Autenticando seu API Solicitar​

Inclua o seu API digite a chave na solicitação para autenticar com o PDF4me REST API.

Get your api Key

Principais características​

  • Posicionamento do cabeçalho ou rodapéEscolha se deseja inserir imagens no cabeçalho ou no rodapé do documento.
  • Controle de posiçãoAlinhar imagens à esquerda, ao centro ou à direita na área do cabeçalho/rodapé
  • Planilha de ObjetivosAplicar imagens a planilhas específicas por nome ou índice, ou a todas as planilhas.
  • Personalização de margemConfigure as margens superior, inferior, esquerda e direita da página em centímetros.
  • Suporte a formatos de imagem: PNG, JPG, JPEGe formatos GIF

REST API Ponto final​

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de cabeçalho/rodapé de imagem para Excel são realizadas por meio de um único ponto final:

  • Método: POST
  • Ponto final: office/ApiV2Excel/ExcelAddImageHeaderFooter

REST API Parâmetros​

Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios. Todas as solicitações usam documento, conteúdo do documento, conteúdo da imagem (nível raiz), e ação adicionarCabeçalhoRodapéDaImagemÀExcelOutras opções são propriedades do objeto de ação.

Parâmetros obrigatórios (nível raiz)​

ParâmetroTipoDescriçãoExemplo
documento*ObjectReferência do documento. Deve conter Nome (corda): Excel Nome do arquivo com extensão .xlsx ou .xls{ "Name": "data.xlsx" }
conteúdo do documento*String (Base64)Excel conteúdo do documento codificado em Base64UEsDBBQABgAIAAAA...
conteúdo da imagem*String (Base64)Conteúdo do arquivo de imagem codificado em Base64Suporta PNG, JPG, JPEG, formatos GIFiVBORw0KGgoAAAANS...
ação adicionarCabeçalhoRodapéDaImagemÀExcel*ObjectConfiguração da ação (posição, direcionamento da planilha, margens, etc.)Veja o exemplo de carga útil abaixo.

Parâmetros opcionais (dentro de addImageHeaderFooterToExcelAction)​

ParâmetroTipoDescriçãoExemplo
éCabeçalhoBooleanSeleção de alocação. true = Adicionar imagem ao cabeçalho do documento (padrão), false = Adicionar imagem ao rodapé do documentotrue
posiçãoStringAlinhamento horizontal no cabeçalho/rodapé. Esquerda, Centro, ou CertoPadrão: "Centralizado". Sem distinção entre maiúsculas e minúsculas.Center
Nomes das planilhasArray (corda[])Matriz de nomes de planilhas às quais a imagem será aplicada. Se `worksheetNames` e `worksheetIndexes` estiverem vazios, a imagem será aplicada a todas as planilhas.["Sheet1", "Report"]
Índices da planilhaArray (int[])Matriz de índices de planilhas (baseada em 1). Se `worksheetNames` e `worksheetIndexes` estiverem vazios, aplica-se a todas as planilhas.[1, 2]
margem superiorNúmero (duplo)Margem superior da página em centímetros. Padrão: 1,91.9
margem inferiorNúmero (duplo)Margem inferior da página em centímetros. Padrão: 1,91.9
margem esquerdaNúmero (duplo)Margem esquerda da página em centímetros. Padrão: 1,91.9
margem direitaNúmero (duplo)Margem direita da página em centímetros. Padrão: 1,91.9
nome_da_culturaStringCódigo de cultura para processamento de documentos (por exemplo, "en-US", "de-DE", "fr-FR")en-US

Observação: Se ambos Nomes das planilhas e Índices da planilha Se estiverem vazias ou nulas, a imagem será aplicada a todas as planilhas do Excel arquivo.

Saída​

O PDF4me Adicionar Cabeçalho e Rodapé com Imagem REST API retorna o Excel documento como um Base64string codificada em JSON formato, não como dados binários.

Processamento síncrono (padrão)

O API processa a solicitação e retorna:

Código de status: 200 OK

Content-Type: application/json

Corpo da resposta:

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

Campos de resposta:

  • documento (string): O Excel Documento com cabeçalho/rodapé de imagem aplicado, codificado como Base64 corda
  • nome_do_arquivo (string): A saída Excel nome do arquivo
  • sucesso (booleano): Indica se a solicitação foi bem-sucedida.
  • mensagem de erro (string ou nulo): Detalhes do erro quando o sucesso for falso

Como usar:

  1. Extraia o document campo do JSON resposta (Base64)
  2. Decifre o Base64 string para obter o binário Excel dados do documento
  3. Salvar ou processar o Excel arquive conforme necessário

Exemplo (JavaScript):

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

Exemplo de solicitação​

Cabeçalho​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Observação:

  • Adquira o seu API chave do PDF4me Painel
  • O API a chave deve ser Base64 codificado e prefixado com "Básico" no Authorization cabeçalho
  • Exemplo: Se o seu API chave é abc123, codifique-o para Base64 e usar Authorization: Basic YWJjMTIz

Carga útil​

Exemplo básico (somente campos obrigatórios):

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

Exemplo avançado (com todos os campos opcionais):

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

Exemplos de código​

O PDF4me Adicionar cabeçalho e rodapé de imagem Excel REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:

C# (CSharp) Exemplo

Completo C# Implementação para adicionar cabeçalhos/rodapés de imagem a Excel documentos:

Casos de uso e aplicações industriais​

Casos de uso em finanças e contabilidade

  • Demonstrações FinanceirasAdicionar cabeçalhos com o logotipo da empresa aos relatórios trimestrais
  • Relatórios orçamentáriosInserir logotipos dos departamentos nas planilhas de orçamento.
  • Documentos de auditoriaAplicar marcas d'água com o logotipo da empresa de auditoria nos rodapés.
  • Relatórios de despesasAdicionar cabeçalhos com o logotipo da empresa para os relatórios de despesas.

Obtenha ajuda​

Get Your API KeyAPI SamplesGetting Started