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

  • Статья

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

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

Примечание.

Надстройки, использующие манифест Unified для Microsoft 365 (предварительная версия), в настоящее время не поддерживаются на мобильных устройствах.

Первым шагом к включению команд надстроек в Outlook Mobile является определение их в манифесте надстройки. В схеме VersionOverrides версии 1.1 определен новый форм-фактор для мобильных устройств — MobileFormFactor.

Этот элемент содержит все данные для загрузки надстройки в мобильных клиентах. Это позволяет определять совершенно другие элементы пользовательского интерфейса и файлы JavaScript для мобильной версии.

В следующем примере показана одна кнопка области задач в элементе< 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>

Она во многом подобна элементам, которые отображаются в элементе DesktopFormFactor, но имеет некоторые существенные отличия.

  • Элемент OfficeTab не используется.
  • У элемента ExtensionPoint должен быть только один дочерний элемент. Если надстройка реализует точку расширения MobileOnlineMeetingCommandSurface или MobileLogEventAppointmentAttendee , необходимо включить дочерний элемент Control . Если надстройка реализует точку расширения MobileMessageReadCommandSurface , необходимо включить дочерний элемент Group , содержащий несколько <элементов Control> .
  • Для элемента Control> нет эквивалента< типа.Menu
  • Элемент Supertip не используется.
  • Требуются значки других размеров. Мобильные надстройки должны поддерживать как минимум значки размерами 25x25, 32x32 и 48x48 пикселей. Дополнительные сведения см. в разделе Дополнительные требования для мобильных форм-факторов.

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

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

Использование REST вместо веб-служб Exchange

Метод Office.context.mailbox.makeEwsRequestAsync не поддерживается в Outlook Mobile. По мере возможности надстройки должны отдавать предпочтение данным из API Office.js. Если надстройкам требуются сведения, которые не предоставляет API Office.js, то для доступа к почтовому ящику пользователя следует использовать интерфейсы REST API Outlook.

Набор обязательных для почтового ящика 1.5 представил новую версию Office.context.mailbox.getCallbackTokenAsync , которая может запрашивать маркер доступа, совместимый с REST API, и новое свойство Office.context.mailbox.restUrl , которое можно использовать для поиска конечной точки REST API для пользователя.

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

По умолчанию пользователи могут использовать жест "ущемление масштаба" для увеличения масштаба областей задач. Если это не имеет смысла для вашего сценария, обязательно отключите в 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 на мобильных устройствах.

См. также