SQL Cockpit - Anwenderdokumentation

x
SQL Cockpit Update Add-on –
Anwenderdokumentation
Version 2.0
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 1
x
Inhaltsverzeichnis
Einleitung ................................................................................................................................................ 3
Disclaimer ............................................................................................................................................... 3
Support Prozess Cadaxo ........................................................................................................................ 3
Oberfläche............................................................................................................................................... 4
Ausgangslage.......................................................................................................................................... 6
Editier-Bereich ........................................................................................................................................ 6
Ticket-Bereich ......................................................................................................................................... 9
Changelog-Bereich ................................................................................................................................. 9
Massenänderungen ............................................................................................................................. 10
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.
Change-
Falls die Ergebnisliste leer ist und Sie die Berechtigung zum Hinzufügen neuer Zeilen besitzen,
können Sie durch Rechtsklick „Insert lines“ oder den
gelangen und neue Sätze in die Tabelle hinzufügen.
SQL Cockpit Update Add-on Anwenderdokumentation
Insert-Button in den Premium Pop-Up
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.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 5
x
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:
-
JOINS und Aggregatfunktionen sind nur in Sub-SELECTs möglich
Im SELECT-Statement müssen alle Key-Felder angegeben werden
Editier-Bereich
Ändern von neuen bestehenden Zeilen
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.
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
Löschen bestehender Zeilen
Mit dieser Schaltfläche
kann man bestehende Zeilen löschen. Die Zeilen, die man löschen
möchte, müssen vorher markiert werden. Es ist auch möglich, mehrere Zeilen gleichzeitig zu
markieren. Die Löschung wird im Changelog mit einem „D“ im Feld „Change-Indikator“
gekennzeichnet.
Hinzufügen neuer Zeilen
Mit diesem Button
kann man neue leere Zeilen hinzufügen. Es ist möglich, entweder je
eine oder mit dem DropDown gleich zehn Zeilen hinzufügen. Dabei sind die Keyfelder
eingabebereit und müssen befüllt werden. Es gibt ein weiteres Feature, das die händische
Eingabe erleichtern kann: Man kann einen bestimmten Nummernkreis auswählen, damit die
Nummern aus diesem Nummernkreis gezogen werden. Diese Nummern werden dann
automatisch in die markierten Zellen bzw. Spalten eingefügt.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 7
x
Kopieren von Zeilen
Mit diesem Button
lassen sich Zeilen kopieren. Dabei muss man nur die Zeilen, die man
kopieren möchte, markieren und die Schaltfläche betätigen. Als nächstes muss man die KeyFelder eintragen, da diese eindeutig sein müssen.
Im Changelog werden neue Zeilen mit den Change-Indikator „I“ gekennzeichnet. Dabei werden
sämtliche Key-Felder, die eingetragen wurden, nach Betätigen der Entertaste, auch im Changelog
angezeigt.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 8
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.
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 die Risiken nochmals vergegenwärtigt.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 9
x
Massenänderungen
Datenfelder können entweder vereinzelt oder gesammelt verändert werden. Es gibt folgende zwei
Optionen für gesammelte Datenänderungen:
-
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.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 10
x
Folgende Möglichkeiten können gewählt werden:
-
-
„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.
SQL Cockpit Update Add-on Anwenderdokumentation
Seite 11
x
Das Berechtigungssystem der Änderungen unterscheidet sich von den Berechtigungen auf
Analyseseite dahingehend, dass alle Tabellen, und auch alle Felder für einen User explizit
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. Auf Tabellenebene
kann jeweils eine Berechtigung für Update, Insert und Delete vergeben werden. 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 freigeschaltet 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–2014 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