ApEx effektiv. Lösungen für Standardanforderungen. Stephan Engel OPITZ CONSULTING Bad Homburg GmbH. Nürnberg,

Transkript

1 Lösungen für Standardanforderungen mit Köpfchen Stephan Engel OPITZ CONSULTING Bad Homburg GmbH Nürnberg, OPITZ CONSULTING GmbH 2009 Seite 1

2 Vorgestellte Lösungen Fachliche Fehlermeldungen aus Prozessen Löschen nur mit Sicherheitsabfrage Rückfrage Daten wurden geändert Navigation mit Zurück Buttons OPITZ CONSULTING GmbH 2009 Seite 2

3 Fachliche Fehlermeldungen aus Prozessen Geschäftslogik liegt in PL/SQL vor In dieser Geschäftslogik finden auch Validierungen statt. Schlägt eine Validierung fehl wird typischerweise eine Exception geworfen. Ziel: Diese Validierungen nur einmal aufrufen, fachliche Meldungen in der Oberfläche anzeigen. OPITZ CONSULTING GmbH 2009 Seite 3

4 Fachliche Fehlermeldungen aus Prozessen Szenario: Eingabeformular für Projekte Projektnamen muss eindeutig sein. Gesichert durch einen Unique Constraint. Default Verhalten: OPITZ CONSULTING GmbH 2009 Seite 4

5 Fachliche Fehlermeldungen aus Prozessen Einfache Lösung: Validierung implementieren OPITZ CONSULTING GmbH 2009 Seite 5

6 Fachliche Fehlermeldungen aus Prozessen Nachteil der Validierungslösung Performance Code Redundanzen Aufwand bei der Entwicklung Vorteil: Sieht gut aus Ziel: Entwicklung einer Lösung, die Nachteile kompensiert und gut aussieht OPITZ CONSULTING GmbH 2009 Seite 6

7 Fachliche Fehlermeldungen aus Prozessen Lösungsansatz Fehlermeldungen in Collection schreiben Bericht auf Seite 0, der aussieht wie Validierungsmeldungen OPITZ CONSULTING GmbH 2009 Seite 7

8 Fachliche Fehlermeldungen aus Prozessen Vorgehen: 1. Neue Collection beim Anmelden an die Anwendung anlegen OPITZ CONSULTING GmbH 2009 Seite 8

9 Fachliche Fehlermeldungen aus Prozessen 2. Methode zum Schreiben der Fehlermeldungen in die Collection anlegen OPITZ CONSULTING GmbH 2009 Seite 9

10 Fachliche Fehlermeldungen aus Prozessen 2. Bericht auf Seite 0 anlegen OPITZ CONSULTING GmbH 2009 Seite 10

11 Fachliche Fehlermeldungen aus Prozessen 3. Globale Prozesse und Items definieren Item F101_SHOW_ERRROS Branch definieren, der im Fehlerfall auf der Seite bleibt Prozess anlegen, der die Collection aufräumt OPITZ CONSULTING GmbH 2009 Seite 11

12 Fachliche Fehlermeldungen aus Prozessen 4. Fehler in PL/SQL fangen und Loggen OPITZ CONSULTING GmbH 2009 Seite 12

13 Löschen mit Sicherheitsabfrage Anforderung: Alle Löschaktionen in der Anwendung sollen mit einer Sicherheitsabfrage bestätigt werden. Häufige Umsetzung: javascript:apex.confirm(htmldb_delete_message,' DELETE'); Nachteil: Muss bei jedem Button implementiert werden OPITZ CONSULTING GmbH 2009 Seite 13

14 Löschen mit Sicherheitsabfrage Idee: Einhängen in den Submit Prozess Generisch auf allen Seiten automatisch einen Delete Meldung anzeigen, wenn der Request bestimmten Werten entspricht. OPITZ CONSULTING GmbH 2009 Seite 14

