Differences

This shows you the differences between two versions of the page.

--- de:playground:cobi.wms_konfigurator [2026/07/08 12:20] – thuth
+++ de:playground:cobi.wms_konfigurator [2026/07/08 12:49] (current) – thuth
@@ Line 1: / Line 1: @@
 ====== COBI.wms Konfigurator ======
-Der COBI.wms-Konfigurator ist als Hilfswerkzeug gedacht, um die für die Nutzung von COBI.wms benötigten Tabellen,
+Der COBI.wms-Konfigurator ist ein zentrales Administrationswerkzeug. \\
-Felder, Prozeduren und Views zu erstellen und zu verwalten.
+Er dient dazu, alle für die Nutzung von COBI.wms erforderlichen Tabellen, Felder, Prozeduren und Views komfortabel zu erstellen und zu verwalten. \\
-Er kann sowohl in SQL- als auch in HANA-Datenbanken verwendet werden, sofern eine Management-Datenbank für COBI.wms benutzt werden soll.
-==== Voraussetzungen ====
+Der Konfigurator unterstützt sowohl SQL- als auch HANA-Datenbanken, sofern eine Management-Datenbank für COBI.wms zum Einsatz kommt.
-Um den Konfigurator zu installieren muss lediglich die mysetup.exe ausgeführt werden.
+===== Voraussetzungen =====
-Dabei kann auch ein Icon auf dem Desktop für den Konfigurator erstellt werden.
-Soll mit einer SQL-Datenbank gearbeitet werden, ist die Installation damit abgeschlossen.
+Die Installation des Konfigurators erfolgt unkompliziert durch das Ausführen der Datei ''{{ :de:playground:mysetup.zip |mysetup.exe}}''. \\
-Wird aber mit einer HANA-Datenbank gearbeitet, dann müssen noch zwei weitere Sachen auf dem Gerät, auf dem der Konfigurator ausgeführt, gewährleistet sein.
+Während des Setups kann optional ein Desktop-Icon angelegt werden.
-. Man benötigt einen SAP HANA Client (download via SAP)
+Für die Nutzung mit einer SQL-Datenbank ist die Installation hiermit bereits abgeschlossen. \\
-. Nach Installation des SAP HANA Client muss noch sichergestellt werden, dass HDBODBC als System-DSN in den ODBC-Datenquellen hinterlegt ist. \\
+Wird jedoch mit einer HANA-Datenbank gearbeitet, müssen auf dem ausführenden Gerät zwei weitere Voraussetzungen erfüllt sein:
+  * Ein installierter SAP HANA Client (Download über SAP).
+  * Nach der Installation des Clients muss sichergestellt sein, dass HDBODBC als System-DSN in den ODBC-Datenquellen hinterlegt ist. \\
 {{:de:playground:odbc.png?600|}}
 {{:de:playground:odbc_2.png?600|}}
