Información sobre los conocimientos básicos de complementos de Office
La plataforma Complementos de Office le permite ampliar la funcionalidad de las aplicaciones de Office. En esta unidad, explorará las diferentes formas en que puede usar los complementos para ampliar e interactuar con las aplicaciones de Office. También obtendrá información sobre cómo configurar el complemento con el archivo de manifiesto del complemento.
Entender el panel de tareas y los complementos de contenido
Complementos de Office ofrece varias opciones para que su solución pueda interactuar con una aplicación de Office. En esta unidad analizamos dos de estas opciones:
- Panel de tareas
- Contenido
Complementos de panel de tareas
Los complementos del panel de tareas permiten la interacción del usuario a través de un panel que se muestra en una aplicación de Office. A través de la interfaz del panel de tareas, puede permitir al usuario modificar documentos o correos electrónicos, ver datos de un origen de datos y mucho más. En la siguiente imagen, el panel de tareas es el panel que se muestra a la derecha del documento.
Complemento de panel de tareas que se muestra dentro de una aplicación de Office
En las versiones más recientes de Word, Excel y PowerPoint, puede configurar el panel de tareas para que se muestre automáticamente cuando un usuario abre un archivo. El usuario necesitará tener instalado primero el complemento para activar este comportamiento.
Definir el tipo de complemento del panel de tareas
Como se describió anteriormente, el archivo de manifiesto de un complemento define la configuración y las capacidades del complemento.
Para configurar un complemento como complemento del panel de tareas para cualquier aplicación de Office excepto Outlook, establezca el atributo xsi:type en TaskPaneApp dentro del elemento OfficeApp del archivo de manifiesto, tal y como se muestra en el siguiente ejemplo.
<OfficeApp
...
xsi:type="TaskPaneApp">
...
</OfficeApp>
Para configurar un complemento para Outlook, establezca el atributo xsi:type en MailApp dentro del elemento OfficeApp del archivo de manifiesto, tal y como se muestra en el siguiente ejemplo.
<OfficeApp
...
xsi:type="MailApp">
...
</OfficeApp>
Complementos de contenido
Los complementos de contenido se pueden usar para insertar un objeto en una hoja de cálculo de Excel o una presentación de PowerPoint. Ese objeto puede ser una visualización de datos basada en la web, medios u otro contenido externo. En la siguiente imagen, el complemento de contenido se muestra cerca del centro del documento.
Complemento de contenido cargado en una aplicación de Office
Definir el tipo de complemento de contenido
Como se describió anteriormente, el archivo de manifiesto de un complemento define la configuración y las capacidades del complemento. Para configurar un complemento como complemento de contenido, establezca el atributo xsi:type en ContentApp dentro del elemento OfficeApp del archivo de manifiesto, tal y como se muestra en el siguiente ejemplo.
<OfficeApp
...
xsi:type="ContentApp">
...
</OfficeApp>
Entender los cuadros de diálogo de Complementos de Office
La plataforma Complementos de Office le permite mostrar un cuadro de diálogo para que los usuarios:
- Inicien sesión en un servicio integrado (por ejemplo, para que se autentiquen con una cuenta de Microsoft, Google o Facebook).
- Confirmen la acción del usuario.
- Ejecuten una tarea que puede estar demasiado limitada a un panel de tareas (por ejemplo, ver un vídeo).
La ventana de diálogo no es modal, lo que significa que el usuario puede seguir interactuando con la aplicación de Office y con el complemento, mientras se muestra la ventana de diálogo. La imagen siguiente exhibe un cuadro de diálogo que se muestra en una aplicación de Office.
Cuadro de diálogo mostrado en una aplicación de Office
Entender las funciones personalizadas de Complementos de Office
Complementos de Office permite crear funciones de JavaScript o TypeScript personalizadas a las que se puede tener acceso, entre ellas las funciones integradas de Excel como SUM().
La imagen siguiente muestra una función personalizada denominada SPHEREVOLUME introducida en Excel.
Función personalizada que se introduce en Excel
El siguiente ejemplo de código muestra el código JavaScript para la función SPHEREVOLUME() que se ha mostrado anteriormente.
/**
* Returns the volume of a sphere.
* @customfunction
* @param {number} radius
*/
function sphereVolume(radius) {
return (Math.pow(radius, 3) * 4 * Math.PI) / 3;
}
¿Dónde puede usar funciones personalizadas?
Las funciones personalizadas están disponibles en Excel en las siguientes plataformas.
- Windows (conectado a una suscripción de Microsoft 365)
- macOS (conectado a una suscripción de Microsoft 365)
- Explorador web
Definir el tipo de complemento de la función personalizada
Para configurar un complemento para que contenga funciones personalizadas, la configuración clave del manifiesto es la siguiente para los complementos de Excel.
<OfficeApp
...
xsi:type="TaskPaneApp">
...
<Hosts>
<Host Name="Workbook"/>
</Hosts>
...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
<Hosts>
<Host xsi:type="Workbook">
<AllFormFactors>
<ExtensionPoint xsi:type="CustomFunctions">
...
</ExtensionPoint>
</AllFormFactors>
</Host>
</Hosts>
...
</VersionOverrides>
</OfficeApp>
Entender los comandos del complemento
Los comandos de complementos son elementos de interfaz de usuario que amplían la interfaz de usuario de Office e inician acciones en el complemento. Puede utilizar comandos de complementos para agregar un botón en la cinta de opciones o un elemento a un menú contextual. Cuando los usuarios seleccionan un comando, inician acciones como ejecutar código JavaScript o mostrar una página de complemento en un panel de tareas. Los comandos de complementos ayudan a los usuarios a encontrar y utilizar el complemento, que puede ayudar a aumentar la adopción y reutilización de su complemento y mejorar la retención de los clientes.
Comandos de complementos en Excel, Word, PowerPoint y OneNote
Puede configurar un complemento para que un usuario pueda ejecutarlo seleccionando:
- Cinta de opciones o botón de menú de desbordamiento de comandos de la aplicación de Office
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="PrimaryCommandSurface">.
- Configuración de manifiesto clave:
- Elemento de menú contextual
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="ContextMenu">.
- Configuración de manifiesto clave:
Un comando de complemento también puede abrir un submenú con más comandos.
Nota:
Actualmente, los complementos de contenido no admiten los comandos de complementos.
En la imagen siguiente se muestran tres comandos de complemento (botones personalizados) agregados a la pestaña Datos de la cinta de opciones de Excel.
Comandos de complemento de Excel en Windows
Comandos de complemento en Outlook
Puede configurar un complemento para que un usuario pueda ejecutarlo seleccionando un botón de la cinta de opciones de Office o del menú de desbordamiento de comandos cuando el usuario:
- está leyendo un mensaje en el panel de lectura o en una ventana emergente.
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="MessageReadCommandSurface">.
- Configuración de manifiesto clave:
- Redactar un mensaje.
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="MessageComposeCommandSurface">.
- Configuración de manifiesto clave:
- Crear o ver una cita o reunión como organizador.
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">.
- Configuración de manifiesto clave:
- Ver una reunión como asistente.
- Configuración de manifiesto clave:
<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">.
- Configuración de manifiesto clave:
Un comando de complemento también puede abrir un submenú con más comandos.
Las siguientes imágenes muestran tres comandos de complemento (botones personalizados) agregados a la cinta de opciones de Outlook. En la primera imagen, los botones se representan en un estado normal; en la segunda imagen, los botones se representan en estado contraído.
Comandos de complementos en Outlook en Windows
¿Dónde puede usar comandos de complemento?
Los comandos de complemento están disponibles en Excel, Outlook, OneNote, PowerPoint y Word, tal y como se muestra en la tabla siguiente.
| Plataforma | Versión principal de Office | ¿Suscripción o compra de pago único? | Notas |
|---|---|---|---|
| Windows | No aplicable | conectado a la suscripción de Microsoft 365 | No disponible en OneNote |
| 2021 | pago único | No disponible en OneNote | |
| 2019 | pago único | No disponible en OneNote | |
| 2016 | pago único | Solo está disponible en Outlook en Exchange 2016 (requiere una actualización posterior al lanzamiento) o una versión posterior. No está disponible en otras aplicaciones de Office. | |
| 2013 | pago único | Solo está disponible en Outlook en Exchange 2016 o una versión posterior. Requiere actualizaciones posteriores a la versión para Outlook y Exchange 2016. No está disponible en otras aplicaciones de Office. | |
| macOS | No aplicable | conectado a la suscripción de Microsoft 365 | No disponible en OneNote |
| 2021 | pago único | No disponible en OneNote | |
| 2019 | pago único | No disponible en OneNote | |
| 2016 | pago único | No disponible en OneNote | |
| iOS | No aplicable | conectado a la suscripción de Microsoft 365 | Solo disponible en Outlook |
| Android | No aplicable | conectado a la suscripción de Microsoft 365 | Solo disponible en Outlook |
| explorador web | No aplicable | No aplicable | Disponible en todas las aplicaciones compatibles de Office |
Entender el propósito del manifiesto del complemento
El archivo de manifiesto XML de un complemento de Office define la configuración y las capacidades del complemento. Puede configurarlo para controlar cómo se representa el complemento y cómo se comporta en las aplicaciones de Office de destino.
Qué define el manifiesto
En el manifiesto, definirá información clave sobre el complemento, que incluye:
- Metadatos de complemento (por ejemplo, id., versión, descripción, nombre para mostrar, configuración regional predeterminada)
- Información sobre cómo el complemento se integra con Office (por ejemplo, aplicaciones de destino, funciones personalizadas, comandos de complemento)
- Ubicación de imágenes que el complemento debe usar para la personalización de marca y la iconografía del comando
- Permisos que requiere el complemento
- Dimensiones del complemento (por ejemplo, dimensiones predeterminadas para complementos de contenido, altura solicitada para complementos de Outlook)
- Reglas que especifican cuándo debe activarse el complemento en un mensaje o cita (solo para Outlook)
Cómo se usa el manifiesto
El manifiesto de un complemento se usa de las siguientes maneras:
- Las aplicaciones de Office donde se ejecuta el complemento usan información del manifiesto para representar la interfaz de usuario del complemento y conectar botones o entradas de menú personalizados.
- Si publica el complemento en AppSource:
- La información del manifiesto (nombre, descripción, autor, logotipo, etc.) se usa para crear la entrada de la aplicación que se muestra a los posibles clientes en AppSource.
- El proceso de validación de AppSource lee la información del manifiesto y valida que el complemento se ejecuta en las plataformas esperadas.
Resumen
La plataforma Complementos de Office le permite ampliar la funcionalidad de las aplicaciones de Office. En esta unidad, ha explorado las diferentes formas en que puede usar los complementos para ampliar e interactuar con las aplicaciones de Office. También ha aprendido a configurar el complemento con el archivo de manifiesto del complemento.