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.
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 WOPiXX - 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.
0056 – SQL SELECT Ergänzung
Darstellung als Combo Box
Als Darstellung für die Combo Box stehen folgende Auswahlmöglichkeiten zur Verfügung:
0087 - Darstellung als Combo Box aktiviert
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.
0050 – Feldart – Normales Eingabefeld
Combo Box mit Werteliste
Bei dieser Feldart öffnet sich mit Klick auf das Pfeilsymbol eine Werteliste.
0051 – Feldart –Combo Box mit 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.
0057 – SQL zur Gültigkeitsprüfung
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.
0058 – Formel zur Gültigkeitsprüfung
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 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
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.
0088 – In Liste anzeigen – aktiviert
0089 – 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.
0052 – CCSID des Feldes
Spezielle Anzeige als
Hier wird die Darstellung der Feldausgabe gesteuert. Folgende Anzeigemöglichkeiten stehen zur Verfügung:
0064 – Spezielle Anzeige als
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.
0054 – SQL Abfrage ändern – Reiter Suche – Filter Combo Box
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
0195 - Abfragen - Suchmaske – Suchergebnis – Link beim Ergebnis
0196 - 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