Outlook-Add-In-ManifesteOutlook add-in manifests

Ein Outlook-Add-In besteht aus zwei Komponenten: dem XML-Add-In-Manifest und einer Webseite, die von der JavaScript-Bibliothek für Office-Add-Ins (office.js) unterstützt wird.An Outlook add-in consists of two components: the XML add-in manifest and a web page supported by the JavaScript library for Office Add-ins (office.js). Das Manifest beschreibt, wie das Add-In in Outlook-Clients integriert ist.The manifest describes how the add-in integrates across Outlook clients. Es folgt ein Beispiel.The following is an example.

Hinweis

Alle URL-Werte im folgenden Beispiel beginnen mit „https://appdemo.contoso.com“. Dieser Wert ist ein Platzhalter. In einem tatsächlich gültigen Manifest würden diese Werte gültige HTTPS-Webd-URLs enthalten.All URL values in the following sample begin with "https://appdemo.contoso.com". This value is a placeholder. In an actual valid manifest, these values would contain valid https web URLs.

<?xml version="1.0" encoding="UTF-8" ?>
<!--Created:cb85b80c-f585-40ff-8bfc-12ff4d0e34a9-->
<OfficeApp
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
  xmlns:mailappor="http://schemas.microsoft.com/office/mailappversionoverrides/1.0"
  xsi:type="MailApp">
  <Id>7164e750-dc86-49c0-b548-1bac57abdc7c</Id>
  <Version>1.0.0.0</Version>
  <ProviderName>Microsoft Outlook Dev Center</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="Add-in Command Demo" />
  <Description DefaultValue="Adds command buttons to the ribbon in Outlook"/>
  <IconUrl DefaultValue="https://appdemo.contoso.com/images/blue-64.png" />
  <HighResolutionIconUrl DefaultValue="https://appdemo.contoso.com/images/blue-80.png" />
  <Hosts>
    <Host Name="Mailbox" />
  </Hosts>
  <Requirements>
    <Sets>
      <Set Name="MailBox" MinVersion="1.1" />
    </Sets>
  </Requirements>
  <!-- These elements support older clients that don't support add-in commands -->
  <FormSettings>
    <Form xsi:type="ItemRead">
      <DesktopSettings>
        <!-- NOTE: Just reusing the read taskpane page that is invoked by the button
             on the ribbon in clients that support add-in commands. You can 
             use a completely different page if desired -->
        <SourceLocation DefaultValue="https://appdemo.contoso.com/AppRead/TaskPane/TaskPane.html"/>
        <RequestedHeight>450</RequestedHeight>
      </DesktopSettings>
    </Form>
  </FormSettings>
  <Permissions>ReadWriteItem</Permissions>
  <Rule xsi:type="RuleCollection" Mode="Or">
    <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
  </Rule>
  <DisableEntityHighlighting>false</DisableEntityHighlighting>

  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">

    <Requirements>
      <bt:Sets DefaultMinVersion="1.3">
        <bt:Set Name="Mailbox" />
      </bt:Sets>
    </Requirements>

    <Hosts>
      <Host xsi:type="MailHost">
        <DesktopFormFactor>
          <FunctionFile resid="functionFile" />

          <!-- Message read form -->
          <ExtensionPoint xsi:type="MessageReadCommandSurface">
            <OfficeTab id="TabDefault">
              <Group id="msgReadDemoGroup">
                <Label resid="groupLabel" />
                <!-- Function (UI-less) button -->
                <Control xsi:type="Button" id="msgReadFunctionButton">
                  <Label resid="funcReadButtonLabel" />
                  <Supertip>
                    <Title resid="funcReadSuperTipTitle" />
                    <Description resid="funcReadSuperTipDescription" />
                  </Supertip>
                  <Icon>
                    <bt:Image size="16" resid="blue-icon-16" />
                    <bt:Image size="32" resid="blue-icon-32" />
                    <bt:Image size="80" resid="blue-icon-80" />
                  </Icon>
                  <Action xsi:type="ExecuteFunction">
                    <FunctionName>getSubject</FunctionName>
                  </Action>
                </Control>
                <!-- Menu (dropdown) button -->
                <Control xsi:type="Menu" id="msgReadMenuButton">
                  <Label resid="menuReadButtonLabel" />
                  <Supertip>
                    <Title resid="menuReadSuperTipTitle" />
                    <Description resid="menuReadSuperTipDescription" />
                  </Supertip>
                  <Icon>
                    <bt:Image size="16" resid="red-icon-16" />
                    <bt:Image size="32" resid="red-icon-32" />
                    <bt:Image size="80" resid="red-icon-80" />
                  </Icon>
                  <Items>
                    <Item id="msgReadMenuItem1">
                      <Label resid="menuItem1ReadLabel" />
                      <Supertip>
                        <Title resid="menuItem1ReadLabel" />
                        <Description resid="menuItem1ReadTip" />
                      </Supertip>
                      <Icon>
                        <bt:Image size="16" resid="red-icon-16" />
                        <bt:Image size="32" resid="red-icon-32" />
                        <bt:Image size="80" resid="red-icon-80" />
                      </Icon>
                      <Action xsi:type="ExecuteFunction">
                        <FunctionName>getItemClass</FunctionName>
                      </Action>
                    </Item>
                    <Item id="msgReadMenuItem2">
                      <Label resid="menuItem2ReadLabel" />
                      <Supertip>
                        <Title resid="menuItem2ReadLabel" />
                        <Description resid="menuItem2ReadTip" />
                      </Supertip>
                      <Icon>
                        <bt:Image size="16" resid="red-icon-16" />
                        <bt:Image size="32" resid="red-icon-32" />
                        <bt:Image size="80" resid="red-icon-80" />
                      </Icon>
                      <Action xsi:type="ExecuteFunction">
                        <FunctionName>getDateTimeCreated</FunctionName>
                      </Action>
                    </Item>
                    <Item id="msgReadMenuItem3">
                      <Label resid="menuItem3ReadLabel" />
                      <Supertip>
                        <Title resid="menuItem3ReadLabel" />
                        <Description resid="menuItem3ReadTip" />
                      </Supertip>
                      <Icon>
                        <bt:Image size="16" resid="red-icon-16" />
                        <bt:Image size="32" resid="red-icon-32" />
                        <bt:Image size="80" resid="red-icon-80" />
                      </Icon>
                      <Action xsi:type="ExecuteFunction">
                        <FunctionName>getItemID</FunctionName>
                      </Action>
                    </Item>
                  </Items>
                </Control>
                <!-- Task pane button -->
                <Control xsi:type="Button" id="msgReadOpenPaneButton">
                  <Label resid="paneReadButtonLabel" />
                  <Supertip>
                    <Title resid="paneReadSuperTipTitle" />
                    <Description resid="paneReadSuperTipDescription" />
                  </Supertip>
                  <Icon>
                    <bt:Image size="16" resid="green-icon-16" />
                    <bt:Image size="32" resid="green-icon-32" />
                    <bt:Image size="80" resid="green-icon-80" />
                  </Icon>
                  <Action xsi:type="ShowTaskpane">
                    <SourceLocation resid="readTaskPaneUrl" />
                  </Action>
                </Control>
              </Group>
            </OfficeTab>
          </ExtensionPoint>
        </DesktopFormFactor>
      </Host>
    </Hosts>

    <Resources>
      <bt:Images>
        <!-- Blue icon -->
        <bt:Image id="blue-icon-16" DefaultValue="https://appdemo.contoso.com/images/blue-16.png" />
        <bt:Image id="blue-icon-32" DefaultValue="https://appdemo.contoso.com/images/blue-32.png" />
        <bt:Image id="blue-icon-80" DefaultValue="https://appdemo.contoso.com/images/blue-80.png" />
        <!-- Red icon -->
        <bt:Image id="red-icon-16" DefaultValue="https://appdemo.contoso.com/images/red-16.png" />
        <bt:Image id="red-icon-32" DefaultValue="https://appdemo.contoso.com/images/red-32.png" />
        <bt:Image id="red-icon-80" DefaultValue="https://appdemo.contoso.com/images/red-80.png" />
        <!-- Green icon -->
        <bt:Image id="green-icon-16" DefaultValue="https://appdemo.contoso.com/images/green-16.png" />
        <bt:Image id="green-icon-32" DefaultValue="https://appdemo.contoso.com/images/green-32.png" />
        <bt:Image id="green-icon-80" DefaultValue="https://appdemo.contoso.com/images/green-80.png" />
      </bt:Images>
      <bt:Urls>
        <bt:Url id="functionFile" DefaultValue="https://appdemo.contoso.com/FunctionFile/Functions.html" />
        <bt:Url id="readTaskPaneUrl" DefaultValue="https://appdemo.contoso.com/AppRead/TaskPane/TaskPane.html" />
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="groupLabel" DefaultValue="Add-in Demo" />
        <bt:String id="funcReadButtonLabel" DefaultValue="Get subject" />
        <bt:String id="menuReadButtonLabel" DefaultValue="Get property" />
        <bt:String id="paneReadButtonLabel" DefaultValue="Display all properties" />

        <bt:String id="funcReadSuperTipTitle" DefaultValue="Gets the subject of the message or appointment" />
        <bt:String id="menuReadSuperTipTitle" DefaultValue="Choose a property to get" />
        <bt:String id="paneReadSuperTipTitle" DefaultValue="Get all properties" />

        <bt:String id="menuItem1ReadLabel" DefaultValue="Get item class" />
        <bt:String id="menuItem2ReadLabel" DefaultValue="Get date time created" />
        <bt:String id="menuItem3ReadLabel" DefaultValue="Get item ID" />
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="funcReadSuperTipDescription" DefaultValue="Gets the subject of the message or appointment and displays it in the info bar. This is an example of a function button." />
        <bt:String id="menuReadSuperTipDescription" DefaultValue="Gets the selected property of the message or appointment and displays it in the info bar. This is an example of a drop-down menu button." />
        <bt:String id="paneReadSuperTipDescription" DefaultValue="Opens a pane displaying all available properties of the message or appointment. This is an example of a button that opens a task pane." />

        <bt:String id="menuItem1ReadTip" DefaultValue="Gets the item class of the message or appointment and displays it in the info bar." />
        <bt:String id="menuItem2ReadTip" DefaultValue="Gets the date and time the message or appointment was created and displays it in the info bar." />
        <bt:String id="menuItem3ReadTip" DefaultValue="Gets the item ID of the message or appointment and displays it in the info bar." />
      </bt:LongStrings>
    </Resources>
  </VersionOverrides>
