Conjuntos de requisitos de la API de JavaScript de Excel
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 la web | Office en Windows
|
Office en Windows
|
Office en Mac | Office en iPad |
|---|---|---|---|---|---|
| Vista previa | 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 | Lo más reciente (vea la página de conjunto de requisitos) | No aplicable | No aplicable | No aplicable | No aplicable |
| ExcelApi 1.17 | Compatible | Versión 2302 (compilación 16130.20332) | Office 2024: versión 2302 (compilación 16130.20332) | Versión 16.70 (23021201) | Versión 16.70 |
| ExcelApi 1.16 | Compatible | Versión 2208 (compilación 15601.20148) | Office 2024: versión 2208 (compilación 15601.20148) | Versión 16.64 (22081401) | Versión 16.66 |
| ExcelApi 1.15 | Compatible | Versión 2202 (compilación 14931.20132) | Office 2024: versión 2202 (compilación 14931.20132) | Versión 16.58 (22021501) | Versión 16.59 |
| ExcelApi 1.14 | Compatible | Versión 2108 (compilación 14326.20508) | Office 2021: versión 2108 (compilación 14326.20508) | Versión 16.52 (21080801) | Versión 16.53 |
| ExcelApi 1.13 | Compatible | Versión 2102 (compilación 13801.20738) | Office 2021: versión 2102 (compilación 13801.20738) | Versión 16.50 (21061301) | Versión 16.50 |
| ExcelApi 1.12 | Compatible | Versión 2008 (Compilación 13127.20408) | Office 2021: versión 2008 (compilación 13127.20408) | Versión 16.40 (20081000) | Versión 16.40 |
| ExcelApi 1.11 | Compatible | Versión 2002 (compilación 12527.20470) | Office 2021: versión 2002 (compilación 12527.20470) | Versión 16.33 (20011301) | Versión 16.35 |
| ExcelApi 1.10 | Compatible | Versión 1907 (compilación 11929.20306) | Office 2021: versión 1907 (compilación 11929.20306) | Versión 16.30 (19101301) | Versión 16.0 |
| ExcelApi 1.9 | Compatible | Versión 1903 (compilación 11425.20204) | Office 2021: versión 1903 (compilación 11425.20204) | Versión 16.24 (19041401) | Versión 16.0 |
| ExcelApi 1.8 | Compatible | Versión 1808 (compilación 10730.20102) | Office 2021: versión 1808 (compilación 10730.20102) | Versión 16.17 (18090901) | Versión 16.0 |
| ExcelApi 1.7 | Compatible | Versión 1801 (compilación 9001.2171) | Office 2019: versión 1801 (compilación 9001.2171) | Versión 16.9 (18011602) | Versión 16.0 |
| ExcelApi 1.6 | Compatible | Versión 1704 (compilación 8201.2001) | Office 2019: versión 1704 (compilación 8201.2001) | Versión 15.36 (17070200) | Versión 15.0 |
| ExcelApi 1.5 | Compatible | Versión 1703 (compilación 8067.2070) | Office 2019: versión 1703 (compilación 8067.2070) | Versión 15.36 (17070200) | Versión 15.0 |
| ExcelApi 1.4 | Compatible | Versión 1701 (compilación 7870.2024) | Office 2019: versión 1701 (compilación 7870.2024) | Versión 15.36 (17070200) | Versión 15.0 |
| ExcelApi 1.3 | Compatible | Versión 1608 (compilación 7369.2055) | Office 2019: versión 1608 (compilación 7369.2055) | Versión 15.27 | Versión 15.0 |
| ExcelApi 1.2 | Compatible | Versión 1601 (compilación 6741.2088) | Office 2019: versión 1601 (compilación 6741.2088) | Versión 15.22 | Versión 15.0 |
| ExcelApi 1.1 | Compatible | Versión 1509 (compilación 4266.1001) | Office 2016: versión 1509 (compilación 4266.1001) | Versión 15.20 | Versión 15.0 |
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:
- Números de versión y compilación de versiones de canal de actualización para clientes de Microsoft 365
- ¿Qué versión de Office estoy usando?
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>