COBISOFT Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== COBI.wms Konfigurator ======

Der COBI.wms-Konfigurator ist ein zentrales Administrationswerkzeug. \\
Er dient dazu, alle für die Nutzung von COBI.wms erforderlichen Tabellen, Felder, Prozeduren und Views komfortabel zu erstellen und zu verwalten. \\

Der Konfigurator unterstützt sowohl SQL- als auch HANA-Datenbanken, sofern eine Management-Datenbank für COBI.wms zum Einsatz kommt.

===== Voraussetzungen =====

Die Installation des Konfigurators erfolgt unkompliziert durch das Ausführen der Datei ''{{ :de:playground:mysetup.zip |mysetup.exe}}''. \\
Während des Setups kann optional ein Desktop-Icon angelegt werden.

Für die Nutzung mit einer SQL-Datenbank ist die Installation hiermit bereits abgeschlossen. \\
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|}}

Sind diese Schritte abgeschlossen, ist der Konfigurator vollständig für HANA-Datenbanken einsatzbereit.

===== Einstellungen =====
{{:de:playground:ui.png?1100|}}

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).
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.
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.

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: 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 =====
{{:de:playground:ui_2.png?900|}}
{{:de:playground:ui_3.png?900|}}

Ü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 =====
{{:de:playground:ui_4.png?900|}}
{{:de:playground:ui_5.png?900|}}

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.
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 lassen sich hier Lizenzen zuweisen und die individuellen Modul-Berechtigungen detailliert steuern.

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 =====
{{:de:playground:ui_6.png?900|}}

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 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 =====
{{:de:playground:ui_7.png?900|}}

Über die Berechtigungssteuerung lässt sich genau definieren, welche COBI.wms-Module für bestimmte Benutzer oder Geräte sicht- oder unsichtbar sind:

  * 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 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.)

{{:de:playground:ui_10.png?1100|}}

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_11.png?1100|}}

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.

====== COBI.wms Configurator ======

The COBI.wms Configurator is a central administration tool. \\
It is used to comfortably create and manage all tables, fields, procedures, and views required to use COBI.wms. \\

The configurator supports both SQL and HANA databases, provided a management database is used for COBI.wms.

===== Prerequisites =====

The configurator can be easily installed by running the {{ :playground:mysetup.zip |mysetup.exe}} file. \\
During the setup, a desktop icon can optionally be created.

For use with an SQL database, the installation is now complete. \\
However, if working with a HANA database, two additional prerequisites must be met on the executing device:

  * An installed SAP HANA Client (download via SAP).
  * After installing the client, it must be ensured that HDBODBC is configured as a System DSN in the ODBC data sources. \\
{{:de:playground:odbc.png?600|}}
{{:de:playground:odbc_2.png?600|}}

Once these steps are completed, the configurator is fully ready for use with HANA databases.

===== Settings =====
{{:de:playground:ui.png?1100|}}

To use the configurator, the connection data for the database where the management database is running (or will run in the future) must first be entered.
Additionally, you select whether it is an SQL or HANA database. The standard ports for the respective database type (SQL: 1433, HANA: 30015) are pre-filled automatically but can be adjusted manually if required.
Important: An active VPN connection may be required to access certain databases. Please check this in advance and activate the appropriate VPN profile.

Clicking on "Save and Connect" initiates the connection. If successful, the indicator in the top right corner of the application turns green. If it remains gray, either connection data is missing, or the server cannot be reached.

Note: Almost all functions of the COBI.wms Configurator require an active database connection and only work when the indicator is green! The only exception is the initial creation of the COBIWMS database – here, the indicator remains gray until the creation has been successfully completed.

===== Company Management =====
{{:de:playground:ui_2.png?900|}}
{{:de:playground:ui_3.png?900|}}

In the "Company Management" tab, you manage the COBI.wms companies (tenants) within the management database. Here you can create new companies as well as edit or delete existing ones. The integrated list view provides a clear overview of all existing companies. With a simple click on the respective entry, you can select the desired company directly for editing.

