Dokumentation
pascom Produkt Dokumentation und Release Notes
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.
Systemvoraussetzung ist Exchange 2013 SP1 oder höher, Office 365 oder Exchange Online.
Ö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: mmustermann@pascom.onmicrosoft.com
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 |
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.
Damit der Connector die Daten abrufen darf braucht der Exchange Benutzer folgende Rollen: Discovery Management und Organisation Management (Beide zusammen).
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.
Connector Profil erstellen
Erstellen Sie ein neues Connector-Profil indem Sie in der pascom Web-UI unter dem Menüpunkt > auf klicken.
Suchen Sie Vorlage und klicken Sie auf . 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 starten Sie einen Probeimport und bekommen die ersten 500 Datensätze angezeigt.
Wenn Sie mit dem Ergebnis zufrieden sind können Sie unter den Datenimport komplett durchführen.
(Optional) Feldzuordnung anpassen
Im Connector Profil können Sie im Reiter und 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 folgende Zeile durch ein:
Variable | Quelle |
---|---|
BusinessHomePage | return $row['BusinessHomePage']; |
Im Gegensatz zu anderen Connector-Profilen muss der Name der Variablen und der Name des Quellfeldes (hier “BusinessHomePage”) identisch sein.
Durch diese Zeile speichert der Connector den Inhalt des Exchange Feldes “BusinessHomePage” in der gleichnamigen Variable “BusinessHomePage” ab.
Diese Variable muss nun unter 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 | |
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ü > durch Klicken auf die Schaltfläche an.
Wählen Sie , vergeben Sie den Namen Abteilung und klicken auf .
Wenden Sie ausstehende Jobs an um das Label anzulegen.
Connector Profil anpassen
Fügen Sie hierzu im Reiter folgende Zeile durch ein:
Variable | Quelle |
---|---|
Department | return $row['Department']; |
Im Gegensatz zu anderen Connector-Profilen muss der Name der Variablen und der Name des Quellfeldes (hier “Department”) identisch sein.
Durch diese Zeile speichert der Connector den Inhalt des Exchange Feldes “Department” in der gleichnamigen Variable “Department” ab.
Diese Variable muss nun unter 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
Label-Zuordnungen werden NICHT unter “Speichern und Simulieren” mit angezeigt
Prüfen Sie die erfolgreiche Zuordnung des Labels in der pascom Web-UI unter > indem Sie einen ensprechenden Kontakt und die Zuordnung im Reiter prüfen. Alternativ können Sie auch das Firmentelefonbuch im pascom Client einsehen.