InstallApp-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang InstallApp .

Der InstallApp-Vorgang installiert eine Mail-App für Outlook in einem Postfach.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des InstallApp-Vorgangs

Der InstallApp-Vorgang verwendet ein einzelnes Argument, das eine zu installierende Mail-App identifiziert. Das Argument enthält das base64-codierte Manifest für eine Mail-App.

SOAP-Header des InstallApp-Vorgangs

Der InstallApp-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername Element Beschreibung
RequestVersion
RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion
ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

Beispiel für eine Installationsapp-Vorgangsanforderung: Installieren einer Mail-App in einem Postfach

Das folgende Beispiel einer InstallApp-Vorgangsanforderung zeigt, wie Eine Mail-App für Outlook installiert wird. Das App-Manifest kann mithilfe des GetAppManifests-Vorgangs gefunden werden.

Hinweis

Das Base64-codierte App-Manifest wurde willkürlich abgeschnitten, um die Lesbarkeit zu erhalten, und stellt kein gültiges Manifest dar.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body >
      <m:InstallApp>
         <m:Manifest>TUwiIC8+CiAgPC9SdWxlPgo8L09mZmljZUFwcD4=</m:Manifest>
      </m:InstallApp>
   </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche Antwort des InstallApp-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine InstallApp-Vorgangsanforderung zum Installieren einer Mail-App.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="14" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <InstallAppResponse ResponseClass="Success" 
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </InstallAppResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

Fehlerantwort des InstallApp-Vorgangs

Das folgende Beispiel zeigt eine Fehlerantwort auf eine InstallApp-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung, die ein ungültiges Manifest enthält.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="556" 
                           MinorBuildNumber="14" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <InstallAppResponse ResponseClass="Error" 
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>This app can't be installed. Missing OfficeApp element.</MessageText>
         <ResponseCode>ErrorInternalServerError</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </InstallAppResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:

Siehe auch