Hinzufügen von Unterstützung für Add-In-Befehle für Outlook MobileAdd support for add-in commands for Outlook Mobile

Durch Verwendung von Add-In-Befehlen in Outlook Mobile können Benutzer auf die gleichen Funktionen (mit einigen Einschränkungen) zugreifen, die sie bereits in Outlook für Windows, Outlook für Mac und Outlook im Web hatten. Um Unterstützung für Outlook Mobile hinzuzufügen, müssen Sie das Add-In-Manifest aktualisieren und möglicherweise den Code für mobile Szenarien ändern.Using add-in commands in Outlook Mobile allows your users to access the same functionality (with some limitations) that they already have in Outlook for Windows, Outlook for Mac, and Outlook on the web. Adding support for Outlook Mobile requires updating the add-in manifest and possibly changing your code for mobile scenarios.

Aktualisieren des ManifestsUpdating the manifest

Der erste Schritt beim Aktivieren der Add-In-Befehle in Outlook Mobile ist die Definition dieser im Add-In-Manifest. Version 1.1 des VersionOverrides-Schemas definiert einen neuen Formfaktor für mobile Umgebungen, MobileFormFactor.The first step to enabling add-in commands in Outlook Mobile is to define them in the add-in manifest. The VersionOverrides v1.1 schema defines a new form factor for mobile, 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.This element contains all of the information for loading the add-in in mobile clients. This enables you to define completely different UI elements and JavaScript files for the mobile experience.

Das folgende Beispiel zeigt eine einzelne Aufgabenbereichsschaltfläche in einem MobileFormFactor-Element.The following example shows a single taskpane button in a 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 den Elementen, die in einem DesktopFormFactor-Element enthalten sind, wobei einige wichtige Unterschiede erkennbar sind.This is very similar to the elements that appear in a DesktopFormFactor element, with some notable differences.

  • Das OfficeTab-Element wird nicht verwendet.The OfficeTab element is not used.
  • Das ExtensionPoint-Element darf nur ein untergeordnetes Element enthalten. Wenn das Add-In nur eine Schaltfläche hinzufügt, sollte das untergeordnete Element ein Control-Element sein. Wenn das Add-In mehr als eine Schaltfläche hinzufügt, sollte das untergeordnete Element ein Group-Element sein, das mehrere Control-Elemente enthält.The ExtensionPoint element must have only one child element. If the add-in only adds one button, the child element should be a Control element. If the add-in adds more than one button, the child element should be a Group element that contains multiple Control elements.
  • Es gibt kein Äquivalent vom Typ Menu für das Control-Element.There is no Menu type equivalent for the Control element.
  • Das Supertip-Element wird nicht verwendet.The Supertip element is not used.
  • Die erforderlichen Symbolgrößen weichen ab. Mobile Add-Ins müssen mindestens Symbole mit einer Größe von 25 x 25, 32 x 32 und 48 x 48 unterstützen.The required icon sizes are different. Mobile add-ins minimally must support 25x25, 32x32 and 48x48 pixel icons.

CodeüberlegungenCode considerations

Beim Entwerfen eines Add-Ins für mobile Umgebungen müssen zusätzliche Aspekte berücksichtigt werden.Designing an add-in for mobile introduces some additional considerations.

Verwenden Sie REST anstelle von Exchange-Webdiensten.Use REST instead of Exchange Web Services

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.The Office.context.mailbox.makeEwsRequestAsync method is not supported in Outlook Mobile. Add-ins should prefer to get information from the Office.js API when possible. If add-ins require information not exposed by the Office.js API, then they should use the Outlook REST APIs to access the user's mailbox.

In dem Postfachanforderungssatz 1.5 werden eine neue Version des Office.context.mailbox.getCallbackTokenAsync-Elements eingeführt, mit der ein mit den REST-APIs kompatibles Zugriffstoken angefordert werden kann, sowie eine neue Office.context.mailbox.restUrl-Eigenschaft, die für die Suche des REST-API-Endpunkts für den Benutzer verwendet werden kann.Mailbox requirement set 1.5 introduces a new version of Office.context.mailbox.getCallbackTokenAsync that can request an access token compatible with the REST APIs, and a new Office.context.mailbox.restUrl property that can be used to find the REST API endpoint for the user.

VergrößernPinch zoom

Standardmäßig können Benutzer den Fingereingabemodus „Vergrößern“ in Aufgabenbereichen verwenden. Wenn dies für Ihr Szenario nicht sinnvoll ist, deaktivieren Sie den Freigabemodus „Vergrößern“ in Ihrem HTML-Code.By default users can use the "pinch zoom" gesture to zoom in on taskpanes. If this does not make sense for your scenario, be sure to disable pinch zoom in your HTML.

Schließen von AufgabenbereichenClosing taskpanes

In Outlook Mobile werden Aufgabenbereiche auf dem gesamten Bildschirm angezeigt. Benutzer müssen sie schließen, um zur Nachricht zurückzukehren. Verwenden Sie ggf. dieOffice.context.ui.closeContainer-Methode, um den Aufgabenbereich zu schließen, wenn Ihr Szenario abgeschlossen ist.In Outlook Mobile, taskpanes take up the entire screen and by default require the user to close them to return to the message. Consider using the Office.context.ui.closeContainer method to close the taskpane when your scenario is complete.

Verfassenmodus und TermineCompose mode and appointments

Aktuell wird in Add-Ins in Outlook Mobile nur die Aktivierung beim Lesen von Nachrichten unterstützt. Add-Ins sind beim Verfassen von Nachrichten oder beim Anzeigen oder Verfassen von Terminen nicht aktiviert.Currently add-ins in Outlook Mobile only support activation when reading messages. Add-ins are not activated when composing messages or when viewing or composing appointments.

Nicht unterstützte APIsUnsupported APIs

Die folgenden APIs werden von Outlook Mobile nicht unterstützt.The following APIs are not supported by Outlook Mobile.