Codegenerator für APEX Collections und Tabular Forms

Transkript

1 Codegenerator für APEX Collections und Tabular Forms Andreas Wismann WHEN OTHERS Beratung Programmierung Coaching

2 Agenda Andreas Wismann Tabular Forms Features APEX Collection Features Welchen Code brauchen wir Wie wird der Code erzeugt Herausforderungen und Grenzen WHEN OTHERS Beratung Programmierung Coaching

3 Ausgangspunkt

4 Tabular Forms-Assistent

5 Tabular Form maximal 50 Spalten, ein Grid pro Seite

6 Direkter Zugriff auf die Tabelle!

7 nur Standardfunktionalität

8 möchte man "mehr", SELECT APEX_ITEM.HIDDEN(1, empno) APEX_ITEM.DISPLAY_AND_SAVE(2,ename) ename, APEX_ITEM.TEXT (3, salary) job, APEX_ITEM.DATE_POPUP2(4, hiredate) hiredate, APEX_ITEM.TEXT (5, sal) sal, APEX_ITEM.TEXT (6, comm) comm FROM emp

9 möchte man "mehr", BEGIN FOR i IN 1.. APEX_APPLICATION.G_F01.COUNT LOOP UPDATE emp SET ename = APEX_APPLICATION.G_F02(i),job = APEX_APPLICATION.G_F03(i),hiredate = to_date(apex_application.g_f04(i), 'dd-mon-yyyy'),sal = APEX_APPLICATION.G_F05(i),comm = APEX_APPLICATION.G_F06(i) WHERE empno = to_number(apex_application.g_f01(i)); END LOOP; END;

10 Zwischenstand Tabular Forms entweder überhaupt kein Code (Assistenten) oder gleich "die volle Breitseite" Zuordnung von Formularspalten (Nummern) zu Tabellenspalten (Namen), fehleranfällig Direktes Arbeiten auf der DB-Tabelle (INSERT, UPDATE, DELETE)

11 Was sind APEX Collections? zwei echte Datenbanktabellen unbegrenzte Menge Daten privat, der Benutzersession zugeordnet APEX übernimmt die Session-Verwaltung

12 Was sind APEX Collections? WWV_FLOW_COLLECTIONS$ WWV_FLOW_COLLECTION_MEMBERS$

13 API-Dokumentation

14

15 Ähnlichkeiten? Temporäre Tabellen Materialized Views funktionieren nicht mit APEX Sessions werden laufend gewechselt sind mächtiger als APEX Collections aber nicht privat

16 Persistenz Collection-Daten sind innerhalb der Session auf allen APEX-Seiten verfügbar.

17 Flexibilität Abkopplung von fachlichen Tabellen endgültiges Datenmodell muss nicht bekannt sein Fehlerhafte Eingaben können dem Benutzer später wiedervorgelegt werden

18 APEX Collections sind robust.

