AddImGroup-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang AddImGroup .

Der Vorgang AddImGroup Exchange Web Services (EWS) fügt einem Postfach eine neue Chatgruppe hinzu.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des AddImGroup-Vorgangs

Der AddImGroup-Vorgang verwendet nur ein einzelnes Anzeigenamenargument.

Dieser Vorgang gibt den Anzeigenamen, den Gruppentyp und den Exchange-Speicherbezeichner der neuen Gruppe zurück.

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

Tabelle 1. SOAP-Header des AddImGroup-Vorgangs

Headername Element Beschreibung
Impersonation
ExchangeImpersonation
Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dies gilt für eine Anforderung.
MailboxCulture
MailboxCulture
Identifiziert die Kultur, wie in RFC 3066 definiert, "Tags für die Identifizierung von Sprachen", die für den Zugriff auf das Postfach verwendet werden soll. Dies gilt für eine Anforderung.
RequestVersion
RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an. Dies gilt für eine Anforderung.
ServerVersion
ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dies gilt für eine Antwort.

AddImGroup-Vorgangsanforderungsbeispiel: Erstellen einer neuen Chatgruppe

Das folgende Beispiel einer AddImGroup-Vorgangsanforderung zeigt, wie Sie eine Chatgruppe mit dem Namen MyCustomerGroup erstellen.

<?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" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddImGroup>
         <m:DisplayName>MyCustomGroup</m:DisplayName>
      </m:AddImGroup>
   </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche Antwort des AddImGroup-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine AddImGroup-Vorgangsanforderung .

<?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="349"
                           MinorBuildNumber="0"
                           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">
      <AddImGroupResponse ResponseClass="Success"
                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <ImGroup>
            <DisplayName xmlns="https://schemas.microsoft.com/exchange/services/2006/types">MyCustomGroup</DisplayName>
            <GroupType xmlns="https://schemas.microsoft.com/exchange/services/2006/types">IPM.DistList.MOC.UserGroup</GroupType>
            <ExchangeStoreId Id="AAMkAGQ1MjJjMTBkLTc4Y2UtNDA5Ny04ZjU5LWI3MAAA="
                             ChangeKey="EgAAAA=="
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/types"/>
         </ImGroup>
      </AddImGroupResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

Fehlerantwort des AddImGroup-Vorgangs

Das folgende Beispiel zeigt eine Fehlerantwort auf eine AddImGroup-Vorgangsanforderung . Dies ist eine Antwort auf eine Anforderung, die ein Zeichen enthält, das nicht in einem Anzeigenamen verwendet werden kann. Beachten Sie, dass dies ein SOAP-Fehler und keine schemabasierte Fehlermeldung ist. Der in der Anforderung übermittelte Anzeigename lautet ~!@#$%^&, und der Fehler tritt im & Zeichen auf. Das & Zeichen ist in der 11. Zeile und dem 33. Zeichen in der Anforderungsnutzlast aufgetreten. Die Antwort wurde mit einem HTTP 500-Code zurückgegeben.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <s:Fault>
         <faultcode xmlns:a="https://schemas.microsoft.com/exchange/services/2006/types">a:ErrorSchemaValidation</faultcode>
         <faultstring xml:lang="en-US">The request failed schema validation: An error occurred while parsing EntityName. Line 11, position 33.</faultstring>
         <detail>
            <e:ResponseCode xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
            <e:Message xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">The request failed schema validation.</e:Message>
            <t:MessageXml xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
               <t:LineNumber>11</t:LineNumber>
               <t:LinePosition>33</t:LinePosition>
               <t:Violation>An error occurred while parsing EntityName. Line 11, position 33.</t:Violation>
            </t:MessageXml>
         </detail>
      </s:Fault>
   </s:Body>
</s:Envelope>

Siehe auch