Application Express Mehrsprachigkeit & Mandantenfähigkeit. Copyright Apps Associates LLC. 1

Transkript

1 Application Express Mehrsprachigkeit & Mandantenfähigkeit Copyright Apps Associates LLC. 1

2 Agenda Einleitung Mehrsprachigkeit Übersetzung mit Hilfe von XLIFF-files Übersetzung mit Hilfe einer Übersetzungstabelle Mandantenfähigkeit Fazit Virtual Private Database Do It Yourself Copyright Apps Associates GmbH. 2

3 Einleitung Wachsende Anforderungen an Web-Applikationen Mehrsprachigkeit Mandantenfähigkeit Viele Wege führen nach Rom Verschiedene Beispiele aufzeigen Vor- und Nachteile Copyright Apps Associates LLC. 3

4 Mehrsprachigkeit Beispiel: Eine Applikation, die ein Formular enthält, die auf der Tabelle EMP basieren, soll auf Englisch und Deutsch zur Verfügung stehen. Applikation, wie gewöhnt erstellen Application Primary Language hier English (en) Applikationssprache vom Wert eines Items abhängig machen Copyright Apps Associates LLC. 4

5 Mehrsprachigkeit Erstellen eines speziellen Application Item zum Ändern der Sprache Wichtig: - Name des Items: FSP_LANGUAGE_PREFERENCE - Session State Protection: Unrestricted Problem: Änderungen des Werts des Items FSP_LANGUAGE_PREFERENCE sind erst sichtbar, wenn die Seite neu geladen wurde Application Process - Point: On Load: Before Header (page template header) - Process Text begin owa_util.redirect_url('f?p=' :APP_ID ':' :APP_PAGE_ID ':' :APP_SESSION); end; - Condition Type: Request = Expression 1 Expression 1 = LANG Copyright Apps Associates LLC. 5

6 Mehrsprachigkeit Sprachwechsel für den User in der Navigation Bar ermöglichen ist für jeden User auf jeder Seite ständig sichtbar Unter Shared Components Navigation Bar Entries neuen Eintrag mit folgenden Einstellungen erstellen: - Option: From Scratch - Type: Navigation to URL - Label: English - Target is a: Page in this application - Page: &APP_PAGE_ID. - Request: LANG - Set these Items: FSP_LANGUAGE_PREFERENCE - With these values: en Weiteren Eintrag für Deutsch Copyright Apps Associates LLC. 6

7 Mehrsprachigkeit Zwei Wege die Applikation zu übersetzen mit Hilfe einer XLIFF Datei mit Hilfe einer Übersetzungstabelle Copyright Apps Associates LLC. 7

8 Mehrsprachigkeit mit Hilfe einer XLIFF Datei XLIFF steht für XML Localization Interchange File Format zur Darstellung hierarchisch strukturierter Inhalts-Daten speziell für den verlustarmen Austausch von Übersetzungsdaten und den dazugehörigen Kontextinformationen Copyright Apps Associates LLC. 8

9 Mehrsprachigkeit mit Hilfe einer XLIFF Datei unter Shared Components Globalization Translat Application Map your primary language application to a translated application kann eine neue Applikation in einer anderen Sprache erstellt werden. - dazu eine freie Application ID und die gewünschte Sprache angeben für jeden zu übersetzenden Text der Applikation müssen Einträge im APEX Repository erstellet werden - unter Seed translatable test to translation repository unter Download XLIFF translation files from translation repository wird die XLIFF Datei runtergeladen - der gesamten Applikation - einzelner Seiten Copyright Apps Associates LLC. 9

10 Mehrsprachigkeit mit Hilfe einer XLIFF Datei diese XLIFF Datei übersetzen - Übersetzung zwischen <target> unter Upload and apply XLIFF translation files to translation repository wird die geänderte XLIFF Datei hochgeladen unter Publish translated applications wird die Übersetzung veröffentlicht Copyright Apps Associates LLC. 10

11 Mehrsprachigkeit mit Hilfe einer XLIFF Datei diese XLIFF Datei Copyright Apps Associates LLC. 11

12 Mehrsprachigkeit mit Hilfe einer Übersetzungstabelle erstellen einer Übersetzungstabelle (T_UEBERSETZUNG) - ID_Uebersetzung - Bezeichnung - EN (Englisch) - DE (Deutsch) Daten, für jeden zu übersetzenden Text der Applikation, in die Tabelle schreiben Copyright Apps Associates LLC. 12

13 Mehrsprachigkeit mit Hilfe einer Übersetzungstabelle auf jeder Seite der Applkation eine neue Region erstellen für jeden zu übersetzenden Text der Applikation ein Hidden Item in der neuen Region erstellen erstellen eines Prozesses mit folgenden Einstellungen: - Process Point: On Load - Before Header - Condition Type: none der Prozess schreibt abhängig vom Wert des Items FSP_LANGUAGE_PREFERENCE die deutschen oder die englischen Texte in die Hidden Items alle Namen der Items, Buttons, Regionen usw. sind vom Wert der jeweiligen Hidden Items abhängig zum Beispiel: das Item P2_SAL hat die Label-Einstellung: &P2_HIDDEN_SAL. weil das Item P2_HIDDEN_SAL je nach ausgewählter Sprache den Wert Sal oder Gehalt hat Copyright Apps Associates LLC. 13

