Conjuntos de requisitos de la API de JavaScript de Excel

  • Artículo

Los conjuntos de requisitos son grupos de miembros de la API con nombre. Los complementos de Office usan los conjuntos de requisitos especificados en el manifiesto o usan una comprobación en tiempo de ejecución para determinar si una aplicación de Office admite las API necesarias para el complemento. Para obtener más información, vea Versiones y conjuntos de requisitos de Office.

Disponibilidad del conjunto de requisitos

Los complementos de Excel se ejecutan en varias versiones de Office, incluida la versión de Office 2016 y versiones posteriores en Windows, Office en la web, iPad y Mac. En la tabla siguiente se enumeran los conjuntos de requisitos de Excel, las aplicaciones cliente de Office admitidas y las compilaciones o versiones mínimas para esas aplicaciones cuando corresponda.

Nota:

Para usar las API en cualquiera de los conjuntos de requisitos numerados o ExcelApiOnline, debe hacer referencia a la biblioteca de producción en la red de entrega de contenido (CDN) de Office.js.

Para obtener información sobre el uso de las API en versión preliminar, vea el artículo API en versión preliminar de JavaScript de Excel.

Conjunto de requisitos Office en Windows
- Suscripción a Microsoft 365
- Comercio minorista perpetuo de Office 2016 y versiones posteriores		 Office en Windows
(perpetuo con licencia por volumen)		 Office en Mac Office en iPad Office en la web
Versión preliminar Use la versión más reciente de Office para probar las API de versión preliminar (es posible que tenga que unirse al programa Microsoft 365 Insider).
ExcelApiOnline No aplicable No aplicable No aplicable No aplicable Lo más reciente (vea la página de conjunto de requisitos)
ExcelApi 1.17 Versión 2302 (compilación 16130.20332) No disponible 16.70 16.70 Compatible
ExcelApi 1.16 Versión 2208 (compilación 15601.20148) No disponible 16.64 16.66 Compatible
ExcelApi 1.15 Versión 2202 (compilación 14931.20132) No disponible 16.58 16.59 Compatible
ExcelApi 1.14 Versión 2108 (compilación 14326.20508) Office 2021: versión 2108 (compilación 14326.20508) 16.52 16.53 Compatible
ExcelApi 1.13 Versión 2102 (compilación 13801.20738) Office 2021: versión 2102 (compilación 13801.20738) 16.50 16.50 Compatible
ExcelApi 1.12 Versión 2008 (Compilación 13127.20408) Office 2021: versión 2008 (compilación 13127.20408) 16.40 16.40 Compatible
ExcelApi 1.11 Versión 2002 (compilación 12527.20470) Office 2021: versión 2002 (compilación 12527.20470) 16.33 16.35 Compatible
ExcelApi 1.10 Versión 1907 (compilación 11929.20306) Office 2021: versión 1907 (compilación 11929.20306) 16.30 16.0 Compatible
ExcelApi 1.9 Versión 1903 (compilación 11425.20204) Office 2021: versión 1903 (compilación 11425.20204) 16.24 16.0 Compatible
ExcelApi 1.8 Versión 1808 (compilación 10730.20102) Office 2021: versión 1808 (compilación 10730.20102) 16.17 16.0 Compatible
ExcelApi 1.7 Versión 1801 (compilación 9001.2171) Office 2019: versión 1801 (compilación 9001.2171) 16.9 16.0 Compatible
ExcelApi 1.6 Versión 1704 (compilación 8201.2001) Office 2019: versión 1704 (compilación 8201.2001) 15.36 15.0 Compatible
ExcelApi 1.5 Versión 1703 (compilación 8067.2070) Office 2019: versión 1703 (compilación 8067.2070) 15.36 15.0 Compatible
ExcelApi 1.4 Versión 1701 (compilación 7870.2024) Office 2019: versión 1701 (compilación 7870.2024) 15.36 15.0 Compatible
ExcelApi 1.3 Versión 1608 (compilación 7369.2055) Office 2019: versión 1608 (compilación 7369.2055) 15.27 15.0 Compatible
ExcelApi 1.2 Versión 1601 (compilación 6741.2088) Office 2019: versión 1601 (compilación 6741.2088) 15.22 15.0 Compatible
ExcelApi 1.1 Versión 1509 (compilación 4266.1001) Office 2016: versión 1509 (compilación 4266.1001) 15.20 15.0 Compatible

Números de versiones y compilación de Office

Para obtener más información sobre los números de versión y compilación de Office, vea:

Cómo usar conjuntos de requisitos de Excel en tiempo de ejecución y en el manifiesto

Nota:

En esta sección se presupone que está familiarizado con la información general sobre los conjuntos de requisitos de las versiones de Office y los conjuntos de requisitos y las especificaciones de las aplicaciones de Office y los requisitos de API.

Los conjuntos de requisitos son grupos de miembros de la API con nombre. Un complemento de Office puede realizar una comprobación en tiempo de ejecución o usar los conjuntos de requisitos especificados en el manifiesto para determinar si una aplicación de Office admite las API necesarias para el complemento.

Comprobar la compatibilidad de un conjunto de requisitos en tiempo de ejecución

En el ejemplo de código siguiente se muestra cómo determinar si la aplicación de Office donde se ejecuta el complemento es compatible con el conjunto de requisitos de la API especificada.

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

Definir la compatibilidad del conjunto de requisitos en el manifiesto

Puede usar el elemento Requirements en el manifiesto del complemento para especificar conjuntos de requisitos mínimos o los métodos de la API que el complemento necesita activar. Si la aplicación o la plataforma de Office no es compatible con los conjuntos de requisitos o los métodos de API que se especifican en el Requirements elemento del manifiesto, el complemento no se ejecutará en esa aplicación o plataforma y no se mostrará en la lista de complementos que se muestran en Mis complementos. Si el complemento requiere un conjunto específico de requisitos para una funcionalidad completa pero puede proporcionar valor, incluso para los usuarios de las plataformas que no admiten el conjunto de requisitos, se recomienda comprobar si el requisito es compatible en tiempo de ejecución, tal y como se describió anteriormente, en lugar de definir la compatibilidad con el conjunto de requisitos en el manifiesto.

El siguiente código de ejemplo muestra el elemento Requirements en el manifiesto de un complemento que especifica que el complemento debería cargarse en todas las aplicaciones cliente de Office que admiten el conjunto de requisitos ExcelApi versión 1.3 o posterior.

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

Vea también