19 Collection anlegen Warenkorb-Prinzip Abfrage-Prinzip Die Collection ist zu Beginn leer Die Collection wird inital mit Daten aus Tabellen oder Views befüllt apex_collection. create_collection ( WARENKORB' ); apex_collection. create_collection_from_query ( MERKLISTE', select * from merkliste where ' );

20 create_collection_from_query select * from

21 create_collection_from_query where

22 Collection auflösen Warenkorb-Prinzip Abfrage-Prinzip Alle Datensätze prüfen in fachliche Tabellen einfügen apex_collection. delete_collection ( collection_name ) Datensätze prüfen INSERT, UPDATE oder DELETE

23 Hinzufügen eines Datensatzes apex_collection.add_member ( p_collection_name => 'WARENKORB',p_c001,p_c002,p_c003,p_c004,p_c usw. ); => :P100_C001 => :P100_C002 => :P100_C003 => :P100_C004 => :P100_C005

24 Aktualisieren eines Datensatzes apex_collection.update_member ( p_collection_name => 'WARENKORB',p_seq => :P100_SEQ_ID,p_c001,p_c002,p_c003,p_c004,p_c usw. ); => :P100_C001 => :P100_C002 => :P100_C003 => :P100_C004 => :P100_C005

25 Löschen eines Datensatzes apex_collection.delete_member ( p_collection_name => WARENKORB,p_seq => :P100_SEQ_ID );

26 Collection-Lifecycle (Beispiel 1) create_collection add_member add_member update_member insert into TABELLE select * from APEX_COLLECTIONS delete_collection

27 Collection-Lifecycle (Beispiel 2) create_collection_from_query [ Zeile hinzufügen ] add_member [ Speichern ] PL-SQL-Loop, truncate_collection

28 Tabular Form updaten for i in 1.. apex_application.g_f01.count loop apex_collection.update_member ( p_collection_name => 'WARENKORB,p_seq => apex_application.g_f01( i ),p_c001 => apex_application.g_f02( i ),p_c002 => apex_application.g_f03( i ),p_c003 => apex_application.g_f04( i ),p_c004 => apex_application.g_f05( i ),p_c005 => apex_application.g_f06( i ) ); end loop;

29 Zwischenstand: Collections Zuordnung Tabellenspalten zu Collection- Spalten, fehleranfällig Erzeugen einer Collection über APEX_COLLECTION -Aufruf Einfügen, Ändern, Löschen, Beenden über APEX_COLLECTION -Aufrufe

30 Nutzdaten C001 C002 C003 C048 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001

31 kombiniere Tabelle Collection APEX Fehlerquellen potenzieren sich Viel, viel (sehr viel) Code notwendig

32 Demo: Code-Generator verwenden

33

34

35

36

37

38

39

40

41

42

43

44

45 Code und Seite "verheiraten"

46 Code und Seite "verheiraten" Musterseite anlegen (einmalig) "Buttons"-Region ADD_ROW - Schaltfläche CREATE_COLLECTION (raise_application_error) STORE_MRU (raise_application_error) SAVE_MRU_TO_TABLE (raise_application_error) Musterseite kopieren COPY & PASTE aus dem APEX-Codegenerator Berichtsspalten auf "Standard Report Column" umstellen

47 Resultat

48 Validierung? eigenen PL/SQL-Code hinzufügen

49 Tabular Form Start Index A_Collection B_Collection C_Collection 1 50 apex_application.g_f01 apex_application.g_f50

50 Debugging privat bedeutet privat Collection-Inhalte (zunächst) nur in derselben Benutzersession sichtbar Auf Formularseiten einen einfachen Report über die Collection anzeigen: select * from tabellenname_cv;

51 Meta-Informationen C001 C002 C003 C048 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001 N001 N002 N003 N004 N005 neu - geändert sichtbar - unsichtbar Versionsnummer erfolgreich validiert - nicht validiert übergeordneter Datensatz (SEQ_ID)

52 Verkettete Liste C001 C002 C003 C048 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001 N001 N002 N003 N004 N005 Vorgänger Nachfolger

53 Historie C001 C002 C003 C048 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001 D001 D002 D003 D004 D005 erstellt am letzte Änderung am validiert am zuletzt gespeichert am gültig bis

54 Freie Auswahl C001 C002 C003 C048 C049 C050 N001 N005 D001 D005 BLOB001 CLOB001 XMLTYPE001 Direkte Vorversion des Datensatzes Änderungshistorie <aenderung user= Heinz" datum=" :59:11"> <feld name="x" wert-alt="1" wert-neu= "2"/> <feld name="y" wert-alt="10" wert-neu= "20"/> </aenderung> Informationen für der Benutzer (Kommentare, ToDo, Links, Dokumentverweise ) HTML

55 Fallstricke Datensatz-Status (neu, geändert, gelöscht) Integrität (Pessimistic Locking)

56 Demo: Exception Handler Generator

57

58

59 Fazit? Beißen Sie sich durch die Dokumentation Bauen Sie nichts nach, das es bereits gibt Schreiben Sie Code-Generatoren

60 Lesetipp Expert Oracle Application Express (Verlag: Apress, Mai 2011) ausführlicher Teil zu Tabular Forms gute Einführung zu APEX-Collections Charts, Dynamic Actions, Plugins u.v.m.

61 Andreas Wismann WHEN OTHERS Beratung Programmierung Coaching