</OfficeApp>

SchemaversionenSchema versions

Nicht alle Outlook-Clients bieten Unterstützung für die neuesten Funktionen. Einige Outlook-Benutzer verwenden möglicherweise eine ältere Version von Outlook. Mit den Schemaversionen können Entwickler Add-Ins erstellen, die abwärts kompatibel sind, und so die neuesten Funktionen verwenden, wo diese verfügbar sind, die gleichzeitig auch in älteren Versionen funktionieren.Not all Outlook clients support the latest features, and some Outlook users will have an older version of Outlook. Having schema versions lets developers build add-ins that are backwards compatible, using the newest features where they are available but still functioning on older versions.

Das VersionOverrides-Element in der Manifestdatei ist ein Beispiel dafür. Alle Elemente, die innerhalb von VersionOverrides definiert sind, überschreiben dasselbe Element im anderen Teil des Manifests. Dies bedeutet, dass Outlook möglichst die Elemente aus dem VersionOverrides Abschnitt verwendet, um das Add-In einzurichten. Wenn die Version von Outlook jedoch eine bestimmte Version von VersionOverrides nicht unterstützt, ignoriert Outlook sie und verwendet die Informationen im Rest des Manifests.The VersionOverrides element in the manifest is an example of this. All elements defined inside VersionOverrides will override the same element in the other part of the manifest. This means that, whenever possible, Outlook will use what is in the VersionOverrides section to set up the add-in. However, if the version of Outlook doesn't support a certain version of VersionOverrides, Outlook will ignore it and depend on the information in the rest of the manifest.

