# Formats DOCX et XLSX : quand un document final complet est nécessaire avec l'IA > Guide pratique complet sur la génération et le traitement de documents DOCX et de tableaux XLSX à l'aide de l'IA : comparaison avec Markdown et CSV, ingénierie des prompts, gestion des formules et automatisation dans le code. ## 1. Quatre formats — quatre enjeux distincts : Text, CSV, DOCX et XLSX L'une des erreurs les plus courantes lors de l'interaction avec l'intelligence artificielle consiste à exiger d'emblée : *« Génère un document Word »* ou *« Exporte tout dans Excel »*. L'extension du fichier n'apporte aucune valeur en soi si le format choisi ne correspond pas à l'étape suivante du cycle de vie des données. ```mermaid flowchart TD A["Вхідний запит / Сирі дані"] --> B{"Яка мета використання результату?"} B -->|Обговорення, драфт, код, проміжний аналіз| C["Текст / Markdown
(Максимальна швидкість, гнучкість у чаті)"] B -->|Імпорт у БД, міграція, машинний парсинг| D["CSV / JSON
(Легкий формат, плоска структура даних)"] B -->|Презентація клієнту, друк, фірмовий звіт| E["DOCX
(Стилі, ієрархія H1-H3, колонтитули, брендбук)"] B -->|Розрахунки, бізнес-план, щоденний облік| F["XLSX
(Багатосторінковість, динамічні формули, фільтри)"] ``` ### Matrice de sélection du format optimal | Format | Quand l'utiliser | Principaux avantages | À éviter quand | | :--- | :--- | :--- | :--- | | **Texte / Markdown** | Brouillons, discussion itérative, génération de code | Réponse instantanée, absence d'artefacts binaires | Rapports finaux destinés aux clients et à la direction | | **CSV** | Extrait de grands jeux de données (>10 000 lignes), import dans un CRM | Universalité, taille minimale | Calculs, rapports multi-pages, mise en forme | | **DOCX** | Procédures, propositions commerciales, guides méthodologiques, contrats | Mise en page professionnelle, styles Word, impression | Notes intermédiaires et code brut | | **XLSX** | Budgets, plans de contenu, modèles financiers, tableaux de bord | Formules actives, sous-totaux, filtres, mise en forme conditionnelle | Simple échange de listes entre scripts | > [!NOTE] > Si vous demandez au modèle de développer une structure de rapport ou un plan de cours, générer un DOCX est prématuré : il est préférable de peaufiner le texte dans le chat et de figer les points clés. Les formats DOCX et XLSX doivent intervenir lorsque le fichier lui-même devient le produit final. --- ## 2. Quand commander un DOCX : du brouillon à l'artefact final Le format DOCX est nécessaire lorsque le document est destiné à être lu par un humain, revu collaborativement via une suite bureautique ou intégré dans un circuit officiel de gestion documentaire. ### Ce que le DOCX apporte par rapport au simple texte 1. **Hiérarchie typographique stricte :** Utilisation de styles sémantiques Word (*Titre 1*, *Titre 2*, *Normal*), permettant au document de générer automatiquement une table des matières cliquable. 2. **Modèle visuel unifié :** Possibilité de modifier la police ou l'interligne sur l'ensemble d'un document de 50 pages en un clic via le panneau des styles. 3. **Mise en forme de tableaux complexes :** Largeur fixe des colonnes, en-têtes colorés et alignement des valeurs numériques. 4. **Éléments de mise en page institutionnelle :** Numéros de page, en-têtes/pieds de page avec nom de projet, pages de garde et sauts de section. ![Structure de tableau dans les documents DOCX et XLSX](/api/guides-media/automation/docx-xlsx-document-formats-for-ai/images/docx-xlsx-document-formats-for-ai-extra-01.webp) ```markdown | Étape | Responsable | Délai | | :--- | :--- | :--- | | **Préparation** | Chargé de marketing | 3 jours | | **Vérification** | Responsable de pôle | 1 jour | | **Publication** | Gestionnaire de contenu | 1 jour | ``` > [!TIP] > Si vous devez apporter des modifications ponctuelles au texte d'un seul paragraphe, travaillez directement dans le chat. La création d'un DOCX se justifie lorsque le document final est prêt à être transmis aux parties prenantes ou archivé. --- ## 3. Rédaction d'un cahier des charges impeccable pour la génération de DOCX La phrase *« Fais-moi un joli fichier Word »* pousse l'IA à agir au hasard. Pour obtenir un résultat prévisible, adoptez une approche d'ingénierie dans la formulation de votre prompt. ```mermaid flowchart LR A["1. Цільова аудиторія та роль"] --> B["2. Жорстка структура розділів"] B --> C["3. Внутрішні компоненти (Таблиці/Списки)"] C --> D["4. Стилістичні вимоги (Шрифти/Поля)"] D --> E["Готовий бізнес-документ DOCX"] ``` ### Cinq composants obligatoires du prompt 1. **Destinataire du document :** Pour qui le texte est-il rédigé (conseil d'administration, support technique, client B2B). 2. **Liste des sections obligatoires :** Fixez la séquence : *Page de titre $\rightarrow$ Résumé $\rightarrow$ 4 étapes $\rightarrow$ Risques $\rightarrow$ Budget*. 3. **Exigences relatives aux éléments :** Précisez ce qui doit être présenté sous forme de liste à puces, de procédure numérotée ou de tableau comparatif. 4. **Charte graphique :** Police souhaitée (*Calibri*, *Aptos*, *Inter*), interligne (1.15) et couleurs d'accentuation pour les encadrés. 5. **Limites d'inviolabilité (pour les éditions) :** Interdiction explicite de modifier les formulations juridiques ou les spécifications techniques présentes dans le texte source. ### Comparaison des requêtes : faible vs précise :::tabs @tab Requête faible ```text Rédige un document de procédures pour le service commercial au format Word. ``` *Résultat :* Texte continu sans styles, polices aléatoires, absence de page de titre, perte de temps inutile due à une remise en page manuelle. @tab Cahier des charges professionnel ```text Créez un règlement interne prêt à l’emploi au format DOCX : « Travail des managers dans le CRM ». Public cible : nouveaux collaborateurs du service des ventes B2B. Structure : 1. Page de titre avec le nom et la version du document. 2. Table des matières automatique basée sur les titres de niveau 1 et 2. 3. Processus étape par étape pour le traitement d’un lead (liste numérotée incluant les actions). 4. Tableau « Statuts des affaires, champs obligatoires et délais ». 5. Matrice des erreurs courantes et des méthodes pour les corriger. 6. Liste de contrôle finale pour préparer un appel téléphonique. Mise en forme : style professionnel sobre, police Aptos 11 pt, marges de 2 cm, couleur d’accentuation bleue (#1E40AF) pour les en-têtes de tableaux. ``` ::: --- ## 4. Quand le XLSX est requis : données dynamiques, feuilles et formules Le format XLSX est choisi lorsque le fichier doit devenir un outil de calcul vivant, et non une simple capture statique de chiffres. ### Signes indiquant que vous avez besoin du XLSX : - Les données nécessitent une mise à jour mensuelle et un recalcul des totaux. - Il est indispensable de lier plusieurs sources via des formules (`SUM`, `AVERAGE`, `VLOOKUP`, `XLOOKUP`). - Le projet comporte plusieurs dimensions (par exemple : feuille séparée pour les revenus, les dépenses et le tableau de bord synthétique). - Les utilisateurs appliqueront des filtres par statut, responsable ou date. - Une mise en forme conditionnelle est requise pour visualiser instantanément les risques (surlignage des paiements en retard). ```mermaid flowchart TD subgraph Excel_Workbook["Структура робочої книги XLSX"] S1["Аркуш 1: 'Вихідні дані'
(Чистий реєстр угод, дати, суми)"] S2["Аркуш 2: 'Розрахунки'
(Динамічні формули, коефіцієнти, маржа)"] S3["Аркуш 3: 'Дашборд'
(Зведені підсумки, ключові KPI, діаграми)"] end S1 -->|Посилаються формули| S2 S2 -->|Агрегує показники| S3 ``` --- ## 5. XLSX contre CSV : différences architecturales clés En raison de leur similarité visuelle apparente, les développeurs débutants confondent souvent ces formats ou choisissent l'outil inadapté. | Paramètre | CSV (Comma-Separated Values) | XLSX (Microsoft Excel OpenXML) | | :--- | :--- | :--- | | **Nature du format** | Flux textuel plat avec délimiteurs | Archive de fichiers XML et médias (ZIP) | | **Multi-feuilles** | Un seul feuillet plat uniquement | Nombre illimité de feuilles nommées | | **Prise en charge des formules** | Absente (seules les lignes brutes sont stockées) | Support complet du moteur de calcul Excel | | **Mise en forme** | Aucune (pas de couleur, police, largeur de colonne) | Polices, bordures, remplissage, formats nombre/devise | | **Filtres et validation** | Absents | Autofiltres, listes déroulantes, verrouillage de cellules | | **Taille du fichier** | Minimale (idéal pour des millions de lignes) | Plus élevée due aux métadonnées structurelles | > [!WARNING] > Si vous sauvegardez un classeur Excel complexe multi-feuilles contenant des formules au format CSV, toutes les feuilles supplémentaires, graphiques et liens mathématiques seront irrévocablement perdus ! --- ## 6. Ingénierie des formules, types de données et mise en forme conditionnelle dans XLSX Le principal avantage d'un fichier XLSX de qualité généré par l'IA réside dans la séparation correcte entre les données brutes et la logique de calcul. ### Formules plutôt que nombres statiques Exigez toujours de l'IA qu'elle inscrive de vraies formules dans les cellules de synthèse : - ❌ **Mauvais :** L'IA a calculé la somme en mémoire et inscrit le nombre `45200` dans la cellule `D20`. (Si les prix sources changent, le total restera erroné). - ✅ **Correct :** L'IA a inscrit la formule `=SUM(D2:D19)` dans la cellule `D20`. (Le tableau reste interactif durablement). ### Typage strict des données Chaque colonne doit avoir un format clairement assigné : - **Dates :** format `JJ.MM.AAAA` ou `AAAA-MM-JJ` (pour qu'Excel trie chronologiquement et non alphabétiquement). - **Montants monétaires :** format numérique avec séparateur de milliers et symbole devise (`12 500,00 €` ou `$12,500.00`). - **Pourcentages :** format numérique pourcentage (`15.4%`), et non une chaîne de texte `"15%"`. ### Mise en forme conditionnelle dynamique Les indicateurs de couleur automatiques permettent d'évaluer la situation sans parcourir des centaines de lignes : - Dégradé vert : réalisation du plan $\ge 100\%$. - Surlignage rouge : dépassement du budget ou échéance dépassée. --- ## 7. Rédaction du cahier des charges pour la génération de tableaux XLSX Pour obtenir un tableau mature de l'intelligence artificielle, formulez cinq blocs d'exigences fondamentaux. ```mermaid flowchart TD A["1. Архітектура аркушів"] --> B["2. Реєстр стовпців та типи даних"] B --> C["3. Математичні формули та зв'язки"] C --> D["4. Фільтри, сортування та випадаючі списки"] D --> E["5. Зведені підсумки та візуальні діаграми"] ``` ### Prompt de référence pour un fichier de calcul ```text Crée un classeur XLSX complet et fonctionnel pour le calcul du budget annuel d’un projet IT en 2027. Structure des feuilles : 1. « Paramètres » : taux horaires des spécialistes, coefficients fiscaux, taux de change. 2. « Dépenses » : registre des postes (catégorie, intervenant, taux horaire, nombre d’heures, montant). 3. « Synthèse » : rapport mensuel incluant les dépenses prévues et réelles, les écarts et le % de réalisation. Exigences relatives aux calculs : - Calculer le montant dans la feuille « Dépenses » via une formule multipliant le nombre d’heures par le taux horaire issu de la feuille « Paramètres ». - Dans la feuille « Synthèse », utiliser les formules SUMIF/SUMIFS pour agréger les données par catégorie. - Ajouter le calcul de l’écart : =(Réel - Prévu) / Prévu. Mise en forme : - Figer la première ligne (en-têtes) sur toutes les feuilles. - Activer les filtres automatiques sur la feuille « Dépenses ». - Formater les montants monétaires en USD avec deux décimales. - Sur la feuille « Synthèse », ajouter un histogramme comparatif « Prévu vs Réel par mois ». ``` --- ## 8. Travail avec les modèles : création from scratch vs mise à jour de fichiers existants Créer un fichier à partir d'une page blanche et mettre à jour un modèle d'entreprise existant sont deux opérations d'ingénierie radicalement différentes. ```mermaid flowchart LR subgraph From_Scratch["Створення з нуля"] A1["Опис архітектури"] --> B1["Проєктування сітки"] --> C1["Генерація нового файлу"] end subgraph By_Template["Робота за шаблоном"] A2["Завантаження еталона"] --> B2["Аналіз зв'язків і формул"] --> C2["Акуратне оновлення комірок"] end ``` ### Règles de mise à jour sécurisée des modèles 1. **Figez les éléments inviolables :** Ordonnez explicitement au modèle : *« Ne modifie pas les noms des feuilles, la taille des polices, les en-têtes de tableaux ni les formules des colonnes F:H »*. 2. **Spécifiez les limites exactes d'insertion :** Par exemple : *« Ajoute les nouvelles lignes de transactions à la fin du tableau avant la ligne de total 'Somme' et étends la plage dans la formule SUM »*. 3. **Préservation des macros et connexions :** Si le fichier original contient des scripts VBA ou des connexions à des bases de données, assurez-vous que le traitement ne corrompe pas les structures binaires du classeur. --- ## 9. Automatisation dans le code : comment l'IA et le backend génèrent DOCX et XLSX Lorsque les agents IA opèrent dans un environnement de production (via Claude Code, LangChain ou des services backend personnalisés), la génération de fichiers ne se fait pas manuellement, mais via des bibliothèques logicielles robustes. :::tabs @tab Python (python-docx) ```python from docx import Document from docx.shared import Inches, Pt, RGBColor from docx.enum.text import WD_ALIGN_PARAGRAPH doc = Document() # Налаштування стилів документа title = doc.add_heading("Звіт з продуктивності команди", level=0) title.alignment = WD_ALIGN_PARAGRAPH.CENTER p = doc.add_paragraph("Цей документ сформовано автоматично на основі даних за 3 квартал.") p.runs[0].font.size = Pt(11) # Додавання таблиці з даними table = doc.add_table(rows=1, cols=3) table.style = 'Light Shading Accent 1' hdr_cells = table.rows[0].cells hdr_cells[0].text = 'Спринт' hdr_cells[1].text = 'Задач закрито' hdr_cells[2].text = 'Ефективність' data = [("Sprint 41", "34", "94%"), ("Sprint 42", "41", "98%")] for sprint, count, eff in data: row_cells = table.add_row().cells row_cells[0].text = sprint row_cells[1].text = count row_cells[2].text = eff doc.save("team_report.docx") ``` @tab Python (openpyxl) ```python from openpyxl import Workbook from openpyxl.styles import Font, PatternFill, Alignment wb = Workbook() ws = wb.active ws.title = "Бюджет" # Створення та стилізація заголовків headers = ["Категорія", "План ($)", "Факт ($)", "Відхилення ($)"] ws.append(headers) header_fill = PatternFill(start_color="1E40AF", end_color="1E40AF", fill_type="solid") header_font = Font(color="FFFFFF", bold=True) for col_num in range(1, 5): cell = ws.cell(row=1, column=col_num) cell.fill = header_fill cell.font = header_font cell.alignment = Alignment(horizontal="center") # Додавання рядків даних rows = [ ["Сервери AWS", 2500, 2350], ["Маркетинг", 5000, 5600], ["Підписки на ПЗ", 800, 800], ] for row_idx, data in enumerate(rows, start=2): ws.append([data[0], data[1], data[2], f"=C{row_idx}-B{row_idx}"]) # Підсумковий рядок із формулами ws.append(["Разом", "=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"]) ws.cell(row=5, column=1).font = Font(bold=True) wb.save("project_budget.xlsx") ``` @tab TypeScript (exceljs) ```typescript import ExcelJS from 'exceljs'; async function generateSpreadsheet() { const workbook = new ExcelJS.Workbook(); const sheet = workbook.addWorksheet('Sales Data'); sheet.columns = [ { header: 'Продукт', key: 'product', width: 25 }, { header: 'Кількість', key: 'qty', width: 15 }, { header: 'Ціна за од.', key: 'price', width: 15 }, { header: 'Разом', key: 'total', width: 18 } ]; sheet.addRow({ product: 'Cloud Gateway License', qty: 5, price: 1200, total: { formula: 'B2*C2' } }); sheet.addRow({ product: 'Support SLA Tier 1', qty: 1, price: 3500, total: { formula: 'B3*C3' } }); await workbook.xlsx.writeFile('enterprise_sales.xlsx'); } ``` ::: --- ## 10. Protocole de vérification et validation des fichiers générés Ne transmettez jamais de fichiers générés automatiquement à des clients ou partenaires sans inspection préalable. Vérifiez le document selon deux protocoles spécialisés. ### Protocole de contrôle qualité pour DOCX - [ ] **Structure sémantique :** Le document utilise les niveaux de titres natifs (*Heading 1*, *Heading 2*), et non simplement du texte gras avec une police agrandie. - [ ] **Intégrité des tableaux :** Les tableaux ne débordent pas des marges de la page, le texte des cellules ne chevauche pas et n'est pas tronqué. - [ ] **Sauts de page :** Aucun titre « orphelin » en bas de page sans le texte suivant. - [ ] **Champs de mise en page :** Vérification de la numérotation des pages (première page masquée si nécessaire) et de la table des matières. ### Protocole de contrôle qualité pour XLSX - [ ] **Formules vivantes :** Les cellules de synthèse contiennent des formules (`=SUM()`), et non des nombres statiques. - [ ] **Plages de formules :** Vérifiez que les plages de totaux couvrent toutes les lignes insérées, y compris la dernière. - [ ] **Test de recalcul :** Modifiez une valeur de base — l'ensemble du modèle doit mettre à jour le résultat automatiquement. - [ ] **Formats d'affichage :** Les cellules monétaires et pourcentages ont le format approprié, sans erreurs `#VALUE!` ou `#REF!`. --- ## 11. Bibliothèque prête de prompts maîtres et checklist de déploiement Utilisez ces modèles prêts à l'emploi comme base éprouvée pour l'automatisation quotidienne. ### Prompt maître pour procédures et rapports en DOCX ```markdown Agis en tant que rédacteur technique principal. Crée un document officiel prêt à l’emploi au format DOCX. Sujet : [Indiquez le sujet, par exemple : Règlement sur la sécurité des postes de travail distants] Public cible : [Indiquez le public] Structure du document : 1. Page de titre (Titre, version, auteur, date). 2. Résumé et objectifs du document. 3. Exigences normatives (règlement numéroté des actions). 4. Tableau récapitulatif : « Menace | Niveau de risque | Mesure préventive | Responsable ». 5. Matrice d’escalade des incidents. 6. Liste de contrôle finale pour l’auto-vérification par l’employé. Exigences de mise en forme : - Police du corps de texte : Aptos ou Calibri 11 pt, interligne 1,15. - Styles des titres : Heading 1 (18 pt, Gras), Heading 2 (14 pt, Semi-gras). - Schéma de couleurs des tableaux : accent bleu foncé pour les en-têtes, alternance gris clair des lignes. - Intégrer une table des matières au début du document. ``` ### Prompt maître pour modèles financiers en XLSX ```markdown Agis en tant qu'analyste financier. Crée un classeur Excel (XLSX) complet pour un business plan. Les feuilles distinctes suivantes sont requises : 1. « Paramètres » : hypothèses d'entrée (coût de revient, prix de vente, taux de conversion, taxes). 2. « Ventes » : prévision mensuelle du nombre de transactions et du chiffre d'affaires brut via des formules. 3. « OPEX » : liste des dépenses opérationnelles par catégorie (loyer, serveurs, masse salariale). 4. « Synthèse P&L » : rapport mensuel sur les profits et pertes (Revenus, Dépenses, EBITDA, Bénéfice net). Exigences relatives à la logique : - Il est interdit de coder en dur les valeurs calculées — tous les chiffres de la feuille « Synthèse P&L » doivent être liés aux feuilles « Ventes » et « OPEX » via des formules. - Applique le format monétaire USD à toutes les cellules financières. - Ajoute une mise en forme conditionnelle pour la marge : vert si > 25 %, rouge si < 10 %. - Crée un graphique combiné sur la feuille « P&L » : barres pour les revenus, ligne pour le bénéfice net. ``` ### Checklist finale de sélection du format - [ ] **Texte / Markdown :** Nécessaire pour l'itération rapide, le code ou les notes internes ? - [ ] **CSV :** Besoin d'un export massif de données brutes pour ingestion système ? - [ ] **DOCX :** Le livrable final doit-il être imprimé, signé ou lu par un décideur humain ? - [ ] **XLSX :** Le fichier doit-il rester un outil de calcul interactif avec formules et filtres ?