Microsoft Exchange v2-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8858 des Connectors.

Erste Schritte

Versionsunterstützung für Microsoft Exchange

Der Jitterbit Connector für Microsoft Exchange stellt eine Verbindung mit der REST- API her.

Herstellen einer Verbindung

Herstellen einer Verbindung mit Microsoft Exchange

Für die Verbindung mit Exchange stehen zwei Schemata zur Verfügung:

• Exchange Web Services (EWS), das nicht mehr aktualisiert wird, aber weiterhin sowohl für Exchange OnPremise als auch für Exchange Online verfügbar ist.
  

• Microsoft Graph

Eine Übersicht über das Datenmodell für jedes dieser Schemata finden Sie unter „Datenmodell“.

Um zwischen EWS und Microsoft Graph zu wechseln, setzen Sie Schema entweder EWS oder MSGraph.

Exchange Online-Benutzer, die weiterhin EWS verwenden möchten, sollten Folgendes festlegen: Schema Zu EWS und das Platform Zu Exchange_Online.

Exchange vor Ort

Microsoft Exchange OnPremise-Standards festgelegt User, Password, Und AuthScheme zur Unterstützung der Basisauthentifizierung. OnPremise unterstützt jedoch auch die Authentifizierung über Windows (NTLM), Kerberos (unten beschrieben) und das Löschen.

Exchange Online

Exchange Online unterstützt die Authentifizierung über OAuth, wie unten beschrieben. (Azure AD und Microsoft Entra-Dienstprinzipale verwenden auch benutzerdefinierte OAuth-Anwendungen zur Authentifizierung.)

Wenn Sie über EWS eine Verbindung zur Exchange Online-Plattform herstellen, legen Sie fest AuthScheme Zu AzureAD, AzureServicePrincipal, oder AzureMSI.

Wenn Sie sich über Microsoft Graph mit Exchange Online verbinden, legen Sie fest Schema Zu MSGraph. Wann Schema ist auf MSGraph eingestellt, der Platform wird ignoriert.

Authentifizieren bei Microsoft Exchange

Microsoft Exchange unterstützt die Authentifizierung mit OAuth (Azure AD und Microsoft Entra-Dienstprinzipal), Managed Service Identity (MSI) oder Kerberos.

OAuth

Sowohl Azure AD als auch Microsoft Entra-Dienstprinzipal erfordern eine OAuth-basierte Authentifizierung.

Microsoft Entra ID

Azure AD ist der mehrinstanzenfähige, cloudbasierte Verzeichnis- und Identitätsverwaltungsdienst von Microsoft. Es handelt sich um eine benutzerbasierte Authentifizierung, für die Sie Folgendes festlegen müssen: AuthScheme Zu AzureAD.

Microsoft Exchange bietet eingebettete OAuth-Anmeldeinformationen, die die Verbindung von einer Desktop-Anwendung aus vereinfachen. Um eine Verbindung von einer Webanwendung aus herzustellen, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen, wie in Erstellen einer benutzerdefinierten OAuth-Anwendung beschrieben.

Um von allen Authentifizierungsabläufen aus eine Verbindung über OAuth herzustellen, müssen Sie festlegen AuthScheme Zu OAuth.

In den folgenden Unterabschnitten wird beschrieben, wie Sie sich von allen anwendbaren Authentifizierungsabläufen aus bei Microsoft Exchange authentifizieren. Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung und warum Sie möglicherweise eine solche sogar für Authentifizierungsabläufe erstellen möchten, die bereits eingebettete OAuth-Anmeldeinformationen haben, finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung. Eine vollständige Liste der in Microsoft Exchange verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.

Desktop-Anwendungen

bietet eine eingebettete OAuth-Anwendung, die die Authentifizierung am Desktop vereinfacht.

Sie können sich auch vom Desktop aus über eine benutzerdefinierte OAuth-Anwendung authentifizieren, die Sie in der Microsoft Exchange Konsole konfigurieren und registrieren. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Legen Sie vor dem Verbinden die folgenden Variablen fest:

• InitiateOAuth: GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken. bietet eine eingebettete OAuth-Anwendung, die die Authentifizierung auf dem Desktop vereinfacht, d. h. in Situationen, in denen der Benutzer einen lokalen Server verwendet, der nicht mit dem Internet verbunden ist.

  Sie können sich auch vom Desktop aus über eine benutzerdefinierte OAuth-Anwendung authentifizieren, die Sie in der Microsoft Exchange Konsole konfigurieren und registrieren. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

• Custom Azure AD applications only:

  • OAuthClientId: Die Client-ID, die Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.
  • OAuthClientSecret: Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.
  • CallbackURL: Die Umleitungs-URI, die bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Microsoft Exchange in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Anschließend schließt der Connector den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector es automatisch.

Microsoft Entra-Dienstprinzipal

Azure Service Principal ist eine rollenbasierte, anwendungsbasierte Authentifizierung. Dies bedeutet, dass die Authentifizierung pro Anwendung und nicht pro Benutzer erfolgt. Alle von der Anwendung ausgeführten Aufgaben werden ohne Standardbenutzerkontext, sondern basierend auf den zugewiesenen Rollen ausgeführt.

Der Anwendungszugriff auf die Ressourcen wird über die Berechtigungen der zugewiesenen Rollen gesteuert.

Informationen zum Einrichten der Microsoft Entra-Dienstprinzipalauthentifizierung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Authentifizierung über Client Secret

