Speicherbarer manueller Filter
Werbung
combit GmbH Untere Laube 30 78462 Konstanz Whitepaper Produkt: combit Relationship Manager Speicherbarer manueller Filter © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -2- Inhalt Übersicht 3 Systemvoraussetzungen 3 Implementierung 3 Anlegen einer Hilfstabelle Prinzip und Struktur Hinzufügen der Ansicht im cRM Hilfstabelle aus Navigation ausblenden Schaltflächen für den manuellen Filter Die einzelnen Funktionen und ihr Aufruf Hinzufügen der Schaltflächen zur Eingabemaske Hinweise © Copyright combit GmbH, Alle Rechte vorbehalten. 3 3 5 6 7 7 8 9 Produkt: combit Relationship Manager Speicherbarer manueller Filter -3- Übersicht Ein manueller Filter ermöglicht die Auswahl einzelner Datensätze, für die sich kein gemeinsames Merkmal findet, das sonst eine Auswahl all dieser Datensätze über einen Filterausdruck ermöglichen würde. Dazu werden die RECORDIDs aller ausgewählten Datensätze in einer Hilfstabelle gespeichert. Indem zusätzlich die Informationen über den jeweiligen cRM-Benutzer und den verwendeten cRM-Ansichtsnamen gespeichert werden, ist eine benutzerspezifische und ansichtspezifische manuelle Auswahl von Datensätzen möglich. Zu Beginn muß die Hilfstabelle, in der die Informationen für den manuellen Filter gespeichert werden, angelegt werden. Diese Anlage können Sie bequem vom cRM aus vornehmen. Die Lösung ist scriptbasiert. Sie benötigt lediglich das Hinzufügen von Schaltflächen zum Aufruf der jeweiligen Funktionalität. Systemvoraussetzungen Diese Funktionalität benötigt den combit Relationship Manager 2006. Der Benutzer bzw. die Gruppe des Benutzers muss über das Recht verfügen, Scripte auszuführen.Das Script bezieht sich auf die Tabellen- und Feldnamen der mitgelieferten combit cRM-Solution und dabei auf die Ansicht Adressen mit der verwendeten Tabelle ADRESSEN. Ebenso verwendet wird das Feld mit dem Namen „RecordID“. Für andere Ansichten bzw. Tabellen- und Feldnamen muss das Script entsprechend angepasst werden. Implementierung Anlegen einer Hilfstabelle Prinzip und Struktur Die Hilfstabelle wird im Datenbanksystem angelegt. Verwenden Sie dazu Konfiguration > Datenbank > Datenbankstruktur im cRM. Tabelle: „MARKIERUNG“ [Abbildung: Prinzip Hilfstabelle] Die Hilfstabelle (mit dem Namen „MARKIERUNG“) enthält 4 Spalten in denen die Informationen des cRMDatensatzes abgespeichert werden. Nachfolgend finden Sie eine Liste mit den Konfigurationsdaten: © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter Feldname ID RecordID cRMUser cRMView Feldtyp MS SQL Server uniqueidentifier uniqueidentifier varchar 20 varchar 30 -4- Feldtyp PostgreSQL char 36 char 36 varchar 20 varchar 30 Bemerkung Schlüsselfeld, keine NULL keine NULL keine NULL keine NULL Das Anlegen der Hilfstabelle kann vollständig im cRM 2006 ausgeführt werden. Über Konfiguration > Datenbank > Datenbankstruktur haben Sie die Möglichkeit über den Button „Neue Datenbanktabelle erstellen“ rechts oben neben der Combobox eine neue Tabelle anzulegen. Beachten Sie bitte die Großschreibung! Anschliessend können Sie die aufgeführten Felder über den Button „Neues Feld hinzufügen“ erstellen. Vergleichen Sie dazu bitte auch das Kapitel 15 im Handbuch. Neue Datenbanktabelle erstellen Neues Feld hinzufügen [Abbildung: Datenbankstruktur der Hilfstabelle im MS SQL Server] Neue Datenbanktabelle erstellen Neues Feld hinzufügen [Abbildung: Datenbankstruktur der Hilfstabelle im PostgreSQL Server] © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -5- Hinzufügen der Ansicht im cRM Damit die Scripting-Schnittstelle des cRM auf diese Ansicht zugreifen kann, muss die Ansicht dem Projekt über Ansichten > Neu hinzugefügt werden. Wählen Sie dazu unter „Datenbanktabelle/-sicht“ die eben erstellte Tabelle „MARKIERUNG“ aus und benutzen Sie als Name der Ansicht den Namen „MARKIERUNG“ . Vergleichen Sie dazu bitte auch das Kapitel 15 in Ihrem Handbuch. Setzen Sie die Felder auf folgende interne Feldtypen: 1. 2. 3. 4. ID: RecordID: cRMUser: cRMView: „Datensatz-ID“ „Global eindeutige ID“ „Zeichen“ „Zeichen“ [Abbildung: Ansicht „MARKIERUNG“ im MS SQL Server] © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -6- [Abbildung: Ansicht „MARKIERUNG“ im PostgreSQL Server] Hilfstabelle aus Navigation ausblenden Da die Tabelle nur als Hilfstabelle dient, ist es ratsam, sie für die Benutzer nicht in der Navigation anzeigen zu lassen. Setzen Sie deshalb das Recht „Ansicht in Navigation anzeigen“ für die Benutzergruppe auf „Nein“ Folgende Rechte in der Ansicht MARKIERUNG sind unbedingt notwendig: - Ansicht öffnen - Datensatz ändern - Datensatz neu anlegen - Datensatz löschen - Freie SQL-Abfrage © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -7- [Abbildung: Rechte für die Ansicht MARKIERUNG] Hinweis: Das Recht „Freie SQL-Abfrage“ ist auch Voraussetzung in der Ansicht, in der der manuelle Filter ausgeführt werden soll. Schaltflächen für den manuellen Filter Die einzelnen Funktionen und ihr Aufruf Der manuelle Filter ist benutzer- und ansichtsspezifisch! Jeder Benutzer kann für verschiedene Ansichten eigene manuelle Filter erstellen. Die Scriptdatei mark.vbs enthält folgende Funktionalitäten für den Einsatz des manuellen Filters: 1. Datensatz markieren Aufruf: Add2Filter(false) Beschreibung: fügt den aktuellen Datensatz der aktuellen Ansicht zum manuellen Filter hinzu. 2. Datensatz entmarkieren Aufruf: RemoveFromFilter(false) Beschreibung: Entfernt den aktuellen Datensatz aus dem manuellen Filter falls dieser dort vorhanden ist 3. Aktuellen Filter markieren Aufruf: Add2Filter(true) Beschreibung: fügt alle Datensätze des aktiven Filters dem manuellen Filter hinzu. 4. Alle Markierungen entfernen Aufruf: RemoveFromFilter(true) Beschreibung: Entfernt den gesamten manuellen Filter des Benutzers für diese Ansicht. 5. nur markierte anzeigen Aufruf: ManFilter Beschreibung: Führt den manuellen Filter aus. © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -8- Die nachfolgende Abbildung zeigt ein Beispiel dafür, wie diese Funktionen unter Einsatz von Schaltflächen auf einer Eingabemaske angeordnet werden könnten: [Abbildung: Schaltflächen für den manuellen Filter] Hinzufügen der Schaltflächen zur Eingabemaske Kopieren Sie die Scriptdatei mark.vbs in das Unterverzeichnis „script“ Ihrer cRM-Installation Führen Sie folgende Schritte für jede Schaltfläche/Funktionalität aus: • Fügen Sie für jede der oben angeführten Funktionalitäten eine Schaltfläche vom Typ „Script Direkt“ hinzu und • fügen Sie folgenden Aufruf in das Feld „Scripttext:“ ein: <!--#include file="%APPDIR%\script\mark.vbs"--> • Fügen Sie je nach gewünschter Funktionalität einen der oben angeführten Aufrufe in einer neuen Zeile ein. Die nachfolgende Abbildung zeigt ein Beispiel für einen Aufruf. [Abbildung: Beispiel für Schaltfläche „Datensatz markieren“] © Copyright combit GmbH, Alle Rechte vorbehalten. Produkt: combit Relationship Manager Speicherbarer manueller Filter -9- Hinweise Bitte beachten Sie, dass das Hinzufügen einer großen Anzahl von Datensätzen zum manuellen Filter über die Funktionalität „Aktuellen Filter markieren“ einige Zeit beanspruchen kann. Diese Funktionalität ist nur für eine kleine Menge an Daten gedacht! Beachten Sie bitte auch die Groß- und Kleinschreibung der Bezeichner! Hinweis: combit macht keine Angaben zu einer bestimmten Eignung obiger Informationen. Irrtümer und Fehler bleiben ausdrücklich vorbehalten, die Angaben erfolgen ohne Gewähr und enthalten keine Zusicherung. Die Informationen können z.T. auch ein Versuch sein, Ihnen bei einer Aufgabenstellung zu helfen, selbst wenn das Produkt eigentlich nicht für diesen speziellen Zweck vorgesehen wurde. © Copyright combit GmbH, Alle Rechte vorbehalten.
