SendItem-Vorgang
Der SendItem-Vorgang wird verwendet, um E-Mail-Nachrichten zu senden, die sich im Exchange-Speicher befinden.
Im folgenden Beispiel wird das Senden einer E-Mail-Nachricht veranschaulicht.
<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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<SendItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
SaveItemToFolder="true">
<ItemIds>
<t:ItemId Id="AAAtAEF=" ChangeKey="CQAAABY+T" />
</ItemIds>
</SendItem>
</soap:Body>
</soap:Envelope>
Der Elementbezeichner wurde gekürzt, um die Lesbarkeit zu erhalten.
In der Anforderung werden folgende Elemente verwendet:
Das folgende Beispiel zeigt eine erfolgreiche SendItem-Antwort.
<?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="602" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<SendItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:SendItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:SendItemResponseMessage>
</m:ResponseMessages>
</SendItemResponse>
</soap:Body>
</soap:Envelope>
In der Antwort werden folgende Elemente verwendet:
Ein Delegat, der versucht, eine E-Mail-Nachricht zu senden, die sich im Ordner "Entwürfe" des Prinzipals befindet, wobei die Option SendAndSaveCopy zum Speichern einer Kopie im Ordner "Gesendete Elemente" festgelegt ist, kann eine Kopie des gesendeten Elements im Hintergrund nicht in den Ordner "Gesendete Elemente" verschoben werden. Das Element verbleibt im Ordner Entwürfe des Prinzipals. Die Problemumgehung besteht darin, das Postfach des Prinzipals im DistinguishedFolderId-Element anzugeben.
Ein weiteres Szenario ist, wenn ein Delegat eine E-Mail-Nachricht erstellt und im Ordner Entwürfe des Postfachs des Delegaten speichert. Wenn der Delegat versucht, das Element zu senden und eine Kopie im Ordner "Gesendete Elemente" des Prinzipals zu speichern, wird die Nachricht ordnungsgemäß gesendet, der Nachrichtenentwurf verbleibt im Ordner "Entwürfe" des Delegaten, die gesendete Nachricht wird weder im Ordner 'Gesendete Elemente' des Delegaten noch im Prinzipal angezeigt, und die Antwort ist erfolgreich.
Das folgende Codebeispiel zeigt ein Beispiel für eine Anforderung mit einem ungültigen Bezeichner.
<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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<SendItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
SaveItemToFolder="true">
<ItemIds>
<t:ItemId Id="%BadItemId%" ChangeKey="CQAAABYAAA" />
</ItemIds>
</SendItem>
</soap:Body>
</soap:Envelope>
Das folgende Beispiel zeigt eine Fehlerantwort auf eine SendItem-Anforderung, die einen ungültigen Bezeichner enthält.
<?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="602" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<SendItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:SendItemResponseMessage ResponseClass="Error">
<m:MessageText>Id is malformed.</m:MessageText>
<m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:SendItemResponseMessage>
</m:ResponseMessages>
</SendItemResponse>
</soap:Body>
</soap:Envelope>
Folgende Elemente werden in der Fehlerantwort verwendet:
SendItemType