GetItem-Vorgang (e-Mail-Nachricht)
Der GetItem-Vorgang ermöglicht dem Benutzer den Zugriff auf Informationen über e-Mail-Nachrichten.
Verwenden des GetItem-Vorgangs für Nachrichten
Die GetItem-Anforderung muss über die folgenden Informationen verfügen:
Das ItemID -Element zum Identifizieren der zurückzugebenden Elementinformationen.
Das ItemShape -Element, um die zurückzugebenden Elementeigenschaften zu identifizieren.
GetItem-Anforderungs Beispiel
Beschreibung
Im folgenden Beispiel einer GetItem-Anforderung wird gezeigt, wie auf Informationen zu e-Mail-Nachrichten zugegriffen werden kann.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<GetItem
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ItemShape>
<t:BaseShape>Default</t:BaseShape>
<t:IncludeMimeContent>true</t:IncludeMimeContent>
</ItemShape>
<ItemIds>
<t:ItemId Id="AAAlAF" ChangeKey="CQAAAB" />
</ItemIds>
</GetItem>
</soap:Body>
</soap:Envelope>
Anfordern von Elementen
In der Anforderung werden folgende Elemente verwendet:
Erfolgreiches GetItem (e-Mail-Nachricht)-Antwortbeispiel
Beschreibung
Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die GetItem-Anforderung.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Message>
<t:MimeContent CharacterSet="UTF-8">UmVjZWl</t:MimeContent>
<t:ItemId Id="AAAlAFVz" ChangeKey="CQAAAB" />
<t:Subject />
<t:Sensitivity>Normal</t:Sensitivity>
<t:Body BodyType="HTML">
<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta content="MSHTML 6.00.3790.2759" name="GENERATOR">
<style title="owaParaStyle">P { MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px } </style>
</head>
<body ocsi="x">
<div dir="ltr">
<font face="Tahoma" color="#000000" size="2"></font>&nbsp;
</div>
</body>
</html>
</t:Body>
<t:Size>881</t:Size>
<t:DateTimeSent>2006-10-28T01:37:06Z</t:DateTimeSent>
<t:DateTimeCreated>2006-10-28T01:37:06Z</t:DateTimeCreated>
<t:ResponseObjects>
<t:ReplyToItem />
<t:ReplyAllToItem />
<t:ForwardItem />
</t:ResponseObjects>
<t:HasAttachments>false</t:HasAttachments>
<t:ToRecipients>
<t:Mailbox>
<t:Name>User1</t:Name>
<t:EmailAddress>User1@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:ToRecipients>
<t:IsReadReceiptRequested>false</t:IsReadReceiptRequested>
<t:IsDeliveryReceiptRequested>false</t:IsDeliveryReceiptRequested>
<t:From>
<t:Mailbox>
<t:Name>User2</t:Name>
<t:EmailAddress>User2@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:From>
<t:IsRead>false</t:IsRead>
</t:Message>
</m:Items>
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Comments
Die MIME-Inhalte, Ordner und Element-IDs wurden verkürzt, um die Lesbarkeit zu erhalten.
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet:
Fehlerantwort-Beispiel für GetItem (e-Mail-Nachricht)
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine GetItem-Anforderung. Der Fehler wurde durch einen Versuch verursacht, eine ungültige zusätzliche Eigenschaft abzurufen.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="685" MinorBuildNumber="8"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetItemResponseMessage ResponseClass="Error">
<m:MessageText>Property is not valid for this object type.</m:MessageText>
<m:ResponseCode>ErrorInvalidPropertyRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:FieldURI FieldURI="meeting:AssociatedCalendarItemId" />
</m:MessageXml>
<m:Items />
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Fehlerantwortelemente
Folgende Elemente werden in der Fehlerantwort verwendet: