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.

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

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

• Documentación de referencia de la API de JavaScript de Excel
• Manifiesto de complementos de Office