CreateAttachment-Vorgang

Artikel
03/29/2023

Der CreateAttachment-Vorgang erstellt entweder ein Element oder eine Dateianlage und fügt sie an das angegebene Element an.

Beispiel für die Anforderung "File CreateAttachment"

Das folgende Beispiel einer CreateAttachment-Anforderung zeigt, wie eine Dateianlage erstellt wird.

<?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="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
  <CreateAttachment xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                    xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
    <ParentItemId Id="AAAtAE..." ChangeKey="CQAAABYA..."/>
    <Attachments>
      <t:FileAttachment>
        <t:Name>SomeFile</t:Name>
        <t:Content>AQIDBAU=</t:Content>
      </t:FileAttachment>
    </Attachments>
  </CreateAttachment>
</soap:Body>
</soap:Envelope>

Ein Name für die Anlage muss angegeben werden.

Hinweis

Der Bezeichner des übergeordneten Elements und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

File CreateAttachment-Anforderungselemente

In der Anforderung werden folgende Elemente verwendet:

Beispiel für eine erfolgreiche CreateAttachment-Antwort in der Datei

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die CreateAttachment-Anforderung.

<?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="653" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Attachments>
            <t:FileAttachment>
              <t:AttachmentId Id="AAAtAE=" RootItemId="AAAtAEFk=" RootItemChangeKey="CQAAAB"/>
            </t:FileAttachment>
          </m:Attachments>
        </m:CreateAttachmentResponseMessage>
      </m:ResponseMessages>
    </CreateAttachmentResponse>
  </soap:Body>
</soap:Envelope>

Die Antwort enthält den Bezeichner der angefügten Datei. Sie enthält auch den Bezeichner und den Änderungsschlüssel des Stammelements. Die Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

Erfolgreiche Datei CreateAttachment-Antwortelemente

In der Antwort werden folgende Elemente verwendet:

Element CreateAttachment-Anforderungsbeispiel

Das folgende Beispiel einer CreateAttachment-Anforderung zeigt, wie eine Elementanlage erstellt wird.

<?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="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateAttachment xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                      xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <ParentItemId Id="AAAtAE=" ChangeKey="CQAAABYA"/>
      <Attachments>
        <t:ItemAttachment>
          <t:Name>An item attachment</t:Name>
          <t:Message>
            <t:Subject>A message to attach</t:Subject>
          </t:Message>
        </t:ItemAttachment>
      </Attachments>
    </CreateAttachment>
  </soap:Body>
</soap:Envelope>

Ein Name für die Anlage muss angegeben werden. Der Bezeichner des übergeordneten Elements und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

Element CreateAttachement-Anforderungselemente

In der Anforderung werden folgende Elemente verwendet:

Beispiel für eine erfolgreiche CreateAttachment-Antwort des Elements

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf die CreateAttachment-Anforderung.

<?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="653" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Attachments>
            <t:ItemAttachment>
              <t:AttachmentId Id="AAAtAEFk=" RootItemId="AAAtAEFkb=" RootItemChangeKey="CQAAABYA"/>
            </t:ItemAttachment>
          </m:Attachments>
        </m:CreateAttachmentResponseMessage>
      </m:ResponseMessages>
    </CreateAttachmentResponse>
  </soap:Body>
</soap:Envelope>

Die Antwort enthält den Bezeichner der neuen Anlage. Sie enthält auch den Bezeichner und den Änderungsschlüssel des Stammelements. Das Stammelement ist das Element, das die Anlage enthält. Die Elementbezeichner und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

Erfolgreiche CreateAttachment-Antwortelemente des Elements

In der Antwort werden folgende Elemente verwendet:

Beispiel für createAttachment-Fehlerantwort

Das folgende Beispiel zeigt eine Fehlerantwort auf die CreateAttachment-Anforderung. Der Fehler ist darauf zurückzuführen, dass der Name der Anlage nicht angegeben wurde.

<?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="653" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Error">
          <m:MessageText>Required property is missing.</m:MessageText>
          <m:ResponseCode>ErrorRequiredPropertyMissing</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:MessageXml>
            <t:ExceptionFieldURI FieldURI="attachment:Name"/>
          </m:MessageXml>
          <m:Attachments/>
        </m:CreateAttachmentResponseMessage>
      </m:ResponseMessages>
    </CreateAttachmentResponse>
  </soap:Body>
</soap:Envelope>

CreateAttachment-Fehlerantwortelemente

Folgende Elemente werden in der Fehlerantwort verwendet:

HinwBemerkungeneise

Wenn in einem einzelnen Roundtrip mehrere Anlagen an ein Element angefügt werden, ist rootItemChangeKey in der letzten Antwortnachricht diejenige, die den neuen Änderungsschlüssel des Elements darstellt, das die Anlagen enthält.

Siehe auch

DeleteAttachment-Vorgang GetAttachment-Vorgang

Freigeben über