Información general sobre los complementos de OutlookOutlook add-ins overview

Los complementos de Outlook son integraciones creadas por terceros en Outlook con la nueva plataforma basada en la web.Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Los complementos de Outlook se caracterizan por tres aspectos fundamentales:Outlook add-ins have three key aspects:

  • La misma lógica de negocios y de complementos funciona en las versiones de escritorio (Outlook en Windows y Mac), web (Office 365 y Outlook.com) y móvil.The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Office 365 and Outlook.com), and mobile.
  • Los complementos de Outlook están formados por un manifiesto, que describe cómo se integra el complemento en Outlook (por ejemplo, un botón o un panel de tareas), y por código JavaScript y HTML, que compone la lógica de la interfaz de usuario y la lógica empresarial del complemento.Outlook add-ins consist of a manifest, which describes how the add-in integrates into Outlook (for example, a button or a task pane), and JavaScript/HTML code, which makes up the UI and business logic of the add-in.
  • Los complementos de Outlook se pueden comprar en la AppSource o los usuarios finales o administradores pueden descargarlos localmente.Outlook add-ins can be acquired from AppSource or sideloaded by end-users or administrators.

Los complementos de Outlook son distintos de los de COM o VSTO, que son integraciones anteriores específicas de Outlook que se ejecutan en Windows.Outlook add-ins are different from COM or VSTO add-ins, which are older integrations specific to Outlook running on Windows. A diferencia de los complementos COM, los complementos de Outlook no tienen ningún código físicamente instalado en el dispositivo del usuario o en el cliente de Outlook.Unlike COM add-ins, Outlook add-ins don't have any code physically installed on the user's device or Outlook client. En un complemento de Outlook, Outlook lee el manifiesto y enlaza los controles especificados en la interfaz de usuario, y luego carga el código de JavaScript y HTML.For an Outlook add-in, Outlook reads the manifest and hooks up the specified controls in the UI, and then loads the JavaScript and HTML. Todos los componentes web se ejecutan en el contexto de un explorador en un espacio aislado.The web components all run in the context of a browser in a sandbox.

Entre los elementos de Outlook compatibles con los complementos se incluyen mensajes de correo electrónico, convocatorias, respuestas o cancelaciones de reuniones, y citas.The Outlook items that support add-ins include email messages, meeting requests, responses and cancellations, and appointments. Cada complemento de Outlook define el contexto en el que está disponible, incluidos los tipos de elementos y si el usuario está leyendo o redactando un elemento.Each Outlook add-in defines the context in which it is available, including the types of items and if the user is reading or composing an item.

Nota

Al generar el complemento, si va a publicar el complemento en AppSource, asegúrese de que se ajusta a las directivas de validación de AppSource. Por ejemplo, para superar la validación, el complemento debe funcionar en todas las plataformas que sean compatibles con los métodos especificados (para más información, consulte la sección 4.12 y el host del complemento de Office y la página de disponibilidad).When you build your add-in, if you plan to publish your add-in to AppSource, make sure that you conform to the AppSource validation policies. For example, to pass validation, your add-in must work across all platforms that support the methods that you define (for more information, see section 4.12 and the Office Add-in host and availability page).

Puntos de extensiónExtension points

Los puntos de extensión son la forma en que los complementos se integran con Outlook. La integración se puede hacer de las siguientes maneras:Extension points are the ways that add-ins integrate with Outlook. The following are the ways this can be done:

  • Los complementos pueden declarar los botones que aparecen en superficies de comando a través de mensajes y citas. Para obtener más información, vea Comandos de complementos de Outlook.Add-ins can declare buttons that appear in command surfaces across messages and appointments. For more information, see Add-in commands for Outlook.

    Un complemento con botones de comandos en la cinta de opcionesAn add-in with command buttons on the ribbon

    Forma sin UI de comando de complemento

  • Los complementos pueden desvincular coincidencias de expresiones regulares o entidades detectadas en mensajes y citas. Para obtener más información, vea Complementos de Outlook contextuales.Add-ins can link off regular expression matches or detected entities in messages and appointments. For more information, see Contextual Outlook add-ins.

    Un complemento contextual para una entidad resaltada (una dirección)A contextual add-in for a highlighted entity (an address)

    Muestra una aplicación contextual en una tarjeta

