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

Der erste Schritt zum Aktivieren von Add-In-Befehlen in Outlook Mobile besteht darin, sie im Add-In-Manifest zu definieren.

  1. Fügen Sie im Array "extensions.ribbons.requirements.formFactors" "mobile" als Element hinzu. Wenn Sie fertig sind, sollte das Array wie folgt aussehen.

    "formFactors": [
    "mobile",
    <!-- Typically there will be other form factors listed. -->
]

  2. Wenn Ihr Add-In den Terminteilnehmermodus verwendet, z. B. ein Add-In, das einen Anbieter einer Crm-Anwendung (Note-Taking oder Customer Relationship Management) integriert, fügen Sie dem Array "extensions.ribbons.contexts" "logEventMeetingDetailsAttendee" hinzu. Es folgt ein Beispiel.

    "contexts": [
    "meetingDetailsAttendee",
    "logEventMeetingDetailsAttendee"
],

  3. Wenn Ihr Add-In einen integrierten Onlinebesprechungsanbieter verwendet, fügen Sie "onlineMeetingDetailsOrganizer" zum Array "extensions.ribbons.contexts" hinzu. Es folgt ein Beispiel.

    "contexts": [
    "meetingDetailsOrganizer",
    "onlineMeetingDetailsOrganizer"
],

  4. Suchen Sie im Array "extensions.ribbons.tabs" die Registerkarte mit der "builtInTabId" von "TabDefault". Fügen Sie ein untergeordnetes "customMobileRibbonGroups"-Array hinzu (als Peer der vorhandenen Eigenschaft "groups"). Erstellen Sie in diesem Array ein -Objekt, und führen Sie die folgenden Schritte aus:

    • Legen Sie die entsprechenden Werte für "id" und "label" fest.
    • Create im Array "controls" ein Objekt, das eine Schaltfläche darstellt, und konfigurieren Sie sie wie folgt.
      • Legen Sie die entsprechenden Werte für "id" und "label" fest.
      • Legen Sie "buttonType" auf "MobileButton" fest.
      • Weisen Sie der Eigenschaft "actionId" eine Funktion zu. Dies sollte mit der "ID" des Objekts im Array "extensions.runtimes.actions" übereinstimmen.
      • Stellen Sie sicher, dass Sie über alle neun erforderlichen Symbole verfügen.

    Es folgt ein Beispiel.

    "tabs": [
    {
        "builtInTabId": "TabDefault",
        "groups": [
            <-- non-mobile group objects omitted -->
        ],
        "customMobileRibbonGroups": [
            {
                "id": "mobileApptComposeGroup",
                "label": "Contoso Meeting",
                "controls": [
                    { 
                        "id": "mobileInsertMeetingButton",
                        "label": "Add Meeting",
                        "buttonType": "MobileButton",
                        "actionId": "insertContosoMeeting",
                        "icons": [
                            {
                                "scale": 1,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 1,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 1,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            },                                
                            {
                                "scale": 2,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 2,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 2,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            },                                
                            {
                                "scale": 3,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 3,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 3,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

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