Vue d’ensemble des types de données dans les compléments Excel

Les types de données organisent les structures de données complexes sous forme d’objets. Cela inclut les valeurs numériques mises en forme, les images web et les entités en tant que cartes d’entité.

La capture d’écran suivante met en évidence l’une des principales fonctionnalités des types de données : une entité carte. Dans ce cas, l’entité carte affiche des informations développées sur le produit Tofu à partir d’une liste de produits d’épicerie.

Type de données valeur d’entité avec la fenêtre carte affichée.

Remarque

Pour commencer à tester immédiatement les types de données, installez Script Lab dans Excel et case activée la section Types de données de notre bibliothèque d’exemples. Vous pouvez également explorer les exemples Script Lab dans notre référentiel OfficeDev/office-js-snippets.

Avant l’ajout des types de données, l’API JavaScript Excel prenait en charge les types de données chaîne, nombre, booléen et d’erreur. La couche de mise en forme de l’interface utilisateur Excel est capable d’ajouter des devises, des dates et d’autres types de mise en forme aux cellules qui contiennent les quatre types de données d’origine, mais cette couche de mise en forme contrôle uniquement l’affichage des types de données d’origine dans l’interface utilisateur Excel. La valeur du nombre sous-jacent n’est pas modifiée, même lorsqu’une cellule de l’interface utilisateur Excel est mise en forme en tant que devise ou date. Cet écart entre une valeur sous-jacente et l’affichage mis en forme dans l’interface utilisateur Excel peut se traduire par une confusion et des erreurs pendant les calculs du complément. Les API de types de données sont une solution à cet écart.

Les types de données étendent la prise en charge de l’API JavaScript Excel au-delà des quatre types de données d’origine (chaîne, nombre, booléen et erreur) pour inclure des images web, des valeurs numériques mises en forme, des entités, des tableaux dans des entités et des types de données d’erreur améliorés en tant que structures de données flexibles. Ces types, qui permettent de nombreuses expériences de types de données liées, offrent une précision et une simplicité lors des calculs du complément et étendent le potentiel des compléments Excel au-delà d’une grille à 2 dimensions.

Conseil

Consultez des exemples de types de données liés, qui sont disponibles pour tous les utilisateurs Excel, dans l’exemple de classeur suivant : linked-data-types-sample-workbook.xlsx.

Ressources

Explorez les types de données avec les ressources suivantes.

  1. Découvrez les principes de base des types de données dans l’article Concepts de base des types de données Excel .
  2. Installez Script Lab dans Excel et explorez la section Types de données de notre bibliothèque d’exemples.
  3. Découvrez comment étendre Excel au-delà d’une grille à 2 dimensions avec des types de données d’entité dans l’article Utiliser des cartes avec des types de données valeur d’entité .
  4. Essayez l’exemple Créer et explorer des types de données dans Excel dans notre référentiel OfficeDev/Office-Add-in-samples .

Types de données et fonctions personnalisées

Les types de données améliorent la puissance des fonctions personnalisées. Les fonctions personnalisées acceptent les types de données comme entrées et sorties de fonctions personnalisées et les fonctions personnalisées utilisent le même schéma JSON pour les types de données que l’API JavaScript Excel. Ce schéma JSON de types de données est conservé à mesure que les fonctions personnalisées calculent et évaluent. Pour en savoir plus sur l’intégration des types de données à vos fonctions personnalisées, consultezFonctions personnalisées et types de données.