OAuth unterstützt die Verwendung von Clientanmeldeinformationen zur Authentifizierung. In einem OAuth-Flow mit Clientanmeldeinformationen werden Anmeldeinformationen für die authentifizierende Anwendung selbst erstellt. Der Authentifizierungsflow verhält sich wie der übliche Authentifizierungsflow, mit der Ausnahme, dass ein zugeordneter Benutzer nicht aufgefordert wird, Anmeldeinformationen anzugeben.

Alle von der Anwendung akzeptierten Aufgaben werden außerhalb des Kontexts eines Standardbenutzers ausgeführt.

in einem Client-OAuth-Flow verwenden. Sie müssen immer eine benutzerdefinierte OAuth-Anwendung erstellen, um Client-Anmeldeinformationen zu verwenden.

Die Authentifizierung über Client-Anmeldeinformationen erfordert die Verwendung einer benutzerdefinierten OAuth-Anwendung. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Nachdem Sie diese Parameter festgelegt haben, können Sie eine Verbindung herstellen.

• AuthScheme: AzureServicePrincipal.
• InitiateOAuth: GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.
• AzureTenant: Der Mandant, mit dem Sie sich verbinden möchten.
• OAuthGrantType: CLIENT.
• OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
• OAuthClientSecret: Das Client-Geheimnis in Ihren Anwendungseinstellungen.

Die Authentifizierung mit Client-Anmeldeinformationen erfolgt automatisch, genau wie bei jeder anderen Verbindung, mit der Ausnahme, dass kein Fenster geöffnet wird, das den Benutzer zur Anmeldung auffordert. Da kein Benutzerkontext vorhanden ist, ist kein Browser-Popup erforderlich. Verbindungen werden intern hergestellt und verarbeitet.

Verwaltete Dienstidentität (MSI)

Wenn Sie Microsoft Exchange auf einer Azure-VM ausführen und MSI zur Verbindung nutzen möchten, setzen Sie AuthScheme Zu AzureMSI.

Vom Benutzer verwaltete Identitäten

Um ein Token für eine verwaltete Identität zu erhalten, verwenden Sie OAuthClientId Eigenschaft zur Angabe der „client_id“ der verwalteten Identität.

Wenn Ihre VM über mehrere benutzerzugewiesene verwaltete Identitäten verfügt, müssen Sie außerdem Folgendes angeben: OAuthClientId.

Kerberos

Für die Authentifizierung bei Microsoft Exchange über Kerberos müssen Sie Authentifizierungseigenschaften definieren und auswählen, wie Kerberos Authentifizierungstickets abrufen soll.

Um sich mit Kerberos bei Microsoft Exchange zu authentifizieren, legen Sie diese Eigenschaften fest:

• AuthScheme: NEGOTIATE.
• KerberosKDC: Der Host oder die IP-Adresse Ihrer Kerberos-KDC-Maschine.
• KerberosRealm: Der Bereich des Microsoft Exchange Kerberos-Prinzipals. Suchen Sie diesen Wert direkt nach dem Symbol „@“ des Prinzipalwerts.
• KerberosSPN: Der Dienst und Host des Microsoft Exchange Kerberos-Prinzipals. Suchen Sie diesen Wert direkt vor dem Symbol „@“ des Prinzipalwerts.

Weitere Informationen zur Verwendung von Kerberos in einer Microsoft Exchange Umfeld finden Sie unter Verwenden von Kerberos.

Microsoft Entra-Dienstprinzipal verwenden

Microsoft Entra-Dienstprinzipal

Azure Service Principal ist eine rollenbasierte, anwendungsbasierte Authentifizierung. Dies bedeutet, dass die Authentifizierung pro Anwendung und nicht pro Benutzer erfolgt. Alle von der App ausgeführten Aufgaben werden ohne Standardbenutzerkontext, sondern basierend auf den zugewiesenen Rollen ausgeführt. Der Anwendungszugriff auf die Ressourcen wird über die Berechtigungen der zugewiesenen Rollen gesteuert.

Um die Dienstprinzipalauthentifizierung von Microsoft Entra zu verwenden, müssen Sie:

• Richten Sie die Möglichkeit ein, der Authentifizierungsanwendung eine Rolle zuzuweisen. Erstellen Sie dazu eine benutzerdefinierte OAuth AD-Anwendung, wie unter Erstellen einer benutzerdefinierten OAuth-Anwendung beschrieben.
• Registrieren Sie eine Anwendung mit einem Microsoft Entra ID Mandanten, um einen neuen Dienstprinzipal zu erstellen, der mit der rollenbasierten Zugriffssteuerung verwendet werden kann, um auf Ressourcen in Ihrem Abonnement zuzugreifen.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie eine benutzerdefinierte Microsoft Entra ID Anwendung, wie unter Erstellen einer benutzerdefinierten OAuth-Anwendung beschrieben.
2. Weisen Sie der Anwendung eine Rolle zu:
   1. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
   2. Öffnen Sie die Subscriptions-Seite.
   3. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
   4. Öffnen Sie die Access control (IAM).
   5. Wählen Sie Add > Add role assignment. Microsoft Exchange öffnet die Add role assignment Seite.
   6. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

Zustimmung des Administrators

Die Administratorzustimmung erfolgt, wenn der Administrator für einen Microsoft Entra ID Mandanten Berechtigungen für eine benutzerdefinierte Anwendung erteilt, für die ausdrücklich die Zustimmung eines Administrators zum Anwendungsfall erforderlich ist.

Wenn Sie im Azure-Portal eine neue Microsoft Entra ID Anwendung erstellen, müssen Sie angeben, welche Berechtigungen die Anwendung benötigt. Einige Berechtigungen können als „Administratorzustimmung erforderlich“ gekennzeichnet sein. Beispielsweise erfordern alle Gruppenberechtigungen die Administratorzustimmung. Wenn Ihre Anwendung die Administratorzustimmung erfordert, können Sie dies auf zwei Arten tun.

Der einfachste Weg, die Administrator-Zustimmung zu erteilen, besteht darin, dass sich ein Administrator anmeldet portal.azure.com und navigieren Sie zu der Anwendung, die Sie in App-Registrierungen erstellt haben. Unter API Permissions, klick Grant Consent. Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.

Wenn Ihre Organisation mehrere Mandanten hat oder Sie Anwendungsberechtigungen für andere Mandanten außerhalb Ihrer Organisation erteilen müssen, verwenden Sie GetAdminConsentURL gespeicherte Prozedur zum Generieren der Admin-Autorisierungs URL. Im Gegensatz zur GetOAuthAuthorizationURL gespeicherte Prozedur werden von diesem Endpoint keine wichtigen Informationen zurückgegeben. Stattdessen gibt die OAuth-Anwendung nach erfolgreicher Autorisierung einen Boolean-Wert zurück, der angibt, dass Berechtigungen erteilt wurden.

Nachdem der Administrator die OAuth-Anwendung genehmigt hat, können Sie mit der Authentifizierung fortfahren.

Client-Anmeldeinformationen

Client-Anmeldeinformationen bezieht sich auf einen Ablauf in OAuth, bei dem keine direkte Benutzerauthentifizierung stattfindet. Stattdessen werden Anmeldeinformationen nur für die Anwendung selbst erstellt. Alle von der Anwendung ausgeführten Aufgaben werden ohne einen Standardbenutzerkontext ausgeführt. Dadurch unterscheidet sich der Authentifizierungsablauf etwas vom Standardablauf.

Für alle Berechtigungen im Zusammenhang mit dem Client-OAuth-Flow ist die Zustimmung des Administrators erforderlich. Dies bedeutet, dass Sie die mit dem Jitterbit Connector für Microsoft Exchange eingebettete Anwendung nicht im Client-OAuth-Flow verwenden können. Sie müssen Ihre eigene OAuth-Anwendung erstellen, um Client-Anmeldeinformationen verwenden zu können. Siehe Erstellen einer benutzerdefinierten OAuth-Anwendung für weitere Informationen.

In Ihrer App-Registrierung in portal.azure.com, navigieren Sie zu API Berechtigungen und wählen Sie die Microsoft Graph permissions. Es gibt zwei verschiedene Berechtigungssätze: Delegierte Berechtigungen und Anwendungsberechtigungen. Die während der Client-Anmeldeauthentifizierung verwendeten Berechtigungen finden Sie unter „Anwendungsberechtigungen“.

Wählen Sie die Berechtigungen aus, die Sie für Ihre Integration benötigen. Legen Sie anschließend die folgenden Verbindungseigenschaften fest:

• AuthScheme: AzureServicePrincipal.
• InitiateOAuth: GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.
• AzureTenant: Der Mandant, mit dem Sie sich verbinden möchten.
• OAuthGrantType: CLIENT.
• OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
• OAuthClientSecret: Das Client-Geheimnis in Ihren Anwendungseinstellungen.

Die Authentifizierung mit Client-Anmeldeinformationen erfolgt automatisch wie bei jeder anderen Verbindung, außer dass kein Fenster geöffnet wird, das den Benutzer auffordert. Da kein Benutzerkontext vorhanden ist, ist kein Browser-Popup erforderlich. Verbindungen werden hergestellt und intern gehandhabt.

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

Microsoft Exchange unterstützt die Authentifizierung mithilfe der Microsoft Entra ID und des Microsoft Entra-Dienstprinzipals, die beide auf OAuth basieren.

In diesem Thema wird Folgendes beschrieben:

• Erstellen und Registrieren einer benutzerdefinierten OAuth-Anwendung für die Microsoft Entra ID oder den Microsoft Entra-Dienstprinzipal
• Erteilen Sie die Administratorzustimmung für eine benutzerdefinierte OAuth-Anwendung
• Erstellen Sie eine benutzerdefinierte OAuth-Anwendung zur Verwendung mit Client-Anmeldeinformationen

Microsoft Entra ID

In portal.azure.com:

1. Melden Sie sich an bei https://portal.azure.com.
2. Wählen Sie im linken Navigationsbereich Microsoft Entra ID, Dann applicationRegistrations.
3. Klicken Sie auf New registration.
4. Geben Sie einen Namen für die Anwendung ein.
5. Wählen Sie die gewünschte Mandantenkonfiguration aus: Einzel- oder Mehrmandant und öffentliche oder private Nutzung.
   • Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die AzureTenant Verbindungseigenschaft auf die ID des Microsoft Entra ID Tenant, wenn eine Verbindung mit dem Jitterbit Connector für Microsoft Exchange hergestellt wird. Andernfalls schlägt der Authentifizierungsversuch mit einem Fehler fehl.
   • Wenn Ihre Anwendung nur für den privaten Gebrauch bestimmt ist, geben Sie an Accounts in this organization directory only.
   • Wenn Sie Ihre Anwendung verteilen möchten, wählen Sie eine der Multi-Tenant-Optionen.
6. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standard des Connectors) ODER geben Sie einen anderen Port an und setzen Sie CallbackURL an die genaue Antwort-URL, die Sie definiert haben.
7. Klicken Sie auf Register, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
   Notieren Sie den Wert in Application (client) ID als OAuthClientId und das Directory (tenant) ID als AzureTenant.
8. Navigieren Sie zu Certificates & Secrets und definieren Sie den Authentifizierungstyp der Anwendung. Es stehen zwei Arten der Authentifizierung zur Verfügung: Zertifikat (empfohlen) oder Client-Geheimnis.
   • Für die Zertifikatauthentifizierung: In Certificates & Secrets, wählen Upload certificate, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch.
   • Zum Erstellen eines neuen Client-Geheimnisses: In Certificates & Secrets, wählen New Client Secret für die Anwendung und geben Sie deren Dauer an. Nachdem das Client-Geheimnis gespeichert wurde, zeigt Microsoft Exchange den Schlüsselwert an. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird. Dieser Wert wird zum OAuthClientSecret.
9. Auswählen API Permissions > Add > Delegated permissions.
10. Wenn Sie die Verbindung zu Microsoft Exchange über das EWS Schema herstellen, wählen Sie Exchange API und fügen Sie die Berechtigung EWS.AccessAsUser.All hinzu. Wenn Sie die Verbindung zu Microsoft Exchange über das MSGraph-Schema herstellen, wählen Sie Microsoft Graph API und fügen Sie die folgenden Berechtigungen hinzu: Calendars.ReadWrite.Shared, Contacts.ReadWrite, Group.Read.All, Group.ReadWrite.All, User.ReadWrite.All und Mail.ReadWrite.Shared.
11. Speichern Sie Ihre Änderungen.
12. Wenn Sie die Verwendung von Berechtigungen angegeben haben, für die die Zustimmung des Administrators erforderlich ist (z. B. Anwendungsberechtigungen), können Sie diese vom aktuellen Mandanten aus auf der Seite „API Berechtigungen“ erteilen.

Microsoft Entra-Dienstprinzipal

Um die Microsoft Entra-Dienstprinzipalauthentifizierung zu verwenden, müssen Sie die Möglichkeit einrichten, der Authentifizierungsanwendung eine Rolle zuzuweisen. Anschließend müssen Sie eine Anwendung beim Microsoft Entra ID Mandanten registrieren, um einen neuen Dienstprinzipal zu erstellen. Dieser neue Dienstprinzipal kann dann den zugewiesenen rollenbasierten Zugriff nutzen.

Kontrolle über den Zugriff auf Ressourcen in Ihrem Abonnement.

In portal.azure.com:

1. Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
2. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
3. Öffnen Sie die Subscriptions Seite.
4. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
5. Öffnen Sie die Access control (IAM).
6. Auswählen Add > Add role assignment. Microsoft Exchange öffnet die Add role assignment Seite.
7. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

Zustimmung des Administrators

Einige benutzerdefinierte Anwendungen erfordern Administratorberechtigungen, um innerhalb eines Microsoft Entra ID Mandanten ausgeführt zu werden. Die Administratorzustimmung kann beim Erstellen einer neuen benutzerdefinierten OAuth-Anwendung erteilt werden, indem relevante Berechtigungen hinzugefügt werden, die bereits mit „Administratorzustimmung erforderlich“ gekennzeichnet sind. Die Administratorzustimmung ist auch erforderlich, um Clientanmeldeinformationen im OAuth-Flow zu verwenden.

So erteilen Sie die Administratoreinwilligung:

1. Lassen Sie einen Administrator sich anmelden bei portal.azure.com.
2. Navigieren Sie zu App Registrations und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben.
3. Unter API Permissions, klick Grant Consent.

Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.

Zustimmung zu Kundenanmeldeinformationen

OAuth unterstützt die Verwendung von Clientanmeldeinformationen zur Authentifizierung. In einem OAuth-Flow mit Clientanmeldeinformationen werden Anmeldeinformationen für die authentifizierende Anwendung selbst erstellt. Der Authentifizierungsflow verhält sich wie der übliche Authentifizierungsflow, mit der Ausnahme, dass ein zugeordneter Benutzer nicht aufgefordert wird, Anmeldeinformationen anzugeben.

Alle von der Anwendung akzeptierten Aufgaben werden außerhalb des Kontexts eines Standardbenutzers ausgeführt.

in einem Client-OAuth-Flow verwenden. Sie müssen immer eine benutzerdefinierte OAuth-Anwendung erstellen, um Client-Anmeldeinformationen zu verwenden.

In portal.azure.com:

1. Erstellen Sie eine benutzerdefinierte OAuth-Anwendung, wie oben beschrieben.
2. Navigieren Sie zu App Registrations.
3. Suchen Sie die Anwendung, die Sie gerade erstellt haben, und öffnen Sie API Permissions.
4. Wählen Sie die Microsoft Graph-Berechtigungen aus. Es gibt zwei verschiedene Berechtigungssätze: Delegiert und Anwendung.
5. Unter Application Permissions, wählen Sie die Berechtigungen aus, die Sie für Ihre Integration benötigen.

Kerberos verwenden

Kerberos

Um sich mit Kerberos bei Microsoft Exchange zu authentifizieren, setzen Sie AuthScheme Zu NEGOTIATE.

Für die Authentifizierung bei Microsoft Exchange über Kerberos müssen Sie Authentifizierungseigenschaften definieren und auswählen, wie Kerberos Authentifizierungstickets abrufen soll.

Abrufen von Kerberos-Tickets

Kerberos-Tickets werden verwendet, um die Identität des Anforderers zu authentifizieren. Durch die Verwendung von Tickets anstelle von formellen Logins/Passwörtern entfällt die Notwendigkeit, Passwörter lokal zu speichern oder über ein Netzwerk zu senden. Benutzer werden erneut authentifiziert (Tickets werden aktualisiert), wenn sie sich an ihrem lokalen Computer anmelden oder kinit USER in der Eingabeaufforderung.

Der Connector bietet drei Möglichkeiten, das erforderliche Kerberos-Ticket abzurufen, je nachdem, ob das KRB5CCNAME und/oder KerberosKeytabFile Variablen sind in Ihrer Umfeld vorhanden.

MIT Kerberos-Anmeldeinformations-Cache-Datei

Mit dieser Option können Sie den MIT Kerberos Ticket Manager verwenden oder kinit Befehl zum Abrufen von Tickets. Mit dieser Option ist es nicht erforderlich, den User oder Password Verbindungseigenschaften.

Diese Option erfordert, dass KRB5CCNAME wurde in Ihrem System erstellt.

So aktivieren Sie den Ticketabruf über MIT Cerberos Credential Cache Files:

1. Stellen Sie sicher, dass KRB5CCNAME Variable ist in Ihrer Umfeld vorhanden.
2. Satz KRB5CCNAME zu einem Pfad, der auf Ihre Anmeldeinformations-Cachedatei verweist. (Beispiel: C:\krb_cache\krb5cc_0 oder /tmp/krb5cc_0.) Die Anmeldeinformations-Cachedatei wird erstellt, wenn Sie den MIT Kerberos Ticket Manager zum Generieren Ihres Tickets verwenden.

3. So erhalten Sie ein Ticket:

   1. Öffnen Sie die Anwendung MIT Kerberos Ticket Manager.
   2. Klicken Sie auf Get Ticket.
   3. Geben Sie Ihren Hauptnamen und Ihr Passwort ein.
   4. Klicken Sie auf OK.

   Wenn das Ticket erfolgreich abgerufen wurde, werden die Ticketinformationen im Kerberos Ticket Manager angezeigt und in der Anmeldeinformations-Cache-Datei gespeichert.

Der Connector verwendet die Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Microsoft Exchange abzurufen.

Keytab-Datei

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld, Sie können ein Kerberos-Ticket mithilfe einer Keytab-Datei abrufen.

Um diese Methode zu verwenden, setzen Sie die User Eigenschaft auf den gewünschten Benutzernamen und legen Sie die KerberosKeytabFile-Eigenschaft auf einen Dateipfad, der auf die mit dem Benutzer verknüpfte Keytab-Datei verweist.

Benutzer und Passwort

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld und die KerberosKeytabFile-Eigenschaft nicht festgelegt wurde, können Sie ein Ticket mithilfe einer Benutzer- und Passwortkombination abrufen.

Um diese Methode zu verwenden, legen Sie die-Eigenschaft fest User Und Password Eigenschaften für die Benutzer-/Passwortkombination, die Sie zur Authentifizierung bei Microsoft Exchange verwenden.

Cross-Realm-Authentifizierung aktivieren

Komplexere Kerberos-Umgebungen können eine Cross-Realm-Authentifizierung erfordern, wenn mehrere Realms und KDC-Server verwendet werden. Beispielsweise können sie einen Realm/KDC für die Benutzerauthentifizierung und einen anderen Realm/KDC zum Abrufen des Servicetickets verwenden.

Um diese Art der Cross-Realm-Authentifizierung zu aktivieren, setzen Sie das KerberosRealm Und KerberosKDC Eigenschaften auf die Werte, die für die Benutzerauthentifizierung erforderlich sind. Setzen Sie außerdem die KerberosServiceRealm Und KerberosServiceKDC Eigenschaften auf die Werte, die zum Erhalt des Servicetickets erforderlich sind.

Exchange Online-Verwaltungsaufgaben

Mit dem Jitterbit Connector für Microsoft Exchange können Verwaltungsaufgaben mit MSGraph durchgeführt werden Schema. Dies kann durch Angabe der UserId-Spalte zum Ausführen von CUD-Operationen erfolgen.

Die UserId-Spalte

Viele Tabellen enthalten eine spezielle UserId-Spalte. Diese ist für Administratoren gedacht, die Datensätze im Konto eines anderen Benutzers ändern möchten. Wenn Sie kein Administrator sind oder dieses Verhalten nicht wünschen, geben Sie die UserId nicht an, wenn Sie einen INSERT-/UPDATE-/DELETE Operation ausführen. Wenn Sie beispielsweise Folgendes ausführen, wird ein Kontakt für einen anderen Benutzer eingefügt:

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

Die obige Anfrage hat insgesamt den Effekt, dass versucht wird, einen Kontakt unter der Ressource unter /users/12345/contacts hinzuzufügen. Wenn UserId nicht angegeben ist, werden die betroffenen Ressourcen stattdessen unter /users/me/contacts geändert. Wenn Sie kein Administrator sind, können Sie im Allgemeinen nur Datensätze unter /users/me beeinflussen oder anzeigen. Es wird daher nicht empfohlen, UserId festzulegen, wenn Sie kein Administrator sind.

