Eigenschaftensätze und Antwort shapes in EWS in Exchange

  • Artikel

Erfahren Sie, wie Sie die Antwortformen und Eigenschaftensätze verwalten, die von der verwalteten EWS-API und EWS in Exchange zurückgegeben werden.

Der Exchange-Datenspeicher bietet eine flexible Speicherlösung, mit der Sie verschiedene Elemente wie Kontakte und Kalendereinträge im selben Ordner speichern können. Es kann jedoch schwierig sein, die Daten zu verwalten, die von einem Aufruf eines EWS-Vorgangs oder einer verwalteten EWS-API-Methode zurückgegeben werden.

Um die Verwaltung der Daten zu vereinfachen, die von Exchange Online zurückgegeben werden, Exchange Online als Teil von Office 365 oder version von Excahange ab Exchange 2013, verwendet die verwaltete EWS-API Eigenschaftensätze, und EWS verwendet Antwort-Shapes. Dabei handelt es sich um vordefinierte Auflistungen, die die gängigsten Eigenschaften eines Speicherelements bereitstellen. Der zurückgegebene Eigenschaftensatz wird durch den Elementtyp bestimmt. Wenn Sie also ein Element mithilfe der Exchange Managed API Item.Bind-Methode binden, erhalten Sie je nach Art des Elements, an das Sie binden, einen anderen Satz von Eigenschaften. Die Bindung an ein Kalenderelement gibt einen anderen Satz von Eigenschaften zurück als die Bindung an ein Kontaktelement. Wenn Sie EWS verwenden, gibt der GetItem-Vorgang einen anderen Satz von Eigenschaften basierend auf dem Typ des zurückgegebenen Elements zurück.

Beim Binden an einen Ordner mit der Folder.Bind-Methode oder mithilfe des GetFolder-Vorgangs werden je nach dem von Ihnen gewünschten Ordner auch unterschiedliche Sätze von Eigenschaften zurückgegeben.

Tabelle 1. Vordefinierte Antwort-Shapes

Antwort-Shape Entsprechung in der verwalteten EWS-API Beschreibung
Nur ID
 BasePropertySet.IdOnly
Gibt nur den Bezeichner des Elements oder Ordners zurück. Die meisten Anwendungen sollten dieses Antwort-Shape verwenden und alle erforderlichen zusätzlichen Eigenschaften angeben.
Standard
 –
 Gibt einen vordefinierten Satz von Eigenschaften zurück, die die Standardeinstellung für das Element oder den Ordner sind (nur EWS).
Alle Eigenschaften
 BasePropertySet.FirstClassProperties
Gibt die Eigenschaften zurück, die Clientanwendungen am häufigsten verwenden. Sie können zusätzliche Eigenschaften mithilfe eines Eigenschaftenpfads zurückgeben.

Standardmäßige Antwortshapes

EWS enthält eine Reihe von Standardantwort-Shapes für Ordner und für Elemente.

In der folgenden Tabelle sind die Standardeigenschaften aufgeführt, die von den EWS-Vorgängen FindFolder und GetFolder für jeden Ordner zurückgegeben werden.

Tabelle 2. Standardordnereigenschaften

Eigenschaft Posteingang Calendar Kontakte Gelöschte Elemente Entwürfe Notizen Andere Ordner Postausgang
Anzeigename
 X
 X
 X
 X
 X
 X
 X
 X
Ordner-ID
 X
 X
 X
 X
 X
 X
 X
 X
Anzahl der Unterordner
 X
 X
 X
 X
 X
 X
 X
 X
Gesamtanzahl
 X
 X
 X
 X
 X
 X
 X
Ungelesene Anzahl
 X
 X
 X
 X
 X

In der folgenden Tabelle sind die Standardeigenschaften aufgeführt, die von den EWS-Vorgängen FindItem und GetItem für jeden Elementtyp zurückgegeben werden.

Tabelle 3. Standardelementeigenschaften

Eigenschaft Kalenderelement Kontaktelement Nachrichtenelement Aufgabenelement
Body
 X(1)
CalendarItemType
 x
CompanyName
 x
CompleteName
 x
DateTimeCreated
 x
DateTimeSent
 x
DueDate
 x(2)
EmailAddresses
 x
Ende
 x
FileAs
 x
Von
 x
HasAttachments
 x
 x
 x
 x
ImAddresses
 x
IsAssociated
 x
 x
IsDeliveryReceiptRequested
 x
ItemId
 x
 x
 x
 x
JobTitle
 x
LegacyFreeBusyStatus
 x
Standort
 x
Organisator
 x
PercentComplete
 x
PhoneNumbers
 x
PhysicalAddresses
 x
ResponseObjects
 x(1)
 x(1)
Sensibilität
 x
Größe
 x
StartDate
 x(2)
Status
 x
Betreff
 x
 x
 x

Hinweise:

  1. Enthalten in der Antwort des GetItem-Vorgangs . Nicht in der Antwort des FindItem-Vorgangs enthalten.

  2. Nur in der Antwort enthalten, wenn das Feld Daten enthält. Nicht in der Antwort enthalten, wenn das Feld leer ist.

Alle Eigenschaftensatz und Antwortform

In der folgenden Tabelle sind die erstklassigen Eigenschaften aufgeführt, die durch Aufrufen der EWS Managed API Item.Bind - und Item.FindItems EWS Managed API-Methoden zurückgegeben werden, sowie das Antwort-Shape "alle Eigenschaften", das von den EWS-Vorgängen FindItem und GetItem zurückgegeben wird.

