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.
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ètre | Taper | Description | Exemple |
|---|---|---|---|
| document* | Object | Référence du document avec Nom (Excel nom de fichier) | { "Name": "data.xlsx" } |
| docContent* | String (Base64) | Excel contenu du document encodé en Base64 | UEsDBBQABgAIAAAA... |
| ajouterLignesÀExcelAction* | Object | Configuration de l'action. Doit contenir Entrée JSON (chaîne): JSON données sous forme de tableau d'objets ou d'objet unique | Voir l'exemple de charge utile ci-dessous |
Paramètres optionnels (dans addRowsToExcelAction)
| Paramètre | Taper | Description | Exemple |
|---|---|---|---|
| Nom de la feuille de travail | String | Nom de la feuille de calcul cible. Par défaut : « Feuille1 » | Sheet1 |
| Nom de la table | String | Excel Nom de la table pour le mode basé sur les tables ; vide = mode basé sur les coordonnées | SalesTable |
| numéro de ligne Excel | Nombre (entier) | Position à partir de 1 dans le tableau (mode tableau uniquement) | 5 |
| insérerDepuisLaLigne | Nombre (entier) | Ligne de départ à partir de 1 (mode coordonnées uniquement) | 10 |
| insérerDepuisColonne | Nombre (entier) | Colonne de départ à partir de 1 (mode coordonnées uniquement) | 3 |
| convertNumericAndDate | Boolean | Conversion automatique de type. Par défaut : vrai | true |
| format de date | String | Excel Format de date par défaut : « aaaa-MM-jj ». | MM/dd/yyyy |
| format numérique | String | Excel Modèle de format numérique. Par défaut : « N2 » | #,##0.00 |
| ignorer les valeurs nulles | Boolean | Ignorer les valeurs nulles. Valeur par défaut : false | false |
| ignorerAttributeTitles | Boolean | Correspondance des en-têtes insensible à la casse. Valeur par défaut : false | true |
| nom de la culture | String | Culture 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}]"
}
}