Aller au contenu principal

Ajouter des lignes - Excel API

PDF4me Ajouter des lignes vous permet d'insérer JSON données sous forme de lignes dans Excel documents avec modes d'insertion basés sur des tableaux ou sur des coordonnées. API Ce service prend en charge la conversion automatique des types (chaînes de caractères en nombres/dates), l'analyse syntaxique spécifique à la culture, la mise en forme personnalisable des dates et des nombres, ainsi que la gestion des valeurs nulles. API reçoit Excel contenu du document et JSON données via REST API appels, utilisant Base64 Encodage pour une transmission sécurisée. Cette solution est idéale pour l'alimentation automatisée en données, la génération de rapports et les flux de travail entre bases de données et Excel.

Articles de blog connexes
Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.
En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.
Consultez le blog

Authentification de votre API Demande

Incluez votre API clé dans la requête pour s'authentifier auprès du PDF4me REST API.

Caractéristiques principales

  • Modes d'insertion doubles: Basé sur un tableau (correspondance des en-têtes) ou basé sur des coordonnées (positionnement exact des lignes/colonnes)
  • JSON Support de données: Insérer des objets uniques ou des tableaux d'objets comme Excel rangées
  • Conversion automatique de type: Convertir JSON cordes à Excel nombres et dates
  • Personnalisation du formatAppliquer des modèles de formatage personnalisés pour les dates et les nombres
  • Soutien culturelAnalyser les dates et les nombres selon les codes de culture spécifiés
  • Gestion des valeurs nullesIgnorer les valeurs nulles ou les insérer comme cellules vides

REST API Point de terminaison

  • Méthode: POST
  • Point final : office/ApiV2Excel/ExcelAddRows

REST API Paramètres

Important: Les paramètres marqués d'un astérisque (*) sont obligatoires. Toutes les requêtes utilisent document, docContent, et ajouterLignesÀExcelLes paramètres spécifiques à l'opération (jsonInput, worksheetName, etc.) sont des propriétés de l'objet action.

Paramètres requis (niveau racine)

ParamètreTaperDescriptionExemple
document*ObjectRéférence du document avec Nom (Excel nom de fichier){ "Name": "data.xlsx" }
docContent*String (Base64)Excel contenu du document encodé en Base64UEsDBBQABgAIAAAA...
ajouterLignesÀExcelAction*ObjectConfiguration de l'action. Doit contenir Entrée JSON (chaîne): JSON données sous forme de tableau d'objets ou d'objet uniqueVoir l'exemple de charge utile ci-dessous

Paramètres optionnels (dans addRowsToExcelAction)

ParamètreTaperDescriptionExemple
Nom de la feuille de travailStringNom de la feuille de calcul cible. Par défaut : « Feuille1 »Sheet1
Nom de la tableStringExcel Nom de la table pour le mode basé sur les tables ; vide = mode basé sur les coordonnéesSalesTable
numéro de ligne ExcelNombre (entier)Position à partir de 1 dans le tableau (mode tableau uniquement)5
insérerDepuisLaLigneNombre (entier)Ligne de départ à partir de 1 (mode coordonnées uniquement)10
insérerDepuisColonneNombre (entier)Colonne de départ à partir de 1 (mode coordonnées uniquement)3
convertNumericAndDateBooleanConversion automatique de type. Par défaut : vraitrue
format de dateStringExcel Format de date par défaut : « aaaa-MM-jj ».MM/dd/yyyy
format numériqueStringExcel Modèle de format numérique. Par défaut : « N2 »#,##0.00
ignorer les valeurs nullesBooleanIgnorer les valeurs nulles. Valeur par défaut : falsefalse
ignorerAttributeTitlesBooleanCorrespondance des en-têtes insensible à la casse. Valeur par défaut : falsetrue
nom de la cultureStringCulture pour l'analyse des dates et des nombres. Par défaut : « en-US »en-US

Sortir

Le API renvoie le Excel document comme un Base64chaîne encodée dans JSON format (document, nom_de_fichier, succès, message_d_erreur).

Exemple de requête

En-tête

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Charge utile (basique)

{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}

Exemples de code

Obtenez de l'aide