{"id":7113,"date":"2021-03-07T19:46:51","date_gmt":"2021-03-07T17:46:51","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=7113"},"modified":"2021-03-07T19:46:52","modified_gmt":"2021-03-07T17:46:52","slug":"hcl-connections-pruefen-wer-touchpoint-nicht-abgeschlossen-hat","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/hcl-connections-pruefen-wer-touchpoint-nicht-abgeschlossen-hat\/","title":{"rendered":"HCL Connections: Pr\u00fcfen wer Touchpoint (nicht) abgeschlossen hat"},"content":{"rendered":"

Mit HCL Connections 6.5 wird Touchpoint automatisch installiert. Hierbei handelt es sich um einen sogenannten Onboarding-Assistenten<\/em>: Er soll auf der einen Seite neue Anwender an die Hand nehmen, ihnen beim ausf\u00fcllen des Profiles, finden von Communitys, anderen Personen etc. helfen. Dar\u00fcber hinaus kann auch eine Datenschutzerkl\u00e4rung inklusive Version eingebunden werden. Der Nutzer muss diese akzeptieren, was wiederum systemseitig gespeichert wird. Touchpoint gab es zuvor schon. Allerdings musste die Anwendung h\u00e4ndisch installiert werden.<\/p>\n

Bisher geschah die Einbindung \u00fcber ein JavaScript-Schnipsel in der header.jsp<\/strong> bzw. footer.jsp<\/strong> recht transparent. Mit 6.5 wanderte dies ins Backend und es gibt offiziell auch keine Einstellungsm\u00f6glichkeiten f\u00fcr z.B. den Intervall mehr. Erschwerend hinzu kommt, dass der Touchpoint nach Aktivierung aufgrund verschiedener Caches gar nicht oder erst sp\u00e4ter erscheint. <\/p>\n

Wo speichert Touchpoint seine Daten?<\/h2>\n

Es ist daher nur sinnvoll nachzuschauen, ob und wer \u00fcberhaupt den Touchpoint abgeschlossen hat. Leider gibt es hierzu keinerlei Oberfl\u00e4che oder Dokumentation. Alles Folgende basiert daher auf eigener Arbeit, Recherche sowie Reverse Engineering.<\/p>\n

Zun\u00e4chst muss man wissen, dass Touchpoint zwei benutzerdefinierte Profilfelder anlegt. Alle Daten befinden sich somit in der Tabelle EMPINST.PROFILE_EXTENSIONS<\/strong>. Gefiltert werden muss nach den im folgenden erl\u00e4uterten Schl\u00fcsseln.<\/p>\n

Die Touchpoint Sitzung<\/h3>\n

touchpointSession<\/strong> wird beim ersten Aufruf des Touchpoints angelegt. Das System speichert darin ein riesiges JSON-Dokument von ca. 10KB gr\u00f6\u00dfe. Darin sind zahlreiche Informationen \u00fcber das Profil des Nutzers, seine Communitys in denen er Mitglied ist und vieles mehr enthalten. Dar\u00fcber hinaus auch eigene Daten von Touchpoint, wie etwa den zuletzt ge\u00f6ffneten Schritt. Schlie\u00dft ein Nutzer den Touchpoint in Schritt 2, wird er beim n\u00e4chsten Aufrufen wieder dort landen – statt ihn erneut durchklicken zu m\u00fcssen. Das gespeicherte JSON-Dokument l\u00e4sst sich auch \u00fcber die Profile-API aufrufen:<\/p>\n

\n
\nhttps:\/\/cnx.host\/profiles\/atom\/profileExtension.do?key=51673ab8-4e38-46ca-83ca-795796074813&amp;extensionId=touchpointSession\n<\/pre>\n<\/div>\n
Direkt aus der Datenbank erhalten wir es mit folgender Abfrage (DB2):<\/p>\n
\n
\nSELECT PROF_KEY, CAST(PROF_VALUE_EXTENDED as VARCHAR(32672) CCSID UNICODE) as JSON_VALUE\nFROM EMPINST.PROFILE_EXTENSIONS \nWHERE PROF_PROPERTY_ID = 'touchpointSession'\n<\/pre>\n<\/div>\n
\"\"<\/a><\/figure>\n
Wenn wir hier leere Felder erhalten wie in der ersten Zeile, ist vermutlich ein Fehler in der Standardkonfiguration schuld. Die Datei tdisol\/conf\/LotusConnections-config\/profiles-types.xml enth\u00e4lt die beiden Touchpoint-Attribute:<\/p>\n
<property>\n        <ref>privacyAndGuidelines<\/ref>\n        <updatability>readwrite<\/updatability>\n        <hidden>true<\/hidden>\n        <fullTextIndexed>false<\/fullTextIndexed>\n<\/property>\n<property>\n        <ref>touchpointState<\/ref>\n        <updatability>readwrite<\/updatability>\n        <hidden>true<\/hidden>\n        <fullTextIndexed>false<\/fullTextIndexed>\n<\/property>\n<property>\n        <ref>touchpointSession<\/ref>\n        <updatability>readwrite<\/updatability>\n        <hidden>true<\/hidden>\n        <fullTextIndexed>false<\/fullTextIndexed>\n<\/property><\/code><\/pre>\n
Sofern es diese Felder nicht im LDAP gibt und sie dort nicht prim\u00e4r gespeichert werden (worin ich wenig Sinn sehe), m\u00fcssen sie auskommentiert werden. Ansonsten synchronisiert<\/em> der TDI sie bei jedem Durchlauf. Gibt es die Felder nicht im LDAP, werden sie \u00fcberschrieben, auch wenn sich bereits Daten in der Datenbank befanden.<\/p>\n
Die akzeptierte Datenschutzerkl\u00e4rung und ggf. die Nutzungsbedingungen<\/h3>\n
Der Touchpoint kann auch genutzt werden, um die eigene Datenschutzerkl\u00e4rung sowie die Nutzungsbedingungen vom Benutzer best\u00e4tigen zu lassen. Hierzu muss man in der Konfiguration nur privacyAndGuidelines.enabled<\/strong> auf true <\/strong>setzen und in den Link-Attributen jeweils eine Link f\u00fcr externe und interne Nutzer hinterlegen. Auf der ersten Seite wird den Nutzern dann eine Checkbox mit den hinterlegten Links angezeigt, die er anhaken muss.<\/p>\n
Sinnvolerweise l\u00e4sst sich die Datenschutzerkl\u00e4rung versionieren und Touchpoint speichert, welcher Benutzer welche Version akzeptiert hat. Somit ist dies zum einen nachvollziehbar. Zum anderen lassen sich die Anwender bei ge\u00e4nderten Nutzungsbedingungen dazu auffordern, diese erneut zu akzeptieren. In diesem Falle erh\u00f6ht man beispielsweise die Version von 1.0 (Standard) auf 1.1. \u00dcber den Schl\u00fcssel privacyAndGuidelines <\/strong>k\u00f6nnen wir aus der gleichen Tabelle auslesen, welche Version akzeptiert wurde:<\/p>\n
SELECT PROF_KEY, PROF_VALUE \nFROM EMPINST.PROFILE_EXTENSIONS privacyExt\nWHERE privacyExt.PROF_PROPERTY_ID = 'privacyAndGuidelines'<\/code><\/pre>\n
\"\"<\/a><\/figure>\n
Welcher Benutzer hat den Touchpoint erhalten und abgeschlossen?<\/h2>\n
Mit dem obigen Wissen kann man h\u00e4ndisch ermitteln, ob ein Benutzer den Touchpoint abgeschlossen hat und wenn ja mit welcher Version der Datenschutzerkl\u00e4rung. F\u00fcr die anfangs angesprochene \u00dcbersicht ist dies allerdings wenig hilfreich: Schlie\u00dflich m\u00fcsste man manuell die User-Id heraussuchen und in die Abfrage einf\u00fcgen – f\u00fcr jeden User. Eine Abfrage aller Daten ist ohne sprechende Benutzer wenig hilfreich. Daher habe ich eine Abfrage erstellt, mit der man alle in meinen Augen wichtigen Informationen erh\u00e4lt:<\/p>\n
SELECT e.PROF_DISPLAY_NAME, JSON_VAL(SYSTOOLS.JSON2BSON(PROF_VALUE), 'timestamp' , 'l') AS timestampRaw,\nDATE((((JSON_VAL(SYSTOOLS.JSON2BSON(PROF_VALUE), 'timestamp' , 'l') \/ 1000)-5*3600)\/86400)+719163) AS calculatedDate,\n(\n\tSELECT privacyExt.PROF_VALUE \n\tFROM EMPINST.PROFILE_EXTENSIONS privacyExt\n\tWHERE ext.PROF_KEY = privacyExt.PROF_KEY \n\tAND privacyExt.PROF_PROPERTY_ID = 'privacyAndGuidelines'\n) AS privacyVersion\nFROM EMPINST.PROFILE_EXTENSIONS ext\nLEFT JOIN EMPINST.EMPLOYEE e ON (e.PROF_KEY = ext.PROF_KEY)\nWHERE PROF_PROPERTY_ID = 'touchpointState'\nORDER BY JSON_VAL(SYSTOOLS.JSON2BSON(PROF_VALUE), 'timestamp' , 'l') DESC<\/code><\/pre>\n
Als Ergebnis erhalten wir eine Tabelle mit Anzeigename, Unix-Timestamp, lesbarem Datum und Version der akzeptierten Datenschutzerkl\u00e4rung – sortiert nach Abschlussdatum:<\/p>\n
\"\"<\/a><\/figure>\n
Alte Abfrage<\/h3>\n
Meine erste Abfrage war weniger elegant, da ich Probleme mit den JSON-Funktionen hatte. Mittlerweile funktioniert dies und ich habe die obige Anfrage angepasst. Zu Archivzwecken hier noch die alte Abfrage, die alles au\u00dfer dem Zeitstempel mit der String-Funktion REPLACE <\/strong>entfernt:<\/p>\n
SELECT e.PROF_DISPLAY_NAME, REPLACE(REPLACE(ext.PROF_VALUE, '}', ''), '{"state":"complete","timestamp":', '') AS timestampRaw,\nDATE((((REPLACE(REPLACE(ext.PROF_VALUE, '}', ''), '{"state":"complete","timestamp":', '') \/ 1000)-5*3600)\/86400)+719163) AS calculatedDate,\n(\n\tSELECT privacyExt.PROF_VALUE \n\tFROM EMPINST.PROFILE_EXTENSIONS privacyExt\n\tWHERE ext.PROF_KEY = privacyExt.PROF_KEY \n\tAND privacyExt.PROF_PROPERTY_ID = 'privacyAndGuidelines'\n) AS privacyVersion\nFROM EMPINST.PROFILE_EXTENSIONS ext\nLEFT JOIN EMPINST.EMPLOYEE e ON (e.PROF_KEY = ext.PROF_KEY)\nWHERE PROF_PROPERTY_ID = 'touchpointState'\nORDER BY REPLACE(REPLACE(ext.PROF_VALUE, '}', ''), '{"state":"complete","timestamp":', '') DESC<\/code><\/pre>\n
Zugegeben, technisch ist die Abfrage nicht sauber und durch das ganze Gebastel auch nicht wirklich performant f\u00fcr gro\u00dfe Datenmengen geeignet. Dies liegt prim\u00e4r daran, dass der Touchpoint die generische Attribute-Tabelle nutzt und hier ein JSON-Objekt serialisiert gespeichert wird. Ich hatte kurz mal mit SYSTOOLS.JSON_VAL<\/strong> experimentiert – DB2 scheint grunds\u00e4tzlich tats\u00e4chlich in der Lage zu sein, mit JSON-Dokumenten in Tabellenfeldern zu arbeiten. Jedoch kam ich bisher damit zu keinem zufriedenstellenden Ergebnis.<\/p>\n","protected":false},"excerpt":{"rendered":"
Mit HCL Connections 6.5 wird Touchpoint automatisch installiert. Hierbei handelt es sich um einen sogenannten Onboarding-Assistenten: Er soll auf der einen Seite neue Anwender an die Hand nehmen, ihnen beim ausf\u00fcllen des Profiles, finden von Communitys, anderen Personen etc. helfen. Dar\u00fcber hinaus kann auch eine Datenschutzerkl\u00e4rung inklusive Version eingebunden werden. Der Nutzer muss diese akzeptieren, …<\/p>\n","protected":false},"author":5,"featured_media":7121,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[765],"tags":[854,58,855],"class_list":["post-7113","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-hcl-connections","tag-db2","tag-sql","tag-touchpoint"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7113","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=7113"}],"version-history":[{"count":3,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7113\/revisions"}],"predecessor-version":[{"id":7120,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7113\/revisions\/7120"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media\/7121"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=7113"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=7113"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=7113"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}