Spectrum Miner ™ Version 7.2 Administratorhandbuch für die Integration von Portrait Dialogue Copyright © 2016 Pitney Bowes Software Inc. Alle Rechte vorbehalten. MapInfo und Group 1 Software sind Marken von Pitney Bowes Software Inc. Alle anderen Marken und Markenzeichen sind Eigentum ihrer jeweiligen Besitzer. USPS® Urheberrechtshinweise Pitney Bowes Inc. wurde eine nicht-ausschließliche Lizenz erteilt, die die Veröffentlichung und den Verkauf von ZIP + 4® Postleitzahl-Datenbanken auf optischen und magnetischen Medien genehmigt. Folgende Marken sind Markenzeichen des United States Postal Service: CASS, CASS Certified, DPV, eLOT, FASTforward, Link Link First-Class Mail, Intelligent Mail, LACS , NCOA , PAVE, PLANET Link Code, Postal Service, POSTNET, Post Office, RDI, Suite , United States Postal Service, Standard Mail, United States Post Office, USPS, ZIP Code, und ZIP + 4. Hierbei handelt es sich jedoch nicht um eine vollständige Liste der Marken, die zum United States Postal Service gehören. Pitney Bowes Inc. ist nicht-exklusiver Lizenznehmer von USPS® für Link die Verarbeitungsprozesse von NCOA ®. Die Preisgestaltung jeglicher Pitney Bowes Softwareprodukte, -optionen und -dienstleistungen erfolgt nicht durch USPS® oder die Regierung der Vereinigten Staaten. Es wird auch keine Regulierung oder Genehmigung der Preise durch USPS® oder die US-Regierung durchgeführt. Bei der Verwendung von RDI™-Daten zur Berechnung von Paketversandkosten wird die Entscheidung, welcher Paketlieferdienst genutzt wird, nicht von USPS® oder der Regierung der Vereinigten Staaten getroffen. Datenbereitstellung und Hinweise Hier verwendete Datenprodukte und Datenprodukte, die in Software-Anwendungen von Pitney Bowes verwendet werden, sind durch verschiedene Markenzeichen und mindestens eines der folgenden Urheberrechte geschützt: © Copyright United States Postal Service. Alle Rechte vorbehalten. © 2014 TomTom. Alle Rechte vorbehalten. TomTom und das TomTom Logo sind eingetragene Marken von TomTom N.V. © 2016 HERE Quelle: INEGI (Instituto Nacional de Estadística y Geografía) Copyright Basierend auf elektronischen Daten © National Land Survey Sweden. © Copyright United States Census Bureau © Copyright Nova Marketing Group, Inc. Teile dieses Programms sind urheberrechtlich geschützt durch © Copyright 1993-2007 Nova Marketing Group Inc. Alle Rechte vorbehalten. © Copyright Second Decimal, LLC © Copyright Canada Post Corporation Diese CD-ROM enthält Daten einer urheberrechtlich geschützten Datenerfassung der Canada Post Corporation. © 2007 Claritas, Inc. Das Geocode Address World Dataset enthält lizenzierte Daten des GeoNames-Projekts (www.geonames.org), die unter den Bedingungen der Creative Commons Attribution License („Attribution License“) bereitgestellt werden. Die Attribution License können Sie unter http://creativecommons.org/licenses/by/3.0/legalcode einsehen. Ihre Nutzung der GeoNames-Daten (wie im Nutzerhandbuch beschrieben) unterliegt den Bedingungen der Attribution License. Bei Konflikten zwischen Ihrer Vereinbarung mit Pitney Bowes Software, Inc. und der Attribution License hat die Attribution License lediglich bezüglich der Nutzung von GeoNames-Daten Vorrang. ICU Urheberrechtshinweise Copyright © 1995-2011 International Business Machines Corporation und andere. Alle Rechte vorbehalten. Hiermit wird jeder Person, die eine Kopie dieser Software und der damit verbundenen Dokumentationsdateien (nachfolgend die „Software“) erhält, kostenlos das Recht der uneingeschränkten Nutzung der Software erteilt, insbesondere das Recht auf Verwendung, Erstellen von Kopien, Abänderung, Zusammenführung, Veröffentlichung, Verbreitung und/oder Verkauf von Kopien der Software sowie die Erteilung dieser Genehmigung an andere Personen, denen die Software zur Verfügung gestellt wird. Dies erfolgt unter der Voraussetzung, dass obenstehende Urheberrechtshinweise und diese Nutzungsgenehmigung sowohl in allen Softwarekopien als auch in der zugehörigen Produktdokumentation aufgeführt sind. DIE SOFTWARE WIRD WIE BESEHEN, OHNE JEGLICHE MÄNGELGEWÄHR ODER ANDERE AUSDRÜCKLICHE ODER IMPLIZIERTE GEWÄHRLEISTUNG, INSBESONDERE OHNE GEWÄHRLEISTUNG DER MARKTFÄHIGKEIT, DER EIGNUNG FÜR BESTIMMTE ZWECKE ODER GEWÄHRLEISTUNG DER NICHTVERLETZUNG VON SCHUTZRECHTEN DRITTER, BEREITGESTELLT. DER ODER DIE INHABER DES URHEBERRECHTS, DIE IN DIESER URHEBERRECHTSERKLÄRUNG AUFGEFÜHRT SIND, IST/SIND KEINESFALLS HAFTBAR FÜR ANSPRÜCHE, MITTELBARE ODER UNMITTELBARE SCHÄDEN, ODER JEGLICHE ANDERE SCHÄDEN, DIE, EGAL OB IM RAHMEN EINER VERTRAGSHANDLUNG ODER DURCH FAHRLÄSSIGKEIT ODER UNERLAUBTE HANDLUNG, DURCH DEN VERLUST VON NUTZUNGSFÄHIGKEIT, DATEN ODER GEWINNEN ENTSTEHEN, UND DIE UNABHÄNGIG VON Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 3 Copyright ODER IN VERBINDUNG MIT DER NUTZUNG ODER LEISTUNG DIESER SOFTWARE ENTSTEHEN. Namen der Urheberrechtsinhaber werden, außer wie hierin festgehalten, nicht zum Zweck der Werbung oder zur Förderung von Verkauf, Nutzung oder anderen geschäftlichen Transaktionen in Verbindung mit der Software verwendet, es sei denn, es wurde zuvor eine ausdrückliche schriftliche Zustimmung des Urheberrechtsinhabers eingeholt. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 4 Inhalt C o p y r i g h t 1 - Einleitung Zweck Wer dieses Buch lesen sollte Verwandte Dokumente 7 7 7 2 - Miner-Integrationsübersicht Miner-Integrationsübersicht 9 3 - Installation des Plug-Ins für den Export von Spectrum Miner Installation des Plug-Ins für den Export von Spectrum Miner in Portrait Dialogue 12 4 - Portrait Dialogue-Serverkonfiguration Portrait Dialogue-Serverkonfiguration 16 5 - Tests und Fehlerbehebung Tests und Fehlerbehebung 18 1 - Einleitung In diesem Abschnitt werden folgende Themen behandelt Zweck Wer dieses Buch lesen sollte Verwandte Dokumente 7 7 7 Einleitung Zweck Dieses Dokument beschreibt, wie Sie das Plug-In für Spectrum Miner und die Webdienstkomponente PAWS installieren können, die den Export von Bewertungen, Listen und Regeln in Portrait Dialogue erleichtert. Wer dieses Buch lesen sollte Systemadministratoren, welche die Integration zwischen Spectrum Miner und Portrait Dialogue installieren und verwalten. Verwandte Dokumente Dokument Datenträger (Zip-Datei/DVD) und Ort • Spectrum • Portrait Dialogue-Datenträger in: \Documentation\7 - Miner Integration\ Miner 7.2-Integrationsbenutzerhandbuch • Portrait • Portrait Dialogue-Datenträger in: \Documentation\1 - Installation & upgrade\ Dialogue 5.2-Installationshandbuch • Portrait Dialogue-Datenträger in: \Documentation\ • Portrait Dialogue 5.2-Versionshinweise Tipp: Alle Dokumente stehen ebenfalls auf der Spectrum Software-Support-Website zur Verfügung: http://www.pbinsight.com/support/product-documentation. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 7 2Miner-Integrationsübersicht In diesem Abschnitt werden folgende Themen behandelt Miner-Integrationsübersicht 9 Miner-Integrationsübersicht Miner-Integrationsübersicht Spectrum Miner ist eine Spectrum-Lösung für die Erstellung von Erkenntnissen durch die Analyse von Kundenverhalten. Portrait Dialogue ist eine Kundeninteraktionslösung, die disparate Kundeninteraktionen zur stärkeren Kundenbindung in einen schlüssigen, geschlossenen Dialog über alle Kanäle verwandelt. Die Integration zwischen Spectrum Miner und Portrait Dialogue ermöglicht Analyseergebnisse und Erkenntnisse (z. B. bezüglich Zielgruppen und Vorhersageregeln, die im Spectrum Miner identifiziert werden) an eine operationale Umgebung weiterzuleiten und direkt in ihr zu verwenden. Dies geschieht wahlweise entweder durch Exportieren einer Liste von Kundenidentifizierern (und optional einer Pro-Kopf-Bewertung) oder einer analytischen Regelbeschreibung. Spectrum Miner Folgende Systemvoraussetzungen gelten für die Installation der Plug-in-Komponenten zur Unterstützung des Exports von Bewertungen/Listen von Spectrum Miner zu einer Portrait Dialogue-Installation. • Spectrum Miner 7.2-Server/Desktop ist installiert. • Ein Befehlszeilen-SQL-Client ist auf dem Server/Desktop installiert, auf dem das Plug-in installiert werden soll (z. B. sqlcmd für SQL Server oder sqlplus für Oracle) und der von allen Benutzern des Spectrum Miner Servers/Desktops ausgeführt werden kann. • Der Spectrum Miner Server/Desktop und der Portrait Dialogue-Datenbankserver haben Zugriff auf ein gemeinsames Dateisystem, für das sowohl der Benutzer, der den Export durchführt, als auch der Benutzer des Datenbanksystems lese- und schreibberechtigt ist. • Der Portrait Dialogue-Datenbankserver ist mit einem Netzwerk verbunden, das für alle Benutzer des Spectrum Miner-Servers/Desktops sichtbar ist. • Der Benutzer, der die Installation vornimmt, hat Zugriff auf einen einfachen Texteditor auf dem Installationscomputer des Spectrum Miner-Servers/Desktops. Portrait Dialogue Für eine erfolgreiche Benutzung des Plug-Ins sind folgende Voraussetzungen zu erfüllen. • Portrait Dialogue 5.2 ist installiert. • Portrait Dialogue läuft auf einer Datenbank, die nicht zwischen Groß- und Kleinschreibung unterscheidet. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 9 Miner-Integrationsübersicht • Der Portrait Dialogue-Datenbankserver und der Spectrum Miner-Server/Desktop haben Zugriff auf ein gemeinsames Dateisystem, für das sowohl der Benutzer, der den Export durchführt, als auch der Benutzer des Datenbanksystems lese- und schreibberechtigt ist. • Damit alle exportierten Kategorien genutzt werden können, muss die Systemdatengruppe „Kategorien“ in der Domäne vorhanden sein, zu der die Kategorien exportiert werden sollen. • Anmerkung: Der SQL Server 2000 wird nicht mehr als Datenbank für die Exportfunktion unterstützt. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 10 3 - Installation des Plug-Ins für den Export von Spectrum Miner In diesem Abschnitt werden folgende Themen behandelt Installation des Plug-Ins für den Export von Spectrum Miner in Portrait Dialogue 12 Installation des Plug-Ins für den Export von Spectrum Miner Installation des Plug-Ins für den Export von Spectrum Miner in Portrait Dialogue Die Erweiterungskomponenten für den Spectrum Miner Server werden in einem Verzeichnis auf der Versions-DVD bereitgestellt. Um die Komponenten zu installieren, gehen Sie wie folgt vor: • Kopieren Sie den Ordner „millionhandshakes“ auf der Versions-DVD (\5.2\5.2.x.xx\Miner Integration\Miner7.2\Spectrum Miner Export to Portrait Dialogue Plug-in 1.3A\) in das Verzeichnis „ext“ der Installation von Spectrum Miner. Das heißt, wenn sich die Installation von Spectrum Miner 7.2 unter C:\SpectrumMiner_7.2 befindet, kopieren Sie den Komponentenordner in C:\SpectrumMiner_7.2\ext. • Navigieren Sie zum neuen „millionhandshakes“-Komponentenverzeichnis (C:\SpectrumMiner_7.2\ext\millionhandshakes), öffnen Sie die Datei javastartup.xml, und legen Sie die Werte für Ihre Installation für folgende Eigenschaften fest: Eigenschaft Beschreibung MH_DATABASE_TYPE Der Datenbanktyp, auf dem Portrait Dialogue installiert ist (muss entweder MSSQL2005 oder ORACLE sein). Anmerkung: Für einen SQL Server 2008 Datenbankserver müssen Sie MSSQL2005 eingeben. MH_INSTANCE Die Portrait Dialogue-Instanz (das heißt der Name der im Visual Dialogue-Anmeldefenster erscheinende Datenbankname), in die diese Installation exportieren wird. MH_USERNAME Der Benutzername für Portrait Dialogue (das heißt der Benutzername, der zum Anmelden beim Visual Dialogue verwendet wird), unter dem alle Exporte durchgeführt werden. MH_PASSWORD Das Kennwort für den oben genannten Benutzer (das heißt das Kennwort zum Anmelden beim Visual Dialogue). MH_WH_BASE_URL Dies ist die Basis-URL für die Portrait Dialogue-Webservices, und zwar typischerweise: http://<SERVERNAME>/MHDialogServerAPI/ Anmerkung: Die URL muss mit einem Schrägstrich '/' enden. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 12 Installation des Plug-Ins für den Export von Spectrum Miner Eigenschaft Beschreibung MH_EXPORT_DIR Der Pfad zu einem Verzeichnis, in das diese Installation ihre Daten exportieren wird. Typischerweise ist das ein Verzeichnis im Default Share des Portrait Dialogue sein, z. B. ein UNC-Pfad wie \\\MH\Imports es kann auch ein zugeordnetes Laufwerk sein. Wichtig ist, dass dieser Speicherort sowohl für den Spectrum Miner-Server als auch den Portrait Dialogue-Datenbankserver erkennbar ist (daher wird ein UNC-Pfad empfohlen). MH_IMPORT_DIR Das ist der Pfad zum Verzeichnis, das der Portrait Dialogue-Datenbankserver prüft, um die Dateien zu lokalisieren, welche die zu importierenden Daten enthalten. Im Allgemeinen wird das derselbe UNC-Ort sein wie MH_EXPORT_DIR. Es kann aber ein anderer Name sein, solange beide auf denselben physikalischen Ort auf dem Laufwerk verweisen. Anmerkung: Bei Portrait Dialogue-Systemen, die Oracle nutzen, wird dieser Wert nicht verwendet und der Exportort muss einem definierten Oracle-Verzeichnis mit dem Namen MH_IMPORT zugewiesen werden. MH_IMPORT_SQL_CMD Die SQL Client-Befehlszeile für SQL Server 2005/2008: sqlcmd /U <user> /P <passwd> /S <server> /i ~FILE~ Anmerkung: Es kann sein, dass Sie die /d angeben müssen, wenn die Portrait Dialogue-Datenbank nicht Ihre Standardeinstellung ist. Anmerkung: Falls Sie die Windows-Authentifizierung für die Verbindung zur Datenbank nutzen, lassen Sie die Optionen /U und /P weg. Die SQL Client-Befehlszeile für Oracle: sqlplus <user>/<passwd>@<server>@~FILE~ Anmerkung: ~FILE~ muss in der Befehlszeile vorkommen (wird durch den Namen einer dynamisch generierten SQL-Datei beim Exportvorgang ersetzt). Anmerkung: Das Befehlszeilen-Tool muss sich auf dem Pfad des Benutzers befinden, der den Export durchführt, oder aber es muss der volle Pfad zur Befehlszeileneingabe verwendet werden. Der Benutzer muss auch die entsprechenden Systemberechtigungen haben, um das Tool verwenden zu können. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 13 Installation des Plug-Ins für den Export von Spectrum Miner Eigenschaft Beschreibung Anmerkung: Die Benutzerkonten, die in der Befehlszeile erscheinen, müssen über die entsprechenden Zugriffsberechtigungen verfügen. So muss der Benutzer z. B. für den SQL Server bulkadmin-Rechte haben. • Bei einer Eingabeaufforderung ist sicherzustellen, dass sich das Spectrum Miner-Klassenverzeichnis auf dem Pfad befindet. Dies erfolgt durch folgende Skriptzeile: <PMHOME>/config/setpath-qs7.2.bat • Dann weiter wie folgt, um DBC verfügbar zu machen: qsextadmin –enable millionhandshakes • Starten Sie den Spectrum Miner-Server (Quadstone System Server qs7.2) über „Systemsteuerung > Verwaltung > Dienste“ neu. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 14 4 - Portrait Dialogue-Serverkonfiguration In diesem Abschnitt werden folgende Themen behandelt Portrait Dialogue-Serverkonfiguration 16 Portrait Dialogue-Serverkonfiguration Portrait Dialogue-Serverkonfiguration Erstellen Sie auf dem Datenbankserver ein gemeinsames Verzeichnis, das für die Benutzer von Spectrum Miner und alle, die lese-/schreibberechtigt sind, ersichtlich ist (wie in den Spectrum Miner Installationsanleitungen für MH_IMPORT_DIR beschrieben). Dieses Verzeichnis dient dem Empfang der vom Spectrum Miner exportierten Bewertungen und Listen. Anmerkung: Auf einem Oracle Server muss dieses Verzeichnis auch beim Oracle-Datenbankserver angemeldet werden, und zwar mit folgendem SQL-Befehl: CREATE OR REPLACE DIRECTORY MH_IMPORT AS “[import directory]”; GRANT READ, WRITE ON DIRECTORY MH_IMPORT TO [db user in the SQL command]; Der obige Befehl unterstützt nicht die Verwendung von UNC-Pfadnamen. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 16 5 - Tests und Fehlerbehebung In diesem Abschnitt werden folgende Themen behandelt Tests und Fehlerbehebung 18 Tests und Fehlerbehebung Tests und Fehlerbehebung So testen Sie die Installation: • Starten Sie Decision Studio. • Laden Sie einen Fokus, und öffnen Sie Table Viewer. Die Symbole „Score nach Portrait Dialogue exportieren“ und „Liste nach Portrait Dialogue exportieren“ sollten jetzt in der Symbolleiste sichtbar sein. • Durch Anklicken des Symbols „Liste exportieren“ sollte der Dialog „Exportieren“ mit den verfügbaren Domänen in der Dropdown-Liste erscheinen. Wenn Kategorien in der gewählten Domäne definiert werden, muss die Optionsschaltfläche „Update“ aktiviert sein und bei deren Betätigung die Liste der Kategorien in der entsprechenden Dropdown-Liste angezeigt werden. Erstellen Sie zum Testen der neuen Kategorie im Portrait Dialogue eine neue Auswahl mithilfe der gerade exportierten Kategorie. Wenn die Installation nicht korrekt funktioniert, überprüfen Sie zuerst die Protokolldateien in /shared/logs (insbesondere das Decision Studio-Sitzungsprotokoll), wobei <PMHOME> das Verzeichnis ist, das die Spectrum Miner-Installation enthält. Hat das Klicken auf das Symbol „Liste exportieren“ keinerlei Effekt, überprüfen Sie, ob der Dienst Spectrum Miner qs7.2 auf dem Server neu gestartet wurde. Spectrum Miner™ 7.2 Administratorhandbuch für die Integration von Portrait Dialogue 18 3001 Summer Street Stamford CT 06926-0700 USA www.pitneybowes.com © 2017 Pitney Bowes Software Inc. Alle Rechte vorbehalten