Inhaltsübersicht
| Table of Contents | ||
|---|---|---|
|
Mit vordefinierten Abfragen kann eine Aus-/Eingabe einer Gültigkeitsüberprüfung, Listanzeige, Detailanzeige u.a. unterzogen werden.
0501 – Menüpunkt SQL-Abfragen
0312 - Abfragen
...
...
Abfragearten
Abfragearten können als Kunden-Abfragen oder pro Webapplikation angelegt werden.
0146 – Abfrage pro Webapplikation
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.
0044 – SQL Abfragen
Wird in Spalte "Beispiel" auf Suchen geklickt, bekommt man die Beispieldaten für die definierte Abfrage angezeigt.
0133 – Abfrage - Suche
Ist in Abfragen als Feld eine Telefonnummer enthalten, so kann durch Klick auf die Telefonnummer gleich eine Verbindung hergestellt werden.
0135 – Abfrage - Beispiel Telefon
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.
0136 – SQL Abfrage - Beispiel Mobiltelefon
...
...
...
Abfrage Kontextmenü
Zur Administration der Abfragen gibt es folgendes Kontextmenü:
0055 – Abfrage - Kontextmenü
...
Abfrage erstellen
Eine Abfrage ist mir nachstehenden Parametern zu erstellen.
0049 – SQL Abfrage 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.
0053 – SQL Abfrage – Felder
...
Datenbankfeld ändern
Ein Datenbankfeld kann über Aufruf Ändern aus dem Kontextmenüs geändert werden.
0134 – Datenbankfeld ändern
...
...
...
Reiter Allgemein
Hier werden die allgemeinen Definitionen für eine SQL Abfrage festgelegt.
0060 – Feldbeschreibung ändern – Reiter Allgemein
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. WOPiXX
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 absteigend
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.
0062 - Feldbeschreibung ändern – Reiter Ausgabe
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.
0063 – Feldbeschreibung ändern – Reiter Suche
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.
0246 – SQL Abfrage ändern – Reiter Anruffenster directdial
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.
0213 – Abfrage Berechtigung
0214 – Abfrage Berechtigung erstellen
- 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
0061 – Beispiel Feldartendefinition – definierte Felder
Ergebnis der Suche
0059 – SQL Abfragen - Suchmaske – Suchergebnis
...
...
...
Abfrage Suchmaske Kontextmenü
Mit der rechten Maustaste wird das Kontextmenü aufgerufen.
0194 - Abfragen - Suchmaske – Suchergebnis – Kontextmenü
...
...
Abfrage Suchmaske Link
Das Ergebnis zeigt in einigen Spalten einen weiterführenden Link an. Dieser ermöglicht abhängig von der Definition eine weitere Navigierung.
0193 – Abfragen - Suchmaske – Suchergebnis – Darstellung Link
...
Abfragen - Suchmaske – Suchergebnis – Link beim Ergebnis
...
Abfragen - Suchmaske – Suchergebnis – Link beim Ergebnis – Ausgabe Anzahl Ergebnis
Mit Klick auf das Ergebnis werden die dazugehörigen Suchergebnisse angezeigt.
0197 - Abfragen - Suchmaske – Suchergebnis – Link beim Ergebnis – Ausgabe Anzahl Ergebnis
Dort gibt es einen weiteren Link zum Ansprechpartner.
0198 - Abfragen - Suchmaske – Suchergebnis – Link beim Ergebnis – Ausgabe Anzahl Ergebnis