excel_create

Documents · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Crée une nouvelle feuille de calcul Excel (fichier .xlsx) avec des en-têtes et, facultativement, des lignes de données. Les nombres JSON (entiers et décimaux) sont écrits comme des nombres, de sorte que SUM() et les graphiques fonctionnent dessus ; les chaînes JSON restent toujours du texte même si elles ressemblent à des nombres ("007", "1e3" ou " 42"), tout comme les entiers de plus de 10 chiffres, car ce sont des identifiants comme un CUIT, un CBU ou un numéro de téléphone plutôt que des quantités. Les booléens JSON sont écrits comme des cellules booléennes. Une chaîne qui commence par "=" est écrite comme du texte, non comme une formule — utilisez excel_write_cell pour placer une formule dans une cellule.

Entrées requises

path
headers

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "headers": {
      "description": "Column headers",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "overwrite": {
      "description": "Required (with confirm) to REPLACE a file that already exists at path. Without it an existing file is never touched.",
      "type": "boolean"
    },
    "path": {
      "description": "Output path for the .xlsx file",
      "type": "string"
    },
    "rows": {
      "description": "Array of ROW ARRAYS — each row is itself an array of cell values (optional)",
      "items": {
        "description": "One row: the cell values, in column order",
        "items": {
          "type": [
            "string",
            "number",
            "boolean",
            "null"
          ]
        },
        "type": "array"
      },
      "type": "array"
    }
  },
  "required": [
    "path",
    "headers"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour excel_create. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "confirm": false,
  "headers": [
    "Task",
    "Owner"
  ],
  "path": "/Users/demo/Documents/launch-checklist.xlsx"
}

Windows