Home

Execution Server Benutzerhandbuch

Contents

1. e Abschnitt 2 6 Installation der Lizenz e Abschnitt 2 7 Konfiguration des Execution Servers Es ist nicht m glich eine ltere Version des Execution Server auf die aktuelle Version zu migrieren 2 1 Vorbereiten der Datenbankumgebung Der Visual Rules Execution Server unterst tzt bez glich der Datenbank im Wesentlichen zwei Betriebsmodi n mlich einen automatischen Modus und einen manuellen Modus Welcher Betriebsmodus passend ist h ngt haupts chlich von Ihren Sicherheitsanforderungen ab Im automatischen Modus ben tigt der Datenbankbenutzer Berechtigungen um die Struktur der Datenbank zu ndern Der automatische Modus ist nicht f r produktive Umgebungen geeignet ist aber dennoch wertvoll f r Evaluationszwecke da er den Systembetrieb stark vereinfacht Bei Verwendung des automatischen Modus wird empfohlen f r die Installation des Execution Server eine separate Datenbankinstanz bereit zu stellen Bei Verwendung des manuellen Modus m ssen die Datenbankschemata f r Mandanten manuell aufgesetzt werden F r Beispiele sehen Sie Abschnitt 2 1 1 1 Beispiel Oracle Datenbank und Abschnitt 2 1 2 1 Beispiel Oracle Datenbank 2 1 1 Automatischer Modus Bei Verwendung des automatischen Modus wird empfohlen f r die Installation des Execution Server eine separate Datenbankinstanz bereit zu stellen Im automatischen Modus wird ein Gro teil der administrativen Aufgaben vom Execution Server durchgef hr
2. Kapitel 4 Arbeiten mit der Webkonsole Klicken Sie bei der Ausfuhrung deren Statistik Sie herunterladen wollen auf das Symbol dh Das Symbol wird in der ersten Tabellenspalte nur angezeigt wenn bei der Ausf hrung eine Statistik erstellt wurde 3 Es ffnet sich ein Dialog zum Herunterladen der vrstatistic Datei Er erm glicht Ihnen das Speichern der Datei Das Aussehen des Dialoges ist abh ngig von Ihrem Web Browser Die heruntergeladene Statistik kann vom Visual Rules Modeler geladen und angezeigt werden Weiterf hrende Aufgaben Abschnitt 4 3 1 Anzeige der Ausf hrungen von Rule Services 4 4 Verwaltung bereitgestellter Bibliotheken In der Sicht Bibliotheken des Visual Rules Execution Servers k nnen Sie bereitgestellte Bibliotheken verwalten W hlen Sie in der Webkonsole den Eintrag Bibliotheken um diese Sicht zu ffnen Hier haben Sie folgende M glichkeiten e Abschnitt 4 4 1 Anzeige bereitgestellter Bibliotheken e Abschnitt 4 4 2 Filterung angezeigter Bibliotheken e Abschnitt 4 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek e Abschnitt 4 4 4 L schen einer bereitgestellten Bibliothek 4 4 1 Anzeige bereitgestellter Bibliotheken W hlen Sie in der Webkonsole den Eintrag Bibliotheken aus um die Sicht Bibliotheken zu ffnen Die ge ffnete bersichtsseite zeigt alle auf dem Visual Rules Execution Server bereitgestellten Bibliotheken an l Biblio
3. ber die Execution Server Webkonsole zugegriffen werden Weiterf hrende Konzepte e Abschnitt 3 1 2 Regelbibliothek e Abschnitt 3 1 3 Versionen von Regelbibliothek und Rule Service Weiterf hrende Arbeitsschritte e Abschnitt 3 2 1 Regeln festlegen die als Rule Service exportiert werden sollen e Abschnitt 4 2 5 Anzeige der WSDL Datei eines Rule Service 3 1 2 Regelbibliothek Um einen Rule Service im Visual Rules Execution Server zu verwenden muss das entsprechende Regelprojekt in eine sogenannte Regelbibliothek gepackt werden Regelbibliotheken sind JAR Dateien die den generierten Regelcode f r alle Regelmodelle die im Regelprojekt enthalten sind beinhalten siehe Abbildung 3 1 Regelprojekt Regelbibliothek und Rule Service Die Regelbibliothek beinhaltet somit die WSDL Datei und XML Schemas f r das Regelmodell das als Web Service exportiert wird es kann nur ein Regelmodell eines Regelprojekts als Rule Service exportiert werden die anderen Regelmodelle bleiben intern Die WSDL und XML Schema Dateien werden automatisch von Visual Rules erstellt wenn es eine Regelbibliothek paketiert Bosch Software Innovations 19 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services Rule Project XYZ Rule Library XYZ 1 0 0 RuleServiceA 1 0 0 Rule 1 PIE Input Rule Model A WSDL for A ae Rule Model B Rule 2 input Rule Code A mn Rule Code B Abbildung 3 1 Regelprojek
4. Ist eine der Grenzen nicht gesetzt wird dies als immer interpretiert Sind beide Grenzen nicht gesetzt dann ist ein Rule Service immer g ltig Der Hauptanwendungsfall sind Rule Services in unterschiedlichen Versionen die zu unterschiedlichen Zeiten g ltig sind Gibt es zum Beispiel ein Movie Ticket Pricing in Version 1 0 das ein g ltig bis auf 2008 12 31 gesetzt hat und es gibt ein weiteres in Version 2 0 dessen g ltig von auf 2009 01 01 gesetzt ist dann wird eine Anfrage mit einem effectiveDate auf einen Wert vor dem 2009 01 01 die Version 1 0 ausf hren und im anderen Fall die Version 2 0 Aus Gr nden der Abwartskompatibilitat werden weiterhin zwei spezielle Metadaten n mlich effectiveFrom und effectiveTo unterst tzt Jeder Wert repr sentiert ein Datum und folgt dem Format yyyy mm dd Zu beachten ist dass diese Metadaten nur verwendet werden wenn weder g ltig von noch g ltig bis gesetzt sind Bosch Software Innovations 52 58 Kapitel 6 Arbeiten mit Metadaten 6 2 1 2 Eine WSDL durch Angabe von Metadata abholen Der Execution Server erlaubt es eine WSDL f r einen Rule Service durch die Angabe von Metadaten abzuholen Die daf r benutzte URL hat die Form http lt server gt lt port gt lt context name gt services lt tenant id gt wsdl und Metadaten Elemente werden als Parameter angef gt Die akzeptierten Werte h ngen von der Implementierung des Metadata Mapper ab Im folgenden Beispiel wird eine Standard
5. Klicken Sie auf das Symbol des Rule Service dessen WSDL Datei angezeigt werden soll 3 Die WSDL Datei wird im Web Browser ge ffnet Falls Sie die Detailseite eines Rule Service ge ffnet haben k nnen Sie auch dort die Anzeige der WSDL Datei veranlassen WSDL anzeigen im oberen Bereich der Detailseite Klicken Sie auf 2 Die WSDL Datei wird im Web Browser ge ffnet Die URL f r die WSDL lautet http lt server gt lt port gt lt context name gt services lt tenant id gt lt rule model gt lt version gt lt rule model gt wsdl Das WSDL importiert zus tzliche XML Schema Dateien welche wiederum andere Schema Dateien importieren k nnen Alle diese Ressourcen k nnen vom Execution Server heruntergeladen werden Sie k nnen diese WSDL f r jeden Web Service Client verwenden um ein Regelmodell aufzurufen Weiterf hrende Konzepte e Abschnitt 5 1 6 Abbildung des Regelmodells auf WSDL 4 2 6 Herunterladen eines Rule Service Sie k nnen einen Rule Service als Visual Rules Archiv herunterladen Ein Visual Rules Archiv enth lt neben dem Rule Service auch noch alle weiteren zur Serviceausf hrung erforderlichen Bibliotheken und kann auf einem anderen Visual Rules Execution Server hochgeladen werden 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 ffnen Sie die Detailseite des Rule Service den Sie herunterladen wollen indem Sie auf d
6. die Regel und die Version lt pricing VRResponse xmlns vr http www visual rules com xmlns pricing http www visual rules com vrpath Movie 20Ticket3 320Pricing Pricing gt lt output gt lt price gt 7 lt price gt lt output gt lt vr trace gt lt ruleModel gt Movie Ticket Pricing lt ruleModel gt lt rulePath gt Movie Ticket Pricing Pricing lt rulePath gt lt version gt 1 0 1 lt version gt lt vr trace gt lt pricing VRResponse gt Wenn irgendetwas fehlschl gt erhalten Sie eine SOAP Fehlernachricht Die Fehlernachricht enth lt unter anderem einen Java Stack Trace f r die Fehlerdiagnose Weiterf hrende Konzepte e Abschnitt 5 1 1 Authentifizierung f r eine Rule Service Anfrage e Abschnitt 5 1 2 Format der Rule Service Anfrage e Abschnitt 5 1 3 Format der Rule Service Antwort Weiterf hrende Arbeitsschritte e Abschnitt 4 2 5 Anzeige der WSDL Datei eines Rule Service Bosch Software Innovations 50 58 Kapitel 6 Arbeiten mit Metadaten Kapitel 6 Arbeiten mit Metadaten 6 1 Konzept Metadaten Metadaten werden durch einfache Schl ssel Wert Paare abgebildet und k nnen zu jedem Rule Service hinzugef gt werden In erster Linie dienen sie als erweiterte Informationen f r ein Regelmodell Beispielsweise k nnte dies der Name eines bestimmten Algorithmus sein der f r eine Berechnung eingesetzt wird oder auch einfach nur der Autor der Regeln Wenn Sie in einem multi
7. hlungen Listen Mengen und Maps lt pricing VRRequest xmlns vr http www visual rules com xmlns pricing http www visual rules com vrpath Movie 20Ticket3 320Pricing Pricing gt lt Falls weggelassen wird Visual Rules Execution Server die letzte Version verwenden gt lt vr target gt lt version gt 1 0 1 lt version gt lt vr target gt lt Spezifiziert optionale Einstellungen fur die Ausf hrung eines Rule Service gt lt vr configuration gt lt Eine requestId kann spezifiziert werden um die Statistik auf dem Server zu identifizieren Falls weggelassen wird eine eindeutige ID generiert gt lt requestId gt uniqueRequestId lt requestId gt lt Der Name der aktiven Konfiguration active configuration name der w hrend der Ausf hrung verwendet werden soll Wird dieser weggelassen wird der Standard verwendet gt lt activeConfigurationName gt test lt activeConfigurationName gt lt F r ltere Aufrufer kann anstatt activeConfigurationName auch binding noch verwendet werden gt lt Ebenso sollte dies f r Rule Services verwendet werden die mit einer Version vor 5 2 gebaut wurde gt lt binding gt test lt binding gt lt Der verwendete Statistik Level M gliche Angaben sind high medium und low gt lt Falls weggelassen werden keine Statistiken aufgezeichnet und sind auch nicht herunterladbar gt lt sessionStatistics gt lt level gt medium lt level g
8. ig http www visual rules com und wird in den folgenden Beispielen verwendet Die nachfolgende Beschreibung bezieht sich auf die aktuelle Version Bei der Verwendung von migrierten Rule Services ist die Web Service Schnittstelle immer noch richtig enth lt aber nicht alle hier beschriebenen Elemente Das VRRequest Element kann ein optionales target Element beinhalten mit dem eine spezifische Version des aufzurufenden Regelmodells angeben werden kann Wenn das target Element nicht vorhanden ist ist es das Standardverhalten des Execution Server die neueste Version des Regelmodells aufzurufen Bosch Software Innovations 43 58 Kapitel 5 Aufrufen von Regeln im Execution Server Als nachstes kommt das configuration Element dass Einstellungen zur Ausfuhrung des Rule Services spezifiziert und ebenfalls optional ist Alle Elemente haben eine definierte Reihenfolge Ist das target Element spezifiziert so muss es das erste Element im VRRequest sein und das configuration Element kame als nachstes wenn es spezifiziert ist SchlieBlich werden die Eingabedaten der Regel in einem Element input spezifiziert Die Elemente in diesem Abschnitt haben den gleichen Namen wie die Eingaben einer Regel Der Wert jedes Datenelements wird innerhalb dieser Elemente spezifiziert Der Abschnitt 5 1 5 XML Repr sentation von Datentypen beschreibt die XML Repr sentation f r diese Werte abh ngig von den Datentypen einschlie lich Strukturen Aufz
9. 58 58
10. Bibliotheken Sie anzeigen m chten indem Sie auf den zugeh rigen Link klicken Klicken Sie auf Erforderliche Bibliotheken worauf die Seite Erforderliche Bibliotheken ge ffnet wird Die Seite Erforderliche Bibliotheken zeigt alle Bibliotheken an die dieser Rule Service ben tigt Eine genauere Beschreibung finden Sie in Abschnitt 4 4 1 Anzeige bereitgestellter Bibliotheken 4 3 Verwaltung der Ausf hrungen von Rule Services In der Sicht Ausf hrungen des Visual Rules Execution Servers k nnen Sie Ausf hrungen von Rule Services verwalten W hlen Sie in der Webkonsole den Eintrag Ausf hrungen um diese Sicht zu ffnen Hier haben Sie folgende M glichkeiten e Abschnitt 4 3 1 Anzeige der Ausf hrungen von Rule Services e Abschnitt 4 3 2 Filterung angezeigter Ausf hrungen e Abschnitt 4 3 3 L schen von Ausf hrungen von Rule Services Abschnitt 4 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service Bosch Software Innovations 33 58 Kapitel 4 Arbeiten mit der Webkonsole 4 3 1 Anzeige der Ausf hrungen von Rule Services W hlen Sie in der Webkonsole den Eintrag Ausf hrungen aus um die Sicht Ausf hrungen zu ffnen Die ge ffnete bersichtsseite zeigt die Aufrufe aller auf dem Visual Rules Execution Server bereitgestellten Rule Services an Ausf hrungen bersicht Request ID Filter anwenden Filter zur cksetzen Erweitert gt gt
11. Oberfl che auf die Benutzer mit Standard Webbrowsern zugreifen k nnen Wurde eine Regelbibliothek und ihre Abh ngigkeiten bereitgestellt so wird daraus ein sogenannter Rule Service erzeugt welcher als Web Service mittels Standard Web Service Clients aufgerufen werden kann Jede Ausf hrung eines Rule Service kann eine Statistik erzeugen welche im Visual Rules Modeler angezeigt werden kann Zur Persistierung von Statistiken und Bibliotheken wird ein relationales Datenbankverwaltungssystem RDBMS verwendet W hrend all dieser Schritte ist eine Authentifizierung notwendig und Zugriffe sind durch Berechtigungen eingeschr nkt welche vom Identity Management verwaltet werden Bei alledem unterst tzt der Execution Server Mandantenf higkeit 1 2 Identity Management Das Identity Management IM ist eine Benutzerverwaltungskomponente Ihre Bedienoberfl chen k nnen von anderen Systemen verwendet werden um ihre Benutzer zu identifizieren und zu authorisieren Der wesentliche Anwendungsbereich des IM in einer Kundenanwendung besteht in der Verwaltung von Berechtigungen Bosch Software Innovations 1 58 Kapitel 1 Einleitung Sie k nnen das Identity Management in der Webkonsole ber den Tab Benutzerverwaltung erreichen wenn n tig Weitere Informationen zum Identity Management finden Sie in der zugeh rigen Dokumentation 1 3 Berechtigungs Konzept Das Berechtigungs Konzept des Visual Rules Execution Server basiert auf den folgen
12. der Sicht Wartung k nnen Lizenzen hinzugef gt werden Es gibt zwei M glichkeiten wie der Server eine Lizenzdatei finden kann 1 Die Lizenzdatei liegt im Ordner visualrules6 im Benutzerverzeichnis des Benutzers der den Server ausf hrt Dort wird standardm ig nach Lizenzdateien gesucht 2 Es kann ein Dateipfad zur Lizenzdatei mit der Einstellung license file angegeben werden Dies wird nur ben tigt wenn sich keine Lizenzdatei im Standardverzeichnis befindet Lesen Sie Abschnitt 2 7 Konfiguration des Execution Servers um mehr Details dar ber zu erhalten wie dies bewerkstelligt werden kann Im Fall einer ung ltigen oder fehlenden Lizenz wird nach der Anmeldung automatisch zur Lizenz Verwaltung weitergeleitet Ebenso wird eine Fehlermeldung in das Log geschrieben Dort finden sich ebenfalls Informationen zu den Stellen an denen der Execution Server nach Lizenzen sucht Daf r muss Logging eingeschalten und auch f r den Level INFO konfiguriert sein 2 7 Konfiguration des Execution Servers Nach erfolgreicher Installation des Execution Servers ist keine weitere Konfiguration notwendig Dieses Kapitel beschreibt wie Sie den Execution Server konfigurieren falls Sie die Konfiguration zu einem sp teren Zeitpukt ndern wollen oder Einstellungen vornehmen wollen die nicht im Installations Wizard m glich sind z B f r spezielle Anforderungen in Produktionsumgebungen 2 7 1 Execution Server Home Das Execution Server Home
13. een ee ee 44 5 1 4 Generische Rule Service Anfragen ccccescesceeceeceensenseeseenseeseessesseeseeasesseeseeaseeseeaeessesseeanenss 45 5 1 4 1 Generisches VRRequest Format ccccccec cece ence eeeeeceeeeeeeeseeseeesseeeeeesseeeeesseeeeeteeseeeeeeees 45 5 1 5 XML Repr sentation von Datentypen ccc cc cccc cece ncceeceeeeneeeeeeeenseeeeeeeeseeeeeeeeseeeeeeeenseeeeeeeenaes 46 dig es Ine EVDEN sencesccxsntascewencose cuss ee ee 46 5 1 5 2 T T E a were en urteilen erlassen 47 5 153 LISte il WMG Menden een ee esse 48 BEA WIDE ee ee ee re ee ee era een 48 51 53 3 UI Za UN PCN ee ea E E E E 48 5 1 6 Abbildung des Regelmodells auf WSDL ccc cece ccc ccc ence ent eenteeceeeceeeceeeseeeseeeeeseeeeeesseeseeesqeeges 49 5 2 PVCS SC MMW wesen ee ee ee ee ee 49 5 2 1 Aufr fen eines Rule SEVICE ee ee ee ee ea euere 49 6 Arbeiten mit Metadaten ccccccsccccscccccccccccccccccccccccccccccccccccccccccccccccccccess DL 6 1 Konzept Metadaten c ccc cece cece cece ceeceeenceeenseeeneeeeseeeesseeesseeesseeeseeeseeesteeeseeeeeeeessseesseeesseeenses 51 6 2 Wetadaten Ce EE esee E E T E RETR 51 6 2 1 Zuordnung von Metadaten zu Rule Services sssssssssssssssesererererererererererererererererererereeeeeeeeereeee 52 B 2 1 2 Standard Metadata Mapper een ee EEE ne 52 6 2 1 2 Eine WSDL durch Angabe von Metadata abholen cccccescenceeceeseeeseeseeseeeseeseeaeeesesseea
14. erscheint nach erfolgreicher Operation ein Dialog in dem alle hinzugef gten Rule Services und Bibliotheken aufgelistet sind Hinzugef gte Rule Services und Bibliotheken gt Rule Services a Movie Ticket Pricing movie ticket pricing 0 0 1 5NAPSHOT Bibliotheken Q xmibeans org apache xmibeans 2 4 0 i commons logging commons logging 1 0 3 7 visualrules runtime de visualrul es 5 2 0 activation javex activation 1 1 stax stax 1 2 0 i commons collections commons collections 3 2 1 1 r F i 1 mn S Weiterf hrende Konzepte e Abschnitt 3 1 4 Visual Rules Archiv 4 2 4 L schen eines bereitgestellten Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 Klicken Sie auf das Symbol x des Rule Service den Sie l schen m chten Dieses Symbol ist nur verf gbar wenn Sie ausreichende Berechtigungen haben Der Standardbenutzer Admin hat diese Erlaubnis Siehe auch Abschnitt 1 3 Berechtigungs Konzept 3 Es ffnet sich ein Dialog in dem Sie best tigen k nnen dass Sie die Aktion wirklich durchf hren m chten Klicken Sie zur Best tigung auf die Schaltfl che Bosch Software Innovations 29 58 Kapitel 4 Arbeiten mit der Webkonsole 4 2 5 Anzeige der WSDL Datei eines Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 3
15. executionserverDs 2 2 2 Vorbereiten eines WebSphere Application Servers Um einen WebSphere Application Server vorzubereiten f hren Sie folgende Schritte durch 1 Konfigurieren Sie die Anmeldedaten f r die Datenbank als JAAS J2C Authentication Data Alias 2 Konfigurieren sie den f r die Datenbank notwendigen herstellerspezifischen JDBC Provider 3 Konfigurieren Sie die Datenbank als JDBC Datenquelle Benutzen Sie hierbei die folgenden Werte e Der JNDI Name ist jdbc executionserverDS e In den Sicherheitseinstllungen spezifizieren Sie den Authentication Alias f r container managed sowie und component managed Authentication Alias e In den Sicherheitseinstllungen setzen Sie die Mapping Konfiguration f r den Alias auf DefaultPrincipalMapping 4 Speichern Sie die Konfigurations nderungen und starten Sie den WebSphere Server neu um den Authentication Alias effektiv werden zu lassen 2 2 3 Vorbereiten eines JBoss Application Servers Um einen JBoss Application Server vorzubereiten konfigurieren Sie die Datenbank als eine JDBC Daten Resource mit dem JNDI Namen java jboss jdbc executionserverDs Bosch Software Innovations 9 58 Kapitel 2 Aufsetzen des Execution Servers 2 3 Deployment des Execution Servers Der Execution Server wird als gepacktes Web Archiv WAR ausgeliefert und kann installiert werden indem er auf einem Application Server bereitgestellt wird Die grundsatzliche Vorgehensweise um den Execution Serv
16. for the tenant the schema is created when a user logs into the Execution Server for a tenant for the first time if no schema exists for the tenant i e a schema named according to the tenants technical name prefixed with VRS_ grant Create user to lt username gt grant create database object privileges in all schemata in the database so that the Execution Server is able to automatically create its database objects in the tenant schemata grant create any table to lt username gt grant create any view to lt username gt grant create any index to lt username gt grant create any sequence to lt username gt grant create any trigger to lt username gt grant CRUD privileges in all schemata so that the Execution Server is able to perform regular database operations across all tenant schemata grant select any table to lt username gt grant insert any table to lt username gt grant update any table to lt username gt grant delete any table to lt username gt Beispiel 2 1 Automatischer Modus in Oracle Datenbank 2 1 2 Manueller Modus Bei Verwendung des manuellen Modus mussen die Datenbankschemata fur Mandanten manuell aufgesetzt werden Siehe Abschnitt 2 5 Manuelles Aufsetzen der Mandanten Der manuelle Betriebsmodus setzt voraus dass ein Datenbankadministrator den Benutzer der vom Execution Server f r die Datenbankverbindung verwendet wird anlegt und konfiguriert Bosch Softwar
17. hren m chten Klicken Sie zur Best tigung auf die Schaltfl che ei J 4 2 8 3 Editieren von Metadatennamen und werten An den zus tzlichen Metadaten lassen sich der Name und der Wert nachtr glich editieren 1 Klicken Sie auf den Metadatennamen bzw wert um die Eingabe direkt in der grafischen Darstellung vorzunehmen 2 Geben Sie den Metadatennamen bzw wert ein 3 Klicken Sie auf die Schaltfl che Speichern um die nderungen zu speichern Weiterf hrende Konzepte Abschnitt 6 1 Konzept Metadaten 4 2 9 Anzeige der Ausf hrungen eines Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 ffnen Sie die Detailseite des Rule Service dessen Ausf hrungen Sie sehen wollen indem Sie auf den zugeh rigen Link klicken dj Ausf hrungen Klicken Sie auf worauf die Ausf hrungsseite ge ffnet wird Die Ausf hrungsseite zeigt alle Aufrufe dieses Rule Service an Zudem gibt es den Abschnitt Filter Ausf hrungen in dem Sie die Anzeige der Ausf hrungen einschr nken k nnen Eine genauere Beschreibung finden Sie in Abschnitt 4 3 1 Anzeige der Ausf hrungen von Rule Services 4 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 ffnen Sie die Detailseite des Rule Service dessen erforderliche
18. ist ein Ordner der f r die Speicherung von Daten und Konfigurationen des Execution Server benutzt wird Der Ordnername entspricht normalerweise dem Kontext Root den Sie beim Deployment der Execution Server Anwendung gew hlt haben Er befindet sich in einem Verzeichnis visualrules im Benutzerverzeichnis des Betriebssystembenutzers der den Execution Server startet Bei Bedarf wird der Ordner automatisch angelegt Es ist ebenfalls m glich ein anderes Verzeichnis als lt user home gt visualrules zu verwenden durch das Setzen einer System Property f r die Java VM welche den Applikations Server betreibt Der Schl ssel ist visualrules executionserver home und der Wert ist ein g lter Dateipfad der auf ein schreib und lesbares Verzeichnis zeigt Beispielsweise k nnte das folgenderma en aussehen wenn der Wert per Kommandozeile angegeben wird Dvisualrules executionserver home D my es home Bosch Software Innovations 16 58 Kapitel 2 Aufsetzen des Execution Servers Tabelle 2 1 Execution Server Home Inhalt config executionserver properties Die Execution Server Konfigurationsdatei config vr_logging config Konfigurationsdatei fur die Laufzeit Protokollierung logs Ordner der die Protokoll Dateien des Execution Servers enth lt 2 7 2 Execution Server Konfiguration Der Execution Server wird durch den Installationsassistenten installiert und konfiguriert Alle Einstellungen werden in einer Datei im Execution Server Home Verzei
19. lt soapenv Envelope gt lt soapenv Header xmlns wsse http docs oasis open org wss 2004 01 oasis 200401 wss wssecurity secext 1 0 xsd gt lt wsse Security soapenv mustUnderstand 1 gt lt wsse UsernameToken gt lt tenant gt BOSCH lt tenant gt lt wsse Username gt USER lt wsse Username gt lt wsse Password Type http www visual rules com wss PasswordText gt PASSWORD lt wsse Password gt lt wsse UsernameToken gt lt wsse Security gt lt soapenv Header gt lt soapenv Body gt lt soapenv Body gt lt soapenv Envelope gt Beispiel 5 1 SOAP Envelope mit Header zur Authentifizierung Weiterf hrende Konzepte e Abschnitt 1 2 Identity Management 5 1 2 Format der Rule Service Anfrage Das u erste Element einer Anfrage an eine Regel wird VRRequest genannt Der Namespace dieses Elements reflektiert die Position der Regel im Regelmodell und in der Regelpakethierarchie Diese Information wird vom Execution Server verwendet um die Anfrage an das gew nschte Regelmodell und an die darin gew nschte Regel weiterzuleiten Der vollst ndige Namespace f r den URI des VRRequest besteht aus dem Pr fix der im Regelmodell konfiguriert werden kann gefolgt vom Segment vrpath gefolgt von dem Pfad der Regel die aufgerufen werden soll Der Pfad besteht aus dem Namen des Regelmodells desweiteren den Namen der Regelpakete und schliesslich des Namens der Regel selbst Der Namespace URI Pr fix ist standardm
20. m chten indem Sie auf den zugeh rigen Link klicken Auf der Detailseite werden im Abschnitt bersicht allgemeine Eigenschaften der Bibliothek angezeigt bersicht Gruppen ID de visualrules Name visualrules runtime Version 3 0 0 5MAPSHOT Bereitgestellt von Admin Admin Bereitgestellt am 06 02 2013 15 01 Bosch Software Innovations 37 58 Kapitel 4 Arbeiten mit der Webkonsole Neben den Eigenschaften werden auf dieser Seite im Abschnitt Rule Services alle Rule Services angezeigt die diese Bibliothek verwenden Rule Services Rule Service Artefakt ID Version Bereitgestellt von Bereitgestellt am X 8 Coffee vending machine Coffee vending 0 0 1 SNAPSHOT Admin Admin 06 02 2013 15 01 Seite 1 von1 amp Eine genauere Beschreibung der Tabelle finden Sie in Abschnitt 4 2 1 Anzeige bereitgestellter Rule Services 4 4 4 L schen einer bereitgestellten Bibliothek 1 W hlen Sie in der Webkonsole den Eintrag Bibliotheken aus um die Sicht Bibliotheken zu ffnen 2 ffnen Sie die Detailseite der Bibliothek die Sie l schen wollen indem Sie auf den zugeh rigen Link klicken 3 Klicken Sie auf die Schaltfl che Ungenutzte Bibliothek l schen Diese Schaltfl che ist nur dann aktiviert wenn diese Bibliothek von keinem anderen Rule Service mehr ben tigt wird und wenn Sie ausreichende Berechtigungen haben Der Standardbenutzer Admin hat diese Erlaubnis Siehe auch Abschnitt 1 3 Berechtigungs Konze
21. signalisieren ob es sich bei der aktuellen Position um eine m gliche amp oder unerlaubte D Position handelt Zus tzlich zeigen Pfeile die genaue m gliche Position an 3 Haben Sie die gew nschte Spaltenposition erreicht dann lassen Sie die Maustaste los Die Spalte wird nun dorthin verschoben 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge 1 Klicken Sie auf die Spalten berschrift um die zugeh rige Eigenschaft als Sortierkriterium festzulegen Das Symbol bedeutet dass aufsteigend sortiert wird 2 Falls Sie eine absteigende Sortierreihenfolge m chten dann klicken Sie erneut auf die Spalten berschrift Das Symbol bedeutet dass absteigend sortiert wird Alternativ k nnen Sie die Sortierreihenfolge auch ber das Kontextmen der Spalte festlegen d Bewegen Sie die Maus ber die Spalten berschrift und klicken Sie auf a um das Kontextmen zu ffnen 2 A 7 i Selektieren Sie den Men punkt Z4 Aufsteigend sortieren Sr A Absteigend sortieren 4 7 Filterung angezeigter Objekte Durch die Anwendung eines Filters kann die Zahl der angezeigten Objekte in einer Tabelle reduziert und der Fokus auf bestimmte Objekte gelegt werden Bosch Software Innovations 40 58 Kapitel 4 Arbeiten mit der Webkonsole 4 7 1 Eingabe von Filterkriterien Filterkriterien werden in einem eigenen Abschnitt der Benutzeroberflache spezifiziert Der Filterabschnitt befindet sich meist vor der Tabelle a
22. sollen F r solche Zwecke kann ein Rule Service deaktiviert werden wodurch dieser nicht mehr aufgerufen werden kann F r Aufrufer ist es dann nicht unterscheidbar ob der Rule Service gel scht wurde oder nur deaktiviert wurde 3 1 5 2 G ltig von und G ltig bis Diese Werte werden vom Standard Metadata Mapper in einer generischen Rule Service Anfrage verwendet Beim Einsatz eines benutzerdefinierten Metadata Mappers wie in Abschnitt 6 2 1 3 Benutzerdefinierter Metadata Mapper beschrieben kann das ebenfalls genutzt werden 3 1 5 3 Name der aktiven Konfiguration Active Configuration Name Im Visual Rules Modeler k nnen mehrere Konfigurationen f r die Regelausf hrung auf einem Regelmodell definiert werden Diese k nnen beispielsweise in der Visual Rules Rule Execution API verwendet werden um Implementierungen von Aktionen auszutauschen Mehr Informationen zu diesem Thema finden sich im Java Integration Handbuch Bosch Software Innovations 21 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services Der Execution Server bietet Aufrufern ebenfalls die Moglichkeit den Namen der zu verwendenden Konfiguration anzugeben Im Englischen und den technischen Schnittstellen wird hierfur der Begriff active configuration name verwendet Zu beachten ist hierbei dass diese Angabe im Aufruf in lteren Versionen der Visual Rules Rule Execution API und im Execution Server als binding bezeichnet wird Jeder Rule Service kann konf
23. um ber den Execution Server mit anderen Visual Rules Produkten zu arbeiten 1 3 2 1 Administrator Die Benutzerrolle Administrator repr sentiert einen Administrator Ihm sind standardm ig alle Execution Server Berechtigungen zugewiesen 1 3 2 2 Deployer Die Benutzerrolle Deployer repr sentiert einen Benutzer mit allen relevanten Execution Server Berechtigungen zum Bereitstellen von Rule Services und Bibliotheken Dies sind die Folgenden Visual Rules Archiv bereitstellen e Regel Bibliothek bereitstellen e Regel Bibliothek l schen 1 4 Mandantenfahigkeit und Konzept der Datentrennung 1 4 1 Mandantenfahigkeit Die Mandantenf higkeit erlaubt die Nutzung einer einzelnen Execution Server Instanz und zugeh riger Datenbank durch mehrere Mandanten Der Execution Server stellt sicher dass die Daten eines jeden Mandanten nur durch die Benutzer des besitzenden Mandanten zugreifbar sind Im Gegensatz zu dem Ansatz jedem Mandanten eine eigene Instanz zur Verf gung zu stellen erm glicht Mandantenf higkeit einen effizienteren Umgang mit Ressourcen wie z B Hardware oder Virtualisierungsinfrastrukturen und Lizenzen 1 4 2 Konzept der Datentrennung Das Konzept der Datentrennung des Visual Rules Execution Server beinhaltet folgende Aspekte e Abschnitt 1 4 2 1 Trennung der Mandantendaten e Abschnitt 1 4 2 2 Trennung der Anwendungsdaten Zu den Gr nden f r die Datentrennung siehe Abschnitt 1 4 2 3 No
24. verschiedene Instanzen des Execution Servers Die sogenannten Namensr ume sind lediglich Pr fixe welche den Namen der Datenbankobjekte einer Anwendung vorangestellt sind Das folgende Beispiel zeigt dies f r die Verwendung der Tabelle EP_VERSION Tabelle 1 2 Trennung der Anwendungsdaten Applikationsname Namensraum Pr fix DB Objektname Pr fix _ DB Objektname Execution Server 1 ES1 EP_VERSION ES1_EP_VERSION Execution Server 2 ES2 EP_VERSION ES2_EP_VERSION Dieses Muster wird ber alle betroffenen Schemata globale Verwaltungsschemata und Mandantenschemata hinweg auf alle Datenbankobjekte angewandt die spezifisch sind f r eine Anwendunssinstanz Die folgende Abbildung zeigt wie die Namensr ume eine Art virtueller anwendungsspezifischer Schemata ber mehrere tats chliche Datenbankschemata aufspannen Bosch Software Innovations 4 58 Kapitel 1 Einleitung Execution Server Instance 2 Execution Server Instance 1 e Gr 1 4 2 3 Notwendigkeit und Vorteile der Datentrennung Herk mmliche Mandantenf higkeit setzt voraus dass die Anwendung die Daten der Mandanten trennt und sicherstellt dass kein Mandant auf die Daten anderer Mandanten zugreifen kann Dies kann auf verschiedene Arten geschehen z B durch eine zus tzliche Spalte in jeder Tabelle welche die ID des Mandanten enth lt Der Ansatz des Visual Rules Execution Server hat folgende Vorteile e Mandantendaten k nnen physikalisch getrennt gespeichert
25. verwalten 4 1 Aufruf der Webkonsole Nach erfolgreicher Installation des Execution Servers kann die Webkonsole in einem Web Browser aufgerufen werden Sie ist unter der Adresse http lt server gt lt port gt lt context name gt erreichbar wobei die Werte meist durch den Application Server vorgegeben sind Bei einer Bereitstellung auf einem Apache Tomcat unter Verwendung dessen Standardkonfiguration lautet die Adresse beispielsweise http localhost 8080 executionserver 6 x y wobei x und y Platzhalter f r die Versionsnummern aus dem Dateinamen der WAR Datei des Execution Servers darstellen Es erscheint die folgende Startseite zur Anmeldung L Deutsch Hilfe Visual rules Cr Execution Server Willkommen beim Visual Rules Execution Server Benutzername ki Passwort Mandant Copyright 2004 2013 Bosch Software Innovations GmbH All rights reserved Version 6 0 0 SNAPSHOT Wenn beim Start des Execution Servers keine gultige Lizenz zur Verfugung stand erscheint die Startseite mit einer entsprechenden Fehlermeldung Weiterf hrende Aufgaben e Abschnitt 2 6 Installation der Lizenz 4 1 1 Einstellung einer bestimmten Sprache Die Seiten der Webkonsole werden in der Sprache angezeigt die Sie als bevorzugte Sprache in Ihrem Web Browser eingestellt haben Sollte diese Sprache von der Webkonsole noch nicht unterst tzt werden dann werden die Seiten in Englisch angezeigt Es ist m glich expliz
26. werden indem verschiedene Tablespaces verwendet werden e Ressourcen k nnen effizient genutzt werden da mehrere Anwendungen der gleichen Art in einem einzelnen Mandantenschema installiert sein k nnen e Eine Schema Migration ist f r eine bestimmte Anwendung eines bestimmten Mandanten m glich z B w hrend einer Aktualisierung der Anwendung e Die Datenzusammensetzung eines einzelnen Mandanten betrifft nicht notwendigerweise andere Mandanten 1 5 Distribution Der Visual Rules Execution Server ist als Web Archive WAR gepackt und wird als Bestandteil einer Distribution ausgeliefert Die Distribution ist ein Zip Archiv und enth lt folgendes Tabelle 1 3 Distributions Inhalt api source Quellcode des Application Programming Interface API Hilfreich sofern ein benutzerdefinierter Metadaten Mapper f r den Execution Server entwickelt wird legalnotice Rechtliche Informationen zu Lizenzen und Verwendung von Bibliotheken von Drittanbietern 1 5 1 Maintenance Tool Das Maintenance Tool ist ein Kommandozeilenprogramm f r den Visual Rules Execution Server um Wartungsaufgaben auszuf hren Es kann verwendet werden um Tabellen in einem leeren Datenbank Schema anzulegen Es ist Bestandteil der Execution Server Distribution und da es als Zip Archiv paketiert ist muss es als Bosch Software Innovations 5 58 Kapitel 1 Einleitung erstes entpackt werden damit es verwendet werden kann Zum Aufruf des Programms dient entweder
27. 2 Ausf hrungen l schen Datum Rule Service Version Regelpfad Ausf hrungszeit ms Request ID x dh 06 02 2013 16 12 Movie Ticket 0 0 1 SNAPSH Movie Ticket Pricing Pricing 2812 95ea7ec6 706f 11e2 b06c b9c84d94f72b x 06 02 2013 16 13 Movie Ticket 0 0 1 SNAPSH Movie Ticket Pricing Pricing 31 c2d843e7 706f 11e2 b06c b9c84d94f72b Seite 1 voni amp Standardm ig werden folgende Eigenschaften der Ausf hrungen angezeigt e Ausf hrungszeitpunkt e Name des aufgerufenen Rule Service e Version des Rule Service e Regelpfad e Ausfuhrungszeit e Request ID Sie k nnen das Layout der angezeigten Eigenschaften beeinflussen indem Sie beispielsweise e bestimmte Eigenschaften ein bzw ausblenden Neben den standardm ig angezeigten Eigenschaften gibt es noch weitere Eigenschaften wie ID Artefakt ID und Gruppen ID die eingeblendet werden k nnen siehe Abschnitt 4 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalten verschieben siehe Abschnitt 4 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge Falls bei der Ausf hrung eines Rule Service eine Statistik erstellt wurde wird in der ersten Tabellenspalte das Symbol dh angezeigt Sind Sie nur an den Aufrufen Ausf hrungen eines Rule Service interessiert dann k nnen Sie sich diese Ansicht ber die Detailseite des Rul
28. Bibliotheken eines Rule Service 4 2 1 Anzeige bereitgestellter Rule Services W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen Die ge ffnete bersichtsseite zeigt alle auf dem Visual Rules Execution Server bereitgestellten Rule Services an Rule Services bersicht Name Filter anwenden Filter zur cksetzen Erweitert gt gt Service s aus Archiv hinzuf gen Rule Service Artefakt ID Version Bereitgestellt von Bereitgestellt am gt a a Coffee vending machine Coffee vending 0 0 1 SNAPSHOT Admin Admin 06 02 2013 15 01 wah p Movie Ticket Pricing Movie Ticket Pri 0 0 1 SNAPSHOT Admin Admin 06 02 2013 15 24 ld 4 Seite 1 voni gt i Standardm ig werden folgende Eigenschaften der Rule Services angezeigt Aktiviert oder deaktiviert Ei e Version e Artefakt ID e Bereitgestellt von e Bereitgestellt am Sie k nnen das Layout der angezeigten Eigenschaften beeinflussen indem Sie beispielsweise e bestimmte Eigenschaften ein bzw ausblenden Neben den standardm ig angezeigten Eigenschaften gibt es noch weitere Eigenschaften wie Gruppen ID und Metadaten die eingeblendet werden k nnen Besitzt ein Rule Service die zur Anzeige konfigurierten Metadaten nicht dann werden die betreffenden Spalten in der Tabelle leer gelassen siehe Abschnitt 4 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalte
29. Gr nden ben tigt weil dies erlaubt eine generische Anfrage zu formulieren ohne das zu verwendende Regelmodell oder Regel angeben zu m ssen F r diesen Fall ist es also erforderlich dass rulePath auf jedem Rule Service definiert wird der auch rating unterst tzt Das einzige notwendige Element in einer generischen Anfrage ist rating Weil dies unter Umst nden nicht ausreicht um zu entscheiden welcher Rule Service auszuf hren ist wird im Beispiel auch die Angabe version wie auch andere Metadaten verwendet Im ersten Schritt muss die meta xsd ge ndert werden um valide generische Anfragen zu erlauben Die Schl ssel und Typen der Metadaten geh ren innerhalb des target Elements Der untere Ausschnitt zeigt wie das aussehen k nnte lt xsd complexType name Target gt lt xsd sequence gt lt xsd element name rating type xsd string gt lt Jeglicher Wert erlaubt gt lt xsd sequence gt lt xsd any gt lt xsd sequence gt lt xsd sequence gt lt zsd complexType gt Als n chstes wird eine Java Klasse RatingMetaDataMapper erzeugt welche die abstrakte Klasse de visualrules execution core spi metadata AbstractMetaDataMapper erweitert Da das Object sp ter per Reflection geladen wird muss ein default Konstruktur aufrufbar sein Die abstrakte Klasse fordert die Implementierung von zwei Methoden n mlich mapRuleModelArtifact und mapRuleInvocationTarget Die erste Methode wird aufgerufen sobald ein
30. Lizenz l schen Um eine Lizenz zu l schen klicken Sie auf der Seite Lizenz Verwaltung auf x vor der betreffenden Lizenz 4 5 2 Konfiguration und Anzeige von Nachrichten der Laufzeitprotokollierung Wahlen Sie in der Men leiste der Webkonsole den Eintrag Wartung aus um die Sicht Wartung zu ffnen Klicken PL Sie danach auf Logging Die ge ffnete Seite besteht aus zwei Teilen Der obere mit Detaillierungsgrad beschriebene Teil dient zur Konfiguration der Laufzeitprotokollierung des Execution Server Dazu dient ein Schieberegler 5 Der Schieberegler kontrolliert die Einstellung des Detaillierungsgrades der Laufzeitprotokollierung Je h her der Grad desto mehr Nachrichten werden produziert Zu beachten ist dass ein hoher Detaillierungsgrad einen negativen Einfluss auf die Leistungsf higkeit des Systems hat Neben dem Schieberegler wird eine genaue Beschreibung f r den momentan eingestellten Detaillierungsgrad angezeigt Der untere Teil der Seite ist mit Logs beschrieben und zeigt haupts chlich Protokolldateien Log an Logs Name executionserver log Y Gr e 8 8 KB Letzter Eintrag 15 12 2011 09 54 48 GMT 0100 Log Datei herunterladen Die Dropdown Liste w hlt die Protokolldatei aus deren Eintr ge angezeigt werden sollen Eine Datei kann auch leer sein Informationen zu existierenden Protokolldateien ist in Abschnitt 2 7 3 Laufzeitprotokollierung Bosch Software Innovations 39 58 Kapitel 4 Arbei
31. Sie die XML Schema Dokumentation f r eine detaillierte Beschreibung von xsd time lt alarm gt 15 47 23 lt alarm gt Timestamp Werte werden entsprechend dem XML Schema Typ xsd dateTime repr sentiert Das Format ist YYYY MM DDThh mm ss was das Datum und die Zeit getrennt durch den Buchstaben T darstellt Kein Bestandteil darf weggelassen werden Bitte lesen Sie die XML Schema Dokumentation f r eine detaillierte Beschreibung f r das Format von xsd dateTime lt startTimestamp gt 2009 05 30T09 30 10 lt startTimestamp gt Sofern Werte ausdr cklich als leer angegeben werden sollen in Java durch nu11 repr sentiert kann dies durch Angabe das xsi nil Attributes erreicht werden Dazu ist es erforderlich in der Anfrage auch den Namespace xmins xsi http www w3 org 2001 XMLSchema instance zu importieren lt myDate xsi nil true gt Beachten Sie dass die Angabe des xsi nil Attributes nur f r Datentypen funktioniert die dies unterst tzen Diese Angabe ist beispielsweise wirkungslos wenn es sich in Java um einen primitiven Datentyp wie int handelt da diese ihrer Natur nach immer einen Wert haben 5 1 5 2 Strukturen Werte von Strukturen in einer Anfrage oder einer Antwort werden einfach durch Elemente von jedem Attribut repr sentiert Zum Beispiel repr sentiert das folgende XML Fragment den Wert des Datenelements customer mit zwei Attributen name und address Dabei hat address selbst ein Attribut zip lt
32. Visual Rules Suite Execution Platform Execution Server Benutzerhandbuch Version 6 0 0 Bosch Software Innovations Americas Bosch Software Innovations Corp 161 N Clark Street Suite 3500 Chicago Illinois 60601 USA Tel 1 312 368 2500 info bosch si com www bosch si com Asia Bosch Software Innovations c o Robert Bosch SEA Pte Ltd 11 Bishan Street 21 Singapore 5 3943 Tel 65 6571 2220 info sg bosch si com www bosch si com Europe Bosch Software Innovations GmbH Ziegelei 7 88090 Immenstaad GERMANY Tel 49 7545 202 300 info de bosch si com www bosch si de Execution Server Benutzerhandbuch Version 6 0 0 Visual Rules Execution Server 6 0 0 Copyright 2004 2013 Bosch Software Innovations GmbH Bosch Software Innovations GmbH 2013 Alle Rechte vorbehalten Weitergabe und Vervielfaltigung dieser Publikation oder von Teilen daraus sind zu welchem Zweck und in welcher Form auch immer ohne die ausdr ckliche schriftliche Genehmigung durch die Bosch Software Innovations GmbH nicht gestattet MLDS Visual Rules und Work Frame Relations sind eingetragene Marken der Bosch Software Innovations GmbH BOSCH und die Bildmarke sind registrierte Marken der Robert Bosch GmbH Deutschland Verwendete Produkt und Firmenbezeichnungen sind eingetragene Marken und unabh ngig von ihrer Kennzeichnung Eigentum ihrer jeweiligen Inhaber Execution Server Benutzerhandbuch Inhaltsverzeichnis 1 EINICHUME orr
33. Weg um einen Rule Service aufzurufen besteht darin eine Anfrage aus der spezifischen WSDL zu erzeugen und diese abzuschicken Dieses Vorgehen bedeutet auch dass sich der Aufrufer bereits f r einen Rule Service und den damit verbundenen Regeln entschieden hat Es gibt jedoch auch F lle in denen es gew nscht ist gegen eine f r alle Rule Services gleiche WSDL zu arbeiten und die Anfrage daraus zu erstellen Dies setzt eine implizite Kenntniss der Daten die zu bergeben sind voraus Die zweite Anwendung der generischen Anfrage ist das Weiterleiten einer Anfrage zu einem Rule Service anhand von Metadaten Es ist ebenso m glich eine spezifische WSDL anhand von Metadaten abzuholen Mehr dazu in Abschnitt 6 2 1 2 Eine WSDL durch Angabe von Metadata abholen 5 1 4 1 Generisches VRRequest Format Der generische VRRequest ist in einer speziellen WSDL Datei spezifiziert die auf dem Execution Server unter http lt server gt lt port gt lt context name gt services visualrules generic wsdl verf gbar ist In einer Standard Installation auf einem lokalen Rechner k nnte dies beispielsweise so aussehen wobei x und y der Versionsnummer der WAR Datei des Execution Servers entsprechen http localhost 8080 executionserver 6 x y services visualrules generic wsdl Es gibt einige hnlichkeiten zwischen dem spezifischen und dem generischen Anfrage Format Das VRRequest Element ist ebenfalls das u erste Element in der generischen Anfrage a
34. allation des Execution Servers 022ss0ssnennnnnnnnnnnnnnnnnnnnnnnnnsnnsnennsnnnnsnnsnennsnnsnsnnsnsnnsnssnsnnsnsnnsnene 11 2 4 1 Installieren des Execution Server mit dem Installationsassistenten cceceeeeceeeeceececenceeenceeenes 11 2 4 2 Installieren des Execution Servers mit dem Maintenance Tool ccccececeececceceececeeeeeeeceeeeeeeeees 13 2 4 2 1 Anlegen der Datenbanktabellen f r das globale Schema ccccccesceeceectensenseesenseeseessensenees 13 2 5 Manuelles Aufsetzen der Mandanten cccsscccescsccscsccscescsccncsescesssaesssaseessessesssessssasseesseaeees 15 2 6 Installation der Lizenz ee a ea een 16 2 7 Konfiguration des Execution Servers ccccescenceeceeccenseeseeseenseeeeenseeseeeeenseeseeaseeseeseeaseeseeasessensees 16 2 1 3 EXCCULON Selver HOMO een E E E E 16 Bosch Software Innovations iv 58 Execution Server Benutzerhandbuch 2 2 EXeCuuonm Server Konlieuralioh cctesintiscctscnciavetaldedeanneddaneeesecqnnekssdauviediedisieabousinieneceisaseaerinceedeuses 17 2 13 La fzeitprotokolier ng cenusssssaevsnesedepbosmessnsnsascdaeecdbervulen betas Vi aUn EaR E EE REEN E RENE EEN 18 3 Erstellung und Bereitstellung von Rule Services sessseecssecesecccsecccseccseeesseeso LO 3 1 KOWZEDIE caeubehebaneiawesaratancueswianadeesbencbaneleneaerstendbenmbacesiesbanebesuiacnatestendbeneiecestuatencbesebamesenesenceeneias 19 Oded TUNIC SCI UICC ee ee ee ee
35. ame gt dbPassword lt adminUserName gt e Linux Solaris MaintenanceTool sh dumpTenantBindingSQL tenantId lt tenantId gt globalSchemaName lt globalSchemaName gt tenantSchemaName lt tenantSchemaName gt executeSql sglDumpFile lt dumpFileName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdAbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt Bosch Software Innovations 15 58 Kapitel 2 Aufsetzen des Execution Servers 4 Geben Sie dem Datenbankbenutzer der vom Execution Server fur die Datenbankverbindung verwendet wird CRUD Berechtigungen auf den erzeugten Execution Server Datenbankobjekten Take the result of this select statement and execute it to grant the necessary privileges select grant statements owner db ob sob ect mame to lt username gt as grant statements from select grant select on as Grant statements vVsowner V VIEW NAME as object name from sys all views v union all select grant select insert update delete on t owner t table name from sys all tables t db obj where db obj owner lt tenantSchemaName gt and db obj seb ject name like lt tablerprerix gt s Beispiel 2 4 Manuelles Aufsetzen der Mandanten Berechtigungen 2 6 Installation der Lizenz Der Execution Server ben tigt eine g ltige Lizenzdatei da ansonsten keinerlei Anfragen bearbeiten werden Mit der Lizenz Verwaltung auf
36. ang vor den Werten aus der Datei haben 6 Weisen Sie dem Datenbankbenutzer der vom Execution Server f r die Datenbankverbindung verwendet wird Berechtigungen f r die Datenbankobjekte im globalen Schema zu indem Sie die Statements ausf hren die zum Beispiel f r eine Oracle Datenbank durch folgende Anfrage erzeugt werden Take the result of this select statement and execute it to grant the necessary privileges select grant statements owner db ob object name to lt username gt as grant statements from select grant select on aS grant statements v owner v VLEW NAME as object name from sys all views v union all select grant select insert update delete on t owner t table name from sys all tables t db obj where db ob owner lt qglobalschemaName gt e e Bosch Software Innovations ae Oracle Datenbank 14 58 Kapitel 2 Aufsetzen des Execution Servers 2 5 Manuelles Aufsetzen der Mandanten Ein manuelles Aufsetzen der Mandanten ist nur notig wenn bezuglich der zugrundeliegenden Datenbank der manuelle Modus verwendet wird Im automatischen Modus passiert dies automatisch Um manuell neue Mandanten anzulegen tun Sie Folgendes 1 Erzeugen Sie mithilfe des Execution Server Maintenance Tools ein neues Mandantenschema das aus Schema Prafix VRS besteht gefolgt vom technischen Namen des Mandanten Hierzu k nnen Sie folgendes Kommando verwenden angepasst an Umgebung und Zie
37. be der Filterkriterien und der Anwendung des Filters finden Sie in Abschnitt 4 7 Filterung angezeigter Objekte 4 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv Der Execution Server unterst tzt das Hochladen eines Visual Rules Archivs Dieses enth lt neben dem Rule Service selbst auch alle weiteren zur Serviceausf hrung erforderlichen Bibliotheken 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 Klicken Sie auf die Schaltfl che Serviee s aus Archiv hinzuf gen Diese Schaltfl che ist nur dann aktiviert wenn Sie ausreichende Berechtigungen haben Der Standardbenutzer Admin hat diese Erlaubnis Siehe auch Abschnitt 1 3 Berechtigungs Konzept Der folgende Dialog erscheint Oo ee See Archiv vra Durchsuchen Hochladen Abbrechen Bosch Software Innovations 28 58 Kapitel 4 Arbeiten mit der Webkonsole Klicken Sie auf die Schaltfl che Durshsuchen Es ffnet sich ein Dialog zum Hochladen des Visual Rules Archivs Er erm glicht Ihnen die Spezifikation einer Visual Rules Archiv Datei mit der Endung vra Das Aussehen des Dialoges ist abh ngig von Ihrem Web Browser Der Pfad der ausgew hlten Datei wird anschlie end im Eingabefeld angezeigt Hochladen Klicken Sie auf die Schaltfl che 1 um die spezifizierte Datei hochzuladen Wenn die Operation abgeschlossen ist wird eine Statusmeldung angezeigt Zudem
38. ce eee e eee es eee eeee ees eee eens eeseeesenseeeeeeseesenseennen 26 4 2 1 Anzeige bereitgestellter Rule Services ccccceeccecencenceeseenseeseeseesseeseessenseeeeessesseeasessesseeanees 27 4 2 2 Filterung angezeigter Rule Services cece scence cece eee nc ee eens eeeeeee ees eee eee eeeseeeeeeseeseeeeeeseeseeeeeanes 28 4 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv ccccceccecceecenseeceesseeseeseensenseeaeenes 28 4 2 4 L schen eines bereitgestellten Rule Service ccc ccc ecceccesc ens eeseeseenseeseeeseeseeesensenseeeseesenseeanens 29 4 2 5 Anzeige der WSDL Datei eines Rule Service ccce cece ee eencenteeceensenseeaeenseeseesesseeseeasesseeaeense 30 4 2 6 Herunterladen eines Rule Service ses nase einen ueber 30 4 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service ccccccceeeeeseeeees 30 4 2 8 Verwaltung der Metadaten eines Rule Service sssssssseeeeeessssssssseeeeceeessssssssseeeeeeessssssssseeeeee 32 42 8 1 Hinzu ei Von Metadata ee 32 4 28 7 Loschen von MefadalEN s rorses iyor ti errr tases erR N OEI eier se EN OEREN ERTO N ee 32 4 2 8 3 Editieren von Metadatennamen und werten ssesssesosesosesssesscsesssseseseseseseseessresosesosesesesesessses 33 4 2 9 Anzeige der Ausf hrungen eines Rule Service cc ccc eceescenc enc eeeeenseeseesenseeseeseeseeseeesenseeaeense 33 4 2 10 Anzeige der erfor
39. chnis persistiert Es ist m glich diese Werte zu editieren f r den Fall dass nach der Installation eine nderung notwendig ist Hat sich beispielsweise eine URL f r das Identity Management IM ge ndert so kann dies in der Konfigurationsdatei ge ndert werden ohne die Anwendung erneut zu installieren nderungen an der Konfigurationsdatei d rfen nicht vorgenommen werden wenn der Execution Server in Betrieb ist Bei Eingabe von Werten in eine Properties Datei m ssen unter Umst nden bestimmte Zeichen maskiert werden Unten aufgelistet finden Sie die m glichen Optionen zur Konfiguration des Execution Servers Die typischen Konfigurationseinstellung wie sie vom Installationsassistenten erstellt werden sind executionserver jndi name Der JNDI Resource Name der zu verwendenden Datenbank artifactstorage db brand Der Name der verwendeten Datenbank G ltige Werte sind H2 MYSOL ORACLE MSSOL Gro Kleinschreibung wird nicht beachtet artifactstorage custom prefix Der benutzer definierte Tabellenprafix der bei der Trennung der Anwendungsdaten Verwendung findet Der Wert muss zwischen ein und drei Zeichen lang sein mit einem Buchstaben anfangen und aus Zahlen oder einfachen Buchstaben bestehen Etwas formeller es muss dem folgenden regularen Ausdruck Genuge getan sein A Z 0 9A Z 0 2 mts schema name Der Wert ist der Name des Datenbankschemas welches fur die Verwaltung von verschiedenen Anwendungen und Mandanten verwe
40. customer gt lt name gt John Doe lt name gt lt address gt lt zip gt 12345 lt zip gt lt address gt lt customer gt Bosch Software Innovations 47 58 Kapitel 5 Aufrufen von Regeln im Execution Server 5 1 5 3 Listen und Mengen Die Werte einer Liste oder Menge in einer Anfrage oder Antwort wird durch eine Reihe von element Tags abgebildet Zum Beispiel sieht eine Liste oder Menge von Strings so aus lt names gt lt element gt John Doe lt element gt lt element gt Peter Pan lt element gt lt element gt Captain Hook lt element gt lt names gt Und dies ist eine Liste oder Menge von Kunden wobei jeder Kunde die Attribute name und address hat lt customers gt lt element gt lt name gt John Doe lt name gt lt address gt lt zip gt 12345 lt zip gt lt address gt lt element gt lt element gt lt name gt Peter Pan lt name gt lt address gt lt zip gt 99999 lt zip gt lt address gt lt element gt lt element gt lt name gt Captain Hook lt name gt lt address gt lt zip gt 99996 lt zip gt lt address gt lt element gt lt customers gt 5 1 5 4 Maps Maps werden durch eine Reihe von entry Tags spezifiziert jede davon hat zwei Elemente key und value genannt Zum Beispiel ist dies ein String gt Customer Mapping mit zwei Eintr gen lt customerMap gt lt entry gt lt key gt 8847 736 90 lt key gt lt value gt lt name gt John Doe lt name
41. den Konzepten e Abschnitt 1 3 1 Execution Server Berechtigungen e Abschnitt 1 3 2 Execution Server Benutzerrollen Die tats chlichen Rechte eines Benutzers Teams ergeben sich aus deren Kombination Ein Team kann weitere Teams enthalten Generell sind alle Berechtigungen die einem Team zugewiesen sind automatisch auch jedem Benutzer Team innerhalb des Teams zugewiesen 1 3 1 Execution Server Berechtigungen Execution Server Berechtigungen sind Berechtigungen die im Identity Management mit Bezug auf den Visual Rules Execution Server definiert sind Dabei repr sentiert jede Berechtigung bestimmte Arten von Aktionen Standardm ig wird jedem Mandanten das Standard Berechtigungspaket zugewiesen Die folgenden Execution Server Berechtigungen werden unterschieden Tabelle 1 1 bersicht der Execution Server Berechtigungen Berechtigung Beschreibung Visual Rules Archiv bereitstellen Berechtigung zum Bereitstellen eines Rule Service und aller erforderlichen Bibliotheken mittels Visual Rules Archiv Regel Bibliothek bereitstellen Berechtigung zum Bereitstellen eines Rule Service mittels Regelbibliothek oder einer Bibliothek Regel Bibliothek l schen Berechtigung zum L schen eines bereitgestellten Rule Service oder einer Bibliothek Log Informationen anzeigen herunterladen Berechtigung zum Anzeigen Herunterladen von Log Informationen Logging konfigurieren Berechtigung zum ndern des Detaillierungsgrads des Lo
42. der Hierarchie Obwohl jeder Rule Service seinen Klassenlader hat gibt es immer auch einen vorgelagerten Klassenlader Da auch der Anwendungsserver mehrere Klassenlader verwendet wird dadurch eine Hierarchie gebildet Java API und Kern Klassen Java Erweiterungen Klassen des Anwendungsservers Klassen des Anwendungsservers inklusive Execution KS Server Rule Service Rule Service Klassen Klassenlader n und Abh ngigkeiten V gt D D gt Rule Service Klassenlader 1 Abbildung A 1 Klassenlader Hierarchie Die Hierarchie beeinflusst das Klassen laden Klassen werden typischerweise vom vorgelagerten Klassenlader zuerst geladen Ist beispielsweise ein JDBC Treiber auf dem Klassenpfad des Anwendungsservers so wird Entweder bei einem Web Service Aufruf oder der Anforderung der WSDL Manche Anwendungsserver k nnen die Reihenfolge des Klassen ladens einstellen Informationen dazu sollten sich in der Dokumentation des Anwendungsservers befinden Bosch Software Innovations 57 58 Anhang A Rule Service Klassenlader and Hierarchie dieser vom Anwendungsserver Klassenlader zuerst geladen Sofern in diesem Beispiel der JDBC Treiber von einem Rule Service Klassenlader geladen werden soll wird stattdessen die Klasse verwendet die vom Anwendungsserver Klassenlader zuerst geladen wurde Daher ist es empfehlenswert den Klassenpfad und Einstellungen des Anwendungsservers genau zu pr fen Bosch Software Innovations
43. derlichen Bibliotheken eines Rule Service zs22s2s0ssssesesnenennnnnnnnnennnnnnennenen 33 4 3 Verwaltung der Ausf hrungen von Rule Services cccccecceeeecenceeeeenseeseesenseeseesseeseeseessenseeaeenss 33 4 3 1 Anzeige der Ausf hrungen von Rule Services 22220s2ssssssnonennennnnnnenennnnnnnnnnnennennnsnnsnnennnsnnennen 34 4 3 2 Filterung angezeigter Ausf hrungen 22222s2ssssessenenennnnnnnenennnnnnnnnnnnnnennnnenennenensnnennnsnnsnnennen 34 4 3 3 L schen von Ausf hrungen von Rule Services ccescesccencenseeceesseeseeseenseeseeesessesseesessesseeanes 35 4 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service cc cece ccc eeceeeeeneteneeeneeenseensees 35 Bosch Software Innovations v 58 Execution Server Benutzerhandbuch 4 4 Verwaltung bereitgestellter Bibliotheken cc cccccesceccecceceeceeceeeeeeeeseeseesensesseseaseaseaeseeeeeseeenes 36 4 4 1 Anzeige bereitgestellter Bibliotheken ccccc ccc ec cece ence eee eeeene eee eeee ees eeeeeeseeseeesenseeeeeasensenseeenen 36 4 4 2 Filterung angezeigter Bibliotheken van en padewersncderassacunaeeiandees 37 4 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek cccesceeceeseeeceeceeeeesseeseeaeenss 37 4 4 4 L schen einer bereitgestellten Bibliothek szss2s0sssssssenonnnnnnennnnnnnnnnnnnnennnnnnnnnennnsnnennen 38 4 5 Wartung des Ex
44. e Innovations 8 58 Kapitel 2 Aufsetzen des Execution Servers 2 1 2 1 Beispiel Oracle Datenbank Create a database user which the Execution Server uses to connect to the database This user only must have sufficient privileges for regular operation of the Execution Server In this operational mode the database administrator is responsible for the creation of database schemata and their initialization with the Execution Server database tables using a command line based maintenance tool which is provided as part of the Execution Server distribution create user lt username identified by lt password gt default tablespace lt tableSpaceName gt temporary tablespace lt tempTableSpaceName gt quota unlimited on lt tableSpaceName gt grant login privilege so the Execution Server is able to connect to the database grant create session to lt username gt Beispiel 2 2 Beispiel Oracle Datenbank Anlegen und Konfigurieren eines Datenbankbenutzers f r den manuellen Modus 2 2 Vorbereiten des Web Servers Um den Web Server vorzubereiten f gen Sie die Datenbank als Daten Resource hinzu die ber einen JNDI Namen erreichbar ist Der JNDI Name ist abh ngig vom Application Server Hersteller wie im Folgenden beschrieben 2 2 1 Vorbereiten eines Tomcat Application Servers Um einen Tomcat Application Server vorzubereiten konfigurieren Sie die Datenbank als eine JDBC Daten Resource mit dem JNDI Namen java jboss jdbc
45. e Service anzeigen lassen siehe Abschnitt 4 2 9 Anzeige der Ausf hrungen eines Rule Service Weiterf hrende Aufgaben e Abschnitt 5 2 1 Aufrufen eines Rule Service e Abschnitt 4 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service e Abschnitt 4 3 3 L schen von Ausf hrungen von Rule Services e Abschnitt 4 6 Konfiguration der Anzeige von Tabelleninhalten 4 3 2 Filterung angezeigter Ausf hrungen Auf der bersichtsseite der Sicht Ausf hrungen k nnen Sie Filterkriterien spezifizieren um nur Ausf hrungen die von Interesse sind anzuzeigen Bosch Software Innovations 34 58 Kapitel 4 Arbeiten mit der Webkonsole Request ID Filter anwenden Filter zur cksetzen Erweitert gt gt In diesem Abschnitt k nnen Sie die Request ID der Ausf hrung als Filterkriterium angeben Sie haben die M glichkeit weitere Filterkriterien f r die Anzeige der Ausf hrungen zu spezifizieren e Name des aufgerufenen Rule Service in der Ausf hrungsseite eines Rule Services nicht verf gbar e Version des aufgerufenen Rule Service in der Ausf hrungsseite eines Rule Services nicht verf gbar e Regelpfad e Ausfuhrungszeitraum Dazu steht ein erweiterter Eingabedialog zur Verf gung Request ID Filter anwenden Filter zur cksetzen Erweitert lt lt Rule Service Version Regelpfad Ausf hrungszeitraum Von BE Bis E w Mehr Informationen zur Eingabe der Filte
46. e WSDL angefragt wird und die zweite wenn eine generische Anfrage zu einem Rule Service weitergeleitet werden soll Die mapRuleModelArtifact Methode bekommt zwei Argumente bergeben die Metadaten als java util Properties und eine Instanz des IArtifactStorageReadAccess Als erstes wird Bosch Software Innovations 53 58 Kapitel 6 Arbeiten mit Metadaten gepr ft ob ein Wert f r rating angeben wurde ansonsten wird eine Ausnahme geworfen Danach wird mittels der Metadaten ein IServiceView gesucht Sofern einer gefunden wurde wird dieser zu einem RuleModelArtifact konvertiert und zur ckgegeben public RuleModelArtifact mapRuleModelArtifact Properties metaData IArtifactStorageReadAccess artifactStorage throws AmbiguousRuleModelArtifactException String rating metaData getProperty rating if rating null throw new IllegalArgumentException A rating must be set IServiceView serviceView findByMetaValues metaData artifactStorage return serviceView null new RuleModelArtifact serviceView null Die indByMetaValues Methode benutzt die IArtifactStorageReadAccess listServicesWithMetaValue Methode um Rule Services zu finden in deren Metadaten es einen passenden Wert f r den Schl ssel rating gibt Dies kann bei einer gro en Anzahl von Services der Fall sein Zus tzlich werden solche aussortiert deren Metadaten nicht zu denen passen die in der Anfrage bergeben wurden Danach bleibt i
47. ea A dessen sesessivnneucseessiterucesdcevesevteasescsecers L Li Anwengdun2spereich su see ea ae Huensvbadensubatnotsabannmsds eons 1 L2 denti Manage Ment anne ae Ru 1 1 3 Berecnhlgungs Konzept se ae tnddesex Geoeesos teencdaxeues 2 1 3 1 Execution Server Berechtigungen cccccesccenccenccenceeneeenseenseenseenseenseenseenseenseeneeenseenseenseenseenes 2 1 3 1 1 Standard Berechtigungspaket cccccccesccesceenceeneeeneeesseenseesseesseesseesseesseenseesseesseesseesseesseenees 2 1 3 2 Executi n Server Ben fzerfollen esssaisacascasin ande nenn a ana ee een 3 13 21 AAMINISTATON ernannten 3 1 3 2 9 DEON T nes ee ee nes ensee 3 1 4 Mandantenf higkeit und Konzept der Datentrennung 22s220s2ssssenesnenennnnennenennnnennnsnnennennnsnnenn 3 14 1 Mandantenl niskelt zes aaa re ee Re 3 1 4 2 Konzept der Datentrennung ccccceecceccencenceee eens ees eeeeees ees eeeeenseeseeeeeseeseeaseeseeeseesesseeasessensees 3 1 4 2 1 Trennung der Mandantendaten cccccescceccentenceetensenseessensenseeesenseeseeasesseeseeasessesaeeasensenes 4 1 4 2 2 Trennung der Anwendungsdaten cece cece nce e cence nee e eens ene e eee esses sees eee eeeeeeseeseeaeenseeseeaseeseneees 4 1 4 2 3 Notwendigkeit und Vorteile der Datentrennung cccceeceecceseeeseeseeeeenseeseeeseeseeseeeseeseeeeeeseeeees 5 1 9 DIE WIDUUON ee este es ae ee see ae ee ee wre 5 1 94 Maintenance TOO anne esse ras
48. ecution Servers sine scsacncsbntansustaessesneesateessesaseesendencer taslsoqubenatausteses 38 5 IZEMZ ell VENAE rog EE E EE EE E E EE EE OS 38 4 5 1 1 Lizenz hinzuf gen arena ee rear 39 254 2 Lizenz OSEN ee E T R E E E E E 39 4 5 2 Konfiguration und Anzeige von Nachrichten der Laufzeitprotokollierung ccceceecceeeeeceeseeeeenes 39 4 6 Konfiguration der Anzeige von Tabelleninhalten ccccesceeceeceeseeeseeseeeenseeseesenseeseessesseeeeennen 40 4 6 1 Ein und Ausblenden von Spalten ccccc cece ccc e nec ence eneeeneeenseenseenseenseenseenseenseenseenseeneeesseensees 40 2 65 Vorccheben einer SPAN a ee er a re ee 40 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge cece ccc esceesceeneeenceesseenseesseeseeess 40 A T Fiterane angezeipter ODJEKTE euere ee 40 4 7 1 Eingabe von Filterkriterien c ccc cece cee cc ence e eee et eee e ene e eee e eens eee eee eens ees eee eens eeseeasenseeeeeasenseeaeeenes 41 4 7 1 1 Eingabe von Datumi und UNI ZCI sets enden see 41 4 T2 Anwendenzeine Files ses ee ee ee riesen esse 42 8 1 KONZEDIE E E P A A ee ee ee OEN ee energie 43 5 1 1 Authentifizierung f r eine Rule Service Anfrage ccceccescesceeseenseeceeseesseeseeasessesseeasessesseeanes 43 5 1 2 Format der Rule Service Anfrage cccccescceccenceeceeeeeneeeseeneesseeseesseeseeesesseeseeasesseeseessessesaeense 43 5 1 3 Formatider RUC Sevice ANWON
49. een 19 3 122 FRESE DID NOUN versende ee een ee ee een ee 19 3 1 3 Versionen von Regelbibliothek und Rule Service ccc ccc cece eee eee ence eneeeneeenseenseenseenseeneeenseensees 20 3AA VISUall Rules ACHIV ee see ae ee enter ee ee 21 3 1 5 RUE Service Einstellungen us een ee 21 3 1 5 1 AKTIV ze ee ee ea ee ee ee een 21 3 129 G GUNE WO UNG AUN ls ee een ee 21 3 1 5 3 Name der aktiven Konfiguration Active Configuration Name cccceccescecccecsentenceecsenseeseensens 21 3152 STaUstKIe Velen er en ee ce es EE 22 DANE E CHI ee ee ee ee 22 3 2 1 Regeln festlegen die als Rule Service exportiert werden sollen c cece ccc eeceecceneeeneeenseenseeneees 22 3 2 2 XML Namespace f r Rule Services definieren ccccc cece ecceeecceeeceeeeseeeesseeeseeecseeecseeenseeesseeenges 23 3 2 3 Einstellen von Aktionen als R ckgabewert 2s2202s0ssssssessnnnnnnnnnnnnenennnnnnnnnnnnnnnnnnnnnennennnsnnennen 23 3 2 4 Bereitstellen von Regelprojekten vom Visual Rules Modeler cccccesceecceecteeceeeeeeseeeseeeseeeees 24 4 Arbeiten mit der Webkonsole ccccccccccsccccsccccccccccccccccccccccccccccccccccccccsscses 26 4 1 Aufruf Ger Webkonsola 2er ee use ae ee ae ersehen 26 4 1 1 Einstellung einer bestimmten Sprache 2s2ssss0ssssssonnnnennnnnnnnnnnnnnnnnnnennnnnnennnsnnnnnennnsnnennen 26 4 2 Verwaltung bereitgestellter Rule Services ccccec ccc esc en
50. eenes 53 Bosch Software Innovations vi 58 Execution Server Benutzerhandbuch 6 2 1 3 Benutzerdefinierter Metadata Mapper ccccccecccecccecceecseecseecseeceeecseeseeecseecseegseesseecseenseenges 53 A Rule Service Klassenlader and Hierarchie uses nennen een ee 57 Al Rule Service Klassenlader unseren ee ee 57 Pr 2 Kl aSssenlader PHO CNIC Sunrise eure rear 57 Bosch Software Innovations vii 58 Kapitel 1 Einleitung Kapitel 1 Einleitung 1 1 Anwendungsbereich Der Visual Rules Execution Server ist eine Web Anwendung die es erm glicht mehrere Versionen von Regeln zu verwalten und diese als Web Services auszuf hren Dar berhinaus erlaubt er das Austauschen und Deployen von Regeln zur Laufzeit und sammelt Statistiken zu den ausgefuhrten Regeln r uao BIIMES qam Japying 10 Jaja pop WO Pele UES Visual Rules Execution Server 6 JaSMOIG COM juawaseueyy AyQuap ww Relational Database Management System Abbildung 1 1 berblick Execution Server 6 Der erste Schritt um Regeln als Web Service auszuf hren ist diese zu bauen und als Regelbibliothek zu paketieren Danach k nnen diese Bibliotheken auf dem Visual Rules Execution Server bereitgestellt werden Dies kann entweder mit dem Visual Rules Modeler der Team Platform oder dem Builder erreicht werden die alle eine entsprechende Integration bereitstellen Regelbibliotheken werden mit der Webkonsole verwaltet Diese ist eine Web
51. ein cmd f r Microsoft Windows Betriebssysteme oder ein sh f r nix Betriebssystem Skript Die Verbindung zur Datenbank verwendet JDBC und ben tigt aus diesem Grund den JDBC Treiber f r die Datenbank Die jar Datei des Treibers muss dazu nur in das driver Verzeichnis kopiert werden dass sich im Verzeichnis des entpackten Archivs befindet Nach dem Entpacken kann das Programm auf der Kommandozeile ausgef hrt werden Dazu ffnen Sie eine Kommandozeile und navigieren zu dem Verzeichnis in dem das Zip Archiv entpackt wurde Im folgenden Beispiel wird angenommen dass es sich um das Verzeichnis maintenance in tmp auf einem Microsoft Windows Betriebssystem handelt C tmp maintenance gt Das Verzeichnis ist richtig wenn sich das Kommandozeilenprogramm ausf hren l sst beispielsweise durch Eingabe von MaintenanceTool Dieser Aufruf wird alle verf gbaren Kommandozeilen Optionen mit ihrer Beschreibung und Alternativen ausgeben Bosch Software Innovations 6 58 Kapitel 2 Aufsetzen des Execution Servers Kapitel 2 Aufsetzen des Execution Servers Voraussetzungen Die erforderliche Datenbank sowie das Identity Management sind gestartet Das Aufsetzen des Execution Servers umfasst folgende Tatigkeiten e Abschnitt 2 1 Vorbereiten der Datenbankumgebung e Abschnitt 2 2 Vorbereiten des Web Servers e Abschnitt 2 3 Deployment des Execution Servers e Abschnitt 2 4 Installation des Execution Servers
52. el wird in diesem XML Fragment fur ein Datenelement name ein String Wert Peter angegeben lt name gt Peter lt name gt Integer Werte werden als Ganzzahlen abgebildet Zum Beispiel wird in diesem XML Fragment 199 als der ganzzahlige Wert f r ein Datenelement seat _ no angegeben lt seat_no gt 199 lt seat_no gt Float Werte werden als Gleitkommazahlen dargestellt unter Verwendung eines Punkt als Dezimaltrennzeichen Zum Beispiel wird in diesem XML Fragment f r verschiedene Datenelemente jeweils eine Gleitkommazahl als Wert angegeben Bitte lesen Sie die XML Schema Dokumentation f r detaillierte Beschreibungen von xsd decimal lt price gt 7 45 lt price gt lt rate gt 4453 lt rate gt Boolean Werte werden durch das Wort true oder false abgebildet Der XML Typ istxsd boolean lt student gt true lt student gt lt coupon gt false lt coupon gt Date Werte entsprechen dem Format YYYY MM DD Dabei stehen die ersten vier Zeichen f r das Jahr dann zwei Zeichen f r den Monat und schlie lich zwei Zeichen f r den Tag wobei alle durch Bindestriche getrennt sind Bitte lesen Sie die XML Schema Dokumentation f r eine detaillierte Beschreibung von xsd date lt show _date gt 2008 08 22 lt show date gt Time Werte entsprechen dem Format hh mm ss Die ersten zwei Zeichen stehen f r die Stunde dann Minuten und Sekunden jeweils getrennt durch Doppelpunkte Kein Bestandteil kann weggelassen werden Bitte lesen
53. en Sie sich diese Ansicht ber die Detailseite des Rule Service anzeigen lassen siehe Abschnitt 4 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service Weiterf hrende Aufgaben e Abschnitt 4 4 4 L schen einer bereitgestellten Bibliothek e Abschnitt 4 6 Konfiguration der Anzeige von Tabelleninhalten 4 4 2 Filterung angezeigter Bibliotheken Auf der bersichtsseite der Sicht Bibliotheken k nnen Sie Filterkriterien spezifizieren um nur Bibliotheken die von Interesse sind anzuzeigen Artefakt ID Filter anwenden Filter zur cksetzen Erweitert gt gt In diesem Abschnitt k nnen Sie die Artefakt ID der Bibliothek als Filterkriterium angeben Sie haben die M glichkeit weitere Filterkriterien f r die Anzeige der Bibliotheken zu spezifizieren e Gruppen ID e Version e Bereitstellungszeitraum Dazu steht ein erweiterter Eingabedialog zur Verf gung Artefakt ID Filter anwenden Filter zur cksetzen Erweiterte lt Gruppen ID Version Bereitstellungszeitraum Von E w Bis E w Mehr Informationen zur Eingabe der Filterkriterien und der Anwendung des Filters finden Sie in Abschnitt 4 7 Filterung angezeigter Objekte 4 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek 1 W hlen Sie in der Webkonsole den Eintrag Bibliotheken aus um die Sicht Bibliotheken zu ffnen 2 ffnen Sie die Detailseite der Bibliothek deren Eigenschaften Verwendung Sie sehen
54. en die auf dieser Ebene des Regelmodells vorhanden sind e Die Namespace URI jedes XML Schemas ist vom Regelpaketnamen abgeleitet d h Sie werden im XML Schema Namespace die gleiche Hierarchie der Regelpakete und Regeln finden e Die XML Schema Dateien f r exportierte Regeln enthalten auch die Definitionen des Nachrichtenformats f r die Input und Output Datenelemente Anders ausgedr ckt wird damit die Schnittstelle der Regel einschlie lich der Namen und Typen aller Eingabe Ausgabe Datenelemente beschrieben Weiterf hrende Arbeitsschritte e Abschnitt 4 2 5 Anzeige der WSDL Datei eines Rule Service 5 2 Arbeitsschritte 5 2 1 Aufrufen eines Rule Service Um einen Rule Service im Execution Server aufzurufen m ssen Sie eine SOAP Anfrage an den HTTP Endpunkt schicken der in der WSDL spezifiziert wurde Standardm ssig ist dieser Endpunkt der gleiche f r alle Rule Services was es einfacher f r generische Clients macht Das Vorgehen um einen Web Service aufzurufen h ngt stark von der Programmiersprache oder dem Tool ab das Sie verwenden und kann hier nicht beschrieben werden So wird in den folgenden Beschreibungen lediglich erkl rt was technisch und im SOAP Protokoll geschieht 1 Im Header der SOAP Nachricht liefert der Web Service Client Authentifizierungsdaten wie im Abschnitt 5 1 1 Authentifizierung f r eine Rule Service Anfrage beschrieben 2 Im Body der SOAP Nachricht spezifiziert der Web Service Clie
55. en 5 2 Aufsetzen des Execution Servers cccccccsccsscccccscccsccscccccccccccscccccsccccccsccccccscces 2 1 Vorbereiten der Datenbankumgebung cccceecceceencenceeeeeneenseeseenseeseesesseeseeaseeseeaeessesseesessenaes 7 2 1 1 Automatischer Modus u a ee enter 7 2 1 1 1 Beispiel Oracle Datenbank c cece cece cee nceeeteeet ence cent eesseesseesseeeeesseeteeteeeteeteeteesteesteeseees 7 2 1 2 Manueller Modus as nenne ee eier seien 8 2 1 2 1 Beispiel Oracle Datenbank uns u seen ne re ae 9 2 2 Vorbereiten des Web Servers csesessnesennnnnnnnnnensnnnnnsnnsnennsnnsnsnnsnennsnnsnsnnsnenssnnsnsnnsnennsnnsnsnnsnsnesnnnne 9 2 2 1 Vorbereiten eines Tomcat Application Servers 22222ssssseessesesesnsnnenenennnnnnnennnennnennnennnenenenenenenenenn 9 2 2 2 Vorbereiten eines WebSphere Application Servers ccccesccesccenceesceeseeesseesseesseeseeesseesseesteesqees 9 2 2 3 Vorbereiten eines JBoss Application Servers ssssssssssssssssssssssssssssssssssssssssssssssssssssssessssssssses 9 2 3 Deployment des EXECUTION Servers sic ssccdosndvessauesieenetesuwodedgsdewsdassdeedescnsesaddveenskesundivosdesacensbaeuceeucebas 10 2 3 1 Spezifische Prozedur f r Deployment auf WebSphere c cece cece nce esceeseeeseeesseesteesseesseesteesnens 10 2 3 2 Spezifische Prozedur f r Deployment auf JBOSS ccc cece cc cencceneeeneeenseeneeesseesseeseeesseesseesseenees 10 2 4 Inst
56. en f hren Sie folgende Schritte aus 1 Im Projekt Explorer oder Regel Explorer w hlen Sie das Regelmodell aus welches als Rule Service exportiert werden soll 2 Wechseln Sie zur Seite Metadaten in der Sicht Eigenschaften Dr cken Sie den Eu Knopf neben der Execution Server Tabelle Ein Eintrag in der Schl ssel Spalte wird angelegt mit einem default Namen Der Schl ssel kann durch einen Doppelklick bearbeitet werden Mit dem A Knopf kann ein Schl ssel und sein Wert gel scht werden 4 Mit einem Doppelklick in die Wert Spalte neben dem Schl ssel kann ein Wert hinzugef gt oder bearbeitet werden Bosch Software Innovations 51 58 Kapitel 6 Arbeiten mit Metadaten L Eigenschaften 53 eg Movie Ticket Pricing Ein 4usqabedaten Tatarasunaken Execution Server konstante Daten Schluszel yt ert Aktionen author Jane Doe Datentypen entry rule Pricing Web Service Erweiterungen Beschreibung w eR Notizen color Hetadaten Schl ssel und Wert m ssen in einem bestimmten Format angegeben werden Die L nge muss mindestens ein Zeichen aber maximal 255 Zeichen sein Leerzeichen sind innerhalb des Elements erlaubt jedoch nicht am Anfang oder am Ende Zu beachten ist dass nur Schl ssel und Werte in der Execution Server Tabelle f r die Bereitstellung verwendet werden 6 2 1 Zuordnung von Metadaten zu Rule Services Der Execution Server ist in der Lage anhand von Metadaten eine WSDL zu lie
57. en zugeh rigen Link klicken Klicken Sie im oberen Bereich der Detailseite auf Visual Rules Archiv herunterladen 4 Es ffnet sich ein Dialog zum Herunterladen der Datei Er erm glicht Ihnen das Speichern der Datei Das Aussehen des Dialoges ist abh ngig von Ihrem Web Browser Weiterf hrende Konzepte e Abschnitt 3 1 2 Regelbibliothek e Abschnitt 3 1 4 Visual Rules Archiv 4 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 ffnen Sie die Detailseite des Rule Service dessen Eigenschaften Einstellungen Sie sehen wollen indem Sie auf den zugeh rigen Link klicken Auf der Detailseite werden im Abschnitt bersicht allgemeine Eigenschaften des Rule Service angezeigt Bosch Software Innovations 30 58 Kapitel 4 Arbeiten mit der Webkonsole Ubersicht Name Movie Ticket Pricing Version 0 0 1 SNAPSHOT Bereitgestellt von Admin Admin Bereitgestellt am 07 02 2013 11 41 Gruppen ID movie ticket pricing Artefakt ID Movie Ticket Pricing Neben den Eigenschaften werden auch ver nderbare Einstellungen des Rule Service angezeigt siehe Abschnitt 3 1 5 Rule Service Einstellungen Einstellungen Name der aktiven Konfiguration Statistiklevel Quiet ve Gultigketszetraum Von E v Bis E w Speichern Zur cksetzen Die nderung einer Einstellung k nnen S
58. enauer beschrieben 2 7 3 Laufzeitprotokollierung Die Laufzeitprotokollierung wird vom Execution Server automatisch eingerichtet Beim Startvorgang wird die Laufzeitprotokollierung initialisiert und Nachrichten werden in eine Protokolldatei auch log genannt geschrieben welche sich im Logs Ordner im Execution Server Home befindet Eine Protokoll Datei wird bis zu 3 Megabyte MB gro und wird dann archiviert Es gibt maximal drei Archive die eine Nummer im Dateinamen tragen Zum Beispiel ist 3 das dritte und somit lteste Archiv Der Execution Server schreibt zwei unterschiedliche Protokolle e executionserver log enth lt die Nachrichten vom Execution Server und verwendeter Komponenten von Drittanbietern e performance log wird f r die Analyse der Leistungsf higkeit verwendet Die Datei wird automatisch angelegt Die Datei ist leer da die Analyse standardm ig abgeschalten ist Die Ausgabe von Nachrichten mit Aktionen des Typs Log Eintrag schreiben ist weitestgehend deaktiviert um die Ausgabe von mandatenspezifischen Informationen zu verhindern Wird jedoch die Kategorie Eigenschaft von Aktionen vom Typ Log Eintrag schreiben verwendet so werden die Nachrichten in die executionserver log Datei geschrieben Die Protokoll Datei kann in der Webkonsole eingesehen werden wo es auch m glich ist Einstellungen f r die Laufzeitprotokollierung vorzunehmen Mehr Informationen dazu finden sich in Abschnitt 4 5 2 Konfiguration und Anze
59. er zu Deployen ist wie folgt 1 Deployen Sie die executionserver war 2 Starten Sie den Execution Server Nach der Bereitstellung auf dem Application Server sollte probehalber die Webkonsole aufgerufen werden Dies ist in Abschnitt 4 1 Aufruf der Webkonsole beschrieben Der Deploymentprozess ist abh ngig vom Application Server Hersteller Wenn Sie einen Tomcat Application Server einsetzen sind ist keine besondere Prozedur notwendig Die Prozedur f r einen WebSphere Application Server finden Sie unter Abschnitt 2 3 1 Spezifische Prozedur f r Deployment auf WebSphere Wenn Sie einen JBoss Application Server einsetzen lesen Sie Abschnitt 2 3 2 Spezifische Prozedur f r Deployment auf JBoss 2 3 1 Spezifische Prozedur f r Deployment auf WebSphere Wenn Sie einen WebSphere Anwendungsserver benutzen ist die Prozedur den Execution Server zu Deployen wie folgt Der Standard Klassenlader von WebSphere ist nicht geeignet f r den Execution Server WebSphere kann den vorkonfigurierten JNDI Namen f r die Datenbank des Execution Servers nicht aufl sen 1 F gen Sie die executionserver war WAR Datei als neue Enterprise Application hinzu Mappen Sie den Context Root z B auf executionserver 2 Passen sie den Modul Klassenlader des Execution Server wie folgt an e Gehen Sie zu Anwendungen gt Anwendungstypen gt WebSphere Unternehmensanwendungen und klicken Sie auf die executionserver_war e Inder SektionModule
60. fern oder eine generische Anfrage zu einem Rule Service zu leiten Dies wird dadurch bewerkstelligt dass Metadaten einem bestimmten Rule Service zugeordnet werden Die Komponente die daf r verantwortlich ist hei t Metadata Mapper Abh ngig davon welche Werte in den Metadaten definiert sind und was in der Anfrage angegeben wurde kann es dazu kommen dass es keine eindeutige Zuordnung gibt Je nachdem welches Protokoll verwendet wird f hrt das in so einem Fall zu einem SOAP oder HTTP Fehler 6 2 1 1 Standard Metadata Mapper Die Standardimplementierung des Metadata Mapper benutzt ruleModel rulePath und optional version f r die Weiterleitung einer Anfrage Damit kann eine generische Anfrage anstelle einer spezifischen verwendet werden wie das in Abschnitt 5 1 4 Generische Rule Service Anfragen beschrieben wird Abgesehen davon ist es m glich effectiveDate in Kombination mit ruleModel und rulePath zur Weiterleitung einer Anfrage zu benutzen In diesem Fall soll ein Rule Service ausgef hrt werden der zu einem bestimmten Datum g ltig ist Der rulePath hat das gleiche Format wie es in der Generischen Regel Ausf hrung API verwendet wird die im Java Integration Handbuch beschrieben ist Der Standard Metadata Mapper benutzt die Rule Service Einstellungen g ltig von validFrom und g ltig bis validTo Ein Rule Service ist g ltig falls sich ef fectiveDate zwischen den Grenzen von g ltig von und g ltig bis inklusive befindet
61. gel scht werden k nnen Name und Wert dieser Metadaten werden auf der Metadatenseite des Rule Service im Abschnitt Modellbezogene Metadaten angezeigt Modellbezogene Metadaten Name Wert author Erika Mustermann entry rule Preisberechnung Zudem gibt es zusatzliche Metadaten die Sie Uber die Webkonsole einem Rule Service nach dessen Bereitstellung zuordnen k nnen Diese Metadaten sind editierbar und werden im Abschnitt Zus tzliche Metadaten der Metadatenseite angezeigt Zus tzliche Metadaten Metadaten hinzuf gen Name Wert priority hoch Speichern Abbrechen 4 2 8 1 Hinzuf gen von Metadaten Sie haben die M glichkeit einem Rule Service weitere Metadaten hinzuzuf gen 1 Klicken Sie im Abschnitt Zus tzliche Metadaten auf die Schaltfl che Tabellenzeile wird hinzugef gt Metadaten hinzuf gen Einelgare 2 Geben Sie in der Spalte Name den neuen Metadatennamen ein 3 Geben Sie in der Spalte Wert den Metadatenwert ein Klicken Sie auf die Schaltfl che __PEIehern Die Metadatenliste wird um diesen Eintrag erweitert 4 2 8 2 L schen von Metadaten L schbare Metadaten bekommen im Abschnitt Zus tzliche Metadaten das Symbol H zugeordnet 1 Klicken Sie auf das Symbol des Metadatums das Sie l schen m chten Bosch Software Innovations 32 58 Kapitel 4 Arbeiten mit der Webkonsole 2 Es ffnet sich ein Dialog in dem Sie best tigen k nnen dass Sie die Aktion wirklich durchf
62. gestellt und der Rule Service aktiviert bzw deaktiviert werden 6 Erweitern Sie den Abschnitt Execution Server Einstellungen und pr fen Sie die Werte f r die Execution Server URL den Benutzer das Passwort und den Mandant Bosch Software Innovations 24 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services Die URL endet immer mit admin upload Der Host Name und der Kontext Name hangen von Ihrer Installation des Execution Server ab In der Abbildung oben l uft der Execution Server auf dem lokalen Rechner mit dem Port 8080 und der Webapplikations Kontext wurde executionserver genannt 7 Klicken Sie auf Fertig stellen 8 Visual Rules Modeler wird nun die Abh ngigkeiten des Regelprojekts analysieren den Regelcode generieren und diesen in eine Regelbibliothek mit allen anderen Abh ngigkeiten auf dem Erstellungspfad der involvierten Projekte packen Die Regelbibliothek wird dann zum Execution Server hochgeladen Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service e Abschnitt 3 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e Abschnitt 3 2 1 Regeln festlegen die als Rule Service exportiert werden sollen Bosch Software Innovations 25 58 Kapitel 4 Arbeiten mit der Webkonsole Kapitel 4 Arbeiten mit der Webkonsole Die folgenden Abschnitte enthalten Beschreibungen verschiedener Aufgaben die mit der Webkonsole ausgefuhrt werden konnen z B bereitgestellte Rule Services
63. gging Lizenzen hinzuf gen l schen Berechtigung zum Hinzuf gen L schen von Lizenzen Applikationskonfiguration anzeigen Berechtigung zum Anzeigen der Applikationskonfiguration 1 3 1 1 Standard Berechtigungspaket Das Standard Berechtigungspaket wird jedem Mandanten standardm ig zugewiesen Es enth lt die folgenden Execution Server Berechtigungen e Visual Rules Archiv bereitstellen e Regel Bibliothek bereitstellen Bosch Software Innovations 2 58 Kapitel 1 Einleitung e Regel Bibliothek l schen 1 3 2 Execution Server Benutzerrollen Execution Server Benutzerrollen sind Benutzerrollen die im Identity Management mit Bezug auf den Visual Rules Execution Server definiert sind Dabei reprasentiert jede Benutzerrolle einen virtuellen Benutzer der befugt ist bestimmte Aufgaben auszuf hren d h dem die entsprechenden Execution Server Berechtigungen standardm ig per Definition zugewiesen sind Standardm ig werden die folgenden Execution Server Benutzerrollen bereitgestellt e Abschnitt 1 3 2 1 Administrator e Abschnitt 1 3 2 2 Deployer Weitere Execution Server Benutzerrollen k nnen im Identity Management definiert werden Standardm ig beinhaltet jede Execution Server Benutzerrolle die Berechtigungen Query users und Query groups die im Identity Management allgemein d h mit Bezug auf alle Execution Server Anwendungen definiert sind Diese Berechtigungen sind die Mindestvoraussetzung
64. gt lt address gt lt 2aip gt 12345 lt 2ip gt lt address gt lt value gt lt entry gt lt entry gt lt key gt 2234 993 77 lt key gt lt value gt lt name gt Peter Pan lt name gt lt address gt lt 219 gt 99999 lt zig gt lt address gt lt value gt lt entry gt lt customerMap gt 5 1 5 5 Aufz hlungen Der Wert f r eine Aufz hlung wird einfach durch Angabe des gew nschten Literals definiert Im folgende Beispiel wird f r eine Aufz hlung f r das Datenelement bonus card der Wert GOLD angegeben Bosch Software Innovations 48 58 Kapitel 5 Aufrufen von Regeln im Execution Server lt bonus _card gt GOLD lt bonus_card gt 5 1 6 Abbildung des Regelmodells auf WSDL Wird ein Regelmodell als Rule Service exportiert so wird die WSDL Datei mit folgender Prozedur erstellt e Die WSDL enth lt einen Service der lt rule model gt Service genannt wird e Jede exportierte Regel wird durch eine Operation in einem portType repr sentiert die mit dem Regelnamen endet Die WSDL Datei importiert einige XML Schema Dateien Die XML Schema Dateien werden folgenderma en erstellt e Es gibt eine XML Schema Datei f r jede Ebene im Regelmodell d h eine f r das Regelmodell selbst eine f r jedes Regelpaket und eine f r jede Regel Ablaufregel oder Entscheidungstabelle die f r das Exportieren als Rule Service gekennzeichnet wurde e Jede XML Schema Datei beinhaltet die Definitionen der Datentyp
65. ie folgenderma en vornehmen 1 F hren Sie f r die einzustellende Eigenschaft die entsprechende Eingabe Auswahl aus e Name der aktiven Konfiguration Eingabe des Namens der zu verwendenden Konfiguration e Statistiklevel Auswahl eines Statistiklevels aus der Dropdown Liste e G ltigkeitszeitraum Eingabe eines Start und oder Endzeitpunktes siehe Abschnitt 4 7 1 1 Eingabe von Datum und Uhrzeit e Aktiv Selektieren Deselektieren der CheckBox um den Rule Service zu aktivieren deaktivieren M chten Sie alle vorgenommenen Eingaben wieder auf die urspr nglich gespeicherten Werte zur cksetzen Sur ckset dann klicken Sie auf die Schaltfl che nnd f 2 z Speich Best tigen Sie die Anderungen indem Sie auf die Schaltfl che __ Speichern klicken Weiterf hrende Konzepte e Abschnitt 3 1 5 Rule Service Einstellungen Bosch Software Innovations 31 58 Kapitel 4 Arbeiten mit der Webkonsole 4 2 8 Verwaltung der Metadaten eines Rule Service 1 W hlen Sie in der Webkonsole den Eintrag Rule Services aus um die Sicht Rule Services zu ffnen 2 ffnen Sie die Detailseite des Rule Service dessen Metadaten Sie verwalten wollen indem Sie auf den zugehorigen Link klicken 3 Eu Klicken Sie auf Metadaten worauf die Metadatenseite ge ffnet wird Es gibt modellbezogene Metadaten eines Rule Service die im Regelmodell gespeichert sind und nach der Bereitstellung des Rule Service nicht mehr ver ndert
66. ige von Nachrichten der Laufzeitprotokollierung Sollte der Fall eintreten dass der Execution Server nicht starten kann oder es aus anderen Gr nden nicht m glich ist auf die Webkonsole zuzugreifen dann kann die Laufzeitprotokollierung in der vr_logging config Datei im Execution Server Home konfiguriert werden Das sollte nur in Ausnahmesituationen benutzt werden und ist nicht f r die Verwendung im Normalbetrieb gedacht Diese Einstellung ist nur m glich wenn der Execution Server nicht l uft Die Konfigurationsdatei wird nur beim Startvorgang eingelesen und Einstellungen in der Webkonsole berschreiben Werte in der Datei Bevor die Protokollierung in der Konfigurations Datei vorgenommen werden kann muss sichergestellt sein dass der Execution Server nicht l uft Dann kann die vr logging config Datei in einem Texteditor ge ffnet werden Die Datei enth lt XML Elemente names loggers und logger Diese haben Attribute names level welche den Protokollierungsgrad log level spezifizieren die hnlich zu den in Simple Logging Facade for Java SLFAJ sind Der Wert kann ge ndert werden zu TRACE DEBUG INFO WARN oder ERROR F r die Fehlersuche eignet sich DEBUG Nach dem Speichern der nderung sollte die Protokolldatei geleert werden damit Fehler leichter zu finden sind Beim anschlie enden Start des Execution Servers wird die neue Konfiguration angewendet und Nachrichten mit dem eingestellten Protokollierungsgrad sollten in der Protoko
67. iguriert werden einen speziellen Namen als Standardwert fur die aktive Konfiguration zu verwenden Dieser kann anders sein als derjenige der normalerweise in der Visual Rules Rule Execution API verwendet wird Dies wird dann als active configuration name verwendet wenn ein Rule Service ausgefuhrt wird Ein Aufrufer kann ein active configuration name auch in der Rule Service Anfrage angeben fur Details siehe Abschnitt 5 1 2 Format der Rule Service Anfrage Die Einstellung in der Anfrage bertrumpft in diesem Fall immer den Wert der am Rule Service eingestellt wurde 3 1 5 4 Statistiklevel Der Statistiklevel erlaubt es den Detaillierungsgrad der aufgezeichneten Statistiken einzustellen Das ist eine Eigenschaft der Visual Rules Rule Execution API die detailliert im Java Integration Handbuch beschrieben wird Der Execution Server sammelt Informationen von Ausf hrungen von Rule Services Im Rahmen dieser Funktionalit t k nnen auch Statistiken von Regeln aufgezeichnet werden Das kann auf zwei Arten verwendet werden Zum einen kann der Statistiklevel pro Rule Service eingestellt werden welcher dann als Standardwert bei der Ausf hrung verwendet wird Zum anderen k nnen Aufrufer einen Statistiklevel auch in der Rule Service Anfrage spezifizieren siehe Abschnitt 5 1 2 Format der Rule Service Anfrage welcher dann statt der Einstellung des Rule Service verwendet wird Generell gilt je h her der Detaillierungsgrad desto mehr Inf
68. installation des Execution Servers die unter der URL http localhost 8080 executionserver 6 x y verf gbar ist und ein Mandant mit ID 00e 02394 angenommen Wegen der Lesbarkeit wurden Zeilenumbr che eingef gt Normalerweise w rde die URL in einer Zeile eingegeben Die Platzhalter x und y entsprechen dabei der Versionsnummer aus dem Dateinamen der WAR Datei des Execution Servers http localhost 8080 executionserver 6 x y services 00ef 02394 wsdl ruleModel Movie 20Ticket 20Pricing amp rulePath Movie 20Ticket 20Pricing Pricing g amp effectiveDate 2008 01 01 In der URL im Beispiel wird eine WSDL f r das Regelmodell Movie Ticket Pricing Mit der Regel Pricing angefragt das g ltig ist am 2008 01 01 Zu beachten ist dass Sonderzeichen maskiert werden m ssen wenn sie in einer URL verwendet werden Beispiel 6 1 Beispiel einer URL mit dem Standard Metadata Mapper 6 2 1 3 Benutzerdefinierter Metadata Mapper Die Anpassung des Metadata Mapper ist ein fortgeschrittenes Thema da dies die Anpassung der Execution Server Installation die Erweiterung einer abstrakten Java Klasse und die Anderung einer XML Schema Datei erfordert Der Vorgang wird anhand eines Beispiels dargestellt Der angepasste Metadata Mapper wird mit dem Metadatum rating was die Kurzform f r Rating Verfahren ist der version und dem Metadatum rulePath welches die Regel spezifiziert die das Rating Verfahren ausf hrt arbeiten Letzteres wird aus technischen
69. it die deutsche bzw englische Sprache f r die Webkonsole einzustellen 1 ffnen Sie eine Seite der Webkonsole in Ihrem Web Browser 2 Bewegen Sie die Maus ber das Flaggensymbol im rechten Teil der Men leiste Klicken Sie im Kontextmen auf die Flagge wenn Sie die deutsche Sprache einstellen wollen bzw auf Pad bo die Flagge wenn Sie die englische Sprache wunschen 4 2 Verwaltung bereitgestellter Rule Services In der Sicht Rule Services des Visual Rules Execution Servers konnen Sie bereitgestellte Rule Services verwalten Wahlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services um diese Sicht zu ffnen Hier haben Sie folgende Moglichkeiten e Abschnitt 4 2 1 Anzeige bereitgestellter Rule Services Bosch Software Innovations 26 58 Kapitel 4 Arbeiten mit der Webkonsole e Abschnitt 4 2 2 Filterung angezeigter Rule Services e Abschnitt 4 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv e Abschnitt 4 2 4 L schen eines bereitgestellten Rule Service e Abschnitt 4 2 5 Anzeige der WSDL Datei eines Rule Service Abschnitt 4 2 6 Herunterladen eines Rule Service e Abschnitt 4 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service e Abschnitt 4 2 8 Verwaltung der Metadaten eines Rule Service Abschnitt 4 2 9 Anzeige der Ausf hrungen eines Rule Service e Abschnitt 4 2 10 Anzeige der erforderlichen
70. klicken Sie auf Module Verwalten e Klicken Sie auf das Modul Visual Rules Execution Server SOA e Im Drop down Men Reihenfolge der Klassenlader w hlen Sie Mit dem lokalen Klassenlader geladene Klassen zuerst bergeordneter zuletzt e Speichern Sie die Konfigurations nderung 3 Um den JNDI Namen f r den Execution Server in der Execution Server Propertiesdatei anzupassen gehen Sie wie folgt vor e Starten Sie die Execution Server Anwendung Die Execution Server Konfigurationsdatei wird mit initialen Werten angelegt e Stoppen sie die Execution Server Anwendung e Die Execution Server Konfigurationsdatei befindet sich im Execution Server Home Verzeichnis siehe Abschnitt 2 7 1 Execution Server Home unter config executionserver properties Passen Sie in dieser Datei folgendes Property an executionserver jndi name jdbc executionserverDS 4 Starten Sie den Execution Server 2 3 2 Spezifische Prozedur f r Deployment auf JBoss Wenn Sie einen JBoss Anwendungsserver benutzen ist die Prozedur den Execution Server zu Deployen wie folgt Bosch Software Innovations 10 58 Kapitel 2 Aufsetzen des Execution Servers JBoss kann den vorkonfigurierten JNDI Namen f r die Datenbank des Execution Servers nicht aufl sen 1 F gen Sie die executionserver war WAR Datei als neue Enterprise Application hinzu Mappen Sie den Context Root z B auf executionserver 2 Um den JNDI Namen f r den Execution Server in der Exec
71. klusses eines Regelprojekts viele verschiedene Versionen f r die Ausf hrungsumgebung zur Verf gung gestellt werden k nnen So k nnen mehrere Versionen des gleichen Regelprojekts zur gleichen Zeit eingesetzt werden Durch Verwendung der Versionsnummer kann ein Aufrufer genau spezifizieren welche Version der Regel aufgerufen werden soll Die drei Komponenten einer Versionsnummer werden major minor und micro genannt H here Nummern werden als neuere Versionen angesehen Die micro und oder minor Komponenten k nnen weggelassen werden und werden dann als 0 behandelt beispielsweise entspricht die Versionsnummer 2 6 der Nummer 2 6 0 und 1 entspricht 1 0 beziehungsweise 1 0 0 Optional kann nach der micro Komponente eine weitere Komponente angegeben werden die qualifier genannt wird Der Qualifier wird durch einen Bindestrich getrennt und kann zus tzlich zur Identifikation verwendet werden beispielsweise kann dies ein Zeitstempel sein Der Qualifier kann nicht nur Nummern enthalten sondern Bosch Software Innovations 20 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services auch Buchstaben A Z a z Unterstriche _ und Bindestriche Qualifier werden lexikographisch geordnet um zu bestimmen welche Version neuer ist Unter Umst nden kann es dazu kommen dass zwei Rule Services die gleiche Version haben aber nur einer der beiden einen qualifier hat Wenn in so einem Fall der Rule Service ohne eine spe
72. l die ausgef hrt werden soll Im Beispiel wird hierf r das rulePath Metadatum verwendet Die grundlegende Idee ist dass jeder Rule Service wei was seine Einstiegsregel ist Das erlaubt die Benutzung von Metadaten f r die Weiterleitung einer Anfrage ohne dass dabei ein Regelmodell oder dessen Regel angegeben werden muss Der folgende Ausschnitt zeigt die Implementierung der Methode mapRuleInvocationTarget Auch hier wird zuerst die Existenz eines Werts f r rating gepr ft Danach wird ein IServiceView f r die Metadaten gesucht Das erfordert genau die gleiche Zuordnung wie sie in mapRuleModelArtifact verwendet wird weshalb die vorher geschriebene findByMetaValues Methode wiederverwendet wird Danach wird das Metadatum rulePath ausgelesen ein RuleInvocationTarget erzeugt und zur ckgegeben public RuleInvocationTarget mapRuleInvocationTarget Properties metaData TArtifactStorageReadAccess artifactStorage throws AmbiguousRuleModelArtifactException String rating metaData getProperty rating if rating null throw new IllegalArgumentException No rating provided IServiceView serviceView findByMetaValues metaData artifactStorage if serviceView null Map metaValues serviceView getMetaValues if metaValues null IMetaValue metaValue IMetaValue metaValues get rulePath if metaValue null String rulePath metaValue getValue RuleInvocationTarget target new RuleInv
73. l der Installation e Windows MaintenanceTool cmd dumpTenantSchemaDDL tenantSchemaName lt tenantSchemaName gt sqlDumpFile lt dumpFileName gt executeSql dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt e Linux Solaris MaintenanceTool sh dumpTenantSchemaDDL tenantSchemaName lt tenantSchemaName gt sqlDumpFile lt dumpFileName gt executeSql dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt Das neue Mandantenschema wird registriert werden wenn ein Execution Server Benutzer sich das erste Mal fur den Mandanten einlogt Damit diese Registrierung funktioniert muss der Execution Server Datenbankbenutzer in der Lage sein existierende Schemata auszuw hlen um zu verifizieren dass das Datenbankschema fur den Mandanten tatsachlich existiert Wenn Sie das Pr fix VRS_ nicht fur das Mandantenschema verwenden wollen oder einfach einen beliebigen Namen fur das Mandantenschema verwenden wollen dann wird der Execution Server nicht in der Lage sein die automatische Registrierung fur dieses Mandantenschema durchzuf hren Daher m ssen Sie in diesem Fall die Registrierung mithilfe des Execution Server Maintenance Tools manuell durchf hren was auch als anbinden bezeichnet wird 2 Legen Sie die Datenbanktabellen f
74. llation starten 10 F llen Sie die folgenden Felder oder ndern Sie ggfs die Eintr ge e Dom nenname Name der Dom ne unter der Ihr Execution Server im Identity Management installiert werden wird e Anwendungsname Anwendungsname mit dem Ihr Execution Server im Identity Management installiert werden wird Administrator Administrator der berechtigt ist Anwendungen im Identity Management zu installieren 11 Klicken Sie auf Vorw rts gt gt 12 Die Seite Summary ffnet sich Zusammenfassung EN O Identity Management Verbindung Backend URL http localhost 8080 im server Webkonsole URL http localhost 8080 im ui Datenbankverbindung Marke h2 Globales Datenbankschema VRS Benutzerdefinierter Tabellenpr f ES Anwendungsspezifischer Tabellenpr fix EP Anwendungseinstellungen Anwendungsname EXECUTIONSERVER Dom nenname TAP Administrator Admin lt lt Zur ck Vorwarts gt gt Installation starten 13 Klicken Sie auf Installation starten 14 Der Execution Server wird installiert 2 4 2 Installieren des Execution Servers mit dem Maintenance Tool 2 4 2 1 Anlegen der Datenbanktabellen f r das globale Schema Um die Datenbanktabellen f r das globale Schema anzulegen tun Sie Folgendes 1 2 Extrahieren Sie die Distributionsdatei Execution Server 6 x x distribution zip Gehen Sie in der Kommandozeile zum Ordner maintenance Extrahieren Sie das Maintenance Tool Archiv maintena
75. lldatei zu finden sein Bosch Software Innovations 18 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services Kapitel 3 Erstellung und Bereitstellung von Rule Services 3 1 Konzepte 3 1 1 Rule Service Der Visual Rules Execution Server ist eine Ausfuhrungsumgebung fur Regeln Regeln werden mit dem Visual Rules Modeler erstellt und k nnen dann auf dem Visual Rules Execution Server bereitgestellt werden Einmal bereitgestellt stehen die Regeln fur jegliche andere Applikationen oder Systeme welche die Regeln aufrufen mochten zur Verfugung Der Visual Rules Execution Server stellt eine Web Service Schnittstelle zur Verfugung um Regeln aufzurufen Auf diese Weise wird jede Regel zu einem separaten Service ein sogenannter Rule Service Die Regeln fur einen Rule Service m ssen fur die Anwendung in eine Regelbibliothek gepackt werden Diese Bibliothek und die entsprechenden Services haben Versionsnummern um eindeutig wahrend des Lebenszyklusses eines Regelprojektes identifiziert werden zu k nnen Mehrere Versionen des gleichen Rule Service k nnen im Visual Rules Execution Server bereitgestellt und zur gleichen Zeit ausgef hrt werden Ein Rule Service wird durch eine WSDL Datei Web Service Description Language beschrieben die automatisch durch Visual Rules w hrend der Erstellung der Regelbibliothek generiert wird um dann nach der Bereitstellung verf gbar zu sein Auf die WSDL Dateien aller eingesetzten Rule Services kann
76. llerdings mit einem festen Namespace Weil die Information des Regel Modells und der aufzurufenden Regel nicht mehr im Namespace vorhanden sind m ssen diese nun Mit ruleModel und rulePath im target Element spezifiziert werden Deswegen ist target auch nicht mehr optional Es kann optional eine version angegeben werden was die gleiche Bedeutung wie im spezifischen VRRequest hat Bosch Software Innovations 45 58 Kapitel 5 Aufrufen von Regeln im Execution Server Als Alternative zur version kann ein Element effectiveDate angegeben werden welches die Anfrage anhand der Metadaten zu einem Rule Service leitet In Abschnitt 6 2 1 1 Standard Metadata Mapper ist die Funktionsweise genauer erkl rt Zu beachten ist dass die Elemente welche unter target eingetragen werden ebenfalls angepasst werden k nnen wenn ein benutzerdefinierter Matadata Mapper eingesetzt wird wie das in Abschnitt 6 2 1 3 Benutzerdefinierter Metadata Mapper beschrieben ist Das n chste Element ist configuration dass genau dasselbe ist wie in Abschnitt 5 1 2 Format der Rule Service Anfrage beschrieben Als n chstes kommt das input Element welches beliebige Elemente akzeptiert Das ist der Nachteil des generischen Ansatzes und dies ist zugleich der gr te Unterschied zur spezifischen Anfrage die genau beschriebt welche Elemente und Typen enthalten sind lt gen VRRequest xmlns vr http www visual rules com xmlns gen http www visual rules co
77. m g nstigsten Fall genau ein IServiceView brig der zur ckgegeben werden kann Es gibt jedoch auch die M glichkeit dass es mehrere Services oder gar keine gibt In letzterem Fall wird null zur ckgeben was impliziert dass nichts gefunden wurde F r mehrere Ergebnisse wird eine Ausnahme geworfen die Informationen zu den gefundenen Services und ihren Metadaten enth lt F r dieses Beispiel macht dies durchaus Sinn Die Anwendungslogik benutzt die Metadaten der Anfrage um einen passenden Rule Service zu finden Um genauer zu werden reicht die Angabe weiterer Werte in der Anfrage Je spezifischer das wird desto mehr Services k nnen ausgefiltert werden bis nur noch einer brig ist Die Art und Weise wie mit mehreren gefundenen Rule Services umgegangen wird kann nat rlich anders gehandhabt werden als im Beispiel Es sollte nur sichergestellt werden dass es das gleiche Verhalten ist wie bei der Implementierung der mapRuleInvocationTarget Methode private static IServiceView findByMetaValues Properties metaData IArtifactStorageReadAccess artifactStorage throws AmbiguousRuleModelArtifactException String ratingValue String metaData get rating if ratingValue null List services filter artifactStorage listServicesWithMetaValue rating ratingValue metaData final int size services size if size 1 return IServiceView services get 0 else if size gt 1 IServiceView serviceVie
78. m generic gt lt target gt lt ruleModel gt Movie Ticket Pricing lt ruleModel gt lt rulePath gt Movie Ticket Pricing Pricing lt rulePath gt lt Eines der beiden Elemente kann angegeben werden gt lt effectiveDate gt 2009 10 03 lt effectiveDate gt lt oder gt lt version gt 1 0 1 lt version gt lt target gt lt Optional gt lt vr configuration gt lt Die gleichen Elemente wie in der spezifischen Anfrage gt lt vr configuration gt lt input gt lt Diese Elemente werden nicht vom XML Schema definiert Die hier verwendeten Daten und Typen m ssen vom Regelinterface akzeptiert werden gt lt auditorium no gt 1 lt auditorium no gt lt seat_no gt 199 lt seat_no gt lt show _date gt 2008 08 22 lt show date gt lt coupon gt true lt coupon gt lt student gt true lt student gt lt bonus card gt GOLD lt bonus card gt lt input gt lt gen VRRequest gt Die Antwort einer generischen Anfrage unterscheidet sich nicht von der einer spezifischen Anfrage Related Concepts e Abschnitt 5 1 5 XML Repr sentation von Datentypen Beispiel 5 4 Generic VRRequest format 5 1 5 XML Repr sentation von Datentypen 5 1 5 1 Einfache Typen Einfache Typen werden auf folgende XML Schema Typen abgebildet Bosch Software Innovations 46 58 Kapitel 5 Aufrufen von Regeln im Execution Server String Werte werden einfach als Text abgebildet ohne Anf hrungszeichen Zum Beispi
79. n Servers im Identity Management Benutzen Sie f r diesen Schritt in jedem Fall den Installations Wizard wie beschrieben in Abschnitt 2 4 1 Installieren des Execution Server mit dem Installationsassistenten 2 4 1 Installieren des Execution Server mit dem Installationsassistenten Sie k nnen den Visual Rules Execution Server mithilfe des Installationsassistenten installieren Beim Installieren des Execution Server mit dem Installationsassistenten werden die wesentlichen Installationsschritte automatisch durchgef hrt Sobald der Execution Server bereitgestellt wurde ist der Installationsassistent im Web Browser erreichbar mit einer Adresse im Format lt protocol gt lt server gt lt port gt lt context name gt z B http localhost 8080 executionserver 6 x y 1 ffnen Sie den Installationsassistenten 2 Die Seite Identity Management Verbindung ffnet sich Bosch Software Innovations 11 58 Kapitel 2 Aufsetzen des Execution Servers Identity Management Verbindung Konfigurieren Sie die Verbindung zum Identity Management Backend URL http s lt hostname gt lt port gt lt path gt Webkonsole URL http s lt hostname gt lt port gt lt path gt Benutzername Passwort Mandant Zur ck Vorw rts gt gt Installation starten 3 Geben Sie die URLs vom Backend und der Webkonsole des Identity Management in den entsprechenden Feldern an 4 Geben Sie in den entsprechenden Feldern Be
80. n verschieben siehe Abschnitt 4 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service Weiterf hrende Aufgaben e Abschnitt 4 2 2 Filterung angezeigter Rule Services Abschnitt 4 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv Bosch Software Innovations 27 58 Kapitel 4 Arbeiten mit der Webkonsole e Abschnitt 4 2 4 L schen eines bereitgestellten Rule Service Abschnitt 4 2 5 Anzeige der WSDL Datei eines Rule Service e Abschnitt 4 6 Konfiguration der Anzeige von Tabelleninhalten 4 2 2 Filterung angezeigter Rule Services Auf der bersichtsseite der Sicht Rule Services k nnen Sie Filterkriterien spezifizieren um nur Rule Services die von Interesse sind anzuzeigen Name Filter anwenden Filter zur cksetzen Erweitert gt gt In diesem Abschnitt k nnen Sie den Namen des Rule Service als Filterkriterium angeben Sie haben die M glichkeit weitere Filterkriterien f r die Anzeige der Rule Services zu spezifizieren e Version e Bereitstellungszeitraum Dazu steht ein erweiterter Eingabedialog zur Verf gung Name Filter anwenden Filter zur cksetzen Erweitert lt lt Version Bereitstellungszeitraum Von E Bis E w Mehr Informationen zur Einga
81. nationalen Team arbeiten sollten Sie passende Namen f r Metadaten w hlen damit diese von jedem verstanden werden Mit Hilfe von Metadaten ist es m glich eine WSDL f r einen Rule Service abzuholen und der Execution Server ist in der Lage damit generische Anfragen zu einem Rule Service zu leiten Das h ngt von der eingesetzten Implementierung der Metadata Mapper Komponente ab Eine Standardimplementierung einer Metadata Mapper Komponente ist in Abschnitt 6 2 1 1 Standard Metadata Mapper beschrieben Es ist auch m glich eine benutzerdefinierte Implementierung zu verwenden Letzteres ist in Abschnitt 6 2 1 3 Benutzerdefinierter Metadata Mapper beschrieben 6 2 Metadaten definieren Metadaten bestehen aus einer Menge eindeutiger Schl ssel und zugeh riger Werte Es gibt zwei Wege um Metadaten zu bearbeiten Sie k nnen nach der Bereitstellung in der Webkonsole eingegeben werden was in Abschnitt 4 2 8 Verwaltung der Metadaten eines Rule Service beschrieben ist oder vor der Bereitstellung im Visual Rules Modeler Dabei werden die Metadaten im Regelmodell gespeichert und bilden eine feste Definition die nach der Bereitstellung nicht mehr ge ndert werden kann Das garantiert dass die Metadaten immer existieren auch wenn die Regelbibliothek auf mehreren Servern zum Einsatz kommt Zu beachten ist dass es weiterhin m glich ist zus tzliche Metadaten ber die Webkonsole anzugeben Um Metadaten im Visual Rules Modeler anzugeb
82. nceTool zip Gehen Sie in der Kommandozeile in den extrahierten Maintenance Tool Ordner Bosch Software Innovations 13 58 Kapitel 2 Aufsetzen des Execution Servers 5 Starten Sie das Maintenance Tool indem Sie eins der folgenden Kommandos verwenden angepasst an Umgebung und Ziel der Installation e Windows MaintenanceTool cmd dumpGlobalSchemaDDL executeSql sqlDumpFile lt dumpFileName gt globalSchemaName lt globalSchemaName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt e Linux Solaris MaintenanceTool sh dumpGlobalSchemaDDL executeSql sqlDumpFile lt dumpFileName gt globalSchemaName lt globalSchemaName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt Das Argument executeSql ist optional und muss nur spezifiziert werden wenn die Datenbanktabellen sofort angelegt werden sollen Ohne dieses Argument wurden die resultierenden SQL Statements lediglich in die durch das Argument sql DumpFile spezifizierte Datei ausgegeben und k nnen dann sp ter manuell ausgef hrt werden in diesem Fall m ssen die zu JDBC geh rigen Argumente auch nicht definiert werden Wenn das Argument spezifiziert wird muss der f r die jeweilige Datenbank geeignete Treiber in das Verzeichnis driver de
83. ndet wird wie in Abschnitt 1 4 2 1 Trennung der Mandantendaten beschrieben im application id Die eindeutige ID uuid mit der diese Anwendung beim Identity Management IM registriert ist Zu beachten ist dass dies nicht der Name der Anwendung ist und der Wert nur von IM geliefert werden kann im Trontend url Die URL der Webkonsolen Anwendung von Identity Management im backend url Die URL der Backend Anwendung von Identity Management Es gibt weitere wenn auch optionale Konfigurationseinstellungen welche nicht vom Installationsassistenten gesetzt werden license file G ltiger Dateipfad zu der Lizenzdatei des Execution Servers Wird nur ben tigt wenn sich die Lizenz nicht im Standardverzeichnis befindet Es ist ebenfalls m glich eine Lizenz in der Lizenz Verwaltung in der Sicht Wartung hinzuzuf gen localstorage workingdir Ort wo der Execution Server Artefakte als Jars speichert Standardm ig wird daf r das tempor re Verzeichnis des Web Containers benutzt welches durch das Kontextattribut Bosch Software Innovations 17 58 Kapitel 2 Aufsetzen des Execution Servers javax servlet context tempdir bestimmt ist Der Wert muss ein Pfad zu einem les und beschreibbaren Ordner sein metadata custom mapper Der voll qualifizierte Klassenname eines benutzer definierten Metadata Mappers Die Benutzung eines benutzerdefinierten Metadata Mappers ist in Abschnitt 6 2 1 3 Benutzerdefinierter Metadata Mapper g
84. nt einen VRRequest wie im Abschnitt 5 1 2 Format der Rule Service Anfrage beschrieben Beispielsweise kann dies so aussehen lt pricing VRRequest xmlns pricing http www visual rules com vrpath Movie 20Ticket 320Pricing Pricing gt lt input gt lt auditorium no gt 1 lt auditorium no gt lt seat_no gt 199 lt seat_no gt lt show _date gt 2008 08 22 lt show date gt lt coupon gt true lt coupon gt lt student gt true lt student gt lt bonus card gt GOLD lt bonus_ card gt lt input gt lt pricing VRRequest gt Nur der XML Namespace des VRRequest Elements wird vom Execution Server verwendet um die Anfrage an das korrekte Regelmodell weiterzuleiten Die URL des Service Endpunkts oder der SOAPAction HTTP Header sind nicht relevant f r die Weiterleitung Bosch Software Innovations 49 58 Kapitel 5 Aufrufen von Regeln im Execution Server 3 Optional kann das target Element als das erste Element im VRRequest hinzugefugt werden um genau zu spezifizieren welche Version des Regelmodells aufgerufen werden soll Wenn dies weggelassen wird ruft der Execution Server die neueste Version auf 4 Wenn der Regelaufruf erfolgreich ist erhalten Sie eine VRResponse wie in Abschnitt 5 1 3 Format der Rule Service Antwort beschrieben Die Ergebnisse des Regelaufrufs k nnen im output Element der VRResponse gefunden werden Das zus tzliche Trace Element beinhaltet Informationen ber das aufgerufene Regelmodell
85. nutzernamen Passwort und Mandant f r einen Administrator an der berechtigt ist Anwendungen im Identity Management zu installieren Die Execution Server Anwendung wird mit dem betreffenden Benutzer im Identity Management registriert 5 Klicken Sie auf Vorwarts gt gt 6 Die Seite Datenbankverbindung ffnet sich Datenbankverbindung Konfigurieren Sie die Datenbankverbindung f r den Execution Server JNDI Name java comp env jdbc executionserverDS Marke H2DB v Globales Datenbankschema Benutzerdefinierter Tabellenpr fix Anwendungsspezfischer Tabellenprafix EP Verbindung testen lt lt Zur ck Vorw rts gt gt Installation starten 7 F llen Sie die folgenden Felder oder ndern Sie ggfs die Eintr ge e Marke Hersteller der Datenbank e Globales Datenbankschema Name des Datenbankschemas welches die Datenbanktabellen f r die Schemaverwaltungskomponente die von allen Visual Rules Suite Anwendungen verwendet wird e Benutzerdefinierter Tabellenpr fix Pr fix der Execution Server spezifischen Datenbanktabellen 8 Klicken Sie auf Vorw rts gt gt 9 Die Seite Anwendungseinstellungen ffnet sich Bosch Software Innovations 12 58 Kapitel 2 Aufsetzen des Execution Servers Anwendungseinstellungen Spezifizieren Sie Einstellungen f r die Execution Server Anwendung Dom nenname IAP Anwendungsname EXECUTIONSERVER Administrator v lt lt Zur ck Vorw rts gt gt Insta
86. ocationTarget serviceView rulePath return target throw new RuntimeException No rulePath provided in service serviceView return null Dieses Beispiel beachtet nicht ob ein Rule Service aktiv ist oder nicht Damit lassen sich somit auch eigentlich inaktive Rule Services aufrufen Das kann durch eine Anpassung der filter Methode ge ndert werden indem dort inaktive Services ausgefiltert werden Als n chstes muss der Execution Server konfiguriert werden um das Beispiel RatingMetaDataMapper zu benutzen Das wird erreicht durch die Einstellung visualrules executionserver metadata custom mapper wie es in Abschnitt 2 7 Konfiguration des Execution Servers beschrieben ist Der Wert ist der vollqualifizierte Klassenname von RatingMetaDataMapper Mit dieser Konfiguration wird der Execution Server die Klasse beim Hochfahren laden Es ist daher notwendig dass sich die Klasse auf dem Klassenpfad befindet Dies h ngt vom eingesetzten Application Server ab Beispielsweise kann dies im Tomcat erreicht werden indem die Klasse in ein JAR gepackt und in das Verzeichnis WEB INF 1ib der ausgepackten Webapplikation gelegt wird Bosch Software Innovations 56 58 Anhang A Rule Service Klassenlader and Hierarchie Anhang A Rule Service Klassenlader and Hierarchie A 1 Rule Service Klassenlader Der Execution Server ist in der Lage mehrere Versionen von Rule Services gleichzeitig zu betreiben Das wird erreicht du
87. ormation wird aufgezeichnet Die folgenden Detaillierungsgrade sind verf gbar e Quiet Statistiken der Regeln werden nicht aufgezeichnet und sind nicht zum Herunterladen verf gbar e Low Besuche von Regelelemente werden gez hlt e Medium Zeit die in einem Regelelement verbracht wird wird gemessen e High Minimale und maximale Zeit die in einem Regelelement verbracht wird wird gemessen Zus tzlich zu den Leveln in der Visual Rules Rule Execution API hat der Execution Server den Level Quiet mit dem die Aufzeichnung der Statistik abgeschalten werden kann Durch die Einstellung Switched off kann ein Rule Service so konfiguriert werden dass keine Ausf hrungen aufgezeichnet wird Ein spezifizierter Statistiklevel eines Aufrufers hat somit keine Auswirkung 3 2 Arbeitsschritte 3 2 1 Regeln festlegen die als Rule Service exportiert werden sollen Nur exportierte Regeln k nnen durch einen Rule Service Client aufgerufen werden Somit muss mindestens eine Regel eines Regelmodells exportiert werden um einen Rule Service zu erstellen Um zu spezifizieren welche Regeln exportiert werden sollen f hren Sie folgendes durch 1 Im Projekt Explorer oder Regel Explorer w hlen Sie eine Regel zum Exportieren aus 2 Gehen Sie auf die Seite Web Service in der Sicht Eigenschaften 3 Aktivieren Sie das K stchen Regel als Web Service bereitstellen WSDL operation l Eigenschaften 2 an E Add i f Fa Aktionen 7 Er l Da
88. pt 4 Es ffnet sich ein Dialog in dem Sie best tigen k nnen dass Sie die Aktion wirklich durchf hren m chten Klicken Sie zur Best tigung auf die Schaltfl che 4 5 Wartung des Execution Servers 4 5 1 Lizenzen verwalten 1 W hlen Sie in der Webkonsole den Eintrag Wartung aus um die Sicht Wartung zu ffnen 2 Klicken Sie auf die Schaltfl che gt Lzenz verwatung worauf die Seite Lizenz Verwaltung ge ffnet wird we Lizenz hinzuf gen Datei Lizenznehmer Typ Wartung endetam G ltig Version license txt Visual Rules Development Full unbegrenzt unbegrenzt 6 Sie zeigt die Lizenzdateien f r den Visual Rules Execution Server Dabei sind f r jede Lizenzdatei folgende Informationen angegeben e Name der Lizenzdatei e Lizenznehmer e Lizenztyp e Wartungsende e G ltigkeit e Version Au erdem haben Sie die folgenden M glichkeiten e Abschnitt 4 5 1 1 Lizenz hinzuf gen Bosch Software Innovations 38 58 Kapitel 4 Arbeiten mit der Webkonsole Abschnitt 4 5 1 2 Lizenz l schen 4 5 1 1 Lizenz hinzuf gen Um eine Lizenz hinzuzuf gen gehen Sie vor wie folgt 1 Klicken Sie auf der Seite Lizenz Verwaltung auf Fa Lizenz hinzuf gen 2 Der folgende Dialog erscheint Lizenz hinzuf gen Datei Durchsuchen Hinzuf gen Abbrechen 3 Klicken Sie auf Durchsuchen und w hlen Sie eine Lizenzdatei von Ihrem Dateisystem 4 Klicken Sie auf Hinzuf gen 4 5 1 2
89. rch die Erzeugung eines Klassenladers fur jeden Rule Service Diese Klassenlader sind voneinander isoliert um Probleme beim Klassen laden zu vermeiden Jeder Rule Service hat Information ber erforderliche Abh ngigkeiten f r die Ausf hrung Diese wird zum Zeitpunkt der Erstellung erzeugt und in der Webkonsole kann diese eingesehen werden Wird ein Rule Service zum ersten Mal angefragt dann wird ein Klassenlader erzeugt Dieser l dt Klassen aus der Regelbibliothek und allen abh ngigen Bibliotheken inklusive der Visual Rules Runtime Falls eine Bibliothek nicht bereitgestellt wurde wird eine Ausnahme geworfen welche die Gruppen Id Artefakt Id und Version der fehlenden Bibliothek enth lt Das ist ein Fr herkennungs Mechanismus der Fehler wie die ClassNotFoundException bei der Ausf hrung von Rule Services verhindert deren Ursache schwer zu ermitteln sind Die Erzeugung eines Klassenladers ben tigt seine Zeit Damit dies nicht bei jeder Anfrage geschieht werden die Klassenlader vom Execution Server in einem Cache vorgehalten Nachfolgende Aufrufe des Rule Service werden dadurch schneller ausgef hrt da ein Klassenlader bereits verf gbar ist Der Cache ist so lange aktiv wie der Rule Service verwendet wird Wird innerhalb einer l ngeren Zeit der Rule Service nicht aufgerufen wird der Klassenlader entfernt um Speicher frei zu geben Wird der Rule Service danach wieder angefragt wird der Klassenlader automatisch neu erzeugt A 2 Klassenla
90. rderliche Berechtigung verf gen Siehe auch Abschnitt 1 3 Berechtigungs Konzept 1 Im Regel Explorer oder Projekt Explorer machen Sie einen Rechtsklick auf das Regelprojekt das bereitgestellt werden soll 2 W hlen Sie den Visual Rules gt Als Web Service bereitstellen Men eintrag Der Assistent f r die Bereitstellung erscheint gt Als Web Service bereitstellen Rule Service definieren und hochladen Bibliothek und Verbindungseinstellungen festlegen Gruppen ID mowie ticket pricing Artefakt ID Mowie Ticket Pricing Version 0 0 1 SNAPSHOT Exportiertes Regel modell t Optionale Rule Service Einstellungen Y Execution Server Einstellungen URL http localhost 080 executionserver admin upload Benutzer Admin Passwort eesse Mandant DEFAULT Fertigstellen Abbrechen 3 Die Artefakt ID Gruppen ID und Version sind auf der ruleproject vr definiert und werden zur Identifizierung des Artefakts JAR verwendet Diese Version gilt fur die Regelbibliothek selbst und den Rule Service der bereitgestellt wird 4 Wenn das Regelprojekt mehrere Regelmodelle enthalt mussen Sie auswahlen welches Regelmodell exportiert werden soll Erweitern Sie den Abschnitt Exportiertes Regelmodell und wahlen Sie das Regelmodell zum Exportieren aus Dies ist nicht notwendig wenn das Regelprojekt nur ein einziges Regelmodell hat 5 Im Abschnitt Optionale Rule Service Einstellungen k nnen Werte f r die G ltigkeitsdauer ein
91. rkriterien und der Anwendung des Filters finden Sie in Abschnitt 4 7 Filterung angezeigter Objekte 4 3 3 L schen von Ausf hrungen von Rule Services Sie haben die M glichkeit eine bestimmte Ausf hrung oder alle in der Sicht Ausf hrungen angezeigten Ausf hrungen zu l schen M chten Sie beispielsweise alle Ausf hrungen die vor einem bestimmten Zeitpunkt liegen l schen dann k nnen Sie sich durch Filterung der Ausf hrungen Filterkriterium Ausf hrungszeitraum die entsprechenden Ausf hrungen anzeigen lassen und darauf die L schoperation ausf hren 1 W hlen Sie in der Webkonsole den Eintrag Ausf hrungen aus um die Sicht Ausf hrungen zu ffnen x Wenn Sie eine einzelne Ausf hrung l schen m chten dann klicken Sie auf das Symbol der Ausf hrung die Sie l schen m chten oder wenn Sie alle aktuell angezeigten Ausf hrungen l schen m chten dann klicken Sie dort auf die Schaltfl che nf ah a Loschen 3 Es ffnet sich ein Dialog in dem Sie best tigen k nnen dass Sie die Aktion wirklich durchf hren m chten Klicken Sie zur Best tigung auf die Schaltfl che ei A Weiterf hrende Aufgaben Abschnitt 4 3 1 Anzeige der Ausf hrungen von Rule Services 4 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Ausf hrungen aus um die Sicht Ausf hrungen zu ffnen Bosch Software Innovations 35 58
92. s Maintenance Tools gelegt werden Wenn das Maintenance Tool ohne irgendwelche Argumente gestartet wird werden die m glichen Argumente auf die Konsole geschrieben Falls manche der Argumente die f r das Ausf hren einer bestimmten Aufgabe ben tigt werden nicht in der Kommandozeile spezifiziert sind werden die ben tigten Argumente ber den Argumentbeschreibungen angezeigt Unter Verwendung des folgenden Kommandos k nnen Sie eine Properties Datei schreiben wobei Sie Standardwerte f r Argumente definieren k nnen e Windows MaintenanceTool cmd writeOptionProperties maintenance properties e Linux Solaris MaintenanceTool sh writeOptionProperties maintenance properties Sie k nnen die Standardwerte wiederverwenden indem Sie das Argument readOptionProperties spezifizieren wie im folgenden Beispiel gezeigt e Windows MaintenanceTool cmd dumpExecutionServerDDL dbBrand oracle readOptionProperties maintenance properties e Linux Solaris MaintenanceTool sh dumpExecutionServerDDL dbBrand oracle readOptionProperties maintenance properties Im obigen Beispiel w rden die Werte f r die Argumente tenantSchemaName und tablePrefix aus der Datei bernommen vorausgesetzt dass sie dort definiert sind Der Wert f r das Argument dbBrand w rde unabhhangig davon ob das Argument in der Datei spezifiziert wurde aus der Kommandozeile bernommen da die in der Kommandozeile spezifizierten Argumente Vorr
93. spielsweise wenn in der Anfrage die zu verwendende Version nicht festgelegt wurde Um die Statistiken nach der Ausf hrung auf dem Execution Server zu identifizieren wird die angegebene oder generierte requestid zur ckgeliefert Mehr zu Statistiken ist in Abschnitt 4 3 1 Anzeige der Ausf hrungen von Rule Services zu finden Als letztes Element wird der Name der aktiven Konfiguration active configuration name ausgegeben der entweder in der Anfrage oder als Einstellung des Rule Service spezifiziert wurde Auch hier wird aus Kompatibilit tsgr unden f r ltere Rule Services das Element binding zur ckgeliefert lt pricing VRResponse xmlns vr http www visual rules com xmlns pricing http www visual rules com vrpath Movie 20Ticket3 320Pricing Pricing gt lt output gt lt price gt 7 lt price gt lt output gt lt vr trace gt lt ruleModel gt Movie Ticket Pricing lt ruleModel gt lt rulePath gt Movie Ticket Pricing Pricing lt rulePath gt lt version gt 1 0 1 lt version gt lt requestId gt 3919c5b8 5bfc 11de b728 456c9d794642 lt requestid gt lt Optional gt lt activeConfigurationName gt test lt activeConfigurationName gt lt oder gt lt binding gt test lt binding gt lt vr trace gt lt pricing VRResponse gt Beispiel 5 3 VRResponse Format Weiterf hrende Konzepte e Abschnitt 5 1 5 XML Repr sentation von Datentypen 5 1 4 Generische Rule Service Anfragen Der gew hnliche
94. t lt sessionStatistics gt lt vr configuration gt lt input gt lt auditorium no gt 1 lt auditorium no gt lt seat no gt 1L99 lt seat o gt lt show _date gt 2008 08 22 lt show date gt lt coupon gt true lt coupon gt lt student gt true lt student gt lt bonus card gt GOLD lt bonus_ card gt lt input gt lt pricing VRRequest gt Beispiel 5 2 VRRequest Format Weiterf hrende Konzepte e Abschnitt 5 1 5 XML Repr sentation von Datentypen 5 1 3 Format der Rule Service Antwort Das u erste Element einer Antwort auf eine Regel Anfrage wird VRResponse genannt Der Namespace ist der gleiche wie f r die Anfrage Die VRResponse hat ein Element mit dem Namen output dass die Werte f r alle Ausgabedatenelemente einer Regel enth lt Im Normalfall enth lt die Antwort auch Aktionen Es ist zu beachten dass dies konfiguriert werden Bosch Software Innovations 44 58 Kapitel 5 Aufrufen von Regeln im Execution Server kann wie in Abschnitt 3 2 3 Einstellen von Aktionen als R ckgabewert erl utert Der Abschnitt 5 1 5 XML Repr sentation von Datentypen beschreibt die XML Repr sentation f r die Werte hier Schlie lich gibt es ein Element trace das die Informationen dar ber zur ckgibt welche Regel in welcher Version von welchem Regelmodell gerade aufgerufen wurde Dies dient dem Zweck der Nachverfolgbarkeit so dass immer klar erkenntlich ist welche Regeln ausgef hrt wurden bei
95. t Regelbibliothek und Rule Service Der Visual Rules Modeler paketiert Regelbibliotheken so dass sie den Regelcode von allen Regelmodellen im Projekt UND den Regelcode von allen abhangigen Regelmodellen enthalten Die Regelbiblothek beinhalt auch alle Klassen von anderen Bibliotheken und Java Projekten auf dem Erstellungspfad des Projekts Auf diese Weise enthalt die resultierende Regelbibliothek alle ben tigten Klassen f r die Regeln zur Ausf hrung Beachten Sie jedoch dass die Visual Rules Laufzeit Bibliotheken nicht in die Regelbibliothek gepackt werden Sie werden zur Laufzeit automatisch zum Klassenpfad des Execution Servers hinzugef gt Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service e Abschnitt 3 1 3 Versionen von Regelbibliothek und Rule Service Weiterf hrende Arbeitsschritte e Abschnitt 3 2 1 Regeln festlegen die als Rule Service exportiert werden sollen 3 1 3 Versionen von Regelbibliothek und Rule Service Eine Regelbibliothek hat immer eine Versionsnummer Diese Versionsnummer wird verwendet um eine spezifische Regelbibliothek und Rule Service w hrend der Bereitstellung und der Ausf hrung von Regeln zu identifizieren Die Versionsnummer besteht aus drei individuellen Nummern die durch Punkte getrennt sind d h 1 0 0 oder 12 4 11 Versionsnummern werden verwendet um eindeutig eine spezifische Version einer Regelbibliothek zu identifizieren Dies ist notwendig weil w hrend des Lebenszy
96. t z B das Erzeugen der Mandantenschemata und Ihre Initialisierung mit Datenbankobjekten wie Tabellen Um dies tun zu k nnen muss der Datenbankbenutzer der vom Execution Server f r die Datenbankverbindung verwendet wird zu folgenden Aktionen berechtigt sein e Erzeugen neuer Schemata in der Datenbank e Initialisieren dieser Schemata mit Tabellen und anderen Datenbankobjekten e Ausf hren regul rer Datenbankoperationen auf diesen Objekten 2 1 1 1 Beispiel Oracle Datenbank Wenn der Execution Server im automatischen Modus betrieben werden soll muss ein Datenbankadministrator die folgenden Statements ausf hren um die Datenbank f r die Installation des Execution Server vorzubereiten Bosch Software Innovations 7 58 Kapitel 2 Aufsetzen des Execution Servers Create a database user which the Execution Server uses to connect to the database This user must have sufficient privileges for regular operation of the Execution Server and additionally to create database schemata for new tenants automatically the specification of the tablespaces in the example is optional create user lt username gt identified by lt password gt default tablespace lt tablespaceName gt temporary tablespace TEMP grant login privilege so the Execution Server is able to connect to the database grant create session to lt username gt grant create user privilege so that the Execution Server is capable to create a database schema
97. t 3 1 1 Rule Service e Abschnitt 3 1 2 Regelbibliothek e Abschnitt 5 1 2 Format der Rule Service Anfrage e Abschnitt 5 1 3 Format der Rule Service Antwort 3 2 3 Einstellen von Aktionen als R ckgabewert Aktionen sind ein Teil des Ergebnisses eines Regelaufrufs Somit sind sie auch Teil der R ckgabe der generierten XML Schema Dateien f r einen Rule Service Es ist m glich einzustellen ob Aktionen als R ckgabewert behandelt werden Das f hrt dann zu unterschiedlichen XML Schema Definitionen f r einen Web Service Um dies einzustellen f hren Sie folgende Schritte durch 1 Im Projekt Explorer oder Regel Explorer w hlen Sie das entsprechende Regelmodell aus Dies ist das Regelmodell welches f r den Rule Service exportiert wird 2 Gehen Sie auf die Seite Web Service in der Sicht Eigenschaften 3 Durch Einstellen der Checkbox kann das Verhalten umgestellt werden Das hat einen Effekt auf die Elemente welche in der Antwort zur ckgeliefert werden Bosch Software Innovations 23 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services 3 2 4 Bereitstellen von Regelprojekten vom Visual Rules Modeler Regelprojekte k nnen direkt im Visual Rules Modeler paketiert und auf dem Execution Server bereitgestellt werden Diese Funktionalitat ist auch in Visua Rules Builder und Visual Rules Team Platform beide separat verf gbar enthalten F r die Bereitstellung muss der Benutzer ber die erfo
98. t sich eine Liste aus der Sie einen Zeitpunkt Stunden und Minuten ausw hlen k nnen Bosch Software Innovations 41 58 Kapitel 4 Arbeiten mit der Webkonsole 4 7 2 Anwenden eines Filters Soll die Filterung der Objekte einer Tabelle ausgefuhrt werden klicken Sie im Filterabschnitt auf die Schaltflache Fi Fiter See Anschlie end wird die Anzeige der zugeh rigen Tabelle aktualisiert und es werden nur solche Objekte angezeigt deren Eigenschaften mit den spezifizierten Filterkriterien bereinstimmen Bosch Software Innovations 42 58 Kapitel 5 Aufrufen von Regeln im Execution Server Kapitel 5 Aufrufen von Regeln im Execution Server 5 1 Konzepte SOAP Nachrichten werden verwendet um Rule Services im Execution Server aufzurufen Der SOAP Envelope einer Nachricht umfasst einen SOAP Header der Authentifizierungsdaten beinhaltet und einen SOAP Body der zur Spezifikation der Rule Service Anfrage verwendet wird 5 1 1 Authentifizierung f r eine Rule Service Anfrage Der SOAP Header enth lt Elemente die in der Spezifikation der Web Service Security definiert sind Es gibt ein Security Element zur bermittlung sicherheitsrelevanter Informationen in einer SOAP Nachricht Das enthaltene UsernameToken Element dient dazu einen Benutzernamen und zus tzliche Attribute die zur Authentifizierung n tig sind Passwort und Mandant des Benutzers zur Verf gung zu stellen Beispielsweise kann dies so aussehen
99. ten mit der Webkonsole beschrieben Mit dem Log Datei herunterladen beschrifteten Link kann die ausgew hlte Protokolldatei heruntergeladen werden 4 6 Konfiguration der Anzeige von Tabelleninhalten Die tabellarische Anzeige von Informationen in der Webkonsole kann oftmals auf folgende Art und Weise verandert werden Abschnitt 4 6 1 Ein und Ausblenden von Spalten e Abschnitt 4 6 2 Verschieben einer Spalte Abschnitt 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge 4 6 1 Ein und Ausblenden von Spalten In vielen Tabellen ist es m glich die Anzeige bestimmter Spalten zu aktivieren deaktivieren 1 Bewegen Sie die Maus ber die berschrift einer beliebigen Spalte der Tabelle Klicken Sie auf um das Kontextmen zu ffnen 2 Gehen Sie mit der Maus auf den Men punkt Spalten worauf sich ein weiteres Kontextmen ffnet in dem ausblendbare Spalten aufgef hrt werden 3 Aktivieren Deaktivieren Sie die Checkbox der Spalten die Sie ein ausblenden m chten 4 6 2 Verschieben einer Spalte In vielen Tabellen haben Sie die M glichkeit die Reihenfolge der Spalten zu ver ndern 1 Eine Spalte kann per Drag amp Drop an eine andere Position verschoben werden Klicken Sie auf die berschrift der Spalte die Sie verschieben m chten und halten Sie die linke Maustaste gedr ckt 2 Bewegen Sie die Maus nach links bzw rechts W hrend der Mausbewegung erscheinen Symbole die
100. tentypen Regel als Web Service bereitstellen WSDL Operation Web Service Beschreibung Bosch Software Innovations 22 58 Kapitel 3 Erstellung und Bereitstellung von Rule Services Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service e Abschnitt 3 1 2 Regelbibliothek 3 2 2 XML Namespace f r Rule Services definieren Die generierte WSDL und die XML Schemata f r einen Rule Service verwenden einen spezifischen XML Namespace Wenn Sie die Namespace URI f r einen Rule Service anpassen m chten f hren Sie folgende Schritte durch 1 Im Projekt Explorer oder Regel Explorer w hlen Sie das entsprechende Regelmodell aus Dies ist das Regelmodell welches f r den Rule Service exportiert wird 2 Gehen Sie auf die Seite Web Service in der Sicht Eigenschaften 3 Geben Sie den XML Schema Namespace Pr fix ein Dies muss eine g ltige URI sein typischerweise wird http als Schema verwendet Der vollstandige Namespace URI im WSDL und XML Schema wird spater aus diesem Prafix gebildet gefolgt vom Segment vrpath gefolgt vom Pfad der spezifischen Regel Ist kein Pr fix angegeben wird http www visual rules com als Standardwert verwendet Adder ze Web Service Erweiterungen ML Schema Namespace Pr fix http Foo barjrules 00000 Beschreibung Notizen Aktionen als R ckgabewerte behandeln m Zur Weiterf hrende Konzepte e Abschnit
101. theken bersicht Artefakt ID Filter anwenden Filter zur cksetzen Erweitert gt gt Artefakt ID Version Gruppen ID a activation 1 1 javax activation a commons collections 3 2 2 commons collections commons lang 2 5 commons ang a commons logging 1 0 3 commons ogging O mail 1 4 2 javax mail a stax 1 2 0 stax a stax api 1 0 stax a visualrules runtime 5 5 0 SNAPSHOT de visualrules a visualrules runtime 6 0 0 de visualrules a visualrules runtime 5 2 0 de visualrules xmibeans 2 4 0 org apache xmlbeans Seite 1 voni Standardm ig werden folgende Eigenschaften der Bibliotheken angezeigt e Artefakt ID e Version e Gruppen ID Sie k nnen das Layout der angezeigten Eigenschaften beeinflussen indem Sie beispielsweise e bestimmte Eigenschaften ein bzw ausblenden Neben den standardm ig angezeigten Eigenschaften gibt es noch weitere Eigenschaften wie Bereitgestellt von und Bereitgestellt am die eingeblendet werden k nnen siehe Abschnitt 4 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalten verschieben siehe Abschnitt 4 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 4 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge Bosch Software Innovations 36 58 Kapitel 4 Arbeiten mit der Webkonsole Sind Sie nur an den Bibliotheken interessiert die ein bestimmter Rule Service ben tigt dann k nn
102. twendigkeit und Vorteile der Datentrennung Bosch Software Innovations 3 58 Kapitel 1 Einleitung 1 4 2 1 Trennung der Mandantendaten Da der Execution Server Mandantenfahigkeit unterstutzt muss sichergestellt sein dass die Daten der Mandanten z B Bibliotheken Ausfuhrungen usw getrennt abgelegt werden Dazu braucht jeder Mandant einen eigenen privaten Bereich f r seine Daten Dies wird erreicht indem f r jeden Mandanten ein eigenes Datenbankschema verwendet wird Dar berhinaus wird ein zus tzliches Datenbankschema ben tigt um globale d h nicht mandantenspezifische Information zu speichern so wie das Mapping zwischen den Mandanten und den ihnen zugewiesenen Datenbankschemata Execution Server Cr z VRS_TENANT_1 1 4 2 2 Trennung der Anwendungsdaten Im Gegensatz zum herk mmlichen Ansatz fur jede Anwendung ein eigenes Datenbankschema zu verwenden verwendet der Visual Rules Execution Server f r jeden Mandanten ein eigenes Datenbankschema Der Grund hierf r liegt in der Tatsache dass die Trennung der Mandantendaten erste Priorit t hat Anwendungen trennen ihre Daten durch die Verwendung einer Art von Namensraum Ein eigener Namensraum f r jede Anwendung erm glicht die gemeinsame Verwendung eines Mandantenschemas durch verschiedene Anwendungen So wird sichergestellt dass eine Anwendung nicht die Daten anderer Anwendungen beeinflu t nicht einmal wenn diese vom gleichen Typ sind wie z B zwei
103. ue if version equals key if value null amp amp value equals serviceView getVersion return false else if metaValues containsKey key return false else if matchesValue value IMetaValue metaValues get key return false return true Die matchesValue Methode vergleicht nur die Werte unter Ber cksichtigung von null private static boolean matchesValue String value IMetaValue metaValue if value null return metaValue getValue null else return value equals metaValue getValue Damit ist der notwendige Code geschrieben um eine WSDL mittels Metadaten abzuholen Zum Beispiel ist es jetzt m glich eine WSDL f r einen Rule Service anzufragen der ein Rating Verfahren PD benutzt und von John Doe erstellt wurde die Platzhalter x und y entsprechen der Versionsnummer aus dem Dateinamen der WAR Datei des Execution Servers und 00ef 02394 stellt die ID des Mandanten dar http localhost 8080 executionserver 6 x y services 00ef 02394 wsdl rating PD amp author John Doe Bosch Software Innovations 55 58 Kapitel 6 Arbeiten mit Metadaten Der letzte Schritt f r das Beispiel ist die Implementierung der Methode mapRuleInvocationTarget Diese wird aufgerufen wenn eine generische Anfrage an den Execution Server geschickt wird Weil hierbei etwas ausgef hrt wird spezifiziert der R ckgabewert auch die Rege
104. uf deren Objekte sich die Filterung beziehen soll Initial ist die Eingabe eines wichtigen Filterkriteriums m glich Um weitere Filterkriterien eingeben zu k nnen k nnen Sie in einen erweiterten Eingabedialog mit zus tzlichen Eingabefeldern wechseln Dazu gibt es im Filterabschnitt die Schaltfl che PSR een Den erweiterten Dialog k nnen Sie wieder verlassen indem Sie dort auf die Schaltfl che RERUNS klicken Sie k nnen die Eingabe aller Filterkriterien r ckg ngig machen indem Sie auf die Schaltfl che Palsaan e Seea klicken Die Filtereingabefelder sind danach leer Zudem wird die Anzeige der zugeh rigen Tabelle aktualisiert 4 7 1 1 Eingabe von Datum und Uhrzeit Die Eingabefelder zur Spezifikation eines Datums und einer Uhrzeit haben folgendes Aussehen 20 01 2011 12 320 v Zur Eingabe eines Datums klicken Sie auf das Symbol 4 sodass sich ein Kalender ffnet Januar 2011 Hier k nnen Sie per Mausklick ein Datum ausw hlen das dann automatisch in das Datumsfeld bernommen wird Der Kalender bietet auch die M glichkeit den Monat und das Jahr zu wechseln Klicken Sie dazu auf die Monats berschrift im Kalender sodass sich folgende Ansicht zur Auswahl ffnet Abbrechen In dieser Ansicht k nnen Sie mit der Maus einen Monat in einem bestimmten Jahr ausw hlen Best tigen Sie Ihre Wahl anschlieBend mit OK Zur Eingabe einer Uhrzeit klicken Sie auf das Symbol neben dem zweiten Eingabefeld Es ffne
105. ur einen einzelnen Mandanten an indem Sie folgendes Kommando ausfuhren angepasst an Umgebung und Ziel der Installation e Windows MaintenanceTool cmd dumpExecutionServerDDL tenantSchemaName lt tenantSchemaName gt tablePrefix lt tablePrefix gt executeSql sgqlDumpFile lt dumpFileName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt e Linux Solaris MaintenanceTool sh dumpExecutionServerDDL tenantSchemaName lt tenantSchemaName gt tablePrefix lt tablePrefix gt executeSql sgqlDumpFile lt dumpFileName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdbcUrl lt jdbcUrl gt dbUser lt adminUserName gt dbPassword lt adminUserPassword gt Die tenantId bezieht sich auf die technische ID des Mandanten so wie sie in dem Identity Management gefuhrt wird an das der Execution Server angebunden ist 3 Binden Sie falls n tig das Mandantenschema an einen Mandanten indem Sie folgendes Kommando ausf hren angepasst an Umgebung und Ziel der Installation e Windows MaintenanceTool cmd dumpTenantBindingSQL tenantId lt tenantId gt globalSchemaName lt globalSchemaName gt tenantSchemaName lt tenantSchemaName gt executeSql sglDumpFile lt dumpFileName gt dbBrand lt dbBrand gt dbDriverClass lt driverClassName gt jdAbcUrl lt jdbcUrl gt dbUser lt adminUserN
106. ution Server Propertiesdatei anzupassen gehen Sie wie folgt vor e Starten Sie die Execution Server Anwendung Die Execution Server Konfigurationsdatei wird mit initialen Werten angelegt e Stoppen sie die Execution Server Anwendung e Die Execution Server Konfigurationsdatei befindet sich im Execution Server Home Verzeichnis siehe Abschnitt 2 7 1 Execution Server Home unter config executionserver properties Passen Sie in dieser Datei folgendes Property an executionserver jndi name java jboss jdbc executionserverDS 3 Starten Sie den Execution Server 2 4 Installation des Execution Servers Wenn die ben tigte Datenbank das Identity Management und die Execution Server Anwendung gestartet sind konnen Sie den Execution Server installieren Die Installation des Execution Servers beinhaltet folgende Schritte e Die Datenbank aufsetzen e Den Execution Server im Identity Management registrieren Beide Schritte werden durch den Installations Wizard unterstutzt Dies ist die empfohlene Vorgehensweise welche beschrieben wird in Abschnitt 2 4 1 Installieren des Execution Server mit dem Installationsassistenten Wenn Sie die Datenbankoperationen berpr fen und manuell ausf hren m chten benutzen Sie das Maintenance Tool um die Datenbank anzulegen Dies ist beschrieben in Abschnitt 2 4 2 Installieren des Execution Servers mit dem Maintenance Tool Das Maintenance Tool unterst tzt nicht das Registrieren des Executio
107. ws IServiceView services toArray new IServiceView size throw new AmbiguousRuleModelArtifactException There are multiple rule models that fit the requested meta values serviceViews return null Die filter Methode liefert nur die Services deren Metadaten zur Anfrage passen was mit der Methode matches gepr ft wird Bosch Software Innovations 54 58 Kapitel 6 Arbeiten mit Metadaten private static List filter List services Properties metaData List retVal new ArrayList services size for Iterator it services iterator it hasNext IServiceView serviceView IServiceView it next Map metaValues serviceView getMetaValues if metaValues null amp amp matches metaData serviceView retVal add serviceView return retVal Die matches Methode vergleicht jedes Schl ssel Wert Paar aus der Anfrage mit denen von jedem IServiceView Die Schl ssel in den Metadaten der Anfrage m ssen eine Teilmenge der auf dem Service definierten bilden Zudem m ssen die Werte bereinstimmen Die einzige Ausnahme ist die version da diese kein Metadatum ist private static boolean matches Properties metaData IServiceView serviceView Map metaValues serviceView getMetaValues for Iterator it metaData entrySet iterator it hasNext Map Entry me Map Entry it next String key String me getkey String value String me getVal
108. zifizierte Version aufgerufen wird dann wird der Rule Service ohne qualifier als neuer angesehen Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service Abschnitt 3 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e Abschnitt 3 2 4 Bereitstellen von Regelprojekten vom Visual Rules Modeler 3 1 4 Visual Rules Archiv Der Execution Server unterst tzt auch das Visual Rules Archiv welches neben dem Rule Service auch noch alle weiteren Bibliotheken die zur Ausf hrung eines Rule Services notwendig sind und eine Abh ngigkeitsbeschreibung enth lt In dieser Form k nnen Rule Services von einem Visual Rules Execution Server herunter bzw hochgeladen werden z B um Rule Services von einer Test auf eine Produktionsumgebung zu bertragen Die zugeh rige Archivdatei besitzt die Endung VRA Weiterf hrende Konzepte e Abschnitt 3 1 1 Rule Service e Abschnitt 3 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e Abschnitt 4 2 6 Herunterladen eines Rule Service e Abschnitt 4 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv 3 1 5 Rule Service Einstellungen Rule Services k nnen zus tzliche Einstellungen haben die im folgenden beschrieben sind 3 1 5 1 Aktiv Ein Rule Service ist standardm ig aktiv und kann somit aufgerufen werden Es kann allerdings auch Situationen geben in denen Rule Services zwar bereitgestellt sind aber nicht aufgerufen werden

Download Pdf Manuals

Related Search

Related Contents

Initial Configuration and Platform Troubleshooting  piano regolatore dell` illuminazione comunale  Manufacturing Manual  CDRoller - User's Manual  Dell Laptop D430 User's Manual    自治会ハンドブック  仕様書  "取扱説明書"  

Copyright © All rights reserved. Failed to retrieve file