Dieser Ansatz bedeutet, dass Entwickler nicht mehrere einzelne Manifeste erstellen müssen, sondern alles in einer Datei definieren können.This approach means that developers don't have to create multiple individual manifests, but rather keep everything defined in one file.

Die aktuellen Versionen des Schemas sind:The current versions of the schema are:

VersionVersion BeschreibungDescription
v1.0v1.0 Unterstützt Version 1.0 der JavaScript-API für Office. Für Outlook-Add-Ins wird das Leseformular unterstützt.Supports version 1.0 of the JavaScript API for Office. For Outlook add-ins, this supports read form.
v1.1v1.1 Unterstützt Version 1.1 der JavaScript-API für Office und VersionOverrides. Für Outlook-Add-Ins wird damit die Unterstützung für das Erstellen von Formularen hinzugefügt.Supports version 1.1 of the JavaScript API for Office and VersionOverrides. For Outlook add-ins, this adds support for compose form.
VersionOverrides 1.0VersionOverrides 1.0 Unterstützt neuere Versionen der JavaScript-API für Office. Diese unterstützt Add-In-Befehle.Supports later versions of the JavaScript API for Office. This supports add-in commands.
VersionOverrides 1.1VersionOverrides 1.1 Unterstützt neuere Versionen der JavaScript-API für Office. Diese unterstützt Add-In-Befehle und bietet zusätzliche Unterstützung für neuere Funktionen, z. B. anheftbare Aufgabenbereiche und mobile Add-Ins.Supports later versions of the JavaScript API for Office. This supports add-in commands and adds support for newer features, such as pinnable taskpanes and mobile add-ins.