Nota

Los paneles personalizados se han dejado de usar, así que asegúrese de que está usando un punto de extensión admitido.Custom panes have been deprecated so please ensure that you're using a supported extension point.

Elementos del buzón disponibles para los complementosMailbox items available to add-ins

Los complementos de Outlook están disponibles en los mensajes o citas mientras se redactan o leen, pero no en otros elementos. Outlook no activa complementos si el elemento de mensaje actual de un formulario de redacción o lectura cumple una de las condiciones siguientes:Outlook add-ins are available on messages or appointments while composing or reading, but not other item types. Outlook does not activate add-ins if the current message item, in a compose or read form, is one of the following:

  • Está protegido por Information Rights Management (IRM) o cifrado de otras formas de protección. Un mensaje firmado digitalmente es un ejemplo, puesto que la firma digital se basa en uno de estos mecanismos.Protected by Information Rights Management (IRM) or encrypted in other ways for protection. A digitally signed message is an example since digital signing relies on one of these mechanisms.

  • Es un informe o una notificación de entrega que tiene la clase de mensaje IPM.Report.*, como los informes de entrega y los informes de no entrega (NDR) y las notificaciones de leído, no leído y con retraso.A delivery report or notification that has the message class IPM.Report.*, including delivery and Non-Delivery Report (NDR) reports, and read, non-read, and delay notifications.

  • Es un borrador (no tiene asignado ningún destinatario), o está actualmente en la carpeta Borradores de Outlook.A draft (does not have a sender assigned to it), or in the Outlook Drafts folder.

  • Un archivo .msg o .eml que está adjunto a otro mensaje.A .msg or .eml file which is an attachment to another message.

  • Un archivo .msg o .eml abierto desde el sistema de archivos.A .msg or .eml file opened from the file system.

  • En un buzón compartido, en el buzón de otro usuario, en un buzón de archivo o en una carpeta pública.In a shared mailbox, in another user's mailbox, in an archive mailbox, or in a public folder.

  • Uso de un formulario personalizado.Using a custom form.

Por lo general, Outlook puede activar complementos en formularios de lectura para elementos de la carpeta Elementos enviados, excepto los complementos que se activan en función de coincidencias de entidades conocidas.In general, Outlook can activate add-ins in read form for items in the Sent Items folder, with the exception of add-ins that activate based on string matches of well-known entities. Para obtener más información sobre los motivos por los que esto ocurre, consulte "Compatibilidad con entidades conocidas" en Coincidencia de cadenas en un elemento de Outlook como entidades conocidas.For more information about the reasons behind this, see "Support for well-known entities" in Match strings in an Outlook item as well-known entities.

Host compatiblesSupported hosts

Los complementos de Outlook se admiten en Outlook 2013 o versiones posteriores en Windows, Outlook 2016 o versiones posteriores en Mac, Outlook en la Web para Exchange 2013 local y versiones posteriores, Outlook en iOS, Outlook en Android, Outlook en la Web en Office 365 y Outlook.com.Outlook add-ins are supported in Outlook 2013 or later on Windows, Outlook 2016 or later on Mac, Outlook on the web for Exchange 2013 on-premises and later versions, Outlook on iOS, Outlook on Android, and Outlook on the web in Office 365 and Outlook.com. No todas las características más recientes se admiten en todos los clientes al mismo tiempo.Not all of the newest features are supported in all clients at the same time. Consulte esas características en los artículos y referencias de API para ver en qué hosts se pueden admitir o no.Please refer to articles and API references for those features to see which hosts they may or may not be supported in.

Introducción a la compilación de complementos de OutlookGet started building Outlook add-ins

Para comenzar a compilar complementos de Outlook, pruebe lo siguiente.To get started building Outlook add-ins, try the following.

  • Inicio rápido: cree un sencillo panel de tareas.Quick start - Build a simple task pane.
  • Tutorial: infórmese sobre cómo crear un complemento que inserte un gist de GitHub en un nuevo mensaje.Tutorial - Learn how to create an add-in that inserts GitHub gists into a new message.

Vea tambiénSee also