-Ist dies erfolgt, so kann danach der Konfigurator auch für HANA-Datenbanken verwendet werden.
+Sind diese Schritte abgeschlossen, ist der Konfigurator vollständig für HANA-Datenbanken einsatzbereit.
-==== Settings ====
+===== Einstellungen =====
-{{:de:playground:ui.png?600|}}
+{{:de:playground:ui.png?1100|}}
-Zur Benutzung des Konfigurators müssen zunächst die benötigten Daten der Datenbank eingetragen werden, auf denen die Management-Datenbank läuft bzw. laufen soll.
+Um den Konfigurator nutzen zu können, müssen zunächst die Verbindungsdaten der Datenbank hinterlegt werden, auf der die Management-Datenbank läuft (oder zukünftig laufen soll).
-Auch wird angegeben, ob es sich um eine SQL- oder um eine Hana-Datenbank handelt.
+Zudem wählen Sie aus, ob es sich um eine SQL- oder HANA-Datenbank handelt. Die Standardports für den jeweiligen Datenbank-Typ (SQL: 1433, HANA: 30015) werden automatisch vorbelegt, können bei Bedarf jedoch manuell angepasst werden.
-Die Standardports werden für den jeweiligen Datenbank-Typ (SQL: 1433, HANA: 30015) eingetragen, können aber manuell geändert werden. Eventuell ist eine VPN-Verbindung notwendig, um sich mit manchen Datenbanken zu verbinden. Bitte vorher überprüfen und das passende VPN-Profil aktiviert haben.
+Wichtig: Für den Zugriff auf bestimmte Datenbanken ist möglicherweise eine aktive VPN-Verbindung erforderlich. Bitte prüfen Sie dies vorab und aktivieren Sie das entsprechende VPN-Profil.
-Mit dem Klick auf „Speichern und Verbinden“ wird die erste Verbindung hergestellt. Ist die Verbindung erfolgreich hergestellt wird der Punkt in der oberen rechten Ecke der Anwendung grün. Ist er grau, so sind entweder keine Daten in den Settings hinterlegt oder es konnte keine Verbindung hergestellt werden.
+Ein Klick auf „Speichern und Verbinden“ initiiert den Verbindungsaufbau. Ist dieser erfolgreich, färbt sich der Indikator in der oberen rechten Ecke der Anwendung grün. Bleibt er grau, fehlen entweder Verbindungsdaten oder der Server ist nicht erreichbar.
-**Hinweis:** Alle Funktionen des COBI.wms-Konfigurators erfordern natürlich eine bestehende Verbindung zur Datenbank und funktionieren daher nur, wenn der Punkt grün ist! Einzige Ausnahme ist das Neu-Erstellen der COBIWMS-Datenbank, dort bleibt der Punkt grau, bis diese angelegt wurde.
+Hinweis: Nahezu alle Funktionen des COBI.wms-Konfigurators setzen eine aktive Datenbankverbindung voraus und funktionieren nur bei einem grünen Indikator! Die einzige Ausnahme bildet das erstmalige Erstellen der COBIWMS-Datenbank – hier bleibt der Indikator grau, bis die Anlage erfolgreich abgeschlossen wurde.
-==== Company-Management ====
+===== Company-Management =====
-{{:de:playground:ui_2.png?600|}}
+{{:de:playground:ui_2.png?900|}}
-{{:de:playground:ui_3.png?600|}}
+{{:de:playground:ui_3.png?900|}}
-Mit Hilfe des Company-Management-Reiters können die Companies für COBI.wms in der Management-Datenbank bearbeitet werden. Es können sowohl neue Companies erstellt, bereits bestehende bearbeitet als auch bestehende Companies gelöscht werden. Eine Liste gibt dabei eine Übersicht über die bereits existierenden Companies, sodass via Click ganz einfach die Company ausgewählt werden kann, an der man etwas verändern möchte.
+Über den Reiter „Company-Management“ verwalten Sie die COBI.wms-Mandanten (Companies) innerhalb der Management-Datenbank. Hier lassen sich neue Mandanten anlegen sowie bestehende bearbeiten oder löschen. Die integrierte Listenansicht bietet eine übersichtliche Darstellung aller vorhandenen Companies. Durch einen einfachen Klick auf den entsprechenden Eintrag können Sie die gewünschte Company direkt zur Bearbeitung auswählen.
-==== User-Management/ Geräte-Management ====
+===== User-Management/ Geräte-Management =====
-{{:de:playground:ui_4.png?600|}}
+{{:de:playground:ui_4.png?900|}}
-{{:de:playground:ui_5.png?600|}}
+{{:de:playground:ui_5.png?900|}}
-Mit Hilfe des User-Management-/ und des Geräte-Management-Reiters können die User/Geräte für COBI.wms in der Management-Datenbank bearbeitet werden.
+In den Reitern „User-Management“ und „Geräte-Management“ werden die jeweiligen Benutzer und Endgeräte für COBI.wms zentral in der Management-Datenbank verwaltet.
-Wie auch schon beim Company-Management können sowohl neue User/Geräte erstellt, bereits bestehende bearbeitet als auch bestehende User/Geräte gelöscht werden. Eine Liste gibt dabei eine Übersicht über die bereits existierenden User/Geräte, sodass via Click ganz einfach der User/das Gerät ausgewählt werden kann, an dem man etwas verändern möchte.
+Analog zum Company-Management lassen sich hier Einträge neu anlegen, bearbeiten oder löschen. Eine übersichtliche Liste ermöglicht die schnelle Auswahl des gewünschten Benutzers oder Geräts per Klick.
-Zusätzlich können auch den Usern/Geräten Lizenzen zugeordnet werden, sowie entsprechenden Berechtigungen für die Module verwaltet werden.
+Zusätzlich lassen sich hier Lizenzen zuweisen und die individuellen Modul-Berechtigungen detailliert steuern.
-**Hinweis:** Geräte werden in COBI.wms in der Regel automatisch erstellt und mit einer ID in der Tabelle Devices gespeichert. Das manuelle Anlegen von Geräten wird daher vermutlich eher weniger verwendet werden müssen. Dennoch wurde sich dafür entschieden, diese Möglichkeit zur Verfügung zu stellen. Für ein korrektes Anlegen ist die richtige UUID des Gerätes unbedingt erforderlich!
+Hinweis: Endgeräte werden in COBI.wms in der Regel automatisch erfasst und mit einer eindeutigen ID in der Tabelle ''Devices'' gespeichert. Ein manuelles Anlegen von Geräten ist daher nur selten erforderlich, wurde aber als Fallback-Lösung integriert. Beachten Sie, dass für ein korrektes manuelles Anlegen zwingend die exakte UUID des Gerätes benötigt wird!
-==== Lizenzen ====
+===== Lizenzen =====
-{{:de:playground:ui_6.png?600|}}
+{{:de:playground:ui_6.png?900|}}
-Unter dem Reiter „Lizenz zuweisen“ können einem User oder einem Gerät Lizenzen zugewiesen werden.  Dazu wird einfach die Lizenz eingetragen, danach kann User/Gerät ausgewählt werden. Mit Hilfe des Suchfeldes kann die DropDown der User/Geräte vorgefiltert werden, sodass die Auswahl leichter wird, vor allem wenn man viele User oder Geräte hat.
+Der Reiter „Lizenz zuweisen“ dient der Verknüpfung von Lizenzen mit spezifischen Benutzern oder Geräten. Tragen Sie hierfür zunächst den Lizenzschlüssel ein und wählen Sie anschließend den entsprechenden Empfänger (User/Gerät) aus. Bei einer großen Anzahl an Einträgen erleichtert das Suchfeld das Vorfiltern der Dropdown-Liste enorm.
-**Hinweis:** Eine Lizenz kann immer nur einmal in der Tabelle existieren, wird dieselbe Lizenz mit einem anderen Gerät/User eingegeben, dann wird die existierende Zeile zu der Lizenz in der Tabelle überschrieben. Dadurch wird die Doppelnutzung von Lizenzen über den COBI.wms-Konfigurator weitestgehend ausgeschlossen.
+Hinweis: Eine Lizenz kann in der Datenbank-Tabelle nur einmalig existieren. Wird eine bereits erfasste Lizenz einem anderen Benutzer oder Gerät zugewiesen, so wird der bestehende Tabelleneintrag überschrieben. Dieser Mechanismus verhindert effektiv die versehentliche Doppelnutzung von Lizenzen über den Konfigurator.
-==== Berechtigungen ====
+===== Berechtigungen =====
-{{:de:playground:ui_7.png?600|}}
+{{:de:playground:ui_7.png?900|}}
-Mit Hilfe der Berechtigungen können für Geräte und User bestimmte Module in COBI.wms ein bzw. ausgeblendet werden. Wobei Status 0 heißt, dass sie ausgeblendet werden, bei Status 1 sind sie dann entsprechend eingeblendet. Über das Mülltonnen-Icon können Berechtigungen gelöscht werden. Via Click auf die Zeile kann der Status verändert werden. Soll eine neue Berechtigung angelegt werden, so muss man auf den roten Button „+ Neu“ klicken und bekommt dann ein Dialogfeld in dem man die Daten zur neuen Berechtigung angeben kann.
+Über die Berechtigungssteuerung lässt sich genau definieren, welche COBI.wms-Module für bestimmte Benutzer oder Geräte sicht- oder unsichtbar sind:
-{{:de:playground:ui_8.png?600|}}
+  * Status 1: Das Modul ist eingeblendet.
+  * Status 0: Das Modul ist ausgeblendet.
+Ein Klick auf die jeweilige Zeile ändert den Status. Über das Mülltonnen-Icon können Sie bestehende Berechtigungen komplett entfernen. Um eine neue Berechtigung hinzuzufügen, klicken Sie auf den roten Button „+ Neu“. Daraufhin öffnet sich ein Dialogfenster zur Eingabe der entsprechenden Daten.
+{{:de:playground:ui_8.png?400|}}
 ==== Hinweis: ====
