x SQL Cockpit Update Add-on – Anwenderdokumentation Version 1.0 SQL Cockpit Update Add-on Anwenderdokumentation Seite 1 x Inhaltsverzeichnis Einleitung ................................................................................................................................................ 3 Disclaimer ............................................................................................................................................... 3 Support Prozess Cadaxo ........................................................................................................................ 3 Oberfläche............................................................................................................................................... 4 Ausgangslage.......................................................................................................................................... 5 Editier-Bereich ........................................................................................................................................ 6 Ticket-Bereich ......................................................................................................................................... 8 Changelog-Bereich ................................................................................................................................. 9 Massenänderungen ............................................................................................................................... 9 Einstellungen ........................................................................................................................................ 10 Berechtigungen .................................................................................................................................... 11 Protokolle .............................................................................................................................................. 13 Copyright ............................................................................................................................................... 13 SQL Cockpit Update Add-on Anwenderdokumentation Seite 2 x Einleitung Vielen Dank, dass Sie sich für die SQL Cockpit Premium Version von Cadaxo entschieden haben. Sie halten nun ein mächtiges Tool in der Hand, das Sie bei Entwicklungstätigkeiten und bei Supportaufgaben in Zukunft unterstützen wird. Das SQL Cockpit Premium baut auf dem SQL Cockpit Standard auf und stellt eine Erweiterung dessen dar. Alle Funktionen, die in der StandardVersion vorhanden sind, können in der Premium Version ebenfalls verwendet werden. Mit der Erweiterung können Sie nun nachvollziehbar Datenänderungen direkt im Produktivsystem mitprotokollieren. Diese Dokumentation erläutert die Funktionsweise des SQL Cockpit Premium. In dieser Dokumentation möchten wir Ihnen nun – frei nach unserem Motto „ … es geht auch einfach“ – die Verwendung und die Möglichkeiten des SQL Cockpit Premium näher bringen. Disclaimer Die folgenden Ausführungen gelten für die gesamte gelieferte Software und alle zukünftigen Updates. Für die Gewährleistung einer bestmöglichen Verwendung und Ausführung der Software ist der Kunde selbst dafür verantwortlich das Produkt zu testen, da dieser die IT-Landschaft am besten kennt. Falls systemkritische Änderungen vom Kunden gefordert werden, ist der Kunde dafür verantwortlich, dass diese vorab im Qualitätssicherungssystem ausreichend getestet werden. Der Kunde ist verantwortlich für die Änderungen und folgende Auswirkungen bei Datenänderungen im Produktivsystem. Er ist sich der Folgen und allfälliger Risiken bewusst und nimmt und trägt selbst dafür Sorge, dass nur ausreichend qualifiziertes und berechtigtes Personal das Cockpit verwendet. Zusätzlich ist der Kunde dafür verantwortlich, dass bei Vergabe von Berechtigungen keine Gefährdung des internen Kontrollsystems entsteht und es folglich daraus auch zu keiner Beeinträchtigung der Datensicherheit kommt. Support Prozess Cadaxo Sollte es zu Problemen mit dem SQL Cockpit kommen, so können Sie einfach eine Support Meldung aufgeben. Dies kann von jedem Benutzer mit Administrator Berechtigungen direkt aus dem SQL Cockpit durchgeführt werden. Einfach durch einen Klick auf . Damit werden die wichtigsten Informationen (verwendeter Select, Version, etc.) an Cadaxo übermittelt. SQL Cockpit Update Add-on Anwenderdokumentation Seite 3 x Mit Microsoft Outlook funktioniert das meist automatisch. Bei anderen Mail Clients bitte einfach den Text aus dem Pop-up in eine Mail kopieren und an [email protected] schicken. Oberfläche Im SQL Cockpit Premium können Daten verändert werden. Dies ist durch die Ergebnisliste möglich, in dem Zeilen oder die gesamte Liste durch Rechtsklick „Edit“ oder den Button in den Update-Bereich übertragen werden. SQL Cockpit Update Add-on Anwenderdokumentation Change- Seite 4 x Der Update Bereich wird ein drei Bereiche unterteilt - Editier-Bereich, Changelog-Bereich und Ticket-Bereich. Der obere Bereich ist der Editier-Bereich. Hier können Datensätze verändert werden. Links unten befindet sich der Ticket-Bereich. Mittels Ticketnummer und Kommentar bzw. Beschreibung kann die Datenänderung zugeordnet werden. Im rechten unteren Bereich befindet sich das Changelog. In diesem wird dokumentiert, was verändert wird. Nach erfolgreicher Änderung und Speicherung der Daten, werden die Datenänderungen in der Ergebnisliste sofort sichtbar. Ausgangslage Grundsätzlich ist mit dem Update alles möglich, was mit der Standard Version des SQL Cockpits auch möglich ist. Eine Einschränkung gibt es im Bereich der SELECT Statements: SQL Cockpit Update Add-on Anwenderdokumentation Seite 5 x - JOINS und Aggregatfunktionen sind nur in Sub-SELECTs möglich Im SELECT-Statement müssen alle Key-Felder angegeben werden Im Editierbereich können prinzipiell alle Datenfelder geändert werden. Ausnahme sind Schlüsselfelder bzw. Key-Felder und spezielle Felder, bei denen das Editieren nicht möglich oder sinnvoll ist. Durch das Eingeben eines Wertes und betätigen der Entertaste kann ein Wert in einem Datenfeld geändert werden und wird für den Anwender sichtbar im Changelog eingetragen. Im Hintergrund werden die Änderungen in 4 weiteren Listen eingetragen, wodurch eine nachvollziehbare und revisionssichere Protokollierung entsteht. Durch den Doppelklick auf eine Zeile im Changelog wird auf den entsprechenden Datensatz im Editierbereich hingewiesen und umgekehrt. Dadurch können bereits getätigte Änderungen nochmals einfach und schnell gefunden und kontrolliert werden. Editier-Bereich Die Schlüssel- bzw. Key-Felder, Felder die im ALV nicht geändert werden können (z.B. Strings > 128 Zeichen oder gepackte Felder) sind im Editierbereich farblich von den anderen Datenfeldern abgehoben. Ebenso Felder, bei denen man keine Berechtigungen zum Editieren hat. Grundsätzlich wird in der ersten Spalte die Row ID angezeigt, welche mit dem Changelog kompatibel ist. Dadurch ist ein schnelles Vergleichen der Datensätze möglich. Der Legend Button erklärt die Farben im ALV. Mittels Rechts-Klick auf einen Spaltenkopf werden Detailinformationen zum Feldtyp sowie den Berechtigungen angezeigt. SQL Cockpit Update Add-on Anwenderdokumentation Seite 6 x SQL Cockpit Update Add-on Anwenderdokumentation Seite 7 x Ticket-Bereich Durch die Eingabe einer Ticketnummer und eines Kommentars wird der Update-Prozess vervollständigt und die Änderungen können gespeichert werden. Ob diese Felder Pflicht sind, kann im Admin-Bereich eingestellt werden. Wenn ein Solution Manager integriert ist, ist sogar eine Prüfung der Nummer möglich. SQL Cockpit Update Add-on Anwenderdokumentation Seite 8 x Changelog-Bereich Im Changelog im Editierbereich ist es möglich, die geänderten Daten sofort mitzuverfolgen. Hier ist es außerdem möglich, durch den „Undo“-Button Änderungen wieder rückgängig zu machen. Durch den „Undo All“-Button können alle bisher geänderten Daten zurückgesetzt werden. Im Changelog werden die alten sowie die neuen Werte des Datensatzes gespeichert. Beim Speichern kommt noch ein Warn-Pop-up, damit man nicht leichtfertig Daten im System manipuliert und sich der Risiken nochmals vergegenwärtigt. Massenänderungen Datenfelder können entweder vereinzelt oder gesammelt verändert werden. Es gibt folgende zwei Optionen für gesammelte Datenänderungen: SQL Cockpit Update Add-on Anwenderdokumentation Seite 9 x - Funktion „replace each value“: alle Datenfelder einer Spalte mit einem bestimmten Wert können geändert werden - Funktion „set all values“: alle Werte in der gewählten Spalte werden auf einen Wert geändert Einstellungen In den Einstellungen gibt es nun einen weiteren Reiter „SQL Cockpit – Update“. Hier können vom Administrator einige für den Update-Prozess relevante Einstellungen vorgenommen werden. Folgende Möglichkeiten können gewählt werden: SQL Cockpit Update Add-on Anwenderdokumentation Seite 10 x - - „Ticket required“ – der Anwender kann nur mit Angabe einer Ticketnummer ein Update durchführen. „Comment required“ – der Anwender kann nur mit der Eingabe eines Kommentars ein Update durchführen. „Write Change Document“ – alle Änderungen des Anwenders werden in einem Dokument vermerkt und gespeichert. Disclaimer - der Anwender bekommt eine Nachricht über Änderungen (O = Once, D = Daily, A = Always). „Send Mail“ – wenn diese Funktion aktiv ist, wird an die angegebene Adresse eine Mail versendet. Ein Betreff, der Dateipfad und der Name des Attachments können angegeben werden. „Solution Manager Integration“ – wenn diese Funktion aktiv ist, wird das Ticketsystem mit dem SQL Cockpit verbunden. Berechtigungen Die Verwendung der Änderungsfunktionalitäten kann gravierende Auswirkungen auf die Konsistenz des SAP Systems haben. Deswegen müssen die Berechtigungen sorgsam vergeben werden. Das Berechtigungssystem der Änderungen unterscheidet sich von den Berechtigungen auf Analyseseite dahingehend, dass alle Tabellen, und auch alle Felder für einen User explizit SQL Cockpit Update Add-on Anwenderdokumentation Seite 11 x berechtigt werden müssen, damit Änderungen erlaubt sind. Eine generelle Berechtigung auf alle Tabellen und alle Felder ist nicht möglich. Die Berechtigungspflege wird direkt aus dem Admin-Bereich aufgerufen. Zunächst werden Rollen angelegt. Diesen Rollen werden Tabellen zugeordnet. Mittels Doppelklick auf eine Tabelle werden die Felder angezeigt. Dann können selektiv Felder für Einzelsatzupdates, oder Massenupdates freigeschalten werden. Mittels Felder der Tabelle freigeschalten bzw. gesperrt werden werden. können auch alle Im zweiten Schritt werden einem Benutzer Rollen zugeordnet. Nach einem Neustart des SQL Cockpits ziehen die neuen Berechtigungen. SQL Cockpit Update Add-on Anwenderdokumentation Seite 12 x Mittels können auch alle Rollen in ein anderes System transportiert werden. Protokolle Die Datenänderungen im SQL Cockpit Premium werden an fünf verschiedenen Stellen fortgeschrieben. Im Systemlog (nur rudimentäre Headerdaten) In der Tabellenänderungshistorie (wenn für eine Tabelle eingeschaltet) Im Cadaxo Update Log (Transaktion /CADAXO/ULOG) (Auch aufrufbar aus dem Adminbereich ( )– Hier werden die Daten verschlüsselt abgelegt, sodass ein Verfälschen der Logeinträge erschwert wird. Solution Manager Tickets (wenn aktiviert): hier werden die Headerinformationen übertragen Email: ein detailliertes Email mit allen Änderungen wird an die im Admin-Bereich angegebene Adresse geschickt. Durch diese umfassende Protokollierung ist die Nachvollziehbarkeit und Übersicht der Datenänderungen garantiert. Copyright © 2009–2013 Cadaxo GesmbH. Alle Rechte vorbehalten. Die Vervielfältigung bzw. Übersetzung dieses Dokumentes oder Teilen daraus ist ohne ausdrückliche Genehmigung durch die Cadaxo GesmbH nicht zulässig. SAP®, ABAP™, R/3®, SAP NetWeaver® sind Marken oder eingetragene Marken der SAP AG. Alle anderen Produkte sind Marken oder eingetragene Marken der jeweiligen Firmen. SQL Cockpit Update Add-on Anwenderdokumentation Seite 13