> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/integrations/connector/contacts-microsoft-exchange.md).
# Kontakte aus Microsoft Exchange
Integrieren Sie Microsoft Exchange in Ihre PASCOM.
## Konzept
Mit dem PASCOM Connector für Microsoft Exchange haben Sie die Möglichkeit öffentliche, persönliche und freigegebene Exchange Adressbücher mit den PASCOM Telefonbüchern serverseitig zu synchronisieren.
Microsoft Exchange wird auch unterstützt bei Verwendung des gehosteten Office 365.
{% hint style="success" %}
Systemvoraussetzung ist **Exchange 2013 SP1** oder höher, **Office 365** oder **Exchange Online**.
{% endhint %}
### Öffentliche Adressbücher
PASCOM verbindet sich zum Exchange Server mit einem eigens dafür angelegten Benutzer. Der Connector durchsucht rekursiv alle öffentlichen Ordner nach Adressbüchern und synchronisiert diese automatisch mit dem PASCOM Firmentelefonbuch.
Möchten Sie bestimme öffentliche Adressbücher nicht synchronisieren, entziehen Sie dem PASCOM Exchange Benutzer ensprechend die Leserechte auf dieses Adressbuch.
### Persönlicher Adressbücher
Der Connector sucht nach persönlichen Adressbüchern der Exchange Benutzer und synchronisiert diese mit dem jeweiligen persönlichen Adressbuch des PASCOM Benutzers.
Diese Funktion kann auf 2 Arten genutzt werden:
**Impersonations-Typ: Benutzername\@Domain**
* Benutzername in PASCOM und Exchange müssen identisch sein.
* Der PASCOM Exchange Benutzer muss das Recht *Impersonation* besitzen.
* Beispiel:
**Impersonations-Typ: Email**
* Benutzerzuordnung erfolgt anhand der Mail-Adresse ("Voicemail Email" in Basisdaten des Benutzers)
* Ist diese Mail-Adresse bei einem Benutzer nicht gesetzt erfolgt ein Fallback auf obigen Typ
### Standard Feldzuordnung
Die Feldzuordnung kann beliebig angepasst werden und ist wie folgt voreingestellt:
| pascom | Exchange |
| -------------- | --------------------------------- |
| Anzeigename | Name |
| Telefon | Telefonnummern > Geschäftlich |
| Vorname | Vorname |
| Nachname | Nachname |
| Organisation | Firma |
| Fax | Telefonnummern > Fax geschäftlich |
| Email | E-Mail |
| Handy | Telefonnummern > Mobiltelefon |
| Telefon privat | Telefonnummern > Privat |
## Konfiguration
### Microsoft Exchange
Wie oben erwähnt benötigt der Connector einen eigenen Exchange Benutzer. Fügen Sie hierzu einen neuen Benutzer mit (beispielsweise) dem Namen **pascom** hinzu.
Sorgen Sie dafür, dass der PASCOM Benutzer Leserechte auf alle relevanten öffentlichen Ordner hat.
{% hint style="info" %}
Damit der Connector die Daten abrufen darf braucht der Exchange Benutzer folgende Rollen: **Discovery Management** und **Organisation Management** (Beide zusammen).
{% endhint %}
Falls Sie auch persönliche Adressbücher synchronisieren wollen weisen Sie dem PASCOM Benutzer noch die Rolle *Impersonation* (Identitätswechsel) zu. Eine Anleitung hierzu finden Sie [hier](https://www.codetwo.com/kb/how-to-set-impersonation-rights-manually/).
### Connector Profil erstellen
Erstellen Sie ein neues Connector-Profil indem Sie in der PASCOM Web-UI unter dem Menüpunkt **Einstellungen** > **Connector** auf **Hinzufügen** klicken.
Suchen Sie Vorlage **Exchange Kontakte** und klicken Sie auf **Auswählen**. Folgende Daten werden für die Vorlage benötigt:
| Feld | Beschreibung |
| ----------------- | ------------------------------------------------------------------------------------------ |
| **Bezeichnung**\* | Bezeichnung des Connector Profiles |
| **E-Mail**\* | E-Mail-Adresse des zuvor angelegten PASCOM Exchange Benutzers z. B. `pascom@meinefirma.de` |
| **Passwort**\* | Passwort des zuvor angelegten PASCOM Exchange Benutzers |
PASCOM versucht anhand der E-Mail-Adresse des Exchange-Benutzers Domain und URL automatisch zu ermitteln. Dies funktioniert nur wenn DNS-Server und Domain-Struktur (z. B. bei office365.com) korrekt eingerichtet sind.
Falls die Ermittlung fehlschlägt können Sie Domain und URL manuell ergänzen:
| Feld | Beschreibung |
| ---------- | -------------------------------------------------------------------------------------- |
| **Domain** | Der Active Directory Domain-Name |
| **URL** | Die URL der EWS-Schnittstelle z. B. `https://exchange.meinefirma.de/ews/exchange.asmx` |
### Import simulieren und Datenimport starten
Durch Klicken auf **Speichern und Simulieren** starten Sie einen Probeimport und bekommen die ersten 500 Datensätze angezeigt.
Wenn Sie mit dem Ergebnis zufrieden sind können Sie unter **Aktion** den Datenimport komplett durchführen.
### (Optional) Feldzuordnung anpassen
Im Connector Profil können Sie im Reiter **Variablen** und **Struktur** die Feldzuordnung PASCOM > Exchange an Ihre Bedürfnisse anpassen.
Als Beispiel möchten wir die Exchange Kontakt-Webseitenadresse im Notizfeld des PASCOM Telefonbuches speichern.
Fügen Sie hierzu im Reiter **Variablen** folgende Zeile durch **Hinzufügen** ein:
| Variable | Quelle |
| ---------------- | ---------------------------------- |
| BusinessHomePage | `return $row['BusinessHomePage'];` |
{% hint style="info" %}
Im Gegensatz zu anderen Connector-Profilen muss der Name der Variablen und der Name des Quellfeldes (hier "BusinessHomePage") identisch sein.
{% endhint %}
Durch diese Zeile speichert der Connector den Inhalt des Exchange Feldes "BusinessHomePage" in der gleichnamigen Variable "BusinessHomePage" ab.
Diese Variable muss nun unter **Struktur** einem PASCOM Feld zugeordnet werden. Ergänzen Sie hierzu die Zeile:
```
"028pho_notes" : "{{{BusinessHomePage}}}",
```
in der Struktur:
```
{
"phonebook": [{
"028pho_bez" : "{{{DisplayName}}}",
"028pho_phone" : "{{{PhoneNumbers_BusinessPhone}}}",
"028pho_firstname" : "{{{GivenName}}}",
"028pho_lastname" : "{{{Surname}}}",
"028pho_organisation" : "{{{CompanyName}}}",
"028pho_email" : "{{{EmailAddresses_EmailAddress1}}}",
"028pho_mobile" : "{{{PhoneNumbers_MobilePhone}}}",
"028pho_homephone" : "{{{PhoneNumbers_HomePhone}}}",
"028pho_fax" : "{{{PhoneNumbers_BusinessFax}}}",
"028pho_notes" : "{{{BusinessHomePage}}}",
"011acc_id": "{{{local_id}}}"
}]
}
```
Dadurch wird der Wert der Variablen **BusinessHomePage** dem PASCOM Telefonbuch Feld **028pho\_notes** zugewiesen.
#### Liste der verfügbaren Exchange Felder
* DisplayName
* Initials
* GivenName
* Surname
* MiddleName
* NickName
* CompleteName
* Birthday
* Generation
* CompanyName
* JobTitle
* Department
* OfficeLocation
* BusinessHomePage
* PostalAddressIndex
* SpouseName
* WeddingAnniversary
* FileAs
* FileAsMapping
* PhoneNumbers\_AssistantPhone
* PhoneNumbers\_BusinessFax
* PhoneNumbers\_BusinessPhone
* PhoneNumbers\_BusinessPhone2
* PhoneNumbers\_CompanyMainPhone
* PhoneNumbers\_HomeFax
* PhoneNumbers\_HomePhone
* PhoneNumbers\_HomePhone2
* PhoneNumbers\_MobilePhone
* PhoneNumbers\_OtherFax
* PhoneNumbers\_OtherTelephone
* PhoneNumbers\_Pager
* PhoneNumbers\_RadioPhone
* EmailAddresses\_EmailAddress1
* EmailAddresses\_EmailAddress2
* EmailAddresses\_EmailAddress3
* PhysicalAddresses\_Home
* PhysicalAddresses\_Business
* PhysicalAddresses\_Other
* ImAddresses\_ImAddress1
* ImAddresses\_ImAddress2
* ImAddresses\_ImAddress3
#### Liste der verfügbaren PASCOM Felder
| Name | Bezeichnung |
| -------------------- | -------------- |
| 028pho\_bez | Anzeigename |
| 028pho\_phone | Telefon |
| 028pho\_firstname | Vorname |
| 028pho\_lastname | Nachname |
| 028pho\_organisation | Organisation |
| 028pho\_email | Email |
| 028pho\_mobile | Handy |
| 028pho\_homephone | Telefon privat |
| 028pho\_fax | Fax |
| 028pho\_notes | Notizen |
### (Optional) Labels nutzen
PASCOM Labels lassen sich auch dazu nutzen zusätzliche Informationen aus Exchange mit im PASCOM Firmentelefonbuch anzuzeigen.
In diese Beispiel möchten wir die Abteilung des Exchange Kontakts im Label **Abteilung** abspeichern. Dieses Label ist dann nicht nur im Telefonbuch sondern auch in Journaleinträgen oder diversen Anruferinformationen sichtbar.
#### Label anlegen
Labels legen Sie im Menü **Anrufverteilung** > **Anruf Labels** durch Klicken auf die Schaltfläche **Hinzufügen** an.
Wählen Sie **Generisches Label**, vergeben Sie den Namen **Abteilung** und klicken auf **Speichern**.
Wenden Sie ausstehende Jobs an um das Label anzulegen.
#### Connector Profil anpassen
Fügen Sie hierzu im Reiter **Variablen** folgende Zeile durch **Hinzufügen** ein:
| Variable | Quelle |
| ---------- | ---------------------------- |
| Department | `return $row['Department'];` |
{% hint style="info" %}
Im Gegensatz zu anderen Connector-Profilen muss der Name der Variablen und der Name des Quellfeldes (hier "Department") identisch sein.
{% endhint %}
Durch diese Zeile speichert der Connector den Inhalt des Exchange Feldes "Department" in der gleichnamigen Variable "Department" ab.
Diese Variable muss nun unter **Struktur** dem Label **Abteilung** PASCOM Feld zugeordnet werden.
Ergänzen Sie hierzu die Zeilen:
```
"post": {
"phonebook.phonebooklabel": [
{
"050lab_bez": "Abteilung",
"028050pholab_value": "{{{Department}}}"
}
]
}
```
in der Struktur:
```
{
"phonebook": [{
"028pho_bez" : "{{{DisplayName}}}",
"028pho_phone" : "{{{PhoneNumbers_BusinessPhone}}}",
"028pho_firstname" : "{{{GivenName}}}",
"028pho_lastname" : "{{{Surname}}}",
"028pho_organisation" : "{{{CompanyName}}}",
"028pho_email" : "{{{EmailAddresses_EmailAddress1}}}",
"028pho_mobile" : "{{{PhoneNumbers_MobilePhone}}}",
"028pho_homephone" : "{{{PhoneNumbers_HomePhone}}}",
"028pho_fax" : "{{{PhoneNumbers_BusinessFax}}}",
"028pho_notes" : "{{{BusinessHomePage}}}",
"011acc_id": "{{{local_id}}}",
"post": {
"phonebook.phonebooklabel": [
{
"050lab_bez": "Abteilung",
"028050pholab_value": "{{{Department}}}"
}
]
}
}]
}
```
Dadurch wird jedem Kontakt mit eingetragener Abteilung das Label **Abteilung** mit dem entsprechenden Wert zugeteilt.
#### Ergebnis prüfen
{% hint style="info" %}
Label-Zuordnungen werden NICHT unter "Speichern und Simulieren" mit angezeigt
{% endhint %}
Prüfen Sie die erfolgreiche Zuordnung des Labels in der PASCOM Web-UI unter **Benutzer** > **Telefonbuch** indem Sie einen ensprechenden Kontakt **Bearbeiten** und die Zuordnung im Reiter **Labels** prüfen. Alternativ können Sie auch das Firmentelefonbuch in der PASCOM App einsehen.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.pascom.net/integrations/connector/contacts-microsoft-exchange.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
