Agregar compatibilidad con comandos de complemento en Outlook en dispositivos móviles

  • Artículo

El uso de comandos de complemento en Outlook en dispositivos móviles permite a los usuarios acceder a la misma funcionalidad (con algunas limitaciones) que ya tienen en Outlook en la Web, en Windows (clásico y nuevo (versión preliminar)) y en Mac. Para agregar compatibilidad con Outlook Mobile es necesario actualizar el manifiesto del complemento y, posiblemente, cambiar el código para escenarios móviles.

Actualizar el manifiesto

Nota:

Los complementos que usan el manifiesto unificado para Microsoft 365 (versión preliminar) no se admiten actualmente en dispositivos móviles.

El primer paso para habilitar los comandos de complemento en Outlook mobile es definirlos en el manifiesto del complemento. El esquema VersionOverrides v1.1 define un nuevo factor de forma para dispositivos móviles, MobileFormFactor.

Este elemento contiene toda la información para cargar el complemento en clientes móviles. Esto le permite definir completamente diferentes elementos de interfaz de usuario y archivos de JavaScript para la experiencia móvil.

En el ejemplo siguiente se muestra un único botón de panel de tareas en un <elemento MobileFormFactor> .

<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
  ...
  <MobileFormFactor>
    <FunctionFile resid="residUILessFunctionFileUrl" />
    <ExtensionPoint xsi:type="MobileMessageReadCommandSurface">
      <Group id="mobileMsgRead">
        <Label resid="groupLabel" />
        <Control xsi:type="MobileButton" id="TaskPaneBtn">
          <Label resid="residTaskPaneButtonName" />
          <Icon xsi:type="bt:MobileIconList">
            <bt:Image size="25" scale="1" resid="tp0icon" />
            <bt:Image size="25" scale="2" resid="tp0icon" />
            <bt:Image size="25" scale="3" resid="tp0icon" />

            <bt:Image size="32" scale="1" resid="tp0icon" />
            <bt:Image size="32" scale="2" resid="tp0icon" />
            <bt:Image size="32" scale="3" resid="tp0icon" />

            <bt:Image size="48" scale="1" resid="tp0icon" />
            <bt:Image size="48" scale="2" resid="tp0icon" />
            <bt:Image size="48" scale="3" resid="tp0icon" />
          </Icon>
          <Action xsi:type="ShowTaskpane">
            <SourceLocation resid="residTaskpaneUrl" />
          </Action>
        </Control>
      </Group>
    </ExtensionPoint>
  </MobileFormFactor>
  ...
</VersionOverrides>

Esto es muy similar a los elementos que aparecen en un elemento DesktopFormFactor, con algunas diferencias notables.

Consideraciones de código

Diseñar un complemento para dispositivos móviles presenta algunas consideraciones adicionales.

Usar REST en lugar de servicios Web Exchange

El método Office.context.mailbox.makeEwsRequestAsync no se admite en Outlook Mobile. Los complementos deben preferir obtener información de la API de Office.js siempre que sea posible. Si los complementos necesitan información que no expone la API de Office.js, entonces deben usar las API de REST de Outlook para tener acceso al buzón del usuario.

El conjunto de requisitos de buzón 1.5 introdujo una nueva versión de Office.context.mailbox.getCallbackTokenAsync que puede solicitar un token de acceso compatible con las API REST y una nueva propiedad Office.context.mailbox.restUrl que se puede usar para buscar el punto de conexión de la API REST para el usuario.

Gesto de acercamiento

De forma predeterminada, los usuarios pueden usar el gesto "reducir zoom" para acercar los paneles de tareas. Si esto no tiene sentido para su escenario, asegúrese de deshabilitar el zoom de pellizco en el HTML.

Cerrar los paneles de tareas

En Outlook mobile, los paneles de tareas toman toda la pantalla y, de forma predeterminada, requieren que el usuario los cierre para volver al mensaje. Considere la posibilidad de usar el método Office.context.ui.closeContainer para cerrar el panel de tareas cuando se complete el escenario.

Modo de redacción y citas

Actualmente, los complementos de Outlook Mobile solo admiten la activación al leer mensajes. Los complementos no se activan al redactar mensajes o al ver o redactar citas. Sin embargo, existen excepciones.

  1. Los complementos integrados del proveedor de reuniones en línea se activan en el modo organizador de citas. Para obtener más información sobre esta excepción (incluidas las API disponibles), consulte Creación de un complemento móvil de Outlook para un proveedor de reuniones en línea.
  2. Los complementos que registran notas de citas y otros detalles para la administración de relaciones con el cliente (CRM) o los servicios de toma de notas se activan en el modo asistente de cita. Para obtener más información sobre esta excepción (incluidas las API disponibles), vea Registrar notas de citas en una aplicación externa en complementos móviles de Outlook.
  3. Los complementos basados en eventos se activan cuando se produce el OnNewMessageCompose evento. Para obtener más información sobre esta excepción (incluidas las API admitidas adicionales), vea Implementar la activación basada en eventos en complementos móviles de Outlook.

API admitidas

Aunque Outlook Mobile admite hasta el conjunto de requisitos de buzón 1.5, ahora puede implementar API adicionales de conjuntos de requisitos posteriores para ampliar aún más la funcionalidad del complemento en Outlook Mobile. Para obtener instrucciones sobre qué API puede implementar en el complemento móvil, consulte API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

Vea también