Inhaltsübersicht

Mit vordefinierten Abfragen kann eine Aus-/Eingabe einer Gültigkeitsüberprüfung, Listanzeige, Detailanzeige u.a. unterzogen werden.

0312 - Abfragen

Abfragearten

Abfragearten können als Kunden-Abfragen oder pro Webapplikation angelegt werden.

Wenn das Verwaltungsprogramm auf der IBM i (und nur auf dieser IBM i) aufgerufen wird, sind nicht nur die Kunden-Abfragen (CUSTOMER) zu sehen, sondern auch Abfragen, die für Web Applikationen angelegt wurden.

Da diese Abfragen zusammen mit dem Produkt auf der Kundenmaschine installiert werden müssen, können diese per Programm in ein SQL Script exportiert werden um dann bei Installation wiederhergestellt zu werden.

Der Export in das SQL Script erfolgt über CALL PGM(DWCRTCST) PARM(webappname). Das so erstellte SQL Script wird in der Produktbibliothek in QSQLSRC mit dem Member DWCSTTYP erstellt und kann mit dem Befehl RUNSQLSTM ausgeführt werden.

Vorsicht ist geboten, wenn produktbezogene Abfragen gelöscht/geändert/erstellt werden, da das Script automatisch beim Release Cut erstellt wird.

Wird in Spalte "Beispiel" auf Suchen geklickt, bekommt man die Beispieldaten für die definierte Abfrage angezeigt.

Ist in Abfragen als Feld eine Telefonnummer enthalten, so kann durch Klick auf die Telefonnummer gleich eine Verbindung hergestellt werden.

Wurde bei der Abfrage beim Parameter Spezielle Anzeige als „Mobiltelefon" definiert, so kann über das dargestellte Icon entweder eine Verbindung hergestellt oder eine SMS geschickt werden.

Abfrage Kontextmenü

Zur Administration der Abfragen gibt es folgendes Kontextmenü:

Abfrage erstellen

Eine Abfrage ist mir nachstehenden Parametern zu erstellen.

SQL Abfrage - Name der zu erstellenden SQL Abfrage (max. 20 Zeichen).

Beschreibung - Eingabe einer Beschreibung für die zu erstellende Abfrage.

Datenbank - Auswahl der Datenbank auf die bei der Erstellung der Abfrage Bezug genommen werden soll.

Eine auswählbare Datenbank muss zuvor unter RPGWX → Datenbanken definiert worden sein.

SQL-Befehl: SELECT...

Hier können datenbankbezogene SQL-Eingaben vorgenommen werden, die die Datenselektion einschränken.

Die komplette SQL-Syntax steht zur Verfügung. Komplexe SELECT-Statements incl. JOIN, SUBSTR-Funktionen etc. können angewendet werden.

Darstellung als Combo Box - Als Darstellung für die Combo Box stehen folgende Auswahlmöglichkeiten zur Verfügung:

Normales Eingabefeld - Bei dieser Feldart öffnet sich mit Klick auf das Symbol Werteliste in der Spalte Beispiel ein weiteres Fenster mit den gefundenen Datensätzen. Dieses Fenster erlaubt mit den Feldern eine weitere Datenselektion vorzunehmen, z.B. Einschränkung Selektion für einen bestimmten Kunden.

Combo Box mit Werteliste -Bei dieser Feldart öffnet sich mit Klick auf das Pfeilsymbol eine Werteliste.

Auto Complete Combo Box -Bei dieser Feldart öffnet sich bei Eingabe in das Eingabefeld eine Werteliste, die der Eingabe entspricht. Die fehlenden Eingabedaten werden automatisch ergänzt.

Minimaler Wert - Eingabe eines Minimalwertes, den der Feldart erhalten kann.

Maximaler Wert - Eingabe eines Maximalwertes, den die Feldart erhalten kann.

SQL zur Gültigkeitsprüfung - Eingabe einer Gültigkeitsprüfung

Das Beispiel zeigt eine Kundenstammabfrage, bei der die Kundenummer <= 1000 sein muss.

Formel zur Gültigkeitsprüfung - Definition einer Formel zur Gültigkeitsprüfung auf das Ergebnis der SQL-Abfrage. Das Beispiel schränkt die Kundennummer auf > 100 und < 150 oder 190 ein.

SQL Abfrage Felder

Eine SQL Abfrage kann mehrere Felder beinhalten.

Datenbankfeld ändern

Ein Datenbankfeld kann über Aufruf Ändern aus dem Kontextmenüs geändert werden.

Reiter Allgemein

Hier werden die allgemeinen Definitionen für eine SQL Abfrage festgelegt.

Beschreibung - Eingabe einer Beschreibung für die zu erstellende Feldart (max. 40 Zeichen), falls dieser nicht identisch mit der Beschreibung aus der DDS-Definition sein soll.

RPGWX SQL Abfrage - Hier kann eine vorhandene SQL Abfrage ausgewählt werden.

