Adicionar linhas - Excel API
PDF4me Adicionar linhas permite inserir JSON dados como linhas em Excel documentos com modos de inserção baseados em tabelas ou em coordenadas. Isto API O serviço oferece suporte à conversão automática de tipos (strings para números/datas), análise sintática específica para cada cultura, formatação personalizável de datas e números e tratamento de valores nulos. API recebe Excel conteúdo do documento e JSON dados através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Essa solução é ideal para preenchimento automático de dados, geração de relatórios e fluxos de trabalho de banco de dados para Excel.
Autenticando seu API Solicitar
Inclua o seu API digite a chave na solicitação para autenticar com o PDF4me REST API.
Principais características
- Modos de Inserção DuplaBaseado em tabelas (correspondência de cabeçalho) ou baseado em coordenadas (posicionamento exato de linhas/colunas)
- JSON Suporte de dadosInsira objetos individuais ou matrizes de objetos como Excel linhas
- Conversão automática de tiposConverter JSON cordas para Excel números e datas
- Personalização de formatoAplicar padrões de formatação personalizados para datas e números.
- Apoio à CulturaAnalisar datas e números de acordo com os códigos de cultura especificados.
- Tratamento de valores nulosIgnore valores nulos ou insira-os como células vazias.
REST API Ponto final
- Método: POST
- Ponto final:
office/ApiV2Excel/ExcelAddRows
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, e ação adicionarLinhasAoExcelOs parâmetros específicos da operação (jsonInput, worksheetName, etc.) são propriedades do objeto de ação.
Parâmetros obrigatórios (nível raiz)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| documento* | Object | Referência do documento com Nome (Excel nome do arquivo) | { "Name": "data.xlsx" } |
| conteúdo do documento* | String (Base64) | Excel conteúdo do documento codificado em Base64 | UEsDBBQABgAIAAAA... |
| ação adicionarLinhasAoExcel* | Object | Configuração de ação. Deve conter jsonInput (corda): JSON dados como matriz de objetos ou objeto único | Veja o exemplo de carga útil abaixo. |
Parâmetros opcionais (dentro de addRowsToExcelAction)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Nome da planilha | String | Nome da planilha de destino. Padrão: "Planilha1" | Sheet1 |
| nomedatabela | String | Excel Nome da tabela para o modo baseado em tabela; vazio = modo baseado em coordenadas | SalesTable |
| excelRowNumber | Número (int) | Posição baseada em 1 dentro da tabela (somente no modo de tabela) | 5 |
| inserirDaLinha | Número (int) | Linha inicial baseada em 1 (somente no modo de coordenadas) | 10 |
| inserirDaColuna | Número (int) | Coluna inicial baseada em 1 (somente no modo de coordenadas) | 3 |
| converterNúmeroEDate | Boolean | Conversão automática de tipos. Padrão: verdadeiro | true |
| formato de data | String | Excel Formato padrão de data. Padrão: "aaaa-MM-dd" | MM/dd/yyyy |
| formato numérico | String | Excel Padrão de formato numérico. Padrão: "N2" | #,##0.00 |
| ignorarValoresNulos | Boolean | Ignorar valores nulos. Padrão: falso | false |
| ignoreAttributeTitles | Boolean | Correspondência de cabeçalho sem distinção entre maiúsculas e minúsculas. Padrão: falso | true |
| nome_da_cultura | String | Cultura para análise de datas/números. Padrão: "en-US" | en-US |
Saída
O API retorna o Excel documento como um Base64string codificada em JSON formato (documento, nomeDoArquivo, sucesso, mensagemDeErro).
Exemplo de solicitação
Cabeçalho
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carga útil (básica)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}