OpenXE/userdata/wiki/XentralHandbuch/default/xcs
2021-05-21 08:49:41 +02:00

1 line
6.9 KiB
Plaintext

<p><strong><span style="font-size:28px;">Xentral Customizing Suite XCS</span></strong></p><p>Zentrale App f&uuml;r viele Anpassungen an Xentral ist die Xentral Customizing Suite. Hier k&ouml;nnen bestehende Datenstrukturen erweitert und neue, eigene Datenstrukturen angelegt werden. Zus&auml;tzlich bietet die XCS Optionen f&uuml;r die Verwaltung von Anpassungen. Dieser Bereich wird in naher Zukunft stark ausgebaut werden.</p><p>&nbsp;</p><h1>Beschreibung XCS</h1><p>Neue Tabellen k&ouml;nnen z.B. schnell als Daten-Container f&uuml;r Anpassungen verwendet werden, z.B. wenn eine dynamische Liste von PLZ oder Versandarten erstellt werden soll, die dann im Prozess eine Entscheidung f&uuml;r eine Versandart pro PLZ erm&ouml;glicht. Diese w&auml;re dann - bei geeigneter Programmierung - auch durch den Benutzer direkt erweiterbar ohne die Programmierung neu anstossen zu m&uuml;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&ouml;nnen mit Hilfe eigener Spalten erweitert werden. Diese werden zun&auml;chst nur in der Datenbank erweitert, eine Auswirkung auf die Benutzeroberfl&auml;che ergibt sich nicht automatisch. Spalten k&ouml;nnen in eigene oder bereits vorhandene Datenbanktabellen eingef&uuml;gt werden.</p><p>Beispiel: Erweiterung der Tabelle auftrag um zus&auml;tzliche Spalte &#39;Ablehnungsgrund&#39;</p><p>&nbsp;</p><h2>Datenbanktabellen definieren</h2><p>Die &Uuml;bersicht der Tabellen bildet den Einstiegspunkt zur Bearbeitung der Definition und der Daten in den Tabellen.<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=1" /><br /><br />Folgende Funktionen sind verf&uuml;gbar:</p><ul><li><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=2" /> zum Bearbeiten der Tabellendefinition</li><li><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=3" /> zum Bearbeiten der Inhalte der Tabelle (siehe unten)</li><li><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=4" /> zum L&ouml;schen der Tabelle und aller gespeicherten Daten</li></ul><p>Datenbanktabellen k&ouml;nnen durch Klick auf + NEU angelegt werden.</p><p>Es sind lediglich die Angaben f&uuml;r den Tabellennamen und eine optionale Beschreibung einzugeben. Eine &Auml;nderung des Tabellennamens f&uuml;hrt auch im Nachhinein zu einer &Auml;nderung des Namens in der Datenbank.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=5" /></p><p>&nbsp;</p><h2>Spalten anlegen</h2><p>Unter Spalten k&ouml;nnen alle verf&uuml;gbaren Spalten aller Tabellen bearbeitet werden. Bitte beachten Sie dass beim Ver&auml;ndern von Spaltendefinitionen die Inhalte der Spalten in der Datenbank gel&ouml;scht werden k&ouml;nnen.</p><p>Best Practise: Finales Definieren &amp; Anlegen von Tabellen und Spalten vor der ersten Verwendung oder Bef&uuml;llung mit Daten.<br /><br />Neue Spalten k&ouml;nnen durch Klick auf + Neuer Eintrag angelegt werden.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=6" /><br />&nbsp;</p><p>Beispiel f&uuml;r das Anlegen einer Ganzzahl-Spalte.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=7" /><br />&nbsp;</p><p>Beispiel f&uuml;r das Anlegen einer Text-Spalte.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=8" /></p><p>&nbsp;</p><h2>Daten bearbeiten</h2><p>Wird eine Tabelle &uuml;ber <img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=3" /> aufgerufen k&ouml;nnen die Inhalte der Tabelle bearbeitet werden. Neue Inhalte (Zeilen) k&ouml;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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=9" /><br /><br />Die hinzugef&uuml;gten Zeilen werden wie gewohnt angezeigt und k&ouml;nnen &uuml;ber <img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=2" /> und <img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=4" /> editiert bzw. gel&ouml;scht werden.<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=10" /></p><p>&nbsp;</p><h2>Systemtabellen erweitern</h2><p>Auch zu vorhandenen Systemtabellen k&ouml;nnen neue Spalten hinzugef&uuml;gt werden. Diese Methode sollte sparsam verwendet werden, auch weil die maximale Beschr&auml;nkung der Zeilengr&ouml;&szlig;e in MySQL / MariaDB vor allem bei Verwendung der InnoDB (siehe MySQL-Dokumentation f&uuml;r Row Size Limits). Die Erweiterung von Systemtabellen k&ouml;nnte zu Seiteneffekten innerhalb anderer Bereiche der Software f&uuml;hren.</p><p>&nbsp;</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&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=11" /><br /><br />Die folgenden Systemtabellen k&ouml;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>&nbsp;<p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;fileid=12" /></p><p>&nbsp;</p><h1>Datenbank: Browsen und Strukturen einsehen</h1><p>Im Reiter SQL-Viewer k&ouml;nnen alle Datenbanktabellen des eigenen Systems live aufgerufen werden. Dort ist aus Performancegr&uuml;nden in einigen F&auml;llen eine verkleinerte Ansicht der Tabellen verf&uuml;gbar (nicht alle Zeilen oder Spalten).<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=xcs&amp;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>&nbsp;</p><p>&nbsp;</p><p><br /><br /><br /><br /><br />&nbsp;</p><p>&nbsp;</p>