Notwendige Schritte
- Einrichtung des DQ-Servers.
- Einrichtung einer Datenquelle mit vorhandenen Geokoordinaten (Latitude und Longitude).
- Erstellen eines FACT-Finder Datenziels bzw. FF Worldmatch sowie die Konfiguration für die Verwendung in der CRM-Suche.
- Transformation der Daten.
- Installation der aktuellen CRM-Suche.
- Konfiguration des richtigen Channels (Datenziels).
- Testen des Proxys.
- Testen der CRM-Suche.
Konfiguration eines vorhandenen Datenziels
Die CRM-Suche benötigt spezielle Einstellungen für Geokoordinaten und die Anzeige der gewünschten Felder in der ASN.
Für die korrekte Verwendung von Geokoordinaten, muss der Haken "Geokoordinaten verwenden" aktiviert sein und im Breitengrad und Längengrad Feld die richtigen Feldnamen hinterlegt werden. | In den Sucheinstellungen müssen die Felder, die durchsuchbar sein sollen aktiviert werden. Felder die in der ASN der Suche erscheinen sollen, müssen extra über die ASN Spalte aktiviert werden, welchen ggf. ein anderer Name zugeteilt werden kann. |
Wenn das Datenziel mit Daten befüllt ist, kann der DQServer für die Verwendung in der CRM-Suche genutzt werden.
Die oben hinterlegte Installationsdatei vom Server kopieren und die MSI als Administrator ausführen. Wie bereits im DQServer dieselbe IIS Webseite sowie den AppPool verwenden. Nachfolgend eine Erläuterung zu den benötigten Installationsparameter. |
| CRM User | Der Name für die Proxy Authentifizierungs URL, welcher Teil der URL ist. |
| CRM Password | Das Passwort für die Proxy Authentifizierungs URL, welches Teil der URL ist. |
| Channel | Der Name des Channels bzw. des Datenziels im DQ-Server. |
| Service URL | Die Service URL zur DQ-Server API, welche die Daten für die CRM-Suche liefert. |
| Is DQ-Server | Definiert, ob der Server hinter dem Proxy ein DQ-Server oder ein FACT-Finder selbst ist. |
| DQ User | Der Benutzername für den DQ-Server. |
| DQ Password | Das Passwort für den DQ-Server. |
| Logout timeout | Die Zeit in Millisekunden, nach welcher ein Token nicht mehr gültig sein wird. |
| Password prefix | Das Präfix, welches für die Generierung des Passwordhashes benötigt wird. Standardmäßig "FACT-FINDER" |
| Password postfix | Das Postfix, welches für die Generierung des Passwordhashes benötigt wird. Standardmäßig "FACT-FINDER" |
| Authentication type | Der Authentifizierungstyp am Proxy. Standardmäßig "ADVANCED". |
Testen des Proxy
Mit der nachfolgenden URL kann das AccessToken angefordert werden.
http://HOST:PORT/<PROXY_ORDNER>/AuthService.svc/login/<CRM-User>/<CRM-Password>/<unique-user-id>
Das zurückgegebene Token sollte wie nachfolgend aussehen.
Xnykg3dXL5220NjnXoM7DqHObuZVbJrvHgYp3NsBRwsIkxN4s3smVfVrLh9UfiwZ
Die eigentlichen Suchanfragen können nun mittels generiertem Token erfolgen.
http://HOST:PORT/<PROXY_ORDNER>/RequestService.svc/search.ff?ssid=<TOKEN>
Wenn die Konfigurationen am DQServer sowie am Proxy korrekt sind, sollte die Anfrage ein JSON String als Ergebnis zurückliefern,
welches das eigentliche Suchergebnis der CRM-Suche darstellt.
Konfiguration der CRM-Suche
Die allgemeine Konfigurationsdateien sind im „client/js“ Ordner des Proxy Installationsverzeichnis zu finden.
Nachfolgend eine kleine Erläuterung der Konfigurationsparameter.
| channel | Der Name des Datenziels im DQ-Server. |
| url | Die URL zum Proxy SearchRequest.svc. |
| defaultQuery | Der Standard Suchbegriff zu Beginn. Sollte in den Lokalisierungsdateien selbst geändert werden. |
| coloredScores | Verlauf der Treffer farbig kennzeichnen. (Feldtyp: simi muss definiert sein) |
| mapIsVisible | Lässt die Karte zu Beginn anzeigen oder nicht. |
| useDefaultElementProperties | Ignoriert die obigen ff-communication Einstellungen und verwendet anstelle die im Element hinterlegten Definitionen. |
| ffVersion | die verwendete FF-Version. Momentan nicht relevant. |
| channelDefinitions | die verwendeten Definitionen aus der channel-definitions.js. |
Die roten Parameter sollten nicht geändert werden!
Die Channel Definitionen liegen ebenfalls im „client/js“ Ordner.
Nachfolgend wird gezeigt, wie beliebig viele Channels (Datenziele) hinterlegt werden können.
| channelName | Der Name des Channels für die folgenden Einstellungen. |
| recordType | Der Feldname eines gewünschten Typs des Datensatzes, von welchem die Farbe der Pins auf der Karte abhängig sind. |
| useRandomColors | Generiere die Farben pro Seitenaufruf zufällig. |
| pinColorDefinitions | Die Farben der Pins zu den jeweiligen Inhalten des Feldes. |
| mapPinInformationTemplate | Die Informationen, welche erscheinen wenn auf ein Pin auf der Karte geklickt wird (als HTML-Syntax). Felder aus den Datensätzen können via {FELDNAME} angegeben werden. |
| customDataGridClick | Eine Funktion, welche ausgeführt wird, sobald der Benutzer auf einen Datensatz in der Tabelle klickt. |
| columns | Hier werden die Felder für den Channel definiert, welche in der Tabelle bzw. der ASN verwendet werden sollen. |
|
Testen der CRM-Suche
- Einen beliebigen Webbrowser öffnen.
- Auf die angepasste URL zugreifen.
http://HOST:PORT/<PROXY_ORDNER>/ client/index.html
Der Aufruf sollte den folgenden Fehlerdialog anzeigen "Could not request server.“, welcher korrekt ist, da die CRM-Suche (der Proxy) derzeit noch keine gültige SSID erhalten hat.
Daher übergeben wir die SSID wie folgt, indem wir den Parameter mit dem vom Proxy generierten Token, an die URL anhängen.
http://HOST:PORT/<PROXY_ORDNER>/ client/index.html?ssid=<TOKEN>
Sofern die angegebene URL zum Proxy korrekt und das Token noch gültig ist, sollte die Suche jetzt funktionieren.
Mögliche Fehlerquellen
- Channeldefinition falsch, z.B. der Name zum Datenziel.
- Datenziel nicht vorhanden
- DQ-Server Benutzerdaten falsch
- PRE- und POSTfix (FACT-FINDER) für die Suche über den DQ-Server falsch.
- Service URL zur DQ-Server API falsch.
- SSID nicht generiert
- SSID falsch übergeben
- URL zur SSID Generierung geht nicht. => crmUser und crmPassword korrekt?
- Token abgelaufen?