Freigeben über

GetAppManifests-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang GetAppManifests .

Der GetAppManifests-Vorgang ruft App-Manifeste ab.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des GetAppManifests-Vorgangs

Der GetAppManifests-Vorgang verwendet keine Argumente, um die App-Manifeste für ein Postfach anzufordern. Die Antwort enthält base64-codierte XML-Manifestdateien für jede App, die in einem Postfach installiert ist.

SOAP-Header des GetAppManifests-Vorgangs

Der GetAppManifests-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.

GetAppManifests-Vorgangsanforderungsbeispiel: Abrufen der App-Manifeste für ein Postfach

Das folgende Beispiel einer GetAppManifests-Vorgangsanforderung zeigt, wie Die App-Manifeste für ein Postfach abgerufen werden. Das ApiVersionSupported-Element und das SchemaVersionSupported-Element sind optional.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013_SP1" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
      <t:TimeZoneContext>
         <t:TimeZoneDefinition Id="GMT Standard Time"/>
      </t:TimeZoneContext>
   </soap:Header>
   <soap:Body >
      <m:GetAppManifests>
        <m:ApiVersionSupported>1.1</m:ApiVersionSupported>
        <m:SchemaVersionSupported>1.1</m:SchemaVersionSupported>
      </m:GetAppManifests>
   </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält das folgende Element:

Erfolgreiche GetAppManifests-Vorgangsantwort

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine GetAppManifests-Vorgangsanforderung zum Abrufen der App-Manifeste für ein Postfach.

Hinweis

Alle Base64-App-Manifeste wurden willkürlich abgeschnitten, um die Lesbarkeit zu erhalten.

<?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="918" 
                           MinorBuildNumber="07" 
                           Version="V2_10" 
                           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="http://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">
      <GetAppManifestsResponse ResponseClass="Success" 
                               xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <m:Apps xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
          <t:App xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
            <t:Manifest>WNlQXBwPg==</t:Manifest>
          </t:App>
         </m:Apps>
      </GetAppManifestsResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

Der SOAP-Antworttext kann auch das folgende Element enthalten:

GetAppManifests-Vorgangsfehlerantwort

Fehler, die für diesen Vorgang zurückgegeben werden, beziehen sich auf ein ungültiges Format der Eingabeparameter oder sind generische EWS-Fehler. Informationen zu Fehlercodes, die für EWS generisch und für diesen Vorgang spezifisch sind, finden Sie unter ResponseCode.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="07"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://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">
    <GetAppManifestsResponse ResponseClass="Error"
                             xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <MessageText>The apiVersionSupported parameter is invalid. 
                   It should be in the form of major version, minor 
                   version, separated by '.', for example '2.34'.</MessageText>
      <ResponseCode>ErrorInvalidRequest</ResponseCode>
      <DescriptiveLinkKey>0</DescriptiveLinkKey>
    </GetAppManifestsResponse>
  </s:Body>
</s:Envelope>

Siehe auch