Eigene Benutzerfelder definieren
1. Die Anwendung Garbit SHIP Connector bietet die Möglichkeit eigene Benutzerfelder zu definieren, welche später im Empfänger-Mapping, Regeln und Plugins hinterlegt werden können.
Benutzerdefinierte Felder werden direkt als SQL-Statements erzeugt und sollen nur von den Personen umgesetzt werden, die der SQL-Sprache mächtig sind. Fehlerhafte SQL-Statements werden nicht ausgewertet und solche Benutzerfelder bekommen keinen Wert.
2. Es öffnet sich das Fenster, über welches alle Einstellungen für Garbit SHIP Connector vorgenommen werden können.
Prinzipiell können in GSHIP Einstellungen Lokal, also nur für den aktuellen Benutzer oder Global, für alle Benutzer des Mandanten, festgelegt werden. In diesem Fall können eigene benutzerdefinierte Felder nur Global erzeugt werden.
3. Auf der linken Seite befinden sich die Menüpunkte aller vorhandener Einstellungen. Bitte wählen Sie hier das Modul Benutzerfelder aus.
4. Es existieren hier verschiedene Möglichkeiten. Sie können Neue Benutzerfelder angelegen, bestehende Benutzerfelder bearbeitet, löschen oder umbenennen.
In diesem Fall soll ein neues Benutzerfeld angelegt werden.
5. Es öffnet sich ein Fenster, über welches das Benutzerfeld neu angelegt werden kann. Das neue Feld benötigt zuerst einen Feldnamen. Das Benutzerfeld kann ebenfalls aktiviert bzw. deaktiviert werden.
6. Das Ergebnis des Benutzerfeldes wird über eine SQL-Abfrage auf eine für die Abfrage erforderliche Tabelle geliefert. Im Eingabefeld SQL-Definition kann per SQL- Syntax diese abgebildet werden.
Mit der Schaltfläche "Plus" können Platzhalter in das SQL-Statement eingebaut werden, die dann zur Laufzeit mit richtigen Daten ersetzt werden.
Bitte beachten Sie die richtigen Datentypen Hinter der Platzhalter. Die Platzhalter werden nur mit dem jeweiligen Inhalt ausgetauscht, z. B. ohne SQL-Textqualifizierer (') beim Text. Diese müssen Sie im SQL-Statement selbst setzen.
7. In diesem Fall heißt die Tabelle KHKVKBelege . Die Abfrage filtert die Tabelle über die Parameter Mandant und BelID (Beleg-ID). Die Abfrage liefert das Ergebnis des Feldes Kundengruppe.
Die Abfrage kann auf Ihre Richtigkeit geprüft werden. Nutzen Sie hierfür bitte die SQL-Testen Schaltfläche.
8. Um Ihre SQL-Abfrage Testen zu können, wählen Sie bitte einen Datensatz aus.
9. Hier werden die Parameter des gewählten Datensatzes in die von Ihnen erstellte Abfrage eingesetzt. Bestätigen Sie Ihre Auswahl über die Schaltfläche Übernehmen.
10. Die SQL-Prüfung liefert im unteren Eingabefeld Ergebnis das Resultat ,der von Ihnen erstellten Abfrage. In diesem Fall erscheint als Ergebnis der Feldeintrag der Kundengruppe: "EVI".
11. Sobald die Abfrage das erwünschte Ergebnis liefert, schließen Sie die Testumgebung über die Schaltfläche OK.
12. Sind nun alle Angaben hinterlegt, so bestätigen Sie bitte diese über die Schaltfläche Übernehmen.
13. Ihr soeben neu angelegtes Benutzerfeld, kann nun in den weiteren Garbit SHIP Connector genutzt werden. Bitte öffnen Sie hierfür das Modul Empfänger Mapping.
14. Hier haben Sie nun die Möglichkeit das soeben neu angelegte Benutzerfeld dem Eingabefeld c/o Firmenname zuzuordnen. Bitte benutzen Sie hierfür das Symbol mit dem +-Zeichen neben dem Eingabefeld.
15. Es erscheint ein Fenster mit einer Liste von SQL-Spalten. Hier finden Sie auch das von Ihnen angelegte Feld {Benutzerfeld.Kundengruppe} wieder. Bitte bestätigen Sie Ihre Auswahl über die Schaltfläche Übernehmen.
16. Das neu angelegte Benutzerfeld erscheint nun in der von Ihnen ausgewählten Zeile im Empfänger Mapping. Speichern Sie nun bitte Ihre Daten ab.
17. Wechseln Sie nun in das Modul Manuellen Modus der Hauptanwendung.
18. Tragen Sie über die Zeile Scan/Suche die Belegnummer als Parameter im Eingabefeld ein, über welchen die Sendung gesucht werden kann.
19. Sobald Sie über die Zeile Scan/Suche die Parameter im Eingabefeld eingetragen haben, über welche die Sendung gesucht werden, erscheinen die von Ihnen hinterlegten Parameter in der Empfänger-Sektion. Das neu angelegte Benutzerfeld Kundengruppe wird im Eingabefeld c/o Firmenname angezeigt.