Dieser Artikel behandelt die Anforderungen an ein v1.1-Manifest. Selbst wenn Ihr Add-In-Manifest das Element VersionOverrides verwendet, ist es immer noch wichtig, die Elemente v1.1 Manifest aufzunehmen, damit Ihr Add-In mit älteren Clients arbeiten kann, die VersionOverrides nicht unterstützen.This article will cover the requirements for a v1.1 manifest. Even if your add-in manifest uses the VersionOverrides element, it is still important to include the v1.1 manifest elements to allow your add-in to work with older clients that do not support VersionOverrides.

Hinweis

Outlook verwendet ein Schema zur Validierung von Manifesten. Das Schema verlangt, dass Elemente im Manifest in einer bestimmten Reihenfolge erscheinen. Wenn Sie Elemente aus der gewünschten Reihenfolge einfügen, kann es zu Fehlern beim Seiten-Laden Ihres Add-Ins kommen. Sie können die Schema-Definitionen von GitHub herunterladen, um Ihr Manifest mit Elementen in der gewünschten Reihenfolge zu erstellen.Outlook uses a schema to validate manifests. The schema requires that elements in the manifest appear in a specific order. If you include elements out of the required order, you may get errors when sideloading your add-in. You can download the schema definitions from GitHub to help create your manifest with elements in the required order.

StammelementRoot element

Das Stammelement für das Outlook-Add-In-Manifest ist OfficeApp. Dieses Element deklariert auch den Standard-Namespace, die Schemaversion und den Typ des Add-Ins. Platzieren Sie alle anderen Elemente im Manifest innerhalb der öffnenden und schließenden Tags. Der folgende Code ist ein Beispiel des Stammelements:The root element for the Outlook add-in manifest is OfficeApp. This element also declares the default namespace, schema version and the type of add-in. Place all other elements in the manifest within its open and close tags. The following is an example of the root element:

<OfficeApp
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
  xmlns:mailappor="http://schemas.microsoft.com/office/mailappversionoverrides/1.0"
  xsi:type="MailApp">

  <!-- the rest of the manifest -->

</OfficeApp>

VersionVersion

Dies ist die Version des spezifischen Add-Ins. Wenn ein Entwickler etwas im Manifest aktualisiert, muss auch die Version erhöht werden. Auf diese Weise wird bei der Installation des neuen Manifests das bestehende Manifest überschrieben, und der Benutzer erhält die neue Funktionalität. Wenn dieses Add-In an den Shop übermittelt wurde, muss das neue Manifest erneut gesendet und erneut validiert werden. Dann erhalten die Benutzer dieses Add-Ins das neue aktualisierte Manifest automatisch in wenigen Stunden, nachdem es genehmigt wurde.This is the version of the specific add-in. If a developer updates something in the manifest, the version must be incremented as well. This way, when the new manifest is installed, it will overwrite the existing one and the user will get the new functionality. If this add-in was submitted to the store, the new manifest will have to be re-submitted and re-validated. Then, users of this add-in will get the new updated manifest automatically in a few hours, after it is approved.