Hauptschlüsselfeld - Bei Aktivierung wird dieses Feld als Hauptschlüsselfeld verwendet.

Standard-Sortierfeld - Bei Aktivierung erfolgt die Ausgabe nach dieser Sortierreihenfolge.

Standard-Sortierfolge ist aufsteigend - Bei Aktivierung erfolgt die Ausgabe absteigend sortiert.

Exit Service Programm - In einem Service Programm wird die Darstellung für den verwendeten Typ von einem Anwendungsprogramm mit Übergabeparameter ausgeführt und das Symbol exportiert. Es wird mit HTML-Code geantwortet.

Funktion/Symbol - Funktionsname für das Serviceprogramm Es kann ein Serviceprogramm und ein Name des Symbols (Funktionsname) eingegeben werden (max. 30 Zeichen).

Reiter Ausgabe

Hier werden die Ausgabedefinitionen für eine SQL Abfrage definiert.

In Liste anzeigen - Hier wird gesteuert, ob das Feld in der Auflistung ausgegeben werden soll oder nicht.

In Liste anzeigen – aktiviert

In Liste anzeigen – deaktiviert

Überschrift - Eingabe einer Überschrift, wie diese in der Ausgabe erscheinen soll.

Groß-/Kleinschreibung - Auswahl, ob Groß-/Kleinschreibung zugelassen werden soll.

Ausrichtung - Auswahl, wie die Ausgabe erfolgen soll: linksbündig, zentriert oder rechtsbündig.

Sortieren erlauben - Bei Aktivierung wird eine Sortierung auf diese Feldart zugelassen.

CCSID des Feldes - Hier wird festgelegt, welche CCSID zur Ausgabe des Feldes verwendet werden soll.

Spezielle Anzeige als - Hier wird die Darstellung der Feldausgabe gesteuert. Folgende Anzeigemöglichkeiten stehen zur Verfügung:

Gültige Werte sind:

Keine spezielle Anzeige Ausgabe erfolgt wie Eingabe
Telefonnummer Feldaufbereitung für Telefonnummer
E-Mail-Adresse Feldaufbereitung für E-Mail-Adresse
WWW-Adresse Feldaufbereitung für WWW-Adresse
Mobiltelefon Feldaufbereitung für Mobiltelefon

Reiter Suche

Hier werden die Suchkriterien festgelegt.

Volltextsuche - Bei Aktivierung wird die Suche in allen vorkommenden Feldern durchgeführt.

Filter Auswahl - Bei Aktivierung erfolgt die Suche anhand des Eintrags im Filter.

Erweiterter Filter - Bei Aktivierung erfolgt die Suche anhand des Eintrags im erweiterten Filter.

Eingabe erforderlich - Hier wird gesteuert ob im Feld ein Eintrag erfolgen muss.

Filter Combo Box mit Werteliste - Hier wird für die Suche definiert, ob das Feld ein normales Eingabefeld, eine Combo Box mit Werteliste oder eine Auto Complete Combo Box ist.

Generische Suche - Eine generische Suche kann wie folgt differenziert werden:

Exakte Übereinstimmung: Bei der Suche muss eine exakte Übereinstimmung zwischen der Eingabe im Suchfeld und dem zu findenden Objekt vorliegen.
Textsuche: Bei Aktivierung wird geprüft, ob der komplette String im Text vorkommt.
Matchcode Suche: Bei Aktivierung erfolgt die Suche nach exakter Übereinstimmung beginnend am Text.

Schreibweise ignorieren - Bei der Suche wird die Schreibweise nicht geprüft.

Reiter Anruffenster directdial

Hier werden die Definitionen für directdial festgelegt.

Zeile directdial Anruffenster - Eingabe der Zeilennummer in der das Feld angezeigt werden soll.

Maximale Länge im Anruffenster - Eingabe der maximalen Feldlänge im Anruffenster mit der das Feld angezeigt werden soll.

Position in Zeile Anruffenster - Eingabe der Position ab der das Feld angezeigt werden soll.

Abfrage Berechtigung

Mit dieser Auswahl kann einer Abfrage erfolgt eine Berechtigungsprüfung hinzugefügt werden.

Alle Rechte - Bei Aktivierung hat der Benutzer alle Rechte für die SQL-Abfrage. Der Benutzer kann die SQL Abfrage verwenden, ändern, Daten anzeigen, ändern bzw. löschen.
Verwenden - Bei Aktivierung kann der Benutzer die Abfrage verwenden.
Ändern - Bei Aktivierung kann der Benutzer die Abfrage ändern.
Daten anzeigen - Bei Aktivierung werden die Daten angezeigt.
Daten ändern - Bei Aktivierung können die Daten geändert werden.
Daten löschen - Bei Aktivierung können die Daten gelöscht werden.

Abfrage Suchmaske

Mit dieser Option wird das Ergebnis bei Verwendung dieser Abfrage angezeigt. Somit kann eine schnelle Funktionsprüfung und ggf. eine Korrektur der definierten Abfrage durchgeführt werden.

Beispiel:

Abfragen