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. Das Manifest beschreibt, wie das Add-In in Outlook-Clients integriert wird. Es folgt ein Beispiel.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). The manifest describes how the add-in integrates across Outlook clients. 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="http://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ärtskompatibel sind, und so die neusten 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 Unterstützung für das Entwurfsformular 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. Dies 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. Dies 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.

In diesem Artikel werden die Anforderungen für ein Manifest der Version 1.1 erläutert. Auch wenn Ihr Add-In-Manifest das VersionOverrides-Element verwendet, ist es dennoch wichtig, Manifestelemente der Version 1.1 einzufügen, damit Ihre App mit älteren Clients funktioniert, die VersionOverrides nicht unterstützten.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 zum Überprüfen von Manifesten. Das Schema erfordert, dass Elemente im Manifest in einer bestimmten Reihenfolge angezeigt werden. Wenn Sie Elemente einschließen, die nicht in der erforderlichen Reihenfolge sind, treten beim Querladen Ihres Add-Ins möglicherweise Fehler auf. Sie können die Schemadefinitionen von GitHub herunterladen, um Ihr Manifest mit den Elementen in der erforderlichen 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="http://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 bestimmten Add-Ins. Wenn ein Entwickler etwas in dem Manifest aktualisiert, muss die Version ebenfalls erhöht werden. So wird beim Installieren des neuen Manifests das vorhandenen überschrieben, und der Benutzer erhält neue Funktionen. Wenn dieses Add-In an den Store übermittelt wurde, muss das neue Manifest erneut gesendet und überprüft werden. Sobald es genehmigt wurde, wird das Manifest innerhalb einiger Stunden für die Benutzer dieses Add-Ins automatisch aktualisiert.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 VersionOverrides-Element 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 on this element, see Define add-in commands in your manifest.

In diesem Element wird auf die Unterstützung für mobile Add-Ins in den Add-Ins definiert.This element is also where add-ins define support for mobile add-ins.

LokalisierungLocalization

Einige Aspekte des Add-Ins müssen für unterschiedliche Gebietsschemas lokalisiert werden, z. B. der Name, die Beschreibung und die URL, die geladen wird. Diese Elemente können ganz einfach durch die Angabe des Standardwerts und anschließende Gebietsschemaüberschreibungen im Ressourcen-Element innerhalb des VersionOverrides-Element lokalisiert werden. Die folgende Abbildung zeigt, wie ein Bild, eine URL und eine Zeichenfolge überschrieben werden: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>

Die Schemareferenz 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 unterscheidet sich von dem Hosts-Element innerhalb des VersionOverrides-Elements, das in Definieren von Add-In-Befehlen in Ihrem Manifest erläutert 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 Requirements-Element gibt den Satz von APIs für das Add-In an. Für ein Outlook-Add-In muss der Anforderungssatz „Mailbox" und ein Wert von 1.1 oder höher angegeben werden. Die neueste Anforderungssatzversion finden Sie in der API-Referenz. Eine Erläuterung der Funktionsweise finden Sie unter 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.

Im folgenden Beispiel wird das DefaultMinVersion-Attribut des Sets-Elements verwendet, um office.jx, Version 1.1 oder höher, anzufordern, und das MinVersion-Attribut des Set-Elements, um den Postfach-Anforderungssatz, Version 1.1, anzufordern.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 FormSettings-Element wird von älteren Outlook-Clients verwendet, die nur Schema 1.1 und nicht VersionOverrides unterstützen. Mithilfe dieses Elements definieren Entwickler, wie das Add-In in diesen Clients angezeigt wird. Es gibt zwei Teile – ItemRead und ItemEdit. Mit ItemRead wird angegeben, wie das Add-In angezeigt wird, wenn der Benutzer Nachrichten und Termine liest. ItemEdit beschreibt, wie das Add-In angezeigt wird, während der Benutzer eine Antwort, eine neue Nachricht, einen neuen Termin erstellt oder einen Termin bearbeitet, dessen Organisator er 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 beziehen sich direkt auf die Aktivierungsregeln im Rule-Element. Wenn ein Add-In beispielsweise angibt, dass es in einer gerade verfassten Nachricht angezeigt werden soll, muss ein ItemEdit-Formular 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 Informationen 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 gibt eine Domäne https://www.contoso2.com als zweite Domäne an, 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 Permissions-Element enthält die erforderlichen Berechtigungen für das Add-In. In der Regel sollten Sie die erforderliche Mindestberechtigung angeben, die das Add-In benötigt, je nachdem, welche Methoden zum Verfassen Sie genau verwenden möchten. Für ein Mail-Add-In beispielsweise, das in einem Entwurfsformular aktiviert ist und Elementeigenschaften wie item.requiredAttendees nur liest und nicht in diese schreibt, und mailbox.makeEwsRequestAsync nicht für den Zugriff auf Exchange Web Services-Vorgänge afruft, sollte die ReadItem-Berechtigung angegeben werden. Weitere Informationen zu den verfügbaren Berechtigungen finden Sie unter Angeben von Berechtigungen für den Outlook-Add-In-Zugriff auf die Benutzerpostfächer.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 zum Aktivieren eines Add-Ins basierend auf einer oder mehrerer der folgenden Bedingungen in dem aktuell ausgewählten Element verwendet werden.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

  • Das Vorhandensein 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 Informationen 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: Hinzufügen der Unterstützung für mobile UmgebungenNext steps: Add mobile support

In Add-Ins kann optional die Unterstützung für Outlook Mobile hinzugefügt werden. Outlook Mobile unterstützt Add-In-Befehle auf ähnliche Weise wie Outlook unter Windows und Mac. Weitere Informationen finden Sie unter Hinzufügen der 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