===== User Management / Device Management =====
{{:de:playground:ui_4.png?900|}}
{{:de:playground:ui_5.png?900|}}

In the "User Management" and "Device Management" tabs, the respective users and devices for COBI.wms are centrally managed in the management database.
Similar to company management, entries can be created, edited, or deleted here. A clear list allows for quick selection of the desired user or device with a single click.

Additionally, licenses can be assigned here, and individual module permissions can be controlled in detail.

Note: Devices are usually recorded automatically in COBI.wms and stored with a unique ID in the ''Devices'' table. Manually creating devices is therefore rarely necessary, but has been integrated as a fallback solution. Please note that the exact UUID of the device is strictly required for correct manual creation!

===== Licenses =====
{{:de:playground:ui_6.png?900|}}

The "Assign License" tab is used to link licenses to specific users or devices. To do this, first enter the license key and then select the corresponding recipient (user/device). If there is a large number of entries, the search field greatly facilitates pre-filtering the dropdown list.

Note: A license can only exist once in the database table. If an already recorded license is assigned to another user or device, the existing table entry is overwritten. This mechanism effectively prevents the accidental dual use of licenses via the configurator.

===== Permissions =====
{{:de:playground:ui_7.png?900|}}

The permission control allows you to define exactly which COBI.wms modules are visible or hidden for specific users or devices:

  * Status 1: The module is visible.
  * Status 0: The module is hidden.

A click on the respective row changes the status. Using the trash can icon, you can completely remove existing permissions. To add a new permission, click on the red "+ New" button. A dialog window will then open to enter the corresponding data.

{{:de:playground:ui_8.png?400|}}

==== Note: ====

The internal system abbreviations for the COBI.wms modules are as follows:

^  Abbr  ^ Module                   ^
| IGN | Plus Booking                |
| IGE | Minus Booking               |
| WTR | Inventory Transfer          |
| PDN | Purchase Receipt            |
| PKL | Picking                     |
| RDR | Sales Order                 |
| DLN | Sales Delivery              |
| RPD | Purchase Return             |
| RDN | Sales Return                |
| IPE | Issue for Production        |
| IPN | Receipt from Production     |
| PRQ | Purchase Request            |
| POR | Purchase Order              |
| ITM | Inventory List              |
| INC | Inventory Counting          |
| WTQ | Inventory Transfer Request  |
| PRINT | Label Printing            |
| ITEM | Item Info                  |

===== UDTs and UDFs =====
{{:de:playground:ui_9.png?900|}}

The configurator also assists you in correctly creating user-defined tables (UDTs) and fields (UDFs) required for certain additional options in COBI.wms. Here you can view detailed information about the respective options, generate the required structures via the "Create UDTs/UDFs" tab, and specifically delete (drop) database views.
The official COBI.wms documentation forms the basis for the descriptions and the available options. (Note: If further options are added in new versions, the configurator must be updated accordingly in this regard.)

{{:de:playground:ui_10.png?1100|}}

To create UDTs and UDFs, first select the desired target database. The configurator will then automatically check for which options the necessary structures already exist. All options where at least one UDF or UDT is still missing will appear in the "Required Options" list. Select the desired entries and easily start the creation process using the button at the bottom.

{{:de:playground:ui_11.png?1100|}}

Deleting (dropping) views also requires the prior selection of the affected database. Clicking on "Drop Views" prompts the configurator to automatically search for the highest ''cwXX_Version'' and remove it. The result: The next time you log into COBI.wms, the views will be freshly and flawlessly rebuilt.

Note: This process is iterative. If you click on "Drop Views" again after a successful deletion, the system searches for the next highest version. If, for example, the ''cw43'' was deleted first, the second click would remove the ''cw42'', provided the views have not been regenerated by a new login in the meantime.