Sie können dem Eigenschaftensatz zusätzliche Eigenschaften hinzufügen oder erweiterte Eigenschaften einschließen. Weitere Informationen finden Sie unter Eigenschaften und erweiterte Eigenschaften in EWS in Exchange.

Tabelle 4. Erstklassige Eigenschaften

Eigenschaft
 Kalenderelement
 Kontaktelement
 Nachrichtenelement
 Beitragselement
 Aufgabenelement
ActualWork
 x
AdjacentMeetingCount
 x
AdjacentMeetings
 x
Alias
 x
AllowNewTimeProposal
 x
AppointmentReplyTime
 x
AppointmentSequenceNumber
 x
AppointmentState
 x
AssignedTime
 x
AssistantName
 x
BccRecipients
 x
BillingInformation
 x
Body
 x(1)
 x(1)
 x(1)
 x(1)
BusinessHomePage
 x
 x
CalendarItemType
 x
Kategorien
 x
 x
 x
 x
CcRecipients
 x
ChangeCount
 x
Untergeordnetes Element
 x
Unternehmen
 x
CompleteDate
 x
CompleteName
 x
ConferenceType
 x
ConflictingMeetingCount
 x
ConflictingMeetings
 x
Kontakte
 x
ContactSource
 x
ConversationId
 x
 x
 x
 x
 x
ConversationIndex
 x
 x
ConversationTopic
 x
 x
Culture
 x
 x
 x
 x
 x
DateTimeCreated
 x
 x
 x
 x
 x
DateTimeReceived
 x
 x
 x
 x
 x
DateTimeSent
 x
 x
 x
 x
 x
DateTimeStamp
 x
DelegationState
 x
Delegator
 x
DeletedOccurrences
 x
Department
 x
DirectoryId
 x
DirectReports
 x
DisplayCc
 x
 x
 x
 x
 x
DisplayName
 x
DisplayTo
 x
 x
 x
 x
 x
DueDate
 x
Dauer
 x
EffectiveRights
 x
 x
 x
 x
 x
EmailAddresses
 x
Ende
 x
EndTimeZone
 x
FileAs
 x
FileAsMapping
 x
FirstOccurrence
 x
Von
 x
 x
Generation
 x
GivenName
 x
HasAttachments
 x
 x
 x
 x
 x
HasPicture
 x
ImAddresses
 x
Importance
 x
 x
 x
 x
 x
Initialen
 x
InReplyTo
 x
 x
 x
 x
 x
InternetMessageId
 x
 x
InternetMessageHeaders
 x
 x
 x
 x
 x
IsAllDayEvent
 x
IsAssociated
 x
 x
 x
 x
 x
IsCancelled
 x
IsComplete
 x
IsDeliveryReceiptRequested
 x
IsDraft
 x
 x
 x
 x
 x
IsFromMe
 x
 x
 x
 x
 x
IsMeeting
 x
IsOnlineMeeting
 x
IsRead
 x
IsReadReceiptRequested
 x
IsRecurring
 x
 x
IsResend
 x
 x
 x
 x
 x
IsResponseRequested
 x
 x
IsSubmitted
 x
 x
 x
 x
 x
IsUnmodified
 x
 x
 x
 x
 x
ItemClass
 x
 x
 x
 x
 x
ItemId
 x
 x
 x
 x
 x
JobTitle
 x
LastModifiedName
 x
 x
 x
 x
 x
LastModifiedTime
 x
 x
 x
 x
 x
LastOccurrance
 x
LegacyFreeBusyStatus
 x
Standort
 x
Manager
 x
MeetingRequestWasSent
 x
MeetingTimeZone
 x
MeetingWorkspaceUrl
 x
MiddleName
 x
Reisekilometer
 x
 x
ModifiedOccurrances
 x
MyResponseType
 x
NetShowUrl
 x
NickName
 x
Anmerkungen
 x
OfficeLocation
 x
OptionalAttendees
 x
Organisator
 x
OriginalStart
 x
Besitzer
 x
ParentFolderId
 x
 x
 x
 x
 x
PercentComplete
 x
PhoneNumbers
 x
PhoneticFirstName
 x
PhoneticFullName
 x
PhoneticLastName
 x
Foto
 x
PhysicalAddresses
 x
PostalAddressIndex
 x
PostedTime
 x
Beruf
 x
ReceivedBy
 x
ReceivedRepresenting
 x
Reccurrence
 x
 x
References
 x
 x
ReminderDueBy
 x
 x
 x
 x
 x
ReminderIsSet
 x
 x
 x
 x
 x
ReminderMinutesBeforeStart
 x
 x
 x
 x
 x
ReplyTo
 x
RequiredAttendees
 x
Ressourcen
 x
ResponseObjects
 x(1)
 x(1)
 x(1)
 x(1)
 x(1)
Absender
 x
 x
Vertraulichkeit
 x
 x
 x
 x
 x
Größe
 x
 x
 x
 x
 x
SpouseName
 x
Start
 x
StartDate
 x
StartTimeZone
 x
Status
 x
StatusDescription
 x
Betreff
 x
 x
 x
 x
Nachname
 x
TimeZone
 x
ToRecipients
 x
TotalWork
 x
WebClientEditFormQueryString
 x
 x
 x
 x
 x
WebClientReadFormQueryString
 x
 x
 x
 x
 x

Hinweise:

  1. Enthalten beim Binden an ein Element und in der Antwort des GetItem-Vorgangs. Nicht im Ergebnis der Item.FindItems-Methode oder in der Antwort des FindItem-Vorgangs enthalten.

Siehe auch