Share via


Información general sobre los tipos de datos en complementos de Excel

Los tipos de datos organizan estructuras de datos complejas como objetos. Esto incluye valores de número con formato, imágenes web y entidades como tarjetas de entidad.

En la captura de pantalla siguiente se resalta una de las características principales de los tipos de datos: una tarjeta de entidad. En este caso, la tarjeta de entidad muestra información ampliada sobre el producto Tofu de una lista de productos de la tienda de comestibles.

Tipo de datos de valor de entidad con la ventana de tarjeta mostrada.

Nota:

Para empezar a experimentar con tipos de datos de inmediato, instale Script Lab en Excel y consulte la sección Tipos de datos de nuestra biblioteca de ejemplos. También puede explorar los ejemplos de Script Lab en nuestro repositorio OfficeDev/office-js-snippets.

Antes de agregar los tipos de datos, la API de JavaScript de Excel admitía tipos de datos de cadena, número, booleano y error. La capa de formato de la interfaz de usuario de Excel es capaz de agregar moneda, fecha y otros tipos de formato a las celdas que contienen los cuatro tipos de datos originales, pero esta capa de formato solo controla la presentación de los tipos de datos originales en la interfaz de usuario de Excel. El valor del número subyacente no cambia, incluso cuando una celda de la interfaz de usuario de Excel tiene formato de moneda o una fecha. Esta diferencia entre un valor subyacente y la presentación con formato en la interfaz de usuario de Excel puede dar lugar a confusión y errores durante los cálculos del complemento. Las API de tipos de datos son una solución a esta brecha.

Los tipos de datos expanden la compatibilidad de la API de JavaScript de Excel más allá de los cuatro tipos de datos originales (cadena, número, booleano y error) para incluir imágenes web, valores de número con formato, entidades, matrices dentro de entidades y tipos de datos de error mejorados como estructuras de datos flexibles. Estos tipos, que potencian muchas experiencias de tipos de datos vinculados, permiten precisión y simplicidad durante los cálculos de complementos y amplían el potencial de los complementos de Excel más allá de una cuadrícula bidimensional.

Sugerencia

Consulte ejemplos de tipos de datos vinculados, que están disponibles para todos los usuarios de Excel, en el siguiente libro de ejemplo: linked-data-types-sample-workbook.xlsx.

Recursos

Explore los tipos de datos con los siguientes recursos.

  1. Obtenga información sobre los conceptos básicos de tipos de datos en el artículo conceptos básicos de tipos de datos de Excel .
  2. Instale Script Lab en Excel y explore la sección Tipos de datos de nuestra biblioteca de ejemplos.
  3. Obtenga información sobre cómo ampliar Excel más allá de una cuadrícula bidimensional con tipos de datos de entidad en el artículo Uso de tarjetas con tipos de datos de valor de entidad .
  4. Pruebe el ejemplo Crear y explorar tipos de datos en Excel en nuestro repositorio OfficeDev/Office-Add-in-samples .

Tipos de datos y funciones personalizadas

Los tipos de datos mejoran la eficacia de las funciones personalizadas. Las funciones personalizadas aceptan tipos de datos como entradas para funciones personalizadas y salidas de funciones personalizadas, y las funciones personalizadas usan el mismo esquema JSON para los tipos de datos que la API de JavaScript de Excel. Este esquema JSON de tipos de datos se mantiene a medida que las funciones personalizadas calculan y evalúan. Para más información sobre la integración de tipos de datos con las funciones personalizadas, consulte Funciones personalizadas y tipos de datos.