15 Löschen mit Sicherheitsabfrage Platzieren des JavaScript Codes <script language="javascript" type="text/javascript"> apex.jquery(document).ready(function() { function submitoverride(event) { if(apex.jquery('#prequest').val().indexof('delete')>-1) { if (confirm(htmldb_delete_message)) { this._submit(); } } else { this._submit(); } } document.wwv_flow._submit = document.wwv_flow.submit; document.wwv_flow.submit = submitoverride; }); </script> OPITZ CONSULTING GmbH 2009 Seite 15

16 Löschen mit Sicherheitsabfrage Dieser Code kann z.b. auf Seite 0 oder im Template platziert werden Vorteil Seite 0: Verhalten kann z.b. gezielt für bestimmte Seiten mit ApEx Mitteln ausgeschaltet werden Code ist unabhängig vom gewählten Seitentemplate vorhanden OPITZ CONSULTING GmbH 2009 Seite 16

17 Löschen mit Sicherheitsabfrage Anstelle der Standard JavaScript Dialoge sind in ApEx 4 auch jqueryui Dialoge function submitoverride(event) { if(apex.jquery('#prequest').val().indexof('delete')>-1) { apex.jquery('#confirmdeletemessage').dialog('open'); } else { this._submit(); } } OPITZ CONSULTING GmbH 2009 Seite 17

18 Löschen mit Sicherheitsabfrage apex.jquery('#confirmdeletemessage').dialog({ autoopen: false, width: 400, modal: true, resizable: false, buttons: { "Lieber nicht": function() { $(this).dialog('close'); }, "Klar, weg damit": function() { document.wwv_flow.submit(); }}});}); </script> OPITZ CONSULTING GmbH 2009 Seite 18

19 Rückfrage Daten wurden geändert Der hier vorgestellte Mechanismus kann auch für andere Themen benutzt werden z.b.: Änderungen nur nach Rückfrage, wenn Datensatz bestimmten Status hat z.b. Rückfrage Daten wurden geändert OPITZ CONSULTING GmbH 2009 Seite 19

20 Rückfrage Daten wurden geändert Implementierung mit dem Gedanken Checksumme Beim Laden der Seite den Inhalt aller Items in einen String packen Beim Submit prüfen, ob der alte String!= Neue String und Request z.b. = Back Wenn ja, dann Meldung anzeigen. Vorteil: Funktioniert immer, z.b. auch bei Tabellarischen Formularen OPITZ CONSULTING GmbH 2009 Seite 20

21 Rückfrage Daten wurden geändert Methode zum Bauen des Strings function calculatepageitemschecksum() { return apex.jquery(":input").map(function(){ return (apex.jquery(this).attr("id")=='prequest' apex.jquery(this).attr("id")=='p0_page_input_type_checksum' } ).get().join(","); }; apex.jquery(this).attr("id")==null apex.jquery(this).attr("id")=='' )?null:apex.jquery(this).val(); Item auf Seite 0 anlegen und z.b. mit Hilfe einer Dynamic Action das Item beim Laden der Seite füllen. $s('p0_page_input_type_checksum',calculatepageitemschecksum()); OPITZ CONSULTING GmbH 2009 Seite 21

22 Rückfrage Daten wurden geändert Beim Submit prüfen, ob eine Meldung angezeigt wird if(!(apex.jquery('#prequest').val().indexof('cancel')>-1 apex.jquery('#prequest').val().indexof('save')>-1 apex.jquery('#prequest').val().indexof('delete')>-1) && (apex.jquery('#p0_page_input_type_checksum').val()!= calculatepageitemschecksum())) { apex.jquery('#confirmunsavedchangemessage').dialog('open'); } OPITZ CONSULTING GmbH 2009 Seite 22

23 Navigation mit Zurück Buttons In ApEx Anwendungen wird häufig mit Buttons navigiert Deshalb soll auch der Anwendungsfall Zurück über Buttons implementiert werden. OPITZ CONSULTING GmbH 2009 Seite 23