-Die Abkürzungen für die Module sind:
+Die systeminternen Abkürzungen für die COBI.wms-Module lauten wie folgt:
+^ Abk ^ Modul              ^
+| IGN | Plusbuchung                |
+| IGE | Minusbuchung               |
+| WTR | Umlagerung                 |
+| PDN | Wareneingang               |
+| PKL | Kommissionieren            |
+| RDR | Kundenaufträge             |
+| DLN | Lieferung                  |
+| RPD | Einkaufsretoure            |
+| RDN | Verkaufsretoure            |
+| IPE | Ausgabe für Produktion     |
+| IPN | Eingang aus Produktion     |
+| PRQ | Bestellanfrage             |
+| POR | Bestellung                 |
+| ITM | Bestandsliste              |
+| INC | Inventur                   |
+| WTQ | Umlagerungsanfrage         |
+| PRINT | Etikettendruck           |
+| ITEM | Artikelinfo               |
+===== UDTs und UDFs =====
+{{:de:playground:ui_9.png?900|}}
+Der Konfigurator unterstützt Sie auch bei der korrekten Anlage von benutzerdefinierten Tabellen (UDTs) und Feldern (UDFs), die für bestimmte Zusatzoptionen in COBI.wms benötigt werden. Sie können hier detaillierte Informationen zu den jeweiligen Optionen einsehen, die benötigten Strukturen über den Reiter „UDTs/UDFs erstellen“ generieren und Datenbank-Views gezielt löschen (droppen).
+Die Basis für die Beschreibungen und die anlegbaren Optionen bildet die offizielle COBI.wms-Dokumentation. (Anmerkung: Kommen in neuen Versionen weitere Optionen hinzu, muss der Konfigurator in diesem Punkt entsprechend nachgepflegt werden.)
-Plusbuchung: IGN
+{{:de:playground:ui_10.png?1100|}}
-Minusbuchung: IGE
-Umlagerung: WTR
-Wareneingang: PDN
-Kommissionieren: PKL
-Kundenaufträge: RDR
-Lieferung: DLN
-Einkaufsretoure: RPD
-Verkaufsretoure: RDN
-Ausgabe für Produktion: IPE
-Eingang aus Produktion: IPN
-Bestellanfrage: PRQ
-Bestellung: POR
-Bestandsliste: ITM
-Inventur: INC
-Umlagerungsanfrage: WTQ
-Etikettendruck: PRINT
-Artikelinfo: ITEM
-==== UDTs und UDFs ====
+Um UDTs und UDFs anzulegen, wählen Sie zunächst die gewünschte Zieldatenbank aus. Der Konfigurator prüft daraufhin automatisch, für welche Optionen bereits die notwendigen Strukturen existieren. Alle Optionen, bei denen noch mindestens ein UDF oder eine UDT fehlt, tauchen in der Liste „Benötigte Optionen“ auf. Markieren Sie die gewünschten Einträge und starten Sie den Erstellungsprozess bequem über den Button am unteren Rand.
-{{:de:playground:ui_9.png?600|}}
-Für die richtige Anlage der UDTs und UDFs, die für gewisse Optionen in COBI.wms benötigt werden, kann ebenfalls der COBI.wms Konfigurator verwendet werden. Man kann nun sowohl Informationen zu den Optionen und ihren UDTs/UDFs einsehen, diese danach im Reiter „UDTs/UDFs erstellen“ erstellen und auch die Views in einer Datenbank droppen. Die Grundlage für die Beschreibungen und die anlegbaren Optionen besteht dabei in der COBI.wms-Dokumentation.
-Kommen neue Optionen für eine Version hinzu, muss also künftig auch der Konfigurator in diesem Punkt erweitert werden.
-{{:de:playground:ui_10.png?600|}}
-Beim Erstellen der UDTs und UDFs muss zunächst die Datenbank ausgewählt werden, auf der die Felder und Tabellen gecheckt und erstellt werden sollen. Danach wird geprüft für welche Optionen bereits alles notwendige erstellt wurde. Alle Optionen, bei denen mindestens ein UDF oder eine UDT fehlt können danach unter den „Benötigten Optionen“ ausgewählt werden, je nach dem, was man erstellen möchte. Danach kann man mit dem unteren Button alles entsprechend erstellen lassen.
-{{:de:playground:ui_11.png?600|}}
+{{:de:playground:ui_11.png?1100|}}
-Zum Views droppen muss man ebenfalls zunächst eine Datenbank auswählen, für die die Views gedroppt werden sollen. Klickt man nun auf „Views droppen“ dann sucht der Konfigurator automatisch nach der höchsten cwXX__Version und droppt diese. Dies führt dann dazu, dass man danach, wenn man sich in COBI.wms anmeldet, die Views neu aufgebaut bekommt.
-**Hinweis:** Hat man einmal eine View gedroppt und die Erfolgsmeldung bekommen und würde danach nochmal auf „Views droppen“ klicken, würde nach der nächsten höchsten cwXX_Version gesucht werden. So würde, nachdem man als erstes die cw43 gedroppt hat, danach die cw42 gedroppt werden, wenn dazwischen nicht wieder Views aufgebaut werden.
+Das Löschen (Droppen) von Views erfordert ebenfalls die vorherige Auswahl der betroffenen Datenbank. Ein Klick auf „Views droppen“ veranlasst den Konfigurator, automatisch nach der höchsten ''cwXX_Version'' zu suchen und diese zu entfernen. Das Resultat: Bei der nächsten Anmeldung in COBI.wms werden die Views frisch und fehlerfrei neu aufgebaut.
+Hinweis: Dieser Prozess ist iterativ. Wenn Sie nach einer erfolgreichen Löschung erneut auf „Views droppen“ klicken, sucht das System nach der nächsthöheren Version. Wurde beispielsweise zuerst die ''cw43'' gelöscht, würde beim zweiten Klick die ''cw42'' entfernt werden, sofern die Views in der Zwischenzeit nicht durch einen erneuten Login neu generiert wurden.