Wählen Sie Daten austauschen

Hinweis: Im Folgenden wird das Verhalten beschrieben, wenn Schema ist auf EWS eingestellt. Es hat keine Auswirkungen auf MSGraph.

FindItem vs. GetItem

Standardmäßig führt der Connector den FindItem-API Aufruf der Exchange Web Services aus und fordert nur dann zusammenfassende Informationen zu Elementen an, wenn ein SELECT Operation ausgeführt wird. Jede Anforderung, die mehr als ein Element zurückgeben könnte, gibt nur zusammenfassende Informationen zurück. Beispiel:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith'

Wenn Sie den Inhalt einer Nachricht oder weitere Informationen zu einem Kontakt oder einem Kalenderereignis anfordern möchten, müssen Sie festlegen IncludeContent auf TRUE, geben Sie die ItemIds der Artikel an oder beschränken Sie Ihre Ergebnisse auf einen einzelnen Artikel. Beispiel:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemId='AZQ111222...'

ODER

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemdId IN ('AZQ111222...', 'AZQ111223...', 'AZQ111224...', 'AZQ111225...')

ODER

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith' LIMIT 1

Öffentliche und benutzerdefinierte Ordner

Wenn Sie aus einem öffentlichen oder benutzerdefinierten Ordner lesen möchten, müssen Sie zunächst die Ordner-ID des Ordners ermitteln, aus dem Sie lesen möchten. Dies kann durch Senden einer Abfrage aus dem übergeordneten Ordner (für einen benutzerdefinierten Ordner) oder aus der entsprechenden Tabelle für den Objekttyp erfolgen, der in einem öffentlichen Ordner gespeichert ist. Verwenden Sie dazu den Posteingang, wenn der öffentliche Ordner

enthält Nachrichten. Beispiel:

So ermitteln Sie die Ordner-ID eines Unterordners im Posteingang:

SELECT DisplayName, FolderId FROM Inbox

So finden Sie die Ordner-ID eines benutzerdefinierten Ordners, der Kontakte enthält:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderName='publicfoldersroot'

Wenn Ihr öffentlicher Ordner verschachtelt ist, müssen Sie möglicherweise eine separate SELECT- Abfrage für den übergeordneten benutzerdefinierten Ordner ausführen:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderId='AAEuAAAAAAAa...'

Erstellen von Elementen in öffentlichen und benutzerdefinierten Ordnern

In öffentliche und benutzerdefinierte Ordner einfügen

Wenn Sie ein Element in einem öffentlichen oder benutzerdefinierten Ordner erstellen möchten, müssen Sie zuerst die Ordner-ID des Ordners ermitteln, aus dem Sie lesen möchten (siehe Auswählen von Exchange-Daten). Sobald Sie die Ordner-ID kennen, können Sie diesen Wert als ParentFolderId verwenden, wenn Sie ein neues Objekt erstellen. Um ein Objekt in einem benutzerdefinierten oder öffentlichen Ordner zu erstellen, verwenden Sie den entsprechenden

Objekttyp als Tabelle (oder Posteingang, wenn der Ordner Nachrichten enthält). Beispiel:

Einfügen in einen Unterordner des Posteingangs:

INSERT INTO Inbox (Subject, FromEmailAddress, ToRecipients_EmailAddress, ParentFolderId) VALUES ('New email message', 'user1@email.com', 'user2@email.com', 'AAEuAAAAAAAa...')

Einfügen in einen öffentlichen Ordner, der Kontakte enthält:

INSERT INTO Contacts (GivenName, Surname, EmailAddress1, ParentFolderId) VALUES ('Jill', 'Smith', 'user3@email.com', 'AAEuAAAAAAAa...')

Aktualisieren oder Löschen von Elementen in öffentlichen und benutzerdefinierten Ordnern

Aktualisieren oder Löschen eines Elements in öffentlichen und benutzerdefinierten Ordnern

Anders als beim Lesen aus oder Einfügen in einen öffentlichen oder benutzerdefinierten Ordner benötigen Sie die Ordner-ID nicht, um ein Element zu aktualisieren oder zu löschen. Sie müssen lediglich wissen, welchen Objekttyp

der Ordner enthält, und diesen Typ als Tabelle verwenden (oder Posteingang für einen Ordner verwenden, der Nachrichten enthält). Beispiel:

Aktualisieren eines Nachrichtenelements in einem benutzerdefinierten Ordner:

UPDATE Inbox SET Subject = 'Updated email message' WHERE ItemID = 'AZQ111222...')

Löschen eines Kontaktelements aus einem öffentlichen Ordner:

DELETE FROM Contacts WHERE ItemID = 'AZQ111222...')

Optimieren des Datenzugriffs

Identitätswechsel bei Benutzern

Diese Authentifizierungsmethode wird normalerweise von Administratoren verwendet, um den Zugriff über ein Dienstkonto zu konfigurieren.
Um alle Anfragen zu imitieren, legen Sie zum Zeitpunkt der Verbindung die folgenden Verbindungseigenschaften fest.
Um sich für eine einzelne Abfrage als Benutzer auszugeben, verwenden Sie die gleichnamigen Pseudospalten.