24 Navigation mit Zurück Buttons Lösungsansätze: Javascript: Über die History kann auf die vorherige Seite zurücknavigiert werden. Nachteil: Funktioniert nicht, wenn zweimal auf der gleichen Seiten geblieben wird Mit einem speziellen Item auf den Seiten wird über die Funktion Branch to Page Identified by Item auf die Ursprungsseite zurückgesprungen. Nachteil: Komplexere Navigationen sind sehr aufwendig Idee: Mit einer Collectionen einen Navigationsstack implementieren, bei Back automatisch auf die letze Seite des Stacks navigieren. OPITZ CONSULTING GmbH 2009 Seite 24

25 Navigation mit Zurück Buttons 1. Collection anlegen APEX_COLLECTION.CREATE_COLLECTION(p_collection_name => 'NAVIGATION_COLLECTION'); 2. Prozess anlegen, der die aktuelle Seite auf den Stack legt Muss auf jeder Seite bis auf die Login Seite ausgeführt werden Wenn die oberste Seite auf dem Stack schon die aktuelle Seite ist, dann nichts tun. OPITZ CONSULTING GmbH 2009 Seite 25

26 Navigation mit Zurück Buttons DECLARE v_last_page PLS_INTEGER; BEGIN SELECT c001 INTO v_last_page FROM (SELECT seq_id, c001 FROM apex_collections WHERE collection_name = 'NAVIGATION_COLLECTION' ORDER BY seq_id DESC) WHERE ROWNUM < 2; IF v_last_page!= :app_page_id THEN apex_collection.add_member (p_collection_name => 'NAVIGATION_COLLECTION', p_c001 => :app_page_id ); END IF; EXCEPTION WHEN NO_DATA_FOUND THEN apex_collection.add_member (p_collection_name => 'NAVIGATION_COLLECTION', p_c001 => :app_page_id ); END; OPITZ CONSULTING GmbH 2009 Seite 26

27 Navigation mit Zurück Buttons 3. Prozess anlegen, der auf den Zurück Button reagiert DECLARE v_last_page PLS_INTEGER; v_seq_id PLS_INTEGER; BEGIN -- Vorherige Seite vom Stack ermitteln SELECT c001 INTO v_last_page FROM (SELECT seq_id, c001, ROW_NUMBER () OVER (ORDER BY seq_id DESC) seq FROM apex_collections WHERE collection_name = 'NAVIGATION_COLLECTION') WHERE seq = 2; -- Aktuelle Seite vom Stack ermitteln, damit sie gelöscht werden kann SELECT seq_id INTO v_seq_id FROM (SELECT seq_id, c001, ROW_NUMBER () OVER (ORDER BY seq_id DESC) seq FROM apex_collections WHERE collection_name = 'NAVIGATION_COLLECTION') WHERE seq = 1; OPITZ CONSULTING GmbH 2009 Seite 27

28 Navigation mit Zurück Buttons -- Aktuelle Seite löschen apex_collection.delete_member (p_collection_name p_seq ); -- Redirect OWA_UTIL.redirect_url ( 'f?p=' :app_id ':' v_last_page ':' :app_session ); -- Verarbeitung abbrechen apex_application.g_unrecoverable_error := TRUE; EXCEPTION -- Keine Daten auf dem Stack, kein Redirect. WHEN NO_DATA_FOUND THEN NULL; END; => 'NAVIGATION_COLLECTION', => v_seq_id OPITZ CONSULTING GmbH 2009 Seite 28

29 Navigation mit Zurück Buttons Abbruch führt automatisch auf die Seite Von der aus navigiert wurde OPITZ CONSULTING GmbH 2009 Seite 29

30 Fazit Die hier vorgestellten Lösungen Entlasten den Entwickler von Standardaufgaben Sind generisch im Ansatz und somit wiederverwendbar Erhöhen den Komfort für den Endbenutzer Sollten in Erwägung gezogen werden, wenn eine Neuentwicklung mit ApEx begonnen wird OPITZ CONSULTING GmbH 2009 Seite 30

31 Fragen und Antworten OPITZ CONSULTING GmbH 2009 Seite 31

32 Kontakt Stephan Engel OPITZ CONSULTING Bad Homburg GmbH OPITZ CONSULTING GmbH 2009 Seite 32