Hinzufügen von Unterstützung für Add-In-Befehle in Outlook auf mobilen Geräten

  • Artikel

Die Verwendung von Add-In-Befehlen in Outlook auf mobilen Geräten ermöglicht Es Ihren Benutzern, auf die gleiche Funktionalität (mit einigen Einschränkungen) zuzugreifen, die sie bereits in Outlook im Web, unter Windows (klassisch und neu (Vorschau)) und unter Mac haben. Um Unterstützung für Outlook Mobile hinzuzufügen, müssen Sie das Add-In-Manifest aktualisieren und möglicherweise Ihren Code für mobile Szenarien ändern.

Aktualisieren des Manifests

Hinweis

Add-Ins, die das einheitliche Manifest für Microsoft 365 (Vorschau) verwenden, werden auf mobilen Geräten derzeit nicht unterstützt.

Der erste Schritt zum Aktivieren von Add-In-Befehlen in Outlook Mobile besteht darin, sie im Add-In-Manifest zu definieren. Version 1.1 des VersionOverrides-Schemas definiert einen neuen Formfaktor für mobile Umgebungen, MobileFormFactor.

Dieses Element enthält alle Informationen zum Laden des Add-Ins in mobilen Clients. Mit diesem Element können Sie komplett andere Benutzeroberflächenelemente und JavaScript-Dateien für die mobile Erfahrung definieren.

Das folgende Beispiel zeigt eine einzelne Aufgabenbereich-Schaltfläche in einem <MobileFormFactor-Element> .

<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>

Dieses ähnelt stark Elementen, die in einem DesktopFormFactor-Element enthalten sind, wobei einige wichtige Unterschiede erkennbar sind.

Codeüberlegungen

Beim Entwerfen eines Add-Ins für mobile Umgebungen müssen zusätzliche Aspekte berücksichtigt werden.

Verwenden Sie REST anstelle von Exchange-Webdiensten.

Die Office.context.mailbox.makeEwsRequestAsync-Methode wird in Outlook Mobile nicht unterstützt. Add-Ins sollten nach Möglichkeit das Abrufen von Informationen aus der Office.js-API vorziehen. Wenn Add-Ins Informationen erfordern, die nicht von der Office.js-API zur Verfügung gestellt werden, sollten sie die Outlook-REST-APIs für den Zugriff auf das Postfach des Benutzers verwenden.

Im Postfachanforderungssatz 1.5 wurde eine neue Version von Office.context.mailbox.getCallbackTokenAsync eingeführt, die ein mit den REST-APIs kompatibles Zugriffstoken anfordern kann, sowie eine neue Office.context.mailbox.restUrl-Eigenschaft , die verwendet werden kann, um den REST-API-Endpunkt für den Benutzer zu finden.

Vergrößern

Standardmäßig können Benutzer die Geste "Zoom zusammendrücken" verwenden, um Aufgabenbereiche zu vergrößern. Wenn dies für Ihr Szenario nicht sinnvoll ist, deaktivieren Sie den Zoom in Ihrem HTML-Code.

Schließen von Aufgabenbereichen

In Outlook Mobile nehmen Aufgabenbereiche den gesamten Bildschirm ein und erfordern standardmäßig, dass der Benutzer sie schließen muss, um zur Nachricht zurückzukehren. Erwägen Sie die Verwendung der Office.context.ui.closeContainer-Methode , um den Aufgabenbereich zu schließen, wenn Ihr Szenario abgeschlossen ist.

Verfassenmodus und Termine

Derzeit unterstützen Add-Ins in Outlook Mobile nur die Aktivierung beim Lesen von Nachrichten. Add-Ins werden beim Verfassen von Nachrichten oder beim Anzeigen oder Verfassen von Terminen nicht aktiviert. Es gibt jedoch Ausnahmen.

  1. Integrierte Add-Ins des Onlinebesprechungsanbieters werden im Terminorganisationsmodus aktiviert. Weitere Informationen zu dieser Ausnahme (einschließlich verfügbarer APIs) finden Sie unter Erstellen eines mobilen Outlook-Add-Ins für einen Onlinebesprechungsanbieter.
  2. Add-Ins, die Terminnotizen und andere Details zu Customer Relationship Management (CRM) oder Notizendiensten protokollieren, werden im Terminteilnehmermodus aktiviert. Weitere Informationen zu dieser Ausnahme (einschließlich verfügbarer APIs) finden Sie unter Protokollieren von Terminnotizen für eine externe Anwendung in mobilen Outlook-Add-Ins.
  3. Ereignisbasierte Add-Ins werden aktiviert, wenn das OnNewMessageCompose Ereignis eintritt. Weitere Informationen zu dieser Ausnahme (einschließlich zusätzlicher unterstützter APIs) finden Sie unter Implementieren der ereignisbasierten Aktivierung in mobilen Outlook-Add-Ins.

Unterstützte APIs

Obwohl Outlook Mobile bis zum Postfachanforderungssatz 1.5 unterstützt, können Sie jetzt zusätzliche APIs aus späteren Anforderungssätzen implementieren, um die Funktionen Ihres Add-Ins auf Outlook Mobile weiter zu erweitern. Eine Anleitung dazu, welche APIs Sie in Ihrem mobilen Add-In implementieren können, finden Sie unter Outlook JavaScript-APIs, die in Outlook auf mobilen Geräten unterstützt werden.

Siehe auch