Wenn sich die angeforderten Berechtigungen des Add-Ins ändern, werden die Benutzer aufgefordert, eine Aktualisierung durchzuführen und dem Add-In erneut zuzustimmen. Wenn der Administrator dieses Add-In für die gesamte Organisation installiert hat, muss der Administrator zuerst erneut zustimmen. Für Benutzer werden in der Zwischenzeit weiterhin die alten Funktionen angezeigt.If the add-in's requested permissions change, users will be prompted to upgrade and re-consent to the add-in. If the admin installed this add-in for the entire organization, the admin will have to re-consent first. Users will continue to see old functionality in the meantime.

VersionOverridesVersionOverrides

Das Element VersionOverrides ist der Ort, an dem sich Informationen für Add-In-Befehle befinden. Weitere Informationen zu diesem Element finden Sie unter Definieren von Add-In-Befehlen in Ihrem Manifest.The VersionOverrides element is the location of information for add-in commands. For more information about this element, see Define add-in commands in your manifest.

In diesem Element definieren Add-Ins auch den Support für mobile Add-Ins.This element is also where add-ins define support for mobile add-ins.

LokalisierungLocalization

Einige Aspekte des Add-Ins müssen für verschiedene Gebietsschemata lokalisiert werden, wie beispielsweise der Name, die Beschreibung und die geladene URL. Diese Elemente können einfach lokalisiert werden, indem man den Standardwert festlegt und dann der lokale Wert im Element Ressourcen innerhalb des Elements VersionOverrides außer Kraft setzt. Im Folgenden wird gezeigt, wie Sie ein Bild, eine URL und eine Zeichenkette außer Kraft setzen können:Some aspects of the add-in need to be localized for different locales, such as the name, description and the URL that's loaded. These elements can easily be localized by specifying the default value and then locale overrides in the Resources element within the VersionOverrides element. The following shows how to override an image, a URL, and a string:

<Resources>
  <bt:Images>
    <bt:Image id="icon1_16x16" DefaultValue="https://contoso.com/images/app_icon_small.png" >
      <bt:Override Locale="ar-sa" Value="https://contoso.com/images/app_icon_small_arsa.png" />
      <!-- add information for other locales -->
    </bt:Image>
  </bt:Images>

  <bt:Urls>
    <bt:Url id="residDesktopFuncUrl" DefaultValue="https://contoso.com/urls/page_appcmdcode.html" >
      <bt:Override Locale="ar-sa" Value="https://contoso.com/urls/page_appcmdcode.html?lcid=ar-sa" />
      <!-- add information for other locales -->
    </bt:Url>
  </bt:Urls>

  <bt:ShortStrings> 
    <bt:String id="residViewTemplates" DefaultValue="Launch My Add-in">
      <bt:Override Locale="ar-sa" Value="<add localized value here>" />
      <!-- add information for other locales -->
    </bt:String>
  </bt:ShortStrings>
</Resources>

Der Schema-Verweis enthält umfassende Informationen dazu, welche Elemente lokalisiert werden können.The schema reference contains full information on which elements can be localized.

HostsHosts

Outlook-Add-Ins geben das Hosts-Element folgendermaßen an.Outlook Add-ins specify the Hosts element like the followiing.

<OfficeApp>
...
  <Hosts>
    <Host Name="Mailbox" />
  </Hosts>
...
</OfficeApp>

Dies ist unabhängig vom Hosts Element innerhalb des VersionOverrides Elements, das in Definiere Add-In-Befehle in deinem Manifest beschrieben wird.This is separate from the Hosts element inside the VersionOverrides element, which is discussed in Define add-in commands in your manifest.

AnforderungenRequirements

Das Element Requirements gibt die Menge der für das Add-In verfügbaren APIs an. Für ein Outlook-Add-In muss das Anforderungsset Mailbox und ein Wert von 1.1 oder höher sein. Bitte beachten Sie die API-Referenz für die neueste Version des Anforderungssatzes. Weitere Informationen zu Anforderungssätzen finden Sie in den Outlook Add-In APIs.The Requirements element specifies the set of APIs available to the add-in. For an Outlook add-in, the requirement set must be Mailbox and a value of 1.1 or above. Please refer to the API reference for the latest requirement set version. Refer to the Outlook add-in APIs for more information on requirement sets.

Das Requirements-Element kann auch im VersionOverrides-Element angezeigt werden, sodass das Add-In eine andere Anforderung angeben kann, wenn es in Clients geladen wird, die VersionOverrides unterstützen.The Requirements element can also appear in the VersionOverrides element, allowing the add-in to specify a different requirement when loaded in clients that support VersionOverrides.

