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

Надстройки Outlook с расширением модуля

  • Статья

Надстройки с расширением модуля отображаются на панели навигации Outlook рядом с почтой, задачами и календарями. Расширение модуля не ограничивается использованием почты и сведений о встречах. Вы можете создать приложения, с помощью которых пользователи могут получать доступ к бизнес-информации и средствам повышения производительности, не выходя из Outlook.

Совет

Вместо расширений модулей создайте личные приложения вкладок, которые открываются в Outlook , чтобы предоставить более современное и удобное решение. С помощью личных вкладок пользователи получат доступ к критически важным бизнес-данным и инструментам повышения производительности не только в Outlook, но и в приложениях Microsoft 365, включая Microsoft Teams и различных платформах.

Поддерживаемые клиенты и манифесты

Чтобы создать и запустить надстройки расширения модулей, необходимо:

  • Разработка надстройки с помощью манифеста только надстройки. Манифест Unified для Microsoft 365 не поддерживает расширения модулей.
  • Запустите надстройку в Outlook 2016 или более поздней версии в Windows.

Открытие расширения модуля

Чтобы открыть расширение модуля, перейдите на панель навигации Outlook, выберите Другие приложения, а затем выберите надстройку расширения модуля.

Доступные модули и надстройки расширения модулей во всплывающем элементе Дополнительные приложения.

Совет

В более старых версиях классического Outlook для Windows панель навигации отображается в нижней части окна. Доступ к расширению модуля зависит от макета панели навигации и количества доступных расширений модуля.

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

    Значки модулей и надстроек, отображаемые на компактной панели навигации.

  • Если пользователь не использует компактную навигацию, на панели навигации будет отображаться имя надстройки.

    Имена модулей и надстроек, отображаемые на расширенной панели навигации.

  • Если загружено несколько надстроек, параметры надстройки отображаются на панели навигации. Выберите Надстройки, а затем выберите нужную надстройку.

    Параметр Надстройки, отображаемый на панели навигации, если загружено несколько надстроек.

Настройка расширения модуля

При выборе надстройки расширения модуля Outlook заменяет встроенный модуль пользовательским модулем, чтобы вы могли взаимодействовать с надстройкой. Вы можете использовать некоторые функции API JavaScript для Outlook в надстройке. API, логически предполагающие определенный элемент Outlook, например сообщение или встреча, не работают в расширениях модулей. Модуль также может включать команды функций на ленте Outlook, которые взаимодействуют со страницей надстройки. Чтобы упростить эту задачу, команды функции должны вызывать метод Office.onReady или Office.initialize и метод Event.completed .

Чтобы протестировать и узнать, как настроить расширение модуля, см. пример расширения модуля надстроек Office.

Пользовательский интерфейс примера расширения модуля.

Пример

Ниже показан раздел файла манифеста, который определяет расширение модуля.


<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides"
                  xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1"
                    xsi:type="VersionOverridesV1_1">
    <Requirements>
      <bt:Sets DefaultMinVersion="1.3">
        <bt:Set Name="Mailbox"/>
      </bt:Sets>
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <DesktopFormFactor>
          <!-- Sets the URL of the JavaScript file that contains the code to
               run the operations of a module extension add-in. -->
          <FunctionFile resid="residFunctionFileUrl"/>
          <!--Configures the add-in as a module extension. -->
          <ExtensionPoint xsi:type="Module">
            <SourceLocation resid="residExtensionPointUrl"/>
            <Label resid="residExtensionPointLabel"/>
            <CommandSurface>
              <CustomTab id="idTab">
                <Group id="idGroup">
                  <Label resid="residGroupLabel"/>
                  <!-- Adds the module extension to the Outlook navigation bar. -->
                  <Control xsi:type="Button" id="group.changeToAssociate">
                    <Label resid="residChangeToAssociateLabel"/>
                    <Supertip>
                      <Title resid="residChangeToAssociateLabel"/>
                      <Description resid="residChangeToAssociateDesc"/>
                    </Supertip>
                    <Icon>
                      <bt:Image size="16" resid="residAssociateIcon16"/>
                      <bt:Image size="32" resid="residAssociateIcon32"/>
                      <bt:Image size="80" resid="residAssociateIcon80"/>
                    </Icon>
                    <Action xsi:type="ExecuteFunction">
                      <FunctionName>changeToAssociateRate</FunctionName>
                    </Action>
                  </Control>
                </Group>
                <Label resid="residCustomTabLabel"/>
              </CustomTab>
            </CommandSurface>
          </ExtensionPoint>
        </DesktopFormFactor>
      </Host>
    </Hosts>
    <Resources>
      <bt:Images>
        <bt:Image id="residAssociateIcon16"
                  DefaultValue="https://localhost:3000/assets/associate-16.png"/>
        <bt:Image id="residAssociateIcon32"
                  DefaultValue="https://localhost:3000/assets/associate-32.png"/>
        <bt:Image id="residAssociateIcon80"
                  DefaultValue="https://localhost:3000/assets/associate-80.png"/>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="residFunctionFileUrl"
                DefaultValue="https://localhost:3000/module.html"/>
        <bt:Url id="residExtensionPointUrl"
                DefaultValue="https://localhost:3000/module.html"/>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="residExtensionPointLabel"
                    DefaultValue="Billable Hours"/>
        <bt:String id="residGroupLabel"
                    DefaultValue="Change billing rate"/>
        <bt:String id="residCustomTabLabel"
                    DefaultValue="Billable hours"/>
        <bt:String id="residChangeToAssociateLabel"
                    DefaultValue="Associate Rate"/>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="residChangeToAssociateDesc"
                    DefaultValue="Change to the associate billing rate: $127/hr"/>
      </bt:LongStrings>
    </Resources>
  </VersionOverrides>
</VersionOverrides>

См. также