Parameter-Steuerung
gWLaunch ermöglicht das Öffnen eines bereits vorhandenen Datensatzes oder das Öffnen einer neuen Datensatzmaske inklusiver optionaler Vorbelegung von Feldwerten.
Existierende Datensätze editieren
Die Syntax besteht aus dem GWX-Protokoll, dem Verb, dem Tabellennamen und optionalen Werten. Das Verb zum Öffnen/Editieren von Datensätzen ist «edit».
Beispiel zum Öffnen eines Dokuments direkt über die GGUID:
GWX://edit/DOCUMENT/0xEF82213DCBF34CF38F175B62DAB2EB7E
Anstelle der GGUID kann auch ein Filterwert in Form eines Datenbankfeldes definiert werden. Folgendes Beispiel öffnet das Dokument mit der Nummer «2693»:
GWX://edit/DOCUMENT/DocNumber='2693'
Objekt- und Feldnamen: Die korrekte Bezeichnung eines CAS genesisWorld Datenobjektes oder Feldnamen können direkt aus der Managementkonsole entnommen werden. Dazu wählt man den Bereich «Datenbank» aus und doppelklickt auf das gewünschte Objekt. Im darauffolgenden Dialog findet man die Bezeichnung im Feld «Name». Dieser Wert ist für den Aufrufparameter zu verwenden.
Feldnamen entnimmt man ebenfalls aus dem Bereich, indem man auf der linken Seite das gewünschte Objekt auswählt und im rechten Teil den gewünschten «Feldnamen» sucht.
Im Filter sind keine Leerzeichen oder sonstige Sonderzeichen erlaubt. Diese müssen bei Bedarf URL-Kodiert werden. Beispiel falsch: GWX://edit/DOCUMENT/Keyword='Vertrag März' Beispiel richtig: GWX://edit/DOCUMENT/Keyword='Vertrag%20M%C3%A4rz' Zum einfachen Konvertieren von Werten ins URL-Format stehen verschiedene Tools online zur Verfügung, Beispiel: https://meyerweb.com/eric/tools/dencoder/
Ergebnis: Werden über den Aufrufparameter mehrere CAS genesisWorld Datensätze gefunden, wird eine Listenansicht angeboten. Bei einem einzelnen Datensatz wird direkt der entsprechende Datensatz geöffnet. Kann ein Datensatz nicht gefunden werden oder hat der User nicht ausreichend Rechte, erscheint eine entsprechende Fehlermeldung.
Neue Datensätze erzeugen
Die Syntax besteht jeweils aus dem GWX-Protokoll, dem Verb, dem Tabellennamen und optionalen Werten. Das Verb ist für neue Datensätzen «new».
Beispiel zum Öffnen einer E-Mail mit dem vordefinierten Stichwort:
GWX://new/EMAILSTORE?SUBJECT=Hallo
Beispiel zum Öffnen eines neuen Termins mit vorbelegtem Stichwort, Start- und Ende-Zeitpunkt : GWX://new/APPOINTMENT?start_dt=datetime(2018-08-01 10:00:00)&end_dt=datetime(2018-08-01 11:00:00)&keyword=Testtermin
Der Wert des Feldes ist standardmässig vom Typ «String» und wird nicht automatisch in das entsprechende Format konvertiert. Für eine Konvertierung stehen Funktionen zur Verfügung, die bei der Definition des Wertes aufgerufen werden können. Folgende Funktionen stehen zur Verfügung:
datetime: konvertiert einen Zeitstring in einen Zeitwert. Das Format wird mit YYYY-MM-DD HH-MM-DD erwartet
date: konvertiert einen Datumsstring in einen Datumswert. Das Format wird mit YYYY-MM-DD erwartet
int: konvertiert einen String in einen Integerwert
float: konvertiert einen String in einen Fliesskommawert
guid: konvertiert einen String in einen GUID-Wert. Das Format entspricht dem CAS genesisWorld-GUID-Format inklusive 0x-Präfix.
Es ist möglich, einen neuen Datensatz aus einer bekannten Vorlage zu erstellen. Hierbei kann das Feld «TemplateGUID» mit dem GUID-Wert der Vorlage angegeben werden, Beispiel:
GWX://new/EMAILSTORE?TEMPLATEGUID=0x6157730DA1384A9A870AC0C8BD157608
Bei der Verwendung der TEMPLATEGUID ist es nicht möglich 'einfache Filter' zu verwenden. Hier ist die GUID unbedingt notwendig. Um diese zu ermitteln können Sie auf der SQL-Datenbank folgendes Statement ausführen:
Im Ergebnis kann man die GGUID dann einfach via Kontextmenü kopieren:
Um Datensätze mit dem neuen Datensatz zu verknüpfen, kann das Feld «Link» mit dem Wert «Tablename,GUIDs,RelationName» angegeben werden. Dabei müssen die jeweiligen Werte angegeben werden:
Tablename: Name des Datenobjektes, mit dem verknüpft werden soll GUIDs: Liste der Datensatz-GUIDs, mit denen verknüpft werden soll RelationName: Name der Verknüpfungsart, die verwendet werden soll
Beispiel zum Erstellen eines neuen Dokuments aus einer Vorlage und Verknüpfung einer Adresse über eine Primärverknüpfung:
GWX://new/DOCUMENT?keyword=test&templateguid=0x9DF6FA0F0017EB4DAC3CCE965232A364&link=ADDRESS,0x05BCC828CE9747EFAACF140793E6C69F,ITDDOCADR
Beim Setzen von Verknüpfungen muss man die GGUID (ID) des Datensatzes angeben. Um diese zu ermitteln, können Sie auf der SQL-Datenbank folgendes Statement ausführen:
Die Bezeichnungen der Verknüpfungen kann man in der Managementkonsole im Bereich Sonstiges -> Verknüpfungen nachschauen:
Öffnen von Ansichten
Zum Öffnen von Ansichten stehen zwei Varianten zur Verfügung.
Öffnen von Ansichten über Parameter
Die Syntax besteht aus dem GWX-Protokoll, dem Verb, dem Ansichtsnamen und optionalen Werten. Das Verb ist für Ansichten «view».
Dabei wird der technische Name der Ansicht angegeben und als Parameter können alle notwendigen Werte angegeben werden:
Beispiel zum Öffnen der Adressliste: GWX://view/pTWCAxList.TWCAxList?TableName=Address
Beispiel zum Öffnen der aktuellen Wochenansicht:
GWX://view/PTWCAXCALENDARVIEW.TWCAXCALENDARVIEW?ViewType=WEEK&Date=CURRENTDATE&NumberOfWeekDays=5&WeekStart=0&TableName=APPOINTMENT
Zum Ermitteln der möglichen Parameter, kann man eine bestehende CAS Ansicht exportieren und mit dem Texteditor öffnen:
Nach dem Öffnen der exportierten Ansicht findet man die entsprechenden Parameter in der Datei:
Zu beachten ist, dass man diese geringfügig anpassen muss. Leerzeichen werden in URLs nicht erlaubt und /n sind nicht notwendig.
Um komplexere Ansichten (mit Filter und Einstellungen) aufzurufen, empfehlen wir Ihnen die zweite Methode.
Öffnen von Ansichten aus Navigatoren
Neben dem Öffnen von Ansichten über Parameter können Sie auch direkt Ansichten und deren dazugehörigen Konfiguration aus einem bestehenden CAS-Navigator aufrufen.
Die Syntax besteht aus dem GWX-Protokoll, dem Verb, dem Namen des Navigators, dem Ordnernamen sowie der Ansicht. Das Verb ist für Ansichten «nav».
Beispiel zum Öffnen der Kundenliste aus dem Ordner Adressen des Artwin Navigators: GWX://nav/Artwin/Adressen/Kundenliste
Die Ebene nach «nav» ist der Name des Navigators «Artwin». Danach kommen die einzelnen Ordner und dann die Ansicht.
Beispiel zum Öffnen einer Ansicht aus einem Unterordner:
GWX://nav/Artwin/Zeiterfassung/Abrechnungsreports/Alle%20abgerechneten%20(nach%20Kunde)
Alternativ ist auch möglich, eine Ansicht, direkt mit der Ansichts-GUID zu öffnen:
GWX://nav/0x28436A058D844E408A1F0E6F5F5A550E
Die GGUID kann dabei aus der Tabelle TWView, via SQL-Managementstudio ermittelt werden.
Sollten zu viele Ergebnisse zurückkommen, kann auch noch über die Description gefiltert werden:
(sucht explizit nur in Standardlistenansichten) oder
(sucht explizit nur in Report-Ansichten).
Im Ergebnis kann man die GGUID dann einfach via Kontextmenü kopieren:
Zu beachten
Kann eine Ansicht nicht gefunden werden oder ist diese mehrfach in dem definierten Ordner vorhanden, erscheint eine entsprechende Fehlermeldung.
Wir empfehlen ausschliesslich auf öffentliche Navigatoren zu verweisen, damit auch alle Benutzer auf die Ansicht Zugriff haben. Private Navigatoren werden unterstützt, die Ansichten können dann aber nur von dem Eigentümer des Navigators geöffnet werden.
Last updated