Das folgende Beispiel verwendet das DefaultMinVersion Attribut des Sets Elements, um office.js Version 1.1 oder höher zu verwenden, und das MinVersion Attribut des Set Elements, um das Mailbox-Anforderungs-Set Version 1.1 zu benötigen.The following example uses the DefaultMinVersion attribute of the Sets element to require office.js version 1.1 or higher, and the MinVersion attribute of the Set element to require the Mailbox requirement set version 1.1.

<OfficeApp>
...
  <Requirements>
    <Sets DefaultMinVersion="1.1">
      <Set Name="MailBox" MinVersion="1.1" />
    </Sets>
  </Requirements>
...
</OfficeApp>

FormulareinstellungenForm settings

Das Element FormSettings wird von älteren Outlook-Clients verwendet, die nur das Schema 1.1 und nicht VersionOverrides unterstützen. Mit diesem Element definieren die Entwickler, wie das Add-In bei solchen Clients aussehen soll. Es gibt zwei Teile - ItemRead und ItemEdit. ItemRead wird verwendet, um festzulegen, wie das Add-In aussieht, wenn der Benutzer Nachrichten und Termine liest. ItemEdit beschreibt, wie das Add-In aussieht, während der Benutzer eine Antwort, eine neue Nachricht, einen neuen Termin verfasst oder einen Termin bearbeitet, bei dem er der Organisator ist.The FormSettings element is used by older Outlook clients, which only support schema 1.1 and not VersionOverrides. Using this element, developers define how the add-in will appear in such clients. There are two parts - ItemRead and ItemEdit. ItemRead is used to specify how the add-in appears when the user reads messages and appointments. ItemEdit describes how the add-in appears while the user is composing a reply, new message, new appointment or editing an appointment where they are the organizer.

Diese Einstellungen stehen in direktem Zusammenhang mit den Aktivierungsregeln im Element Rule. Wenn ein Add-In beispielsweise angibt, dass es in einer Nachricht im Verfasser-Modus erscheinen soll, muss ein Formular ItemEdit angegeben werden.These settings are directly related to the activation rules in the Rule element. For example, if an add-in specifies that it should appear on a message in compose mode, an ItemEdit form must be specified.

Weitere Details finden Sie in der Schemareferenz für Office-Add-In-Manifeste (v1.1)For more details, please refer to the Schema reference for Office Add-ins manifests (v1.1)

App-DomänenApp domains

Die Domäne der Add-In-Startseite, die Sie im Element SourceLocation angeben, ist die Standarddomäne. Wenn die Elemente AppDomains und AppDomain nicht verwendet werden und Ihr Add-In versucht, zu einer andere Domäne zu navigieren, öffnet der Browser ein neues Fenster außerhalb des Add-In-Bereichs. Wenn die Navigation innerhalb des Add-In-Bereichs bleiben soll, müssen Sie ein AppDomains Element hinzufügen und jede zusätzliche Domäne in der Add-In-Manifestdatei in ein eigenes AppDomain Unterelement einbeziehen.The domain of the add-in start page that you specify in the SourceLocation element is the default domain for the add-in. Without using the AppDomains and AppDomain elements, if your add-in attempts to navigate to another domain, the browser will open a new window outside of the add-in pane. In order to allow the add-in to navigate to another domain within the add-in pane, add an AppDomains element and include each additional domain in its own AppDomain sub-element in the add-in manifest.

Das folgende Beispiel legt eine Domäne https://www.contoso2.com als zweite Domäne fest, zu der das Add-In innerhalb des Add-In-Bereichs navigieren kann:The following example specifies a domain https://www.contoso2.com as a second domain that the add-in can navigate to within the add-in pane:

<OfficeApp>
...
  <AppDomains>
    <AppDomain>https://www.contoso2.com</AppDomain>
  </AppDomains>
...
</OfficeApp>

App-Domänen sind auch erforderlich, um die gemeinsame Nutzung von Cookies zwischen dem Popupfenster und dem im Rich-Client ausgeführten Add-In zu ermöglichen.App domains are also necessary to enable cookie sharing between the pop-out window and the add-in running in the rich client.

BerechtigungenPermissions

