Einstellungen für Organisationen und Kontakte
KIX kann einem neuen Kontakt automatisch eine Organisation zuordnen, z. B. beim:
automatischen Abruf von E-Mails:
Wird eine E-Mail von einem bisher unbekannten Kontakt abgerufen, so wird ein neuer Kontakt angelegt und die Organisation zugeordnet.
manuellen Anlegen eines neuen Tickets:
Wenn als Kontakt eine bisher unbekannte E-Mail-Adresse eingetragen wird, so wird ein neuer Kontakt angelegt und die Organisation zugeordnet.
manuellen Anlegen eines neuen Kontakts:
Wird keine Organisation angegeben, so kann diese automatisch gesetzt werden.
Die Organisation wird (je nach Konfiguration) anhand der Domain des E-Mail-Absenders zugewiesen. Dafür können an jeder Organisation bis zu 25 Domain-Pattern hinterlegt werden. KIX prüft die Domain des E-Mail- Absenders bzw. der angegebenen E-Mail-Adresse und sucht das entsprechende Pattern in den Organisationen. Wird die Domain im Domain-Pattern einer Organisation gefunden, so wird diese Organisation dem neuen Kontakt zugewiesen.
Beispiel: An der Organisation "capeIT" sind die Domains "*kixdesk.com" und "*.capeIT.de" hinterlegt. Die bislang unbekannten E-Mail-Absender "info@capeIT.de" oder "mail@kixdesk.com" werden automatisch der Organisation "capeIT" zugeordnet.
Die Automatische Zuweisung der Organisation zu einem Kontakt ist ein Event, welches im SysConfig-Schlüssel definiert ist. Sie können die Metoden der Zuordnung im Event anpassen.
Contact::EventModulePost###800-AutoAssignOrganisation
Automatische Zuordnung einer Organisation zu einem Kontakt
Das Event wird ausgelöst, wenn beim Anlegen oder Aktualisieren eines Kontakts keine Organisation angegeben ist.
Sofern (manuell) eine Organisation angegeben wurde, gilt diese. Der Automatismus greift dann nicht.
Das Event umfasst 3 Zuordnungs-Methoden, die Sie nach Bedarf de-/aktivieren können. KIX arbeitet die Methoden in nachfolgend angegebener Reihenfolge ab.
Ist eine Methode deaktiviert oder konnte eine Methode nicht erfolgreich angewendet werden (Fehler/kein Ergebnis), wird die nächste Methode geprüft und angewendet.
Sind alle Methoden deaktiviert oder gab es Fehler bzw. kein Ergebnis, so wird keine Organisation am Kontakt gesetzt.
Methode: Mail Domain (Default)
Diese Methode ist initial aktiv und ist das Standardverhalten.
Die Methode prüft die Mail-Domain des Kontakts (E-Mail) gegen die Domain- Pattern, welche in den Organisationen hinterlegt sind.
Dem Kontakt werden alle Organisationen zugeordnet, bei denen die Maildomain des Absenders hinterlegt ist.
Die zuerst gefundene Organisation wird als Primär-Organisation (PrimaryOrganisationID) am Kontakt gesetzt. Alle anderen Organisationen werden als Sekundäre Organisationen (OrganisationID) am Kontakt gesetzt (Sortierung basierend auf Kundennummer).
Wenn Fehler, kein Ergebnis oder inaktiv, wird die nächste Methode verwendet (→ DefaultOrganisation).
Für diese Methode existiert an jeder Organisation der Bereich "Mail-Domains". Hier kann angegeben werden, worauf die Methode "MailDomain" achten soll. Es können bis zu 25 Suchmuster (Pattern) hinterlegt werden.
Das Feld für die Pattern ist das Dynamisches Feld AddressDomainPattern (Feldtyp "Text", Objekttyp "Organisation"). Es kann nicht gelöscht werden.
Sie können Wildcards verwenden. Die Nutzung von Wildcards gilt immer für den gesamten Teil eines Abschnitts der Domain. Abschnitte sind mit
.getrennt, zum Beispiel:domain: meine.firma.de
mögliche Pattern:
*.firma.de
*.firma.*
*.*.de
meine.*.de
meine.*.*
meine.firma.*
Nicht möglich ist die Verwendung mit Bindestrich, z. B.: *-fima.de
Methode: DefaultOrganisation
Mit dieser Methode kann dem Kontakt eine feste Organisation zugewiesen werden, z. B.:
"DefaultOrganisation" "MY_ORGA"Diese Methode ist initial inaktiv und kann bei Bedarf aktiviert werden. Setzen Sie dazu den Parameter
"Active": "1".Es kann die ID, der Name oder die Nummer der Organisation angegeben werden.
Die Methode kann als 1. Fallback zur Methode "MailDomain" verwendet werden.
Wenn Fehler, kein Ergebnis oder inaktiv, wird die nächste Methode verwendet (→ PersonalOrganisation).
Im Falle eines Fehlers, eines fehlenden Ergebnisses oder diese Methode inaktiv ist, so wird die nächste Methode verwendet (→ PersonalOrganisation).
Wichtig
Wenn diese Zuordnungsmethode aktiviert ist, muss aus Datenschutzgründen für das SSP die Einsichtnahme in die "Tickets anderer" unterbunden werden!
Ändern Sie daher die Berechtigungen für den Zugriff im SysConfig- Schlüssel
Methode: PersonalOrganisation
Mit dieser Methode wird für den Kontakt eine eigene Organisation angelegt, welche aus der E-Mail-Adresse des Kontakts besteht.
Sofern die Organisation nicht angelegt werden konnte, ein Fehler auftrat oder diese Methode inaktiv ist, so wird die nächste Methode (→ letztes Fallback) verwendet.
Im letzten Fallback wird am Kontakt keine Organisation gesetzt.
Konfigurationsschlüssel | Beschreibung | mögliche Werte |
|---|---|---|
ContactSearch::UseWildcardPrefix | De-/Aktiviert das Wildcard-Präfix für die Suche nach dem Kontakt | 0| 1 |
OrganisationSearch::UseWildcard Prefix | De-/Aktiviert das Wildcard-Präfix für die Suche nach der Organisation | 0 | 1 |
Im Organisationen Dashboard ist für die Suche nach Organisationen bzw. Kontakten die Verwendung eines Wildcards (*) am Ende des Suchbegriffs nicht erforderlich. Es ist ausreichend, nur den Suchbegriff ins Suchfeld einzutragen. KIX setzt intern automatisch ein Sternchen nach dem Suchbegriff (Wildcard-Suffix). Gleiches gilt für die Autocomplete-Felder. Das Sternchen vor dem Suchbegriff (Wildcard-Präfix) wird aus Gründen der Performance nicht automatisch gesetzt. Es kann bei der Eingabe des Suchbegriffs vom Nutzer manuell gesetzt werden.
Für On-Premises (lokal) genutzte KIX-Instanzen auf PostgreSQL-Datenbankbasis oder Umgebungen mit überschaubarer Anzahl an Organisationen und Kontakten können Sie KIX so einrichten, dass das Wildcard- Präfix für Kunden und/oder Organisationen automatisch gesetzt wird:
Navigieren Sie zum Menü .
Suchen und öffnen Sie den SysConfig-Schlüssel bzw.
Ändern Sie den Wert auf "1"
Klicken Sie abschließend auf .
Klicken Sie im Header der SysConfig auf , um das geänderte Suchverhalten ins Agentenportal zu übernehmen.
Bei Bedarf: Führen Sie im Menü den Befehl Console::Command::Maint::Cache::Delete aus, um den Cache zu bereinigen. Gegebenenfalls müssen die Agenten ihr Frontend ebenfalls aktualisieren.
Ist das Wildcard-Präfix aktiv, erfolgt die Suche nach dem Suchmuster: <Wildcard-Präfix><Suchbegriff><Wildcard-Suffix>
Suchbegriff | Suchmuster | Ergebnis der Suche |
|---|---|---|
musterma | *musterma* | Max Mustermann, Eva Mustermaier |
man | *man* | Hans von Lehmann, Hermann Meier |
Ist das Wildcard-Präfix nicht aktiv, erfolgt die Suche nach dem Suchmuster:<Suchbegriff><Wildcard-Suffix>
Suchbegriff | Suchmuster | Ergebnis der Suche |
|---|---|---|
musterma | musterma* | Mustermann GmbH, Mustermaier OHG |
man | man* | Mannfred Uhlig, Manuela Muster |
Bei Nutzung der Komplexsuche oder bei der Suche nach Kontakten in einem Ticket können Operatoren (&, +, |, *) verwendet werden, um nach mehreren Parametern zu suchen. So entsteht ein Suchstring, der von KIX verarbeitet wird, z. B. Max+Mustermann.
Das einer Telefonnummer vorangestellte + für die Landesvorwahl kann jedoch bei der kombinierten Suche von bspw. Name und Telefonnummer zu einem fehlerhaften Suchergebnis führen. KIX betrachtet das der Telefonnummer vorangestellte + als Operator und nicht als Teil der Telefonnummer. Somit ergibt die Suche nach "Max" und "+49123456" den Suchstring "Max+49123456" - und damit mit falscher Telefonnummer.
Sie können dies umgehen, wenn Sie die Verwendung von Wildcards im SysConfig-Schlüssel aktivieren. Dadurch wird ein Wildcard-Präfix (* bzw. % auf Datenbankebene) als Platzhalter vor die gesuchten Parameter gesetzt. Der daraus resultierende Suchstring "*Max+*49123456" liefert ein korrektes Ergebnis, da alle den Ziffern vorangehende Zeichen berücksichtigt werden.
Die alleinige Suche nach der Telefonnummer, auch mit vorangestelltem +, ist hingegen unproblematisch.
ObjectSearch::Database::ObjectType###Contact
In diesem Konfigurationsschlüssel können Sie konfigurieren, welche Kontakt-Attribute in Volltextsuchen berücksichtigt werden sollen (Menü: ).
Das kann bspw. erforderlich sein, wenn die Kontaktsuche nach dem Namen der Organisation unscharfe Ergebnisse liefert. In diesem Fall können Sie konfigurieren, dass nicht nach dem Namen der Organisation gesucht werden soll, sondern nur nach Vor- und Nachname. Die Suchergebnisse werden somit optimiert.
Passen Sie im Konfigurationsschlüssel den Parameter FulltextAttributes nach Bedarf an: Entfernen Sie die Attribute, die in der Volltextsuche keine Berücksichtigung finden sollen bzw. fügen Sie weitere Kontakt-Attribute hinzu.
Die Angabe Dynamischer Felder vom Typ Text, TextArea und Selection wird unterstützt.
Hinweis: Die Suche in Auswahlfeldern (Selection) berücksichtigt die internen Werte der Datenbank. Werte die nur im Anzeige-Wert enthalten sind, liefern keinen Treffer.
Beispiel:
{
"FulltextAttributes": [
"Firstname",
"Lastname",
"Phone",
"Mobile",
"Email",
"myDFContactSelection",
"myDFShortName"
],
"Module": "ObjectSearch::Database::Contact"
}Initial werden in der Kontaktsuche verwendet:
Vorname, Nachname
Telefonnummer, Mobilfunknummer
alle E-Mail-Adressen
zugeordnete Kundennummer(n)
Name der zugeordneten Organisation