Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- handbuch:mutationsprotokoll [14.02.2024 15:29] – angelegt Andreas Gritzka
+++ handbuch:mutationsprotokoll [06.06.2024 10:25] (aktuell) – [1 Allgemeines] Andreas Gritzka
@@ Zeile 1: / Zeile 1: @@
-====== Artikel-Schnellerfassung Handbuch ======
+====== Bedienungsanleitung Mutationsprotokollierung ======
 ====== 1 Allgemeines ======
-Die Verfügbarkeit ist ein Modul zur Sage 100 von der abacus edv-lösungen GmbH & Co. KG. Dieses Modul hilft bei der Erfassung von Einkaufs- und Verkaufsbelegen in dem es die zuletzt bei dem Kontokorrenten genutzten Artikel als Schnellauswahl zur Verfügung stellt.
+Das Mutationsprotokoll ist ein Modul zur Sage 100 von der abacus edv-lösungen GmbH & Co. KG. Das Modul ermöglicht ein Änderungsprotokoll für Einfüge, Änderungs- und Löschvorgänge auf alle Tabellen der Sage 100.
+Dieses Dokument beinhaltet eine Bedienungsanleitung zur Konfiguration der Grundlagen des Mutationsprotokoll sowie zur Möglichkeiten der Auswertung der Mutationen auf einer Tabelle. Die hier angegebenen Beispiele stehen in keiner Beziehung zu realexistierenden Unternehmen sowie Produkte.
-Dieses Dokument beinhaltet eine Bedienungsanleitung zur Konfiguration der Grundlagen der Artikel-Schnellerfassung sowie zur Vorgehensweise für den Umgang mit der Artikel-Schnellerfassung. Die hier angegebenen Beispiele stehen in keiner Beziehung zu realexistierenden Unternehmen sowie Produkte.
 ====== 2 Grundlagenkonfiguration ======
-Nach Installation des Moduls können die Grundlagen konfiguriert werden. Das nachfolgende Grundlagenformular erreichen Sie über den Regieeintrag <Artikelschnellerfassung> <Administration> <Mandanteneinstellungen>. In diesem Formular stellen Sie die Grundlagen ein.
+Nach Installation des Moduls können die Grundlagen konfiguriert werden. Das nachfolgende Grundlagenformular erreichen Sie über den Regieeintrag <Mutationsprotokollierung> <Administration> <Grundlagen>. In diesem Formular stellen Sie die Grundlagen ein.
 ----
-===== 2.1 Mandanteneinstellung =====
+===== 2.1 Grundlagen =====
-{{  :handbuch:artikelschnellerfassung_1.png?nolink&800  }}
+{{  :handbuch:mut_grundlagen.png?nolink&1300  }}
+Im oberen Bereich sind alle Tabellen aufgeführt, für die eine bestehende Konfiguration für das Modul Mutationsprotokollierung besteht. Im Detailbereich sind folgende Einstellungen möglich:
 ^Eigenschaft^Wert^Bedeutung|