Das Element Berechtigungen enthält die erforderlichen Berechtigungen für das Add-In. Im Allgemeinen sollten Sie die minimal erforderliche Berechtigung angeben, die Ihr Add-In benötigt, abhängig von den genauen Methoden, die Sie verwenden möchten. Ein Mail-Add-In, das in zusammengesetzten Formularen aktiviert wird und nur liest, aber nicht in Elementeigenschaften wie item.requiredAttendees schreibt und mailbox.makeEwsRequestAsync aufruft, um auf Exchange Web Services Operationen zuzugreifen, sollte ReadItem Berechtigung angeben. Weitere Informationen zu den verfügbaren Berechtigungen finden Sie unter Verständnis der Outlook-Add-In-Berechtigungen.The Permissions element contains the required permissions for the add-in. In general, you should specify the minimum necessary permission that your add-in needs, depending on the exact methods that you plan to use. For example, a mail add-in that activates in compose forms and only reads but does not write to item properties like item.requiredAttendees, and does not call mailbox.makeEwsRequestAsync to access any Exchange Web Services operations should specify ReadItem permission. For details on the available permissions, see Understanding Outlook add-in permissions.

Vierstufiges Berechtigungsmodell für Mail-Add-InsFour-tier permissions model for mail add-ins

4-Stufen-Berechtigungsmodell für Mail-Apps-Schema v1.1

<OfficeApp>
...
  <Permissions>ReadWriteItem</Permissions>
...
</OfficeApp>

AktivierungsregelnActivation rules

Aktivierungsregeln sind im Rule Element angegeben. Das Rule Element kann als untergeordnetes Element des OfficeApp Elements in Manifesten der Version 1.1 angezeigt werden.Activation rules are specified in the Rule element. The Rule element can appear as a child of the OfficeApp element in 1.1 manifests.

Aktivierungsregeln können verwendet werden, um ein Add-In basierend auf einer oder mehreren der folgenden Bedingungen für das aktuell ausgewählte Element zu aktivieren.Activation rules can be used to activate an add-in based on one or more of the following conditions on the currently selected item.

Hinweis

Aktivierungsregeln gelten nur für Clients, die das VersionOverrides Element nicht unterstützen.Activation rules only apply to clients that do not support the VersionOverrides element.

  • Der Elementtyp und/oder die Nachrichtenklasse.The item type and/or message class

  • Die Anwesenheit eines bestimmten Typs einer bekannten Entität, z. B. eine Adresse oder TelefonnummerThe presence of a specific type of known entity, such as an address or phone number

  • Die Übereinstimmung eines regulären Ausdrucks im Nachrichtentext, Betreff oder der Absender-E-Mail-AdresseA regular expression match in the body, subject, or sender email address

  • Das Vorhandensein einer AnlageThe presence of an attachment

Weitere Details sowie Beispiele zu Aktivierungsregeln finden Sie unter Aktivierungsregeln für Outlook-Add-Ins.For details and samples of activation rules, see Activation rules for Outlook add-ins.

Nächste Schritte: Add-In-BefehleNext steps: Add-in commands

Nachdem Sie eine einfache Manifestdatei definiert haben, definieren Sie Add-In-Befehle für Ihr Add-In. Add-In-Befehle werden als Schaltfläche im Menüband dargestellt, sodass Benutzer Ihr Add-In auf einfache und intuitive Weise aktivieren können. Weitere Informationen finden Sie unter Add-In-Befehle für Outlook.After defining a basic manifest, define add-in commands for your add-in. Add-in commands present a button in the ribbon so users can activate your add-in in a simple, intuitive way. For more information, see Add-in commands for Outlook.

Ein Beispiel-Add-In, das Add-In-Befehle definiert, finden Sie unter command-demo.For an example add-in that defines add-in commands, see command-demo.

Nächste Schritte: Mobilen Support hinzufügenNext steps: Add mobile support

Add-Ins können optional die Unterstützung für Outlook Mobile hinzufügen. Outlook Mobile unterstützt Add-In-Befehle in ähnlicher Weise wie Outlook auf Windows und Mac. Weitere Informationen finden Sie unter Unterstützung für Add-In-Befehle für Outlook Mobile.Add-ins can optionally add support for Outlook mobile. Outlook mobile supports add-in commands in a similar fashion to Outlook on Windows and Mac. For more information, see Add support for add-in commands for Outlook Mobile.

Siehe auchSee also