14 Mehrsprachigkeit mit Hilfe einer Übersetzungstabelle diese XLIFF Datei Copyright Apps Associates LLC. 14

15 Mehrsprachigkeit Mehrsprachigkeit mit Hilfe einer XLIFF Datei APEX Standard Mittel geringer Aufwand Anpassungen im JavaScript aufwendiger vorteilhaft wenn eine Applikation in einer Sprache übersetzt werden soll Mehrsprachigkeit mit Hilfe einer Übersetzungstabelle relativ hoher Aufwand vorteilhaft bei Anwendungen, die in mehrere Sprachen übersetzt werden sollen oder bei denen sich Übersetzungen oft ändern User können die Übersetzungstabelle selber pflegen Copyright Apps Associates LLC. 15

16 Mandantenfähigkeit Virtual Private Database Do It Yourself Copyright Apps Associates LLC. 16

17 Virtual Private Database Virtual Private Database (VPD) = Fine Grained Access Control (FGAC) seit der Version Oracle8i Feature der Enterprise Edition unabhängig wie auf geschützte Tabellen zugegriffen wird (Anwendung, Web- Interface oder SQL * Plus) kontrolliert den Zugriff auf einzelne Zeilen oder Spalten auf Ebene der Tabelle Copyright Apps Associates LLC. 17

18 Virtual Private Database Beispiel: Ein Kunde kann nur seine Bestellungen in der Tabelle Bestellungen sehen, wenn er in der Tabelle Kunden eingetragen wurde. Tabelle Kunden customer_id cust_first_name cust_last_name 1 John Dulles 2 William Hartsfield Tabelle Bestellungen order_date order_total customer_id Copyright Apps Associates LLC. 18

19 Virtual Private Database Mit Column Relevance kann definiert werden, dass VPD nur angewendet wird, wenn eine kritische Spalte abgerufen wird. Beispiel: Der Kundenbetreuer mit dem account_mgr_id "149" kann alle Zeilen aus der Tabelle Kunden sehen, aber nicht die Kreditlimits. Sobald die Spalte credit_limit abgefragt wird, kann er nur seine eigenen Kunden sehen. cust_first_name cust_last_name account_mgr_id John Dulles 149 William Hartsfield 125 Edward Logan 149 Albert Lambert 134 cust_first_name cust_last_name credit_limit account_mgr_id John Dulles Edward Logan Copyright Apps Associates LLC. 19

20 Virtual Private Database Mit Column Hiding können öffentliche Informationen der Tabelle angezeigt werden. Vertrauliche Informationen werden verborgen. Beispiel: Der Kundenbetreuer mit dem account_mgr_id "149" kann alle Zeilen aus der Tabelle Kunden sehen, aber die Spalte credit_limit ist leer. Außer bei seinen eigenen Kunden. cust_first_name cust_last_name credit_limit account_mgr_id John Dulles Edward Logan William Hartsfield 125 Albert Lambert 134 Copyright Apps Associates LLC. 20