-|Übernahme Einzelpreis|- ja \\ - nein|Festlegung, ob beim Einfügen einer Artikelpositionen aus der Historie des Kontokorrenten auch der Einzelpreis übernommen werden soll. \\ Bei "Ja" wird der Einzelpreis der zugrundeliegenden historischen Positionen übernommen, bei "Nein" wird der Preis neu initialisiert.|
+|Tabelle|Tabellenname|Name der Tabelle die protokolliert werden soll.|
-|Anzahl Monate als Berechnungsbasis|Anzahl der Monate|Steuerung, wie viele Monate in die Vergangenheit geblickt werden soll, bei der Anzeige der letzten Artikelpositionen dieses Kontokorrenten. Ältere EK- oder VK-Belege werden ignoriert.|
+|Aktiv|- ja \\ - nein|Definiert, ob die Protokollierung für diese Tabelle aktiv ist.|
-|Mengeart für neue Artikelpositionen|- Basis \\ - Verkauf \\ - Standard|Einstellung hier nicht definierbar - nur Anzeige. Pflege findet im Modul "abacus Erweiterungen" statt. \\ Mit dieser Einstellung wird gesteuert in welcher Mengenart eine neue Position eingefügt wird. \\ Basis: Artikel wird mit seiner Basismengeneinheit eingefügt \\ Verkauf: Artikel wird mit seiner Verkaufsmengeneinheit eingefügt \\ Standard: Artikel wird mit Verpackungseinheit eingefügt. Ist diese nicht definiert, wird die Verkaufseinheit genutzt.|
+|Einfügen|- ja \\ - nein|Einfüge-Operationen werden protokolliert - bspw. Anlage eines neuen Fertigungsauftrags \\ Einfüge-Operationen werden nicht protokolliert|
+|Aktualisieren|- ja \\ - nein|Aktualisierungs-Operationen werden protokolliert - bspw. Änderung eines Fertigungsauftrags \\ Aktualisierungs-Operationen werden nicht protokolliert|
+|Löschen|- ja \\ - nein|Lösch-Operationen werden protokolliert - bspw. Löschen eines Fertigungsauftrags \\ Lösch-Operationen werden nicht protokolliert|
-Zusätzlich befindet sich die Möglichkeit die Lizenzanforderungsdatei zu erstellen - Schaltfläche "Lizensierung". Anschließend kann die von abacus edv-lösungen GmbH & Co. KG ausgestellte Lizenz hier eingelesen werden.
+Im Bereich "Spalten" sind folgende Einstellungen möglich:
-----
-===== 2.2 Belegarteneinstellung =====
+|Spalte|Spaltenname|Name der Spalte für die besondere Konfigurationen bestehen.|
+|Zusatz-Schlüsselfeld|- ja \\ - nein|Der Wert der Spalte wird als Primärschlüsselfeld behandelt und ist so in der Bildschirmauskunft im Master-Bereich in der Spalte "Zusatz-Schlüssel" suchbar. Änderungen an dieser Spalte werden als Lösch und Einfügevorgang behandelt, da der Primärschlüssel geändert wird. \\ Behandlung als normales Feld jedoch zusätzlich Aufführung im Master-Bereich in der Spalte "Zusatz-Feld" und ist damit im Master-Bereich suchbar.|
+|IstAusschluss|- ja \\ - nein|Die Spalte wird nicht protokolliert. \\ Spalte wird protokolliert.|
-===== 2.2.1 Verkaufsbelege =====
+Hier nicht aufgeführte Spalten werden protokolliert. Im Standard wird also jede Spalte der Tabelle protokolliert. Achtung: Das kann Auswirkungen haben auf die Performance.
-Diesen Menüpunkt erreichen Sie über den Regiezentrumseintrag <Artikelschnellerfassung> <Administration> <Verkaufsbelege>.
+**Achtung:** Vor größeren Updates sollte Protokollierung deaktiviert werden, da sonst auch alle Änderungen aus Datenbankaktualisierungs-Scripts über den Sage Administrator protokolliert werden und dies die Ausführungszeit der Scripte enorm verlängert.
-{{  :handbuch:artikelschnellerfassung_vkeinstellungen.png?nolink&800  }}
+Durch Speicherung der Datensätze werden die Protokollierungen erzeugt bzw. deaktiviert.
-^Eigenschaft^Wert^Bedeutung|
+**Achtung**: Werden neue Felder in der protokollierten Tabelle angelegt, müssen die Protokollierungen einmal neu erzeugt werden. Hierfür die Protokollierung einmal deaktivieren und wieder aktivieren.
-|Quellbeleg|-ja \\ -nein|Bei "ja" fließen Positionen dieser Belegart ein in die Auflistung der historischen Artikelpositionen und damit in den Vorschlag der Positionen bei der Artikelschnellerfassung.|
-|Zielbeleg|-ja \\ -nein|Bei "ja" wird bei der Erfassung eines Belegs der ausgewählten Belegart nach Eingabe der Kundennummer die Artikelschnellerfassung aufgerufen und angezeigt.|
-===== 2.2.2 Einkaufsbelege =====
+Zusätzlich befindet sich die Möglichkeit die Lizenzanforderungsdatei zu erstellen - Schaltfläche "Lizenzierung". Anschließend kann die von abacus edv-lösungen GmbH & Co. KG ausgestellte Lizenz hier eingelesen werden.
-Diesen Menüpunkt erreichen Sie über den Regiezentrumseintrag <Artikelschnellerfassung> <Administration> <Einkaufsbelege>.
+----
-{{  :handbuch:artikelschnellerfassung_ekeinstellungen.png?nolink&800  }}
-^Eigenschaft^Wert^Bedeutung|
-|Quellbeleg|-ja \\ -nein|Bei "ja" fließen Positionen dieser Belegart ein in die Auflistung der historischen Artikelpositionen und damit in den Vorschlag der Positionen bei der Artikelschnellerfassung.|
-|Zielbeleg|-ja \\ -nein|Bei "ja" wird bei der Erfassung eines Belegs der ausgewählten Belegart nach Eingabe der Lieferantennummer die Artikelschnellerfassung aufgerufen und angezeigt.|
-====== 3 Artikelschnellerfassung ======
-In dem folgenden Abschnitt wird die Artikelschnellerfassung näher betrachtet.
-----
-===== 3.1 Verkaufsbelegerfassung =====
+===== 3.1 Bildschirmauskunft =====
-Die Artikelschnellerfassung öffnet sich bei der initialen Anlage eines Verkaufsbelegs nach Eingabe des Kunden - voraussgesetzt die Belegart ist als Zielbeleg in den Grundlagen des Modusl konfiguriert (siehe Abschnitt 2.2.1).
+Hier ist die Protokollierung einsehbar. Erreichbar ist dies über den Regieeintrag <Mutationsprotokollierung> <Bildschirmauskunft>.
-{{  :handbuch:artikelschnellerfassung_vk.png?nolink&800  }}
+{{  :handbuch:mut_vorfilter.png?nolink&  }}
-Es werde hier die historischen Positionen der Artikel zu diesem Kunden angezeigt. In der Spalte "Eingabe" kann die Menge eingegeben werden, die für diesen Beleg übernommen werden soll.\\
+Zuerst öffnet sich ein Selektionsdialog, über den die Bildschirmauskunft vorfilterbar ist. Hier kann eingeschränkt werden auf ein bestimmtes Änderungsdatum, bestimmte Benutzer und Tabellen.
-Als Menge wird der Durchschnitt aller Belegpositionen genommen, die bei dem Kunden im definierten Zeitraum (siehe Abschnitt 2.1) in den ausgewählten Quellbelegarten (siehe Abschnitt 2.2.1) enthalten sind.
-\\
+Es öffnet sich nun die Bildschirmauskunft: {{  :handbuch:mut_auskunft.png?nolink&  }}
-Nach Klick auf die Schaltfläche "Anwenden" werden die Positionen mit einer Menge in der Spalte "Eingabe" als Position in den Beleg eingefügt.
-Im oberen Bereich sind zusätzlich 4 Felder vorhanden:
+Im oberen Bereich sehen sie alle Änderungen, die dem Vorfilter entsprechen.
-  * Liefertermin: Hier kann der Liefertermin angepasst werden, auf diesen Liefertermin werde die zu übernehmenden Positionen gesetzt beim Einfügen der Positionen in den Beleg.
+^Spalte^Beschreibung|
-  * Sortierung: Hier kann die Sortierung der angezeigten Artikel in der unteren Liste geändert werden.
+|Änderungs-Nr.|eindeutige ID der Änderung|
-  * Filter Artikelnummer: Hier kann ein Filter eingegeben werden, die untere Liste wird daraufhin auf diesen Wert eingeschränkt.
+|Aktion|Anzeige, ob es sich um eine Einfüge-, Aktualisierungs-, oder Löschoperation handelt.|
-  * Filter Artikel-Matchcode: Hier kann ein Filter eingegeben werden, die untere Liste wird daraufhin auf diesen Wert eingeschränkt.
+|Benutzer|Benutzer, der die Änderung durchgeführt hat.|
+|Datum|Zeitpunkt der Änderung|
+|Tabelle|Tabellenname in der die Änderung statt fand.|
+|Schlüssel|Primärschlüssel des Datensatzes inkl. Werte und Spaltennamen.|
+|Zusatzschlüssel|Definierte Zusatzschlüssel - siehe Punkt 2.1|
-===== 3.2 Einkaufsbelegerfassung =====
+Diese Felder können mit den gewohnten Sage Listenfunktionen gefiltert, sortiert etc. werden.
-Die Artikelschnellerfassung öffnet sich bei der initialen Anlage eines Einkaufsbelegs nach Eingabe des Lieferanten - voraussgesetzt die Belegart ist als Zielbeleg in den Grundlagen des Modusl konfiguriert (siehe Abschnitt 2.2.2).
+Im unteren Bereich sehen sie alle Details zu einer oben markierten Änderung:
-{{  :handbuch:artikelschnellerfassung_ek.png?nolink&800  }}
+**Register Details:**
-Es werde hier die historischen Positionen der Artikel zu diesem Lieferanten angezeigt. In der Spalte "Eingabe" kann die Menge eingegeben werden, die für diesen Beleg übernommen werden soll. \\ Als Menge wird der Durchschnitt aller Belegpositionen genommen, die bei dem Lieferanten im definierten Zeitraum (siehe Abschnitt 2.1) in den ausgewählten Quellbelegarten (siehe Abschnitt 2.2.1) enthalten sind.
+^Spalte^Wert|
+|Änderungs-Nr.|eindeutige ID der Änderung|
+|Spalte|Spalte in der ein Wert geändert wurde|
+|alter Wert|vorheriger Wert des Feldes - bei Einfüge-Operationen wird hier nichts eingefügt. Bei Lösch-Operationen sieht man den Wert aller Spalten des gelöschten Datensatzes|
+|neuer Wert|neuer Wert des Feldes - bei Lösch-Operationen wird hier nichts angezeigt|
- \\ Nach Klick auf die Schaltfläche "Anwenden" werden die Positionen mit einer Menge in der Spalte "Eingabe" als Position in den Beleg eingefügt.
+**Register Schlüsselfelder:**
-Im oberen Bereich sind zusätzlich 4 Felder vorhanden:
+Hier werden nochmal alle Primärschlüsselfelder aufgelistet des geänderten Datensatzes.
-  * Liefertermin: Hier kann der Liefertermin angepasst werden, auf diesen Liefertermin werde die zu übernehmenden Positionen gesetzt beim Einfügen der Positionen in den Beleg.
+^Spalte^Wert|
-  * Sortierung: Hier kann die Sortierung der angezeigten Artikel in der unteren Liste geändert werden.
+|Änderungs-Nr.|eindeutige ID der Änderung|
-  * Filter Artikelnummer: Hier kann ein Filter eingegeben werden, die untere Liste wird daraufhin auf diesen Wert eingeschränkt.
+|Datentyp|Datentyp der Spalte als Integer|
-  * Filter Artikel-Matchcode: Hier kann ein Filter eingegeben werden, die untere Liste wird daraufhin auf diesen Wert eingeschränkt.
+|Länge des Datentyps|Länge der Spalte laut Datenbank-Definition|
+|Name des Datentyps|Datentyp der Spalte als Text|
+|Spalte|Spaltenname|
+|Wert|Wert des Primärschlüssels für den geänderten Datensatz|