Поделиться через

Добавлена поддержка команд надстроек в Outlook на мобильных устройствах

Реализуйте команды надстроек в Outlook на мобильных устройствах, чтобы получить доступ к той же функциональности (с некоторыми ограничениями), что и в Outlook в Интернете, в Windows (новой и классической) и на Mac. Чтобы добавить поддержку Outlook Mobile, необходимо обновить манифест надстройки и, возможно, изменить код для мобильных сценариев.

Обновление манифеста

Первым шагом к включению команд надстроек в Outlook Mobile является определение их в манифесте надстройки.

Примечание.

Надстройки, использующие унифицированный манифест для Microsoft 365, не поддерживаются непосредственно в Outlook на мобильных устройствах. Чтобы запустить надстройку этого типа на мобильных платформах, ее необходимо сначала опубликовать в Microsoft Marketplace, а затем развернуть в Центре Microsoft 365 Admin. Дополнительные сведения см. в разделе Поддержка надстроек с унифицированным манифестом для Microsoft 365.

  1. В массиве "extensions.ribbons.requirements.formFactors" добавьте "mobile" как элемент. По завершении массив должен выглядеть следующим образом.

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

  2. Если ваша надстройка использует режим участника встречи, например надстройка, которая интегрирует поставщика приложения для создания заметок или управления отношениями с клиентами (CRM), добавьте "logEventMeetingDetailsAttendee" в "extensions.ribbons.contexts" массив. Ниже приведен пример.

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

  3. Если надстройка использует интегрированный поставщик собраний по сети, добавьте "onlineMeetingDetailsOrganizer" в "extensions.ribbons.contexts" массив. Ниже приведен пример.

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

  4. В массиве найдите "extensions.ribbons.tabs" вкладку с параметром "TabDefault""builtInTabId" . Добавьте в него дочерний "customMobileRibbonGroups" массив (в качестве однорангового узла существующего "groups" свойства). Внутри этого массива создайте объект и выполните следующие действия:

    • Задайте соответствующие "id" значения и "label" .
    • Создайте объект в массиве "controls" для представления кнопки и настройте его следующим образом.
      • Задайте соответствующие "id" значения и "label" . Чтобы кнопка правильно помещалась на ленте, рекомендуется ограничить "label" до 16 символов.
      • Задайте значение "type""mobileButton".
      • Назначьте функцию свойству "actionId" . Он должен соответствовать "id" объекту в массиве "extensions.runtimes.actions" .
      • Убедитесь, что у вас есть все девять необходимых значков.

    Ниже приведен пример.

    "tabs": [
    {
        "builtInTabId": "TabDefault",
        "groups": [
            <-- Non-mobile group objects omitted. -->
        ],
        "customMobileRibbonGroups": [
            {
                "id": "mobileApptComposeGroup",
                "label": "Contoso Meeting",
                "controls": [
                    { 
                        "id": "mobileInsertMeetingButton",
                        "label": "Add meeting",
                        "type": "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"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Особенности кода

При разработке надстроек для мобильных устройств возникают некоторые дополнительные особенности.

Использование Microsoft Graph

По мере возможности надстройки должны отдавать предпочтение данным из API Office.js. Если надстройке требуются сведения, не предоставляемые API Office.js, используйте Microsoft Graph для доступа к почтовому ящику пользователя.

Масштабирование жестами

По умолчанию пользователи могут использовать жест "ущемление масштаба" для увеличения масштаба областей задач. Если это не имеет смысла для вашего сценария, обязательно отключите в HTML-коде масштабирование по сжатию.

Закрытие области задач

В Outlook Mobile области задач занимают весь экран и по умолчанию требуют, чтобы пользователь закрыл их, чтобы вернуться к сообщению. Рассмотрите возможность использования метода Office.context.ui.closeContainer , чтобы закрыть область задач по завершении сценария.

Режим создания и встречи

В настоящее время надстройки в Outlook Mobile поддерживают активацию только при чтении сообщений. Надстройки не активируются при создании сообщений или при просмотре или составлении встреч. однако есть и исключения.

  1. Встроенные надстройки поставщика собраний по сети активируются в режиме организатора встреч. Дополнительные сведения об этом исключении (включая доступные API) см. в статье Создание мобильной надстройки Outlook для поставщика собраний по сети.
  2. Надстройки, которые регистрируют заметки о встречах и другие сведения для управления отношениями с клиентами (CRM) или службы создания заметок, активируются в режиме участника встречи. Дополнительные сведения об этом исключении (включая доступные API) см. в статье Заметки о встречах для внешнего приложения в надстройках Outlook для мобильных устройств.
  3. Надстройки на основе событий активируются при возникновении OnNewMessageCompose события. Дополнительные сведения об этом исключении (включая дополнительные поддерживаемые API) см. в разделе Реализация активации на основе событий в надстройках Outlook mobile.

Поддерживаемые API

Хотя Outlook Mobile поддерживает до набора обязательных почтовых ящиков 1.5, теперь вы можете реализовать дополнительные API из более поздних наборов требований, чтобы расширить возможности надстройки в Outlook Mobile. Инструкции по api-интерфейсам, которые можно реализовать в мобильной надстройке, см. в статье API JavaScript для Outlook, поддерживаемые в Outlook на мобильных устройствах.

См. также

  • Last updated on