Complementos contextuales de Outlook

  • Artículo

Los complementos contextuales son complementos de Outlook que se activan en función del texto de un mensaje o una cita. Mediante el uso de complementos contextuales, un usuario puede iniciar tareas relacionadas con un mensaje sin salir del propio mensaje, lo que da como resultado una experiencia de usuario más fácil y completa.

Importante

Los complementos contextuales de Outlook basados en entidades se retirarán en el segundo trimestre de 2024. El trabajo para retirar esta característica comenzará en mayo y continuará hasta finales de junio. Después de junio, los complementos contextuales ya no podrán detectar entidades en elementos de correo para realizar tareas en ellos. También se retirarán las siguientes API.

Para ayudar a minimizar las posibles interrupciones, se seguirá admitiendo lo siguiente después de que se retiren los complementos contextuales basados en entidades.

  • Se está desarrollando una implementación alternativa del botón Unirse a la reunión , que se activa mediante complementos de reunión en línea. Una vez finalizada la compatibilidad con complementos contextuales basados en entidades, los complementos de reunión en línea pasarán automáticamente a la implementación alternativa para activar el botón Unirse a la reunión .
  • Las reglas de expresión regular seguirán siendo compatibles después de retirar los complementos contextuales basados en entidades. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Usar reglas de activación de expresiones regulares para mostrar un complemento de Outlook.

Para obtener más información, vea Retirada de complementos contextuales de Outlook basados en entidades.

A continuación se muestran ejemplos de complementos contextuales.

  • Seleccionar una dirección para abrir un mapa de la ubicación.
  • Hacer clic en una cadena que abre un complemento de sugerencia de reunión.
  • Seleccionar un número de teléfono para agregar contactos.

Cómo crear un complemento contextual

Nota:

Los complementos contextuales de Outlook no se admiten cuando el complemento usa un manifiesto unificado para Microsoft 365 (versión preliminar).

En un manifiesto de complemento contextual, es necesario incluir un elemento ExtensionPoint con un atributo xsi:type establecido en DetectedEntity. Dentro del <elemento ExtensionPoint> , el complemento especifica las entidades o expresiones regulares que pueden activarlo. Si se especifica una entidad, esta puede ser cualquiera de las propiedades del objeto Entities.

Por tanto, el manifiesto de complemento necesita contener una regla del tipo ItemHasKnownEntity o ItemHasRegularExpressionMatch. En el ejemplo siguiente se muestra cómo especificar que un complemento debe activarse en los mensajes con una entidad detectada que sea un número de teléfono.

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="contextLabel" />
  <!--If you opt to include RequestedHeight, it must be between 140px to 450px, inclusive.-->
  <!--<RequestedHeight>360</RequestedHeight>-->
  <SourceLocation resid="detectedEntityURL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message" />
    <Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />
  </Rule>
</ExtensionPoint>

Cuando un complemento contextual esté asociado a una cuenta, se iniciará automáticamente cuando el usuario haga clic en una expresión regular o una entidad resaltada. Para más información sobre el uso de expresiones regulares con complementos de Outlook, vea Usar reglas de activación de expresiones regulares para mostrar un complemento de Outlook.

Hay varias restricciones sobre los complementos contextuales:

  • Un complemento contextual solo puede existir en complementos de lectura (no en complementos de redacción).
  • No se puede especificar el color de la entidad resaltada.
  • Una entidad que no esté resaltada no iniciará un complemento contextual en una tarjeta.

Debido a que una entidad o expresión regular que no esté resaltada no iniciará un complemento contextual, los complementos deben incluir al menos un elemento Rule con el atributo Highlight establecido como all.

Nota:

Los EmailAddress tipos de entidad y Url no admiten el resaltado, por lo que no se pueden usar para iniciar un complemento contextual. Sin embargo, se pueden combinar en un RuleCollection tipo de regla como criterios de activación adicionales.

Cómo iniciar un complemento contextual

Un usuario inicia un complemento contextual a través del texto, ya sea una entidad conocida o una expresión regular del desarrollador. Normalmente, un usuario identifica un complemento contextual porque la entidad está resaltada. El siguiente ejemplo muestra cómo aparece el resaltado en un mensaje. Aquí, la entidad (una dirección) está coloreada en azul y subrayada con una línea azul de puntos. Un usuario inicia el complemento contextual haciendo clic en la entidad resaltada.

Muestra la entidad resaltada dentro de un correo electrónico.

Cuando hay varias entidades o complementos contextuales en un mensaje, hay unas cuantas reglas de interacción del usuario:

  • Si hay varias entidades, el usuario debe hacer clic en una entidad diferente para iniciar el complemento para este.
  • Si una entidad activa varios complementos, cada complemento abre una nueva pestaña. El usuario pasa de una pestaña a otra para ir de un complemento a otro. Por ejemplo, un nombre y una dirección podrían desencadenar un complemento de teléfono y un mapa.
  • Si una única cadena contiene varias entidades que activan varios complementos, se resalta la cadena completa y, al hacer clic, en la cadena se muestran todas los complementos relacionados con la cadena en pestañas diferentes. Por ejemplo, una cadena que describe una propuesta de reunión en un restaurante podría activar el complemento de reunión sugerida y un complemento de clasificación de restaurantes.

Cómo se muestra un complemento contextual

Un complemento contextual activado aparece en una tarjeta, que es una ventana independiente cerca de la entidad. La tarjeta aparecerá normalmente debajo de la entidad y se centra respecto a esta tanto como sea posible. Si no hay suficiente espacio debajo de la entidad, la tarjeta se coloca encima de ella.

Muestra una entidad de dirección resaltada y el complemento de Mapas de Bing activado.

Para cerrar la tarjeta y el complemento, el usuario hace clic en cualquier lugar fuera de la tarjeta.

Complementos contextuales actuales

Los siguientes complementos contextuales se instalan de forma predeterminada para los usuarios con complementos de Outlook.

  • Mapas de Bing
  • Reuniones sugeridas

Vea también