Versiones de Office y conjuntos de requisitos
Hay varias versiones de Office en varias plataformas y no todas admiten todas las API de JavaScript de Office (Office.js). Office 2013 en Windows era la versión más antigua de Office que admitía complementos de Office. Es posible que no siempre tenga control sobre la versión de Office que han instalado los usuarios. Para controlar esta situación, proporcionamos un sistema denominado conjuntos de requisitos para ayudarle a determinar si una aplicación de Office admite las funcionalidades que necesita en el complemento de Office.
Nota:
- Office se ejecuta en varias plataformas, incluidas Windows, en un explorador, Mac y iPad.
- Ejemplos de aplicaciones de Office son productos de Office: Excel, Word, PowerPoint, Outlook, OneNote, etc.
- Office está disponible mediante una suscripción de Microsoft 365 o una licencia perpetua. La versión perpetua está disponible por contrato de licencias por volumen o por venta al por menor.
- Un conjunto de requisitos es un grupo con nombre de miembros de API, por ejemplo,
ExcelApi 1.5,WordApi 1.3, etc.
Cómo comprobar la versión de Office
Para identificar la versión de Office que está usando, desde una aplicación de Office, seleccione el menú Archivo y luego elija Cuenta. La versión de Office aparece en la sección Información del producto . Por ejemplo, la captura de pantalla siguiente indica office versión 1802 (compilación 9026.1000).
Nota:
Si su versión de Office es diferente de esta, consulte ¿Qué versión de Outlook tengo? o Acerca de Office: ¿Qué versión de Office estoy usando? para comprender cómo obtener esta información para su versión.
Implementación
La implementación del complemento puede afectar a la disponibilidad del complemento en las distintas plataformas y clientes. Para más información sobre las opciones de implementación, consulte Implementación y publicación de complementos de Office.
Disponibilidad de los conjuntos de requisitos de Office
Los complementos de Office pueden usar conjuntos de requisitos de API para determinar si la aplicación de Office admite los miembros de API que necesita usar. La compatibilidad del conjunto de requisitos varía según la aplicación de Office y la versión de la aplicación de Office (consulte la sección anterior Cómo comprobar la versión de Office).
Algunas aplicaciones de Office tienen sus propios conjuntos de requisitos de API. Por ejemplo, el primer conjunto de requisitos para la API de Excel era ExcelApi 1.1 y el primer conjunto de requisitos para la API de Word era WordApi 1.1. Desde entonces, se han agregado varios conjuntos de requisitos nuevos de ExcelApi y WordApi para proporcionar funcionalidades de API adicionales.
Además, se agregaron otras funciones, como los comandos de complemento (extensibilidad de la cinta de opciones) y la capacidad de iniciar cuadros de diálogo (Dialog API) a Common API. Los comandos de complemento y los conjuntos de requisitos de la API de cuadro de diálogo son ejemplos de conjuntos de API que varias aplicaciones de Office comparten en común.
Un complemento solo puede usar las API en conjuntos de requisitos compatibles con la versión de la aplicación de Office en la que se ejecuta el complemento. Para saber exactamente qué conjuntos de requisitos están disponibles para una versión específica de la aplicación de Office, consulte los siguientes artículos del conjunto de requisitos específicos de la aplicación.
- Conjuntos de requisitos de la API de JavaScript de Excel (ExcelApi)
- Conjuntos de requisitos de la API de JavaScript de OneNote (OneNoteApi)
- Conjuntos de requisitos de la API de JavaScript de Outlook (buzón)
- Conjuntos de requisitos de la API de JavaScript de PowerPoint (PowerPointApi)
- Conjuntos de requisitos de la API de JavaScript de Word (WordApi)
Algunos conjuntos de requisitos contienen API que pueden usar varias aplicaciones de Office. Para obtener información sobre estos conjuntos de requisitos, consulte los artículos siguientes.
- Conjuntos de requisitos comunes de Office
- Conjuntos de requisitos de comandos de complemento
- Conjuntos de requisitos del servicio de permisos de dispositivo
- Conjuntos de requisitos de la API de cuadros de diálogo
- Conjuntos de requisitos de origen del cuadro de diálogo
- Conjuntos de requisitos de la API de identidad
- Conjuntos de requisitos de coerción de imágenes.
- Conjuntos de requisitos de métodos abreviados de teclado
- Conjuntos de requisitos de autenticación de aplicaciones anidadas
- Conjuntos de requisitos para abrir la ventana del explorador
- Conjuntos de requisitos de la API de cinta de opciones
- Conjuntos de requisitos del motor en tiempo de ejecución compartido
El número de versión de un conjunto de requisitos, como "1.1" en ExcelApi 1.1, es relativo a la aplicación de Office. El número de versión de un conjunto de requisitos determinado (por ejemplo, ExcelApi 1.1) no corresponde al número de versión de Office.js ni a los conjuntos de requisitos para otras aplicaciones de Office (por ejemplo, Word, Outlook, etc.). Los conjuntos de requisitos para las distintas aplicaciones de Office se publican a diferentes velocidades. Por ejemplo, ExcelApi 1.5 se publicó antes del conjunto de requisitos WordApi 1.3.
La biblioteca de API de JavaScript de Office (Office.js) incluye todos los conjuntos de requisitos que están disponibles actualmente. Aunque existen los conjuntos de requisitos ExcelApi 1.3 y WordApi 1.3, no hay ningún conjunto de requisitos Office.js 1.3. La versión más reciente de Office.js se mantiene como un único punto de conexión de Office que se entrega a través de la red de entrega de contenido (CDN). Para obtener más información sobre la red CDN de Office.js, incluido cómo se controlan el control de versiones y la compatibilidad con versiones anteriores, consulte Descripción de la API de JavaScript de Office.
Especificar las aplicaciones y los conjuntos de requisitos de Office
Hay varias maneras de especificar qué aplicaciones y conjuntos de requisitos de Office son necesarios para un complemento. Para obtener información detallada, vea Especificar aplicaciones de Office y requisitos de API.