21 Virtual Private Database Einrichtung von VPD in APEX-Anwendungen Beispiel: Die Tabelle EMP soll geschützt werden. Zur Umsetzung einer mandantenfähigen Anwendung werden zunächst die Zugriffsregeln definiert. KING darf alle Informationen sehen JONES darf alle Informationen zur Abteilung 10 (ACCOUNTING) sehen SCOTT darf nur seinen eigenen Datensatz sehen Diese Privilegien werden in einer neuen Tabelle MY_USERS hinterlegt. create table my_users( userid varchar2(50), class varchar2(50), depts varchar2(50) ); insert into my_users values ( JONES','DEPTADM','10'); insert into my_users values ('KING','ADMIN',''); Copyright Apps Associates LLC. 21

22 Virtual Private Database Einrichtung eines Session Context, welcher beim Aufbau der Datenbanksitzung initialisiert werden muss. Im Session Context wird der Name des eingeloggten Nutzers, die Privilegien und die Abteilungen, für die die Privilegien gelten für die Dauer der Datenbanksitzung gespeichert. Mit folgendem Code wird der Session Context my_context erzeugt. Dieser darf nur durch das PL/SQL-Paket my_login_package geändert werden. create or replace context my_context using my_login_package; Hinweis Restriktive Ausführungsrechte an diesem Package keine Manipulation möglich, kein Aushebeln der VPD-Policies Privileg CREATE ANY CONTEXT Copyright Apps Associates LLC. 22

23 Virtual Private Database E create or replace package my_login_package is procedure set_context(p_userid in varchar2); end my_login_package; / create or replace package body my_login_package is procedure set_context(p_userid in varchar2) is v_class my_users.class%type := 'USER'; v_deptno my_users.depts%type := ''; begin for cl in (select class,depts from my_users where userid = p_userid) loop v_class := cl.class; v_deptno := cl.depts; end loop; dbms_session.set_context('my_context','class', v_class); dbms_session.set_context('my_context','deptno', v_deptno); dbms_session.set_context('my_context','userid', p_userid); end set_context; end my_login_package; / Copyright Apps Associates LLC. 23

24 Virtual Private Database anlegen der eigentliche Policy-Funktion liest den Session Context mit der SQL-Funktion SYS_CONTEXT aus erstellt eine SQL WHERE-Bedingung, die später von der Datenbank automatisch an jede SQL-Abfrage auf die Tabelle EMP angehängt wird. create or replace function my_policy( p_schema varchar2, p_object varchar2 ) return varchar2 is v_sql varchar2(32767); begin if sys_context('my_context','class') = 'ADMIN' then null; elsif sys_context('my_context','class') = 'DEPTADM' then v_sql := ' DEPTNO in ( ' sys_context('my_context','deptno') ')'; else v_sql := ' ENAME = ''' sys_context('my_context','userid') ''''; end if; return v_sql; end; Copyright Apps Associates LLC. 24

25 Virtual Private Database vor jedem SQL-Kommando wird die Policy-Funktion aufgerufen und die zusätzliche WHERE-Klausel zurückgegeben die SQL-Abfrage wird mit den zusätzlichen Einschränkungen ausgeführt dafür muss die Policy-Funktion zum Abschluss mit dem PL/SQL-Paket DBMS_RLS registriert werden begin DBMS_RLS.ADD_POLICY( object_schema => '[myschema]', object_name => 'EMP', policy_name => 'MY_EMP_POLICY', function_schema => '[myschema]', policy_function => 'MY_POLICY'); end; Copyright Apps Associates LLC. 25

26 Virtual Private Database VPD-Policy mit einer APEX-Anwendung nutzen völlig unabhängig vom verwendeten Authentifizierungsschema Wichtig: die Tabelle my_users muss die richtigen Usernamen enthalten Im Beispiel werden Nutzerkonten im APEX-Workspace verwendet. Das heißt es wurden im Administrationsbereich unter Manage Users and Groups Nutzerkonten für die User KING, JONES und SCOTT erstellt. Copyright Apps Associates LLC. 26

27 Virtual Private Database erstellen einer neuen Applikation mit einem Bericht auf die Tabelle EMP es werden keine Daten angezeigt, auch wenn man sich als KING (Admin) einloggt der Session Context wird beim Anmelden an der Anwendung noch nicht initialisiert Dazu unter Shared Components auf der rechten Seite auf Edit Definition klicken und in der Reiterkarte Security unter Daterbase Session folgenden Code eingeben. begin my_login_package.set_context (:APP_USER); end; Copyright Apps Associates LLC. 27

28 Virtual Private Database Ansicht: KING (Admin) Copyright Apps Associates LLC. 28

29 Virtual Private Database Ansicht: JONES (Deptadm) Ansicht: SCOTT Copyright Apps Associates LLC. 29

30 Virtual Private Database Vorteile keine redundante Programmierarbeit auch bei komplexen Berechtigungssystem sehr übersichtlich Zugriffsrechte sind völlig unabhängig von APEX gilt für jede andere Anwendung Nachteil nur für die Enterprise Edition Copyright Apps Associates LLC. 30

31 Do It Yourself Mandantenfähigkeit Do It Yourself für Standard Edition oder OracleXE Beispiel: Die Tabelle EMP soll geschützt werden. Zur Umsetzung einer mandantenfähigen Anwendung werden zunächst die Zugriffsregeln definiert. KING darf alle Informationen sehen JONES darf alle Informationen zur Abteilung 10 (ACCOUNTING) sehen SCOTT darf nur seinen eigenen Datensatz sehen Diese Privilegien werden in einer neuen Tabelle MY_USERS hinterlegt. Copyright Apps Associates LLC. 31

32 Mandantenfähigkeit Do It Yourself WHERE-Bedingung im Bericht selber bauen select empno, ename, job, mgr, hiredate, sal, comm, deptno from emp where case when (select class from my_users where userid = :APP_USER) = ADMIN then 1 when (select class from my_users where userid = :APP_USER) = DEPTADM and deptno = (select depts from my_users where userid = DEPTADM ) then 1 when :APP_USER not in (select userid from my useres) and ename = :APP_USER then 1 end = 1 Copyright Apps Associates LLC. 32

33 Virtual Private Database Vorteile unabhängig von der DB-Version Nachteil redundante Programmierarbeit wird schnell unübersichtlich Rechtesystem beschränkt sich nur auf die konkrete Anwendung Copyright Apps Associates LLC. 33

34 Fazit APEX bietet einige Unterstützung im Bereich Mehrsprachigkeit und Mandantenfähigkeit Viele Weg führen zum Ziel, man muss den richtigen für seine Anforderungen finden Copyright Apps Associates LLC. 34

35 Vielen Dank!