Conjuntos de requisitos de la API de JavaScript de PowerPoint

  • 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.

En la tabla siguiente se enumeran los conjuntos de requisitos de PowerPoint, las aplicaciones cliente de Office admitidas y las compilaciones o versiones mínimas para esas aplicaciones cuando corresponda.

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).
PowerPointApi 1.5 Versión 2208 (compilación 15601.20230) No disponible 16.64.804.0 No disponible Compatible
PowerPointApi 1.4 Versión 2207 (compilación 15330.20122) No disponible 16.62 No disponible Compatible
PowerPointApi 1.3 Versión 2111 (compilación 14701.20060) No disponible 16.55 No disponible Compatible
PowerPointApi 1.2 Versión 2011 (compilación 13426.20184) Office 2021: versión 2011 (compilación 13426.20184) 16.43 No disponible Compatible
PowerPointApi 1.1 Versión 1810 (compilación 11001.20074) Office 2021: versión 1810 (compilación 11001.20074) 16.19 2.17 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:

PowerPoint JavaScript API 1.1

La API de JavaScript de PowerPoint 1,1 contiene una única API para crear una presentación nueva. Para más información sobre la API, consulte Crear una presentación.

PowerPoint JavaScript API 1.2

La API de JavaScript de PowerPoint 1.2 agrega compatibilidad para insertar diapositivas de otra presentación de PowerPoint en la presentación actual y para eliminar diapositivas. Para más información sobre las API, vea Insertar y eliminar diapositivas en una presentación de PowerPoint.

PowerPoint JavaScript API 1.3

La API de JavaScript de PowerPoint 1.3 añade compatibilidad adicional para agregar y eliminar diapositivas. También permite a los complementos aplicar etiquetas de metadatos personalizadas. Para más información sobre las API, vea Agregar y eliminar diapositivas en PowerPoint y Usar etiquetas personalizadas en presentaciones, diapositivas y formas en PowerPoint.

API de JavaScript de PowerPoint 1.4

La API de JavaScript de PowerPoint 1.4 agrega compatibilidad adicional para agregar, mover, ajustar el tamaño, dar formato y eliminar formas. Para obtener más información sobre el uso de estas API, vea Trabajar con formas.

API de JavaScript de PowerPoint 1.5

La API de JavaScript de PowerPoint 1.5 incluye API para seleccionar diapositivas, intervalos de texto y formas dentro de presentaciones. Para obtener más información, vea Conjunto de requisitos de la API de JavaScript de PowerPoint 1.5.

Cómo usar conjuntos de requisitos de PowerPoint 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('PowerPointApi', '1.1')) {
  // 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 elemento Requirements 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 la versión 1.1 o posterior del conjunto de requisitos de PowerPointApi.

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="PowerPointApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Conjuntos de requisitos de la API común de Office

La mayoría de las funciones de complemento de PowerPoint provienen del conjunto de API común. Para obtener información sobre los conjuntos de requisitos comunes de la API, vea Conjuntos de requisitos comunes de la API de Office.

Consulte también