Im dritten Teil der Beitragsserie geht es um die automatische Erzeugung von APEX-Anwendungsarchiven. Nutzt man darüber hinaus noch die Metadaten des APEX-Repositories, so lässt sich der Vorgang auch noch etwas smarter gestalten.
APEX-Anwendungen sichern via. PL/SQL
Zu Beginn geht es darum herauszufinden, welche PL/SQL Funktion benötigt wird, um eine Anwendungsarchiv zu erzeugen.
Da die Funktion bereits in der Packaged Application “APEX Application Archive” genutzt wird, können Sie sich diese einmal ansehen.
Hierzu begeben Sie sich einfach in die Verwaltung der Packaged Applications.
Öffnen Sie dort die “APEX Application Archive” und klicken Sie auf den Button “Manage’.
Folgen Sie dem Wizzards und Entsperren Sie die Anwendung.
Jetzt können Sie die Anwendung wie gewohnt über den Application Builder bearbeiten.
Öffnen Sie die Seite 9. Dort finden Sie den Prozess der für die Archivierung der Anwendungen zuständig ist.
Der besseren Lesbarkeit wegen, habe ich Ihnen den Quellcode einmal heraus kopiert.
DECLARE
l_vc_arr2 APEX_APPLICATION_GLOBAL.VC_ARR2;
l_hdr_id number;
z integer;
BEGIN
l_vc_arr2 := APEX_UTIL.STRING_TO_TABLE(ltrim(rtrim(:P10_APPLICATIONS_TO_ARCHIVE,':'),':'));
l_hdr_id := apex_cloud_archive.create_header(
p_workspace_id = :flow_security_group_id,
p_version = 1,
p_archive_name = :P5_ARCHIVE_NAME,
p_comments =:P9_COMMENTS);
FOR z IN 1..l_vc_arr2.count LOOP
apex_cloud_archive.archive_applications(
p_workspace_id = :flow_security_group_id,
p_header_id = l_hdr_id,
p_application_id = l_vc_arr2(z));
END LOOP;
END;
Quellcode 1: Auszug aus Seite 9 der Oracle APEX Anwendung Archive Application
Wie Sie dem Listing entnehmen können, benötigen Sie die Funktion create_header und archive_applications.
Die Funktion create_header legt ein neues Archiv an. Diesem Archiv können Sie nun mit Hilfe der Prozedur archive_applications eine oder mehrere Anwendungen hinzufügen.
Die Parameter, die Sie für den Aufruf der beiden Prozeduren benötigen, liefert die APEX-View APEX_APPLICATIONS.
Um beispielsweise die “Sample Database Application” mit der App-Id 507 zu sichern, können Sie folgenden PL/SQL Block ausführen.
Ein Hinweis am Rande. Oracle schreibt auf https://apex.oracle.com/de/ (Stand 22.05.2018 ) folgendes zum Anpassen von Packaged Applications.
“[..] Application Express bietet eine Sammlung von 35 Geschäfts- und Beispielsanwendungen. Sie können diese Anwendundungen für Produktionszwecke einsetzen oder kopieren, editieren und als Grundlage für Ihre eigenen Anwendungen verwenden.[..]”
Smarte Sicherung durch Nutzung der APEX-Views
Kombiniert man nun die APEX-View APEX_APPLICATIONS mit den Tabellen der Anwendung “Application Archive” kann man den Prozess noch etwas smarter gestalten. Über das folgende select-Statement ermitteln Sie notwendigen Parameter. Dabei wird allerdings geprüft, ob seit der letzten Archivierung überhaupt Änderungen an der zu sichernden Anwendung durchgeführt wurden.
select WORKSPACE_ID,APPLICATION_ID, APPLICATION_NAME
from APEX_APPLICATIONS a
where APPLICATION_ID = 507
and not exists (
select 'X'
from "APEX$ARCHIVE_CONTENTS" "APEX$ARCHIVE_CONTENTS",
"APEX$ARCHIVE_HEADER" "APEX$ARCHIVE_HEADER"
where "APEX$ARCHIVE_HEADER".ID="APEX$ARCHIVE_CONTENTS".HEADER_ID
and "APEX$ARCHIVE_HEADER".WORKSPACE_ID = a.WORKSPACE_ID
and "APEX$ARCHIVE_CONTENTS".APP_ID = a.APPLICATION_ID
and "APEX$ARCHIVE_HEADER".CREATED > a.last_updated_on)
Quellcode 2: Änderungen berücksichtigen
Jetzt können Sie diese Erkenntnisse in Form einer Prozedur in der Datenbank speichern.
create or replace procedure back_app
(p_app_id number)
is
l_hdr_id number;
l_workspace_id number;
l_archive_name varchar2(200);
BEGIN
for c in (select WORKSPACE_ID, APPLICATION_NAME
from APEX_APPLICATIONS a
where APPLICATION_ID = p_app_id
and not exists (
select 'X'
from "APEX$ARCHIVE_CONTENTS" "APEX$ARCHIVE_CONTENTS",
"APEX$ARCHIVE_HEADER" "APEX$ARCHIVE_HEADER"
where "APEX$ARCHIVE_HEADER".ID = "APEX$ARCHIVE_CONTENTS".HEADER_ID
and "APEX$ARCHIVE_HEADER".WORKSPACE_ID = a.WORKSPACE_ID
and "APEX$ARCHIVE_CONTENTS".APP_ID = a.APPLICATION_ID
and "APEX$ARCHIVE_HEADER".CREATED > a.last_updated_on))
loop
l_workspace_id := c.WORKSPACE_ID;
l_archive_name := c.APPLICATION_NAME;
l_hdr_id := apex_cloud_archive.create_header(
p_workspace_id => l_workspace_id ,
p_version => 1,
p_archive_name => l_archive_name || to_char(sysdate,'dd.mm.yyyy'),
p_comments => '' );
apex_cloud_archive.archive_applications(
p_workspace_id => l_workspace_id ,
p_header_id => l_hdr_id,
p_application_id => p_app_id );
end loop;
END;
Quellcode 3: Prozeduren back_app
Um nun eine Anwendung zu archivieren genügt folgender Aufruf.
BEGIN back_app(507); END
Quellcode 4: Anwendung archivieren
Sicherungen Automatisieren mit dem dbms_scheduler
Gerade im Rahmen der Entwicklung einer Anwendung ist es oft nützlich, auf ältere Versionen einer Anwendung zurückgreifen zu können. Um das Archivieren nicht immer manuell anstoßen zu müssen, können Sie die eben konzipierte Prozedur back_app über einen Scheduler ausführen. Am einfachsten geht das über das Package dbms_schedule.
BEGIN
DBMS_SCHEDULER.CREATE_JOB (
job_name => 'my_backup_job1',
job_type => 'PLSQL_BLOCK',
job_action => 'BEGIN back_app(507); END;',
start_date => sysdate,
repeat_interval => 'FREQ=DAILY; BYHOUR=10,15,20;',
end_date => sysdate + 1,
enabled => TRUE,
comments => 'sample app');
END;
/
Quellcode 5: Regelmäßige Sicherung
In diesem Beispiel wird die Anwendung 507 jeden Tag um 10:00, 15:00 und 20:00 immer dann gesichert, wenn die Anwendung seit der letzten Archivierung geändert wurde.
Um nun eine Anwendung wieder herzustellen, gehen Sie wie in Teil 2 dieser Reihe beschrieben vor.
Beitragsübersicht
[catlist name=”APEX Application Archive”]