mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-26 06:30:29 +01:00
1 line
6.9 KiB
Plaintext
1 line
6.9 KiB
Plaintext
<p><strong><span style="font-size:28px;">Xentral Customizing Suite XCS</span></strong></p><p>Zentrale App für viele Anpassungen an Xentral ist die Xentral Customizing Suite. Hier können bestehende Datenstrukturen erweitert und neue, eigene Datenstrukturen angelegt werden. Zusätzlich bietet die XCS Optionen für die Verwaltung von Anpassungen. Dieser Bereich wird in naher Zukunft stark ausgebaut werden.</p><p> </p><h1>Beschreibung XCS</h1><p>Neue Tabellen können z.B. schnell als Daten-Container für Anpassungen verwendet werden, z.B. wenn eine dynamische Liste von PLZ oder Versandarten erstellt werden soll, die dann im Prozess eine Entscheidung für eine Versandart pro PLZ ermöglicht. Diese wäre dann - bei geeigneter Programmierung - auch durch den Benutzer direkt erweiterbar ohne die Programmierung neu anstossen zu müssen. Es lassen sich beliebig viele Tabellen anlegen, die Speicherung solcher Listen kann also auch in mehreren Tabellen geschehen. Die Tabellen sind mit dem Prefix xcs_ einfach im Code ansprechbar.</p><p>Beispiel:</p><ul><li>Tabellenname in XCS: custom_table</li><li>Tabellenname in Datenbank: xcs_custom_table</li></ul><p>Vorhandene System-Tabellen können mit Hilfe eigener Spalten erweitert werden. Diese werden zunächst nur in der Datenbank erweitert, eine Auswirkung auf die Benutzeroberfläche ergibt sich nicht automatisch. Spalten können in eigene oder bereits vorhandene Datenbanktabellen eingefügt werden.</p><p>Beispiel: Erweiterung der Tabelle auftrag um zusätzliche Spalte 'Ablehnungsgrund'</p><p> </p><h2>Datenbanktabellen definieren</h2><p>Die Übersicht der Tabellen bildet den Einstiegspunkt zur Bearbeitung der Definition und der Daten in den Tabellen.<br /> </p><p><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=1" /><br /><br />Folgende Funktionen sind verfügbar:</p><ul><li><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=2" /> zum Bearbeiten der Tabellendefinition</li><li><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=3" /> zum Bearbeiten der Inhalte der Tabelle (siehe unten)</li><li><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=4" /> zum Löschen der Tabelle und aller gespeicherten Daten</li></ul><p>Datenbanktabellen können durch Klick auf + NEU angelegt werden.</p><p>Es sind lediglich die Angaben für den Tabellennamen und eine optionale Beschreibung einzugeben. Eine Änderung des Tabellennamens führt auch im Nachhinein zu einer Änderung des Namens in der Datenbank.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=5" /></p><p> </p><h2>Spalten anlegen</h2><p>Unter Spalten können alle verfügbaren Spalten aller Tabellen bearbeitet werden. Bitte beachten Sie dass beim Verändern von Spaltendefinitionen die Inhalte der Spalten in der Datenbank gelöscht werden können.</p><p>Best Practise: Finales Definieren & Anlegen von Tabellen und Spalten vor der ersten Verwendung oder Befüllung mit Daten.<br /><br />Neue Spalten können durch Klick auf + Neuer Eintrag angelegt werden.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=6" /><br /> </p><p>Beispiel für das Anlegen einer Ganzzahl-Spalte.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=7" /><br /> </p><p>Beispiel für das Anlegen einer Text-Spalte.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=8" /></p><p> </p><h2>Daten bearbeiten</h2><p>Wird eine Tabelle über <img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=3" /> aufgerufen können die Inhalte der Tabelle bearbeitet werden. Neue Inhalte (Zeilen) können durch Klick auf + NEU angelegt werden.</p><p>Der angezeigte Dialog verwendet die hinterlegten technischen Spaltennamen und ist daher zur Bearbeitung durch nicht eingewiesene Endbenutzer nur bedingt geeignet.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=9" /><br /><br />Die hinzugefügten Zeilen werden wie gewohnt angezeigt und können über <img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=2" /> und <img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=4" /> editiert bzw. gelöscht werden.<br /> </p><p><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=10" /></p><p> </p><h2>Systemtabellen erweitern</h2><p>Auch zu vorhandenen Systemtabellen können neue Spalten hinzugefügt werden. Diese Methode sollte sparsam verwendet werden, auch weil die maximale Beschränkung der Zeilengröße in MySQL / MariaDB vor allem bei Verwendung der InnoDB (siehe MySQL-Dokumentation für Row Size Limits). Die Erweiterung von Systemtabellen könnte zu Seiteneffekten innerhalb anderer Bereiche der Software führen.</p><p> </p><p>Best Practise: Erstellen einer neuen Tabelle und Erweiterung der Systemtabelle lediglich um eine Referenz auf die neue Tabelle.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=11" /><br /><br />Die folgenden Systemtabellen können erweitert werden:</p><ul><li>adresse</li><li>artikel</li><li>angebot und angebot_position</li><li>auftrag und auftrag_position</li><li>rechnung und rechnung_position</li><li>gutschrift und gutschrift_position</li><li>lieferschein und lieferschein_position</li><li>bestellung und bestellung_position</li><li>produktion und produktion_position</li></ul> <p><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=12" /></p><p> </p><h1>Datenbank: Browsen und Strukturen einsehen</h1><p>Im Reiter SQL-Viewer können alle Datenbanktabellen des eigenen Systems live aufgerufen werden. Dort ist aus Performancegründen in einigen Fällen eine verkleinerte Ansicht der Tabellen verfügbar (nicht alle Zeilen oder Spalten).<br /> </p><p><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=xcs&fileid=13" /><br /><br />Weitere Informationen zum Umgang mit der Datenbank (u.a. XAMPP zum lokalen Test) finden Sie auch unter Report Scripts.</p><p> </p><p> </p><p><br /><br /><br /><br /><br /> </p><p> </p> |