• ImpersonationUser: Legen Sie dies für den Benutzer fest, dessen Identität Sie annehmen möchten.
• ImpersonationType: Stellen Sie hier das Format ein, das Sie zur Angabe des Benutzers verwenden. Beispielsweise UPN oder SID.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Microsoft Exchange Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Microsoft Exchange und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Microsoft Exchange können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Contacts WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der Jitterbit Connector für Microsoft Exchange modelliert die Microsoft Exchange 2- und Microsoft Exchange APIs als relationale Tabellen, Ansichten und gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

Die verfügbaren Entitäten sowie alle API Einschränkungen und-Anforderungen für die Abfrage dieser Entitäten sind im EWS-Datenmodell (dokumentiert und MSGraph-Datenmodell.

Überblick

Die Datenmodelle zeigen ein Beispiel, wie Ihre Microsoft Exchange Umfeld aussehen könnte. Das eigentliche Datenmodell wird dynamisch basierend auf Ihrem Microsoft Exchange Konto abgerufen.

Hauptmerkmale

• Tabellen und Ansichten werden dynamisch definiert, um Kalender, Dokumente und Projekte in Microsoft Exchange zu modellieren.
• Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Microsoft Exchange, einschließlich des Herunterladens und Hochladens von Objekten.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Microsoft Exchange Konto bei Verwendung des Connectors sofort berücksichtigt werden.

EWS-Datenmodell

EWS-Datenmodell beschreibt die verfügbaren Schemata für die Verbindung mit Microsoft Exchange OnPremise und Microsoft Exchange Online mithilfe von EWS. Sie können Tabellen verwenden, um mit Live-Microsoft Exchange Daten zu arbeiten. Sie können gespeicherte Prozeduren verwenden, die von Jitterbit Connector für Microsoft Exchange bereitgestellt werden, um die Arbeit mit Microsoft Exchange Daten zu automatisieren.

MSGraph-Datenmodell

MSGraph-Datenmodell beschreibt die Schemata, die für die Verbindung mit Microsoft Exchange Online-Konten über Microsoft Graph verfügbar sind. Sie können Tabellen verwenden, um mit Live-Microsoft Exchange Daten zu arbeiten. Sie können gespeicherte Prozeduren verwenden, die von Jitterbit Connector für Microsoft Exchange bereitgestellt werden, um die Arbeit mit Microsoft Exchange Daten zu automatisieren.

EWS-Datenmodell

Der Jitterbit Connector für Microsoft Exchange modelliert Microsoft Exchange Entitäten als relationale Tabellen und Gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Microsoft Exchange. Sie können zum Suchen, Aktualisieren und Ändern von Informationen in Microsoft Exchange verwendet werden.

Tabellen

Der Connector modelliert die Daten in Microsoft Exchange als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Jitterbit-Connector für Microsoft Exchange Tabellen

Kalender

Kalenderelemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

SELECT Wiederkehrende Events

Wenn Sie einen SELECT Operation für die Kalendertabelle ausführen, schließt der Connector standardmäßig keine einzelnen wiederkehrenden Ereignisse ein (nur das Hauptelement wird eingeschlossen). Ihre Abfrage muss eine WHERE-Klausel ähnlich der folgenden enthalten:

SELECT Subject, IsRecurring, Recurrence_StartDate, Recurrence_EndDate, Recurrence_Interval, Recurrence_Type, Recurrence_NumberOfOccurrences, FirstOccurrence_Start FROM Calendar WHERE ItemId = 'myid'

Wenn Sie die einzelnen Wiederholungen eines wiederkehrenden Ereignisses anzeigen möchten, müssen Sie die Filter START und END mit den Operatoren „größer als“ bzw. „kleiner als“ hinzufügen. Das Intervall zwischen START und END sollte nicht mehr als 2 Jahre betragen. Die API gibt höchstens 1000 Einträge für wiederkehrende Ereignisse zurück. Bitte geben Sie das Intervall zwischen den Filtern START und END entsprechend an. Ihre Abfrage muss eine WHERE-Klausel ähnlich der folgenden enthalten:

SELECT * FROM Calendar WHERE start >= '2021-05-11 00:50:59.0' AND end <= '2023-02-28 11:20:30.0'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Calendar_OptionalAttendees

Die optionalen Teilnehmer für ein bestimmtes Ereignis. Bei der Abfrage dieser Ansicht muss eine ItemId angegeben werden.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Einfügen

Wenn Sie einen SELECT Operation für die Kalendertabelle ausführen, schließt der Connector standardmäßig keine einzelnen wiederkehrenden Ereignisse ein (nur das Hauptelement wird eingeschlossen). Wenn Sie die einzelnen Wiederholungen eines wiederkehrenden Ereignisses anzeigen möchten, müssen Sie die Suche nach der Spalte „IsRecurring“ filtern und mit „Start“ und „End“ einen Zeitraum angeben. Ihre Abfrage muss eine WHERE-Klausel ähnlich der folgenden enthalten:

INSERT INTO Calendar_OptionalAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Calendar_RequiredAttendees

Die erforderlichen Teilnehmer für ein bestimmtes Ereignis. Bei der Abfrage dieser Ansicht muss eine ItemId angegeben werden.

Tabellenspezifische Informationen

Insert-Anweisungen

Wenn Sie einen INSERT Operation durchführen, müssen Sie EmailAddress und ItemId angeben. Darüber hinaus gibt es eine Eigenschaft namens SendMeetingInvitations, die Sie festlegen können, um zu entscheiden, wer benachrichtigt wird, wenn Sie erforderliche Teilnehmer einfügen.

INSERT INTO Calendar_RequiredAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kontakte

Erstellen, aktualisieren, löschen und Abfrage Kontaktelemente.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gelöschte Elemente

Erstellen, aktualisieren, löschen und Abfrage gelöschte Elemente.

Tabellenspezifische Informationen

Wählen Sie Emails aus den Unterordnern „DeletedItems“ aus

Wenn Sie eine SELECT Operation für die Tabelle „DeletedItems“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „DeletedItems“ ein, sondern nur die Elemente, die im Ordner „DeletedItems“ enthalten sind. Wenn Sie die Elemente unter den Unterordnern „DeletedItems“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „DeletedItems“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „DeletedItems“ abzurufen:

SELECT * FROM DeletedItems WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'DeletedItems' AND TotalCount > 0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Entwürfe

Entwurfselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Unterordnern „Entwürfe“ auswählen

Wenn Sie eine SELECT Operation für die Drafts-Tabelle durchführen, schließt der Connector nicht die Elemente in den Unterordnern unter Drafts ein, sondern nur die Elemente, die im Drafts-Ordner enthalten sind. Wenn Sie die Elemente in den Drafts-Unterordnern abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede Drafts-Unterordner-ID abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Folders-Tabelle ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Drafts-Unterordnern abzurufen:

SELECT * FROM Drafts WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Drafts' AND TotalCount > 0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ordner

Erstellen, aktualisieren, löschen und Abfrage Unterordner für einen bestimmten Ordner.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den FolderChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den FolderChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die Zeit für die Ausführung einer Abfrage verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Posteingang

Posteingangselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Posteingangsunterordnern auswählen

Wenn Sie einen SELECT Operation für die Tabelle „Posteingang“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „Posteingang“ ein, sondern nur die Elemente, die im Ordner „Posteingang“ enthalten sind. Wenn Sie die Elemente unter den Unterordnern „Posteingang“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „Posteingang“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „Posteingang“ abzurufen:

SELECT * FROM Inbox WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Inbox' AND TotalCount > 0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

JunkEmail

Erstellen, aktualisieren, löschen und Abfrage Junk Email Elemente.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Postausgang

Postausgangselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Unterordnern des Postausgangs auswählen

Wenn Sie einen SELECT Operation für die Tabelle „Postausgang“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „Postausgang“ ein, sondern nur die Elemente, die im Ordner „Postausgang“ enthalten sind. Wenn Sie die Elemente in den Unterordnern „Postausgang“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „Postausgang“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „Postausgang“ abzurufen:

SELECT * FROM Outbox WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'Outbox' AND TotalCount > 0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gesendete Artikel

Erstellen, aktualisieren, löschen und Abfrage gesendete Elemente.

Tabellenspezifische Informationen

Emails aus SentItems-Unterordnern auswählen

Wenn Sie eine SELECT Operation für die SentItems-Tabelle durchführen, schließt der Connector nicht die Elemente in den Unterordnern unter SentItems ein, sondern nur die Elemente, die im SentItems-Ordner enthalten sind. Wenn Sie die Elemente unter den SentItems-Unterordnern abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede SentItems-Unterordner-ID abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Ordnertabelle ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den SentItems-Unterordnern abzurufen:

SELECT * FROM SentItems WHERE ParentFolderId IN (SELECT FolderId FROM Folders WHERE ParentFolderName = 'SentItems' AND TotalCount > 0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Aufgaben

Aufgabenelemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Wiederholungsfelder

Um die Wiederholungsfelder in einer Aufgabe EINFÜGEN, AUSWÄHLEN oder AKTUALISIEREN zu können, müssen Sie sicherstellen, dass Sie nur die Felder festlegen, die mit den Feldern Wiederholungstyp und Wiederholungsdauer verknüpft sind. Bitte beachten Sie die folgenden Tabellen:

Recurrence_Type-Werte und zugehörige Felder

Recurrence_Duration und zugehörige Felder

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Microsoft Exchange hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Microsoft Exchange zurück, zusammen mit einer Angabe, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Jitterbit-Connector für gespeicherte Prozeduren in Microsoft Exchange

Anhänge erstellen

Erstellen Sie einen Anhang und fügen Sie ihn einer vorhandenen Email hinzu.

Gespeicherte Prozedurspezifische Informationen

Verwenden Sie das Verfahren CreateAttachments, um einer vorhandenen Email einen Anhang hinzuzufügen. Um die Dateipfade der Anhänge anzugeben, verwenden Sie die Eingabe „Attachments“, während Sie für Base64-codierten Inhalt „AttachmentContent“ und „AttachmentName“ angeben.

EXECUTE CreateAttachments ItemId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD/FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAxEAAABDJHYjDdygQ5pQPUEu3S2cAAVZoayvAAAA', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt'

Eingabe

Ergebnissatzspalten

Anhang abrufen

Ruft die angegebenen Anhänge ab.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Outlook ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern den OAuthAccessToken von dieser URL an.

Eingang

Ergebnissatzspalten

GetUserOfSettings (Benutzereinstellungen abrufen)

Bietet Zugriff auf die Abwesenheitseinstellungen eines Benutzers. Ein Benutzer wird anhand seiner Email-Adresse identifiziert. Wenn die Abwesenheitsnachricht null ist und Abwesenheitsnachrichten aktiviert sind, wird keine Abwesenheitsnachricht gesendet.

Eingang

Ergebnissatzspalten

Verschiebeelement

Nachrichten von einem Ordner in einen anderen verschieben.

Eingang