Gunther Oracle APEX und Datenbank Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====Oracle Apex 20.2 - Mit den APEX Automations Feature Code im Hintergrund bei Bedarf starten====


Mit dem APEX Automations Feature (Declarative asynchronous processes ) läßt sich gut Logik im Hinterrund der Applikation bei Bedarf ausführen.


{{ :prog:apex:apex_automations_apex_connect_2021.png?600 | APEX Automations }}

PDF => {{ :prog:apex-automation-oracle-scheduler-connect-2021_gunther_pipperr_v01.pdf | APEX Connect 2021 - APEX 20.2 Automations Feature und der Oracle Scheduler im Einsatz - Mittwoch, 5. Mai, 14:00 - 14:40 Online }}

**Typische Business Cases:**

Workflows anstarten wenn bestimmte Daten in der Datenbank vorliegen
  * Wie:   Sachbearbeiter A hat Vorgang bearbeitet und abgeschlossen, Kunde B erhält automatisch eine Mail das der Vorgang bearbeitet wurde
  * Wie: Bei Fehlern im Log Admin per Mail benachrichtigen

Regelmäßig im Hintergrund etwas starten
  * Wie: Logs aufräumen


**Vorteil:**

  * Voll in der APEX Welt integriert
  * Es werden kein Rechte für das Anlegen von Jobs benötigt
  * Nach einen Deployment sind die Aufgaben/Jobs einfach “da” ! 
    * Jobs müssen nicht jedesmal umständlich neu angelegt / angepasst werden


<note important>Nach einen erneuten Deployments prüfen ob die APEX-Automations noch nicht deaktiviert sind! </note>


----

==== Anlegen====


=== Ablauf ===



{{ :prog:apex:apex_automation_architecture_overview.jpg | Interner Ablauf APEX Automations Feature}}



=== Die Automation ===


{{ :prog:apex:apex_automations_create_automations_uebersicht_v01.jpg?600 | Oracle APEX Automations  }}



=== Voraussetzung ===

Das Schema in der die APP läuft muss das Rechte "create Job" besitzen!

<code sql>

# als SYS

grant create job to GPI;

</code>


=== Anlegen über die APEX Oberfläche===

Anlegen in der Applikation unter “Shared Components” /   ” Application Logic - Automations“

{{ :prog:apex:apex_automations_create_automations.jpg?300 | Oracle APEX Automations anlegen}}


Über die Oberfläche definieren:
{{ :prog:apex_automations_create_automations_flows_v01.png | Oracle APEX Automations anlegen} }}


<note>Auf die STATIC ID achten, über diese wird der Automation Task später in der API angesprochen!</note>


In der Query kann auf die letzte Ausführung der Automation referenziert werden:
<code sql>
select * 
  from {table}
 where created_at > apex_automation.get_last_run;
</code> 


Im den Aktionen der Automation kann per ":" Notation auf die Spalten in der Automation Check Query zugegriffen werden, über die API können Log Einträge erstellt und die Ausführung der Aktion gesteuert werden. 

Beispiel Action:
<code sql>
BEGIN

  apex_automation.log_info(         p_message     => 'Found '||:ENAME );
  
  if :ENAME = 'Gunther' then
      apex_automation.skip_current_row( p_log_message => 'Gunther is found' );
      apex_automation.log_warn(         p_message     => 'Gunther is found' );
  end if;
  
  if :ENAME is null then   
      apex_automation.exit(p_log_message => 'No Member Name found' );
  end if;   
   
END;

</code>
 

----

=== Über die API Aufrufen ===

Referenziert wird der Automation Task über seine Static ID.


Siehe dazu => https://docs.oracle.com/en/database/oracle/application-express/20.2/aeapi/APEX_AUTOMATION.html

Zum Beispiel über Button mit PL/SQL aufrufen:

<code sql>
apex_automation.execute(
        p_static_id       =>  'new-emp-message'
);
</code>

----

==== Abfragen====


Metadaten abfragen:



Was wurde angelegt:
  * APEX_APPL_AUTOMATION_ACTIONS
  * APEX_APPL_AUTOMATIONS

Monitoring
  * APEX_AUTOMATION_LOG
  * APEX_AUTOMATION_MSG_LOG



----

 
==== Intern ====


Was wird erzeugt? – Wer ruft das dann auf?






  * Pro Automation wird kein Job angelegt, sondern ein zentraler APEX Job unter dem APEX Schema Eigentümer fragt per Default alle 2 Minuten die definierten Automations ab.
  * {{ :prog:apex:oracle_apex_automations_background_job.jpg| Oracle Apex Automations Job}}
  * Dieser Job ruf **wwv_flow_automation.EXECUTE_DUE_AUTOMATIONS** auf und prüft Tabelle **“WWV_FLOW_AUTOMATIONS”** auf notwendige Aufrufe.
  * Falls der Job laufen soll, wird ein einmaliger Job über den Oracle Scheduler angelegt mit der Methode **“wwv_flow_automation.EXECUTE_AUTOMATION_ACTIONS”** .
  * Diese starte den eigentliche Task Code im richtigen Scope der jeweiligen APEX Applikation über **“WWV_FLOW_PLUGIN.EXECUTE_PROCESS“**.





----

==== Quellen ====


Oracle Doku:
  * https://docs.oracle.com/en/database/oracle/application-express/20.2/htmdb/about-automations.html#GUID-23FFD57A-D29A-482D-AA7D-4CBC348662AC

Web:
  * https://blogs.oracle.com/apex/automate-your-business-process-in-oracle-apex-202