Home

Server Handbuch - Bosch Software Innovations

1. 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 1 5 Konfiguration des Execution Server 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 in dem die Klasse in ein JAR gepackt wird und in das Verzeichnis WEB INF 1lib der ausgepackten Webapplikation gelegt wird Bosch Software Innovations 47 47
2. 22222esssesenesenenenenenenenenenenenenenenenenenenenenenenenenenn 25 3 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service 222s222sssseeensnsnsnensnnnnnnennennneenen 25 3 4 Verwaltung bereitgestellter Bibliotheken 222222220002sseesnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnenenennnenn 26 3 4 1 Anzeige bereitgestellter Bibliotheken e22222220s2sssenenenennnennnnnnnnnnnnnnnnnnnnnennnnnnnennnennnennnen 26 3 4 2 Filterung angezeigter Bibliotheken 22z22222s0s2seeesenennnnnnnnnnnennnennnnnnnennnnnnnennnennnennnennnennnenen 27 3 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek s0220220ssssesonnnnennnnenennenen 28 3 4 4 L schen einer bereitgestellten Bibliothek zs220s2sssesesenenenenenenenenenenennnnnnnennnenenenenennnen 28 3 5 Wartung des Execution Servers cceeeseeessesssssnsnnnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnsnnnensnsnsnsnnnensnsnnnsnnnennnen 29 3 5 1 Anzelp amp von Lizenzintormatonen zeussennnsersereeeieenesaeeeeee 29 3 5 2 Konfiguration und Anzeige von Nachrichten der Laufzeitprotokollierung s220s220s0seneenen 29 3 6 Konfiguration der Anzeige von Tabelleninhalten zz2s220ss0ssssesonnnnnnennnnennnnnnnnnennnnnnennenen 30 3 6 1 Ein und Ausblenden von Spalten sss2ssssssenessenennenensenennenennnnnnnennnnnnnnnennnnennnnnnnnnnnnnnnnnnnnnnn 30 3 6 2 Vo
3. Bosch Software Innovations 45 47 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 serviceVlew retVal add serviceView return retVal Die matches Methode vergleicht jedes Schl ssel Wert Paar aus der Anfrage mit den 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 getValue 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 n
4. das Symbol x zugeordnet Klicken Sie auf das Symbol des Metadatums das Sie l schen m chten 2 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 u 3 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 Bosch Software Innovations 22 47 Kapitel 3 Arbeiten mit der Webkonsole 2 Geben Sie den Metadatennamen bzw wert ein 3 i Klicken Sie auf die Schaltfl che Speichern um die nderungen zu speichern Weiterf hrende Konzepte Abschnitt 6 1 Konzept Metadaten 3 2 9 Anzeige der Ausf hrungen eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus 2 ffnen Sie die Detailseite des Rule Service dessen Ausf hrungen Sie sehen wollen indem Sie im Abschnitt Rule Services auf den zugeh rigen Link in der Versionsspalte klicken 3 W hlen Sie in der Aufgabenleiste der Detailseite den Eintrag Ausf hrungen aus worauf die Ausf hrungsseite ge ffnet wird Die Ausf hrungsseite enth lt den Abschnitt Ausf hrungen in dem alle Aufrufe dieses Rule Service angezeigt werden Zudem gibt es den Abschnitt Filter Ausf hrungen in dem Sie die Anzeige d
5. lesbaren Datei in der Benutzer und Rollen f r den datei basierten Security Provider definiert sind siehe Abschnitt 1 5 1 1 Konfiguration des datei basierten Security Providers visualrules executionserver security jaas roledefinition Dieser Wert wird f r JAAS siehe Abschnitt 1 5 1 2 JAAS Konfiguration verwendet um die Benutzer und ihre Rollen zu beschreiben Bosch Software Innovations 4 47 Kapitel 1 Installation und Konfiguration des Execution Server visualrules executionserver security jaas loginConfigURL Die URL beschreibt die Position der Login conf Datei welche die Definition des LoginModule enth lt die von JAAS see Abschnitt 1 5 1 2 JAAS Konfiguration benutzt werden soll visualrules executionserver security jaas activated Der boolsche Wert kontrolliert ob JAAS see Abschnitt 1 5 1 2 JAAS Konfiguration aktiviert ist standardm ig is der Wert true visualrules executionserver artifactstorage jndi name Der JNDI Name zur Benutzung einer externen Datenbank Siehe Abschnitt 1 5 2 Konfiguration externer Datenbanken visualrules executionserver artifactstorage db brand Name der verwendeten Datenbank Siehe Abschnitt 1 5 2 Konfiguration externer Datenbanken visualrules executionserver artifactstorage db name Veraltet Wurde zur Angabe der verwendeten Datenbank benutzt und ist durch visualrules executionserver artifactstorage db brand ersetzt visualrules executionserver m
6. 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 4 1 5 Abbildung des Regelmodells auf WSDL 3 2 6 Herunterladen eines Rule Service Sie k nnen einen Rule Service als Regelbibliothek oder 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 Men leiste der Webkonsole den Eintrag Rule Services aus 2 ffnen Sie die Detailseite des Rule Service den Sie herunterladen wollen indem Sie im Abschnitt Rule Services auf den zugeh rigen Link in der Versionsspalte klicken 3 i Ar i Klicken Sie im oberen Bereich der Detailseite auf den Link Regelbibliothek herunterladen Regelbibliothek herunterladen wollen wenn Sie nur die oder auf den Link YIsual Rules Archiv herunterladen wenn Sie das Visual Rules Archiv herunterladen wollen 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 Weiter
7. Maintenance Tool als reines Kommandozeilen Programm auszuf hren in dem alle Einstellungen als Parameter auf der Kommandozeile bergeben werden Bei der Ausf hrung mit allen Kommandozeilen Parametern gesetzt wird das Maintenance Tool die Migration ohne Nachfrage ausf hren Stellen Sie sicher dass ein Backup davor gemacht wurde Ein Schema auf einer MySQL Datenbank k nnte beispielsweise mit folgender Kommandozeile migriert werden MaintenanceTool d com mysql jdbc Driver db mysql user admin pwd secret url jdbc mysql localhost 3306 executionserver Beispiel 1 1 Migration eines Schemas auf MySQL Die verf gbaren Optionen f r die Kommandozeilen Parameter sind F r eine Liste der unterst tzten Datenbanken lesen Sie bitte in den Execution Server Systemanforderungen nach Bosch Software Innovations 2 47 Kapitel 1 Installation und Konfiguration des Execution Server Tabelle 1 2 Kommandozeilen Optionen f r die Migration externer Datenbanken d lt driverClassName gt Voll qualifizierter Klassenname des JDBC Treibers db lt dbBrand gt Fabrikat der Datenbank die migriert wird pwd lt dbPassword gt Passwort des Datenbank Benutzers url lt jdbcUrl gt JDBC URL f r die Verbindung zur Datenbank o lt file gt Ausgabe der SQL Befehle in eine Datei user lt dbUser gt Name des Datenbank Benutzers Es ist m glich die SQL Befehle in eine Datei auszugeben anstatt die Migration durchzuf hren Das erzeu
8. N GK 13 Ci Ci Ci Ci Ci Weiterf hrende Konzepte e Abschnitt 2 1 4 Visual Rules Archiv 3 2 4 L schen eines bereitgestellten Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus Klicken Sie im Abschnitt Rule Services 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 5 1 Verf gbare Rollen und Berechtigungen 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 E 3 2 5 Anzeige der WSDL Datei eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus Klicken Sie im Abschnitt Rule Services auf das Symbol vrai 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 Klicken Sie auf den Link WSDL anzeigen im oberen Bereich der Detailseite Bosch Software Innovations 19 47 Kapitel 3 Arbeiten mit der Webkonsole 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 rule model gt
9. Neben GMan o Dale ee ee ee er 30 3 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge 22222222022s0s0senenenenenenenenenenenenn 30 3 7 Filterung angezeigter Objekte 22222222ss2sesenenenenennenenennnnnenennnennnennnenensnenennnenenennnensnenenenenennnen 31 3 7 1 Eingabe von Filterkriterien unse ee erneuern tere 31 3 4 1 Eingabe von Datum und Uhrzeit a een 31 3 7 2 Anwenden eines Filters eeessseesssessseocesssessseocssssoseseoeesssoseseoessseoesssocesseesesooeesseoseessoeeeseosesoo 32 4 Aufrufen von Regeln im Execution Server ssssecsseosssecsseeosseooseosseeosseossseessse DI Ae IKONZEDEE tee EE E EE ee see 33 4 1 1 F rmat der Rule Service Antares arena re 33 4 1 2 Format der Rule Service Antwort vera seen er rer 34 4 1 3 Generische Rule Service Anfragen u tn na a nei 35 Bosch Software Innovations v 47 Execution Server Benutzerhandbuch 4 1 3 1 Generisches VRRequest Format ensearseenneeniserenerieenenesaee 35 4 1 4 XML Repr sentation von Datentypen zsssssssseseeesennnsnenenennnnnnnennnnnnnnnennnnnnnnnennnnnnnnnnnnnsnnnenennnnn 36 AA 1 ENa ae Ve ee ee 36 4 1 4 2 N U zur ee er ae nee ee eier 37 21 4 3 Len Und MERBENT ee a ee ee 37 AAA 1 21 eer EAE E E NEEE EE EUER EE EIN E EE E EA A EES 38 AASA E E E E AE EA TA E EEE 38 4 1 5 Abbildung des Regelmodells auf WSDL z2222ss2ssssssssnenennnnnnnnennnnnennnennnennnnnenennnennnennnnnnn 38 A
10. Service _ Erweiterungen SML Schema Namespace Pr fix http ww Foo barfrules 000 _ Beschreibung Notizen Aktionen als R ckgabewerte behandeln ee a a Weiterf hrende Konzepte e Abschnitt 2 1 1 Rule Service Abschnitt 2 1 2 Regelbibliothek Abschnitt 4 1 1 Format der Rule Service Anfrage e Abschnitt 4 1 2 Format der Rule Service Antwort 2 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 2 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 Funktionalit t ist auch i
11. aktiv ist als erstes nach der Authentifizierung gefragt Dazu wird der Login Kontextname ExecutionServerSOA verwendet Eine einfache JAAS Konfiguration kann mit der Einstellung visualrules executionserver security jaas loginConfigURL konfiguriert werden deren Wert eine URL wie beispielsweise file c security SOAServer config ist Dies kann auch mit der Systemeigenschaft java security auth login config erreicht werden Die Verwendung der Systemeigenschaft wird nicht empfohlen Die Datei definiert ein LoginModule wie in nachfolgendem Beispiel ExecutionServerSOA com example ExampleLoginModule required debug false Fr Obwohl die Authentifizierung durch JAAS ber das konfigurierte Loginmodul durchgef hrt wird ist es noch notwendig einen Benutzer auf eine Rolle im Server abzubilden Dies kann dadurch erreicht werden dass die Einstellung visualrules executionserver security jaas roledefinition konfiguriert wird Lesen Sie Abschnitt 1 5 Konfiguration des Execution Server um eine Erl uterung zu erhalten wie der Server konfiguriert werden kann Die Abbildung eines Benutzers auf seine Rolle folgt einem spezifischen Format wo jeder Eintrag mit dem Benutzernamen beginnt gefolgt von einem Doppelpunkt gefolgt von den Rollennamen welche selbst durch ein Komma getrennt sind Das Ende wird mit einem Semikolon abgeschlossen Zum Beispiel definiert admin ROLE ADMIN ROLE USER bob ROLE USER einen Benutzer admin mit den Rollen ROLE_ADMIN
12. das K stchen Regel als Web Service bereitstellen WSDL operation Eigenschaften 3 uni Add u Aktionen I PT Regel als Web Service bereitstellen WSDL Operation F Web Service Beschreibung b Weiterf hrende Konzepte e Abschnitt 2 1 1 Rule Service Bosch Software Innovations 11 47 Kapitel 2 Erstellung und Bereitstellung von Rule Services e Abschnitt 2 1 2 Regelbibliothek 2 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 vollst ndige Namespace URI im WSDL und XML Schema wird sp ter aus diesem Pr fix 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 i x m E Properties 23 gt al li BEE ar y TES A o S Adder i Web
13. der Webkonsole Die folgenden Abschnitte enthalten Beschreibungen verschiedener Aufgaben die mit der Webkonsole ausgef hrt werden k nnen z B bereitgestellte Rule Services verwalten 3 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 5 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 re Execution Server da ee rule your business logic m Ta post A An LS 1 EE Deutsch Hilfe Willkommen beim Visual Rules Execution Server Benutzername Passwort Anmelden Copyright 2011 Bosch Software Innovations GmbH All rights reserved Wenn beim Start des Execution Servers keine g ltige Lizenz zur Verf gung stand erscheint die Startseite mit einer Fehlermeldung Execution Server rule your business logic x sie haben keine g ltige Lizenz fur den Execution Server Keine g ltige Lizenzdatei f r de visualrules executionserver soa 5 1 0 14 02 11 0
14. 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 IArtifactStorageReadAccess 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 RuleInvocationTarget 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 in dem dort inaktive Services ausgefiltert werden
15. 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 ice oder gt lt binding gt test lt binding gt lt vr trace gt lt pricing VRResponse gt Beispiel 4 2 VRResponse Format Weiterf hrende Konzepte e Abschnitt 4 1 4 XML Repr sentation von Datentypen 4 1 3 Generische Rule Service Anfragen Der gew hnliche 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 4 1 3 1 Generisches VRRequest Format D
16. 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 xsd 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 eine 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 44 47 Kapitel 6 Arbeiten mit Metad
17. und RULE_USER und einen Benutzer bob mit der einzigen Rolle ROLE_USER JAAS kann deaktiviert werden durch setzen der Einstellung visualrules executionserver security jaas activated auf den Wert false 1 5 2 Konfiguration externer Datenbanken Execution Server verwendet eine eingebettete Apache Derby Datenbank F r Testzwecke und einfache Szenarien reicht diese zwar aber unter hoher Last kann diese zu einer schlechten Leistung f hren da sie nicht konfiguriert werden kann F r produktions hnliche Systeme lautet die Empfehlung daher eine externe Datenbank einzusetzen Das kann durch Verwendung einer Konfiguration per Java Naming and Directory Interface JNDI erreicht werden Der eingesetzte Application Server muss in diesem Fall die eingesetzte Datenbank als Datenquelle unter einem JNDI Namen zur Verf gung stellen Unter Umst nden ist es auch notwendig nderungen an der bereitgestellten Execution Server war Datei vorzunehmen Das dazu notwendige Vorgehen sollte in der Dokumentation des Application Servers beschrieben sein Mit der Einstellung visualrules executionserver artifactstorage jndi name wird der Name der Datenquelle definiert Zu beachten ist hierbei dass dies der volle Name sein muss wie dies in der J2EE Umgebungen eingestellt ist Ist beispielsweise die Datenbank unter dem Namen jdAbc mydatabase verf gbar gemacht worden so ist im Normalfall der volle Name java comp env jdbc mydatabase einzutragen Im Zweifel sollte hierzu di
18. 001 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 4 1 4 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 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 4 1 4 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 Bosch Software Innovations 37 47 Kapitel 4 Aufrufen von Regeln im Execution Server 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 z
19. 1 3 Benutzerdefinierter Metadata Mapper beschrieben ist Das n chste Element ist configuration dass genau dasselbe ist wie in Abschnitt 4 1 1 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 Bosch Software Innovations 35 47 s com vrpath Kapitel 4 Aufrufen von Regeln im Execution Server lt gen VRRequest xmlns vr http www visual rules com xmlns gen http www visual rules com 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 2 seat no gt lt show _date gt 2008 08 22 lt show date gt lt coupon gt tr
20. 2 AO AO oree a E E A T E E ET E T 39 22 1 Aulruleneines Rule SeWiice seen ee T EE EE EE 39 5 Rollen des Sicherheitskonzepts o u s u u s s o s uu u usu 0o s us s ou u 0o su u u so s u o o u o0o s uo oso 0o s osu s uo 0 s s u o00 uo 41 5 1 Verf gbare Rollen und Berechtigungen 222222222sssnnnensnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnennnen 41 6 Arbeiten mit Metadaten 0s0osooooonunonunnonnnnnnunsnnnnonsnsnnensnsnnonsnsnnensssssensneenee 42 6 1 Konzept Metadaten ee en ee ee ne ee ee een 42 6 2 Melagaten Geiinieren seen erinnere 42 6 2 1 Zuordnung von Metadaten zu Rule Services 22222sssseeesensnenenennnnnnnnnnnnnennnenenennnenensnnnsnenenenennn 43 6 2 1 1 Standard Metadata Mapper ern unser ea ee nenne 43 6 2 1 2 Eine WSDL durch Angabe von Metadata abholen z 22s22ss2sssesesnnenenennnenennnnnnnennnennnennen 44 6 2 1 3 Benutzerdefinierter Metadata Mapper au ee ee nenne 44 Bosch Software Innovations vi 47 Kapitel 1 Installation und Konfiguration des Execution Server Kapitel 1 Installation und Konfiguration des Execution Server 1 1 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 1 Distributions Inhalt legalnotice Rechtliche Informationen zu Lizenzen und Verwendung von Bibliothe
21. 220s220020ssosensesnnnnnennnsnnenn 11 2 2 2 XML Namespace f r Rule Services definieren 22222222ss2s0sesnennnnnnnnnnnnnnnnnnnnnnnnennnnnnnennnenneen 12 2 2 3 Einstellen von Aktionen als R ckgabewert 2z2s2sssssssssenensnnnnnennnnnnennnnnnnnnenennnnennnnensnnennnsnnenn 12 2 2 4 Bereitstellen von Regelprojekten vom Visual Rules Modeler 0s2200220002snensnennnennnnnnnnennenn 12 3 Arbeiten mit der Webkonsole 0 0 0 0 0 00000000000n0n0nnnnnnnnnnnnnnnnnnsnnusnsnsnsnsssuneee LD 3 1 Aufruf der Webkonsdle 2 erteilen 15 Bosch Software Innovations iv 47 Execution Server Benutzerhandbuch 3 1 1 Einstellung einer bestimmten Sprache z2222ss22ssssesesesenennnenennnnnnnennnnnnnnnnnennnennnenenennnsnnnennnen 15 3 2 Verwaltung bereitgestellter Rule Services 222222222ssssesesssenesennnenenennnnnnnnnnnnnnnennnennnnnnnnnnnennnennnen 16 3 2 1 Anzeige bereitgestellter Rule Services 22222202220sensnensnnnsnnnnnnnnnnnnnnnnnnenenenenenenennnenenenenenenenn 16 3 2 2 Filterung angezeigter Rule Services 2222s22sssssesensnennennnennnennnennnennnennnennnennnenenensnenenenenenenenenen 17 3 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv e2sessssssessssssesnnennenenennennnnenennenen 18 3 2 4 L schen eines bereitgestellten Rule Service 222222s2sssesesnsesennnenenennnennnenenennnenenenenenenenenenn 19 3 2 5 Anzeige de
22. 8 16 gefunden Copyright C 2011 Bosch Software Innovations GmbH All rights reserved Weiterf hrende Aufgaben e Abschnitt 1 4 Installation der Lizenz 3 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 explizit die deutsche bzw englische Sprache f r die Webkonsole einzustellen 1 ffnen Sie eine Seite der Webkonsole in Ihrem Web Browser Bosch Software Innovations 15 47 Kapitel 3 Arbeiten mit der Webkonsole 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 Fi kean die Flagge wenn Sie die englische Sprache w nschen 3 2 Verwaltung bereitgestellter Rule Services In der Sicht Rule Services des Visual Rules Execution Servers k nnen Sie bereitgestellte Rule Services verwalten W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services um diese Sicht zu ffnen Hier haben Sie folgende M glichkeiten e Abschnitt 3 2 1 Anzeige bereitgestellter Rule Services e Abschnitt 3 2 2 Filterung angezeigter Rule Services e Abschnitt 3 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archi
23. Abschnitt 3 2 6 Herunterladen eines Rule Service e Abschnitt 3 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv 2 1 5 Rule Service Einstellungen Rule Services k nnen zus tzliche Einstellungen haben die im folgenden beschrieben sind 2 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 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 2 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 2 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 10 47 K
24. Auf der bersichtsseite der Sicht Bibliotheken befindet sich der Abschnitt Filter Bibliotheken in dem Sie Filterkriterien spezifizieren k nnen um nur Bibliotheken die von Interesse sind anzuzeigen Filter Bibliotheken Artefakt Io Filter anwenden Filter zur cksetzen Erwyeitert 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 Filter Bibliotheken Artefakt ID Gruppen ID version Bereitstellungszeitraum Yon 01 01 2011 3 08 0 2 Bis 31 12 2011 A 18 00 ae Fiter anwenden Filter zur cksetzen Erweiterts Mehr Informationen zur Eingabe der Filterkriterien und der Anwendung des Filters finden Sie in Abschnitt 3 7 Filterung angezeigter Objekte Bosch Software Innovations 27 47 Kapitel 3 Arbeiten mit der Webkonsole 3 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Bibliotheken aus 2 ffnen Sie die Detailseite der Bibliothek deren Eigenschaften Verwendung Sie sehen m chten indem Sie im Abschnitt Bibliotheken auf den zugeh rigen Link in der Spalte Artefakt ID klicken Auf der Detailseite werden im Abschnitt bersicht allgemeine Eigenschaften der Biblio
25. Benutzer des Execution Servers hat mindestens die Rolle ROLE_USER Um administrative Aufgaben wahrnehmen zu k nnen muss ein Benutzer zus tzlich ber die Rolle ROLE ADMIN verf gen Tabelle 5 1 bersicht der Berechtigung von ROLE_ADMIN Bereitstellung von Rule Services Artefakten Bereitstellung von Rule Services Artefakten beenden Hochladen von Visual Rules Archiv Dateien Editieren von Einstellungen von Rule Services Editieren von Metadaten von Rule Services L schen von Ausf hrungen von Rule Services Die Konfiguration von Benutzern und ihren Rollen ist in Abschnitt 1 5 1 Konfiguration der Authentifizierung und Berechtigungen beschrieben Bosch Software Innovations 41 47 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 multinationalen 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
26. G ltigkeitszeitraum Eingabe eines Start und oder Endzeitpunktes siehe Abschnitt 3 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 Zur cksetzen z Speichern Best tigen Sie die Anderungen indem Sie auf die Schaltfl che M L klicken Das Editieren der Einstellungen ist nur m glich wenn der angemeldete Benutzer ber die entsprechende Berechtigung verf gt Siehe auch Abschnitt 5 1 Verf gbare Rollen und Berechtigungen Weiterf hrende Konzepte e Abschnitt 2 1 5 Rule Service Einstellungen 3 2 8 Verwaltung der Metadaten eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus 2 ffnen Sie die Detailseite des Rule Service dessen Metadaten Sie verwalten wollen indem Sie im Abschnitt Rule Services auf den zugeh rigen Link in der Versionsspalte klicken Links auf der Detailseite befindet sich die Aufgabenleiste f r einen Rule Service Aufgaben Pr Ausf hrungen Metadaten Erforderliche Bibliotheken Bosch Software Innovations 21 47 Kapitel 3 Arbeiten mit der Webkonsole 3 W hlen Sie in der Aufgabenleiste den Eintrag Metadaten aus worauf die Metadatenseite ge ffnet wird Es gibt modellbezogene Metadate
27. Herunterladen einer Statistik zur Ausf hrung eines Rule Service 3 3 1 Anzeige der Ausf hrungen von Rule Services W hlen Sie in der Men leiste der Webkonsole den Eintrag Ausf hrungen aus um die Sicht Ausf hrungen zu ffnen Die ge ffnete bersichtsseite enth lt den Abschnitt Ausf hrungen in dem die Aufrufe aller auf dem Visual Rules Execution Server bereitgestellten Rule Services angezeigt werden Bosch Software Innovations 23 47 Kapitel 3 Arbeiten mit der Webkonsole Ausf hrungen 2 Ausf hrungen l schen Datum Rule Service version Regelpfad Ausf hrungszeit ms Request ID Hd 26 01 2011 13 39 49 Kinokarte 2 0 Kinokarte Preisberechnung 1329 5d131d5d 2949 11e0 a3a9 7d9d4bb6b0f6 26 01 2011 13 29 38 Kinokarte 1 0 Kinokarte Preisberechnung 140 t0f4b2bc 2947 11e0D a339 7d9d4bh6hDfE Seite 1vonal gt MI 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 Ausf hrungszeit 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 3 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalten verschieben s
28. 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 inAbschnitt 3 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 anzugeben 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
29. 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 hinzuzuf gt oder bearbeitet werden Bosch Software Innovations 42 47 Kapitel 6 Arbeiten mit Metadaten L Eigenschaften 53 eg Movie Ticket Pricing Ein Wusgabedater Tatarasunaken E secuton Semer konstante Daten Schluszel n 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 istin der Lage anhand von Metadaten eine WSDL zu liefern 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 defi
30. Visual Rules Suite Execution Platform Execution Server Benutzerhandbuch Version 5 4 1 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 573943 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 5 4 1 Visual Rules Execution Server 5 4 1 Copyright 2004 2012 Bosch Software Innovations GmbH Bosch Software Innovations GmbH 2012 Alle Rechte vorbehalten Weitergabe und Vervielf ltigung 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 Installation u
31. apitel 2 Erstellung und Bereitstellung von Rule Services Der Execution Server bietet Aufrufern ebenfalls die M glichkeit den Namen der zu verwendenden Konfiguration anzugeben Im Englischen und den technischen Schnittstellen wird hierf r 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 konfiguriert werden einen speziellen Namen als Standardwert f r 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 ausgef hrt wird Ein Aufrufer kann ein active configuration name auch in der Rule Service Anfrage angeben f r Details siehe Abschnitt 4 1 1 Format der Rule Service Anfrage Die Einstellung in der Anfrage bertrumpft in diesem Fall immer den Wert der am Rule Service eingestellt wurde Rule Services die von Visual Rules 4 migriert wurden unterst tzen das Setzen eines active configuration name als Standardwert nicht 2 1 5 4 Statistiklevel Die Visual Rules Rule Execution API erlaubt es den Statistiklevel der aufgezeichneten Statistiken einzustellen Mehr zu diesem Thema findet sich im Java Integration Guide Diese Funktionalit t wird als Aufzeichnung von Ausf hrungen au
32. aten 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 findByMetaValues 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 im 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 Metada
33. ation 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 sesstonstatistics gt lt level gt medium lt level gt lt sessionStatistics gt lt vr configuration gt lt input gt lt auditorium no gt l lt auditoridm 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 Beispiel 4 1 VRRequest Format Weiterf hrende Konzepte e Abschnitt 4 1 4 XML Repr sentation von Datentypen 4 1 2 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 Ausgabedat
34. ch vom Execution Server unterst tzt Der Statistiklevel eines Rule Service kann eingestellt werden welcher dann als Standardwert verwendet wird Aufrufer k nnen einen Statistiklevel auch in der Rule Service Anfrage spezifizieren siehe Abschnitt 4 1 1 Format der Rule Service Anfrage welcher dann statt der Einstellung des Rule Service verwendet wird 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 Ein Rule Service kann auch so eingestellt werden dass keine Ausf hrungen aufgezeichnet werden indem der Level auf SWITCHED OFF gestellt wird Rule Services die von Visual Rules 4 migriert wurden unterst tzen es nicht einen Standardwert f r den Statistiklevel einzustellen Jedoch l sst sich die Aufzeichnung von Ausf hrungen durch Einstellen des Levels SWITCHED OFF ausschalten 2 2 Arbeitsschritte 2 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
35. d 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 k me als n chstes wenn es spezifiziert ist Schlie lich 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 4 1 4 XML Repr sentation von Datentypen beschreibt die XML Repr sentation f r diese Werte abh ngig von den Datentypen einschlie lich Strukturen Aufz hlungen Listen Mengen und Maps Bosch Software Innovations 33 47 Kapitel 4 Aufrufen von Regeln im Execution Server lt pricing VRRequest xmlns vr http www visual rules com xmins pricing http www visual ruleg com vrpath N 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 f r 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 configur
36. e Dokumentation des Application Server oder der Administrator des Servers zu Rate gezogen werden Der Execution Server unterst tzt nur eine bestimmte Anzahl an Datenbanken Der Name der eingesetzten Datenbank kann mit visualrules executionserver artifactstorage db brand definiert werden Die m glichen Werte sind derby mssql mysql db2 und oracle Lesen Sie Abschnitt 1 5 Konfiguration des Execution Server um eine Erl uterung zu erhalten wie der Server konfiguriert werden kann Mit diesen Einstellungen ist der Execution Server in der Lage sich auf externe Datenbanken zu verbinden und die notwendigen Tabellen f r den Betrieb zu erstellen Daf r ist es erforderlich dass der verwendete Datenbankbenutzer die Berechtigungen zur Erstellung von Tabellen hat Der Execution Server sollte in jedem Fall ein eigenes Datenbank Schema zur Verf gung haben das weder Tabellen noch Daten enth lt Beim Hochfahren werden Tabellen erzeugt und solche gel scht die den gleichen Namen haben wie eine die vom Execution Server benutzt wird Der Datenbankbenutzer ben tigt die Rechte um Tabellen zu erstellen ndern und l schen zu k nnen Bosch Software Innovations 6 47 Kapitel 1 Installation und Konfiguration des Execution Server 1 6 Execution Server Home Das Execution Server Home ist ein Ordner der f r die Speicherung von Daten und Konfigurationen des Execution Server benutzt wird Der Ordnername ist normalerweise visualrules executions
37. elbibliothek 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 Lebenszyklusses 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
38. ell im Abschnitt Ausf hrungen angezeigten Ausf hrungen l schen m chten dann klicken Sie dort auf die Schaltfl che 4 T hrungen l schen yobei n die Anzahl der betroffenen Ausf hrungen darstellt Sofern nur eine Ausf hrung betroffen ist hei t die Schaltfl che hen 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 zu ad Das L schen ist nur m glich wenn der angemeldete Benutzer ber die entsprechende Berechtigung verf gt Siehe auch Abschnitt 5 1 Verf gbare Rollen und Berechtigungen Weiterf hrende Aufgaben e Abschnitt 3 3 1 Anzeige der Ausf hrungen von Rule Services 3 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 Bosch Software Innovations 25 47 Kapitel 3 Arbeiten mit der Webkonsole 2 Klicken Sie im Abschnitt Ausf hrungen bei der Ausf hrung deren Statistik Sie herunterladen wollen auf das Symbol dl 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 Model
39. enelemente einer Regel enth lt Im Normalfall enth lt die Antwort auch Aktionen Es ist zu beachten dass dies konfiguriert werden kann wie in Abschnitt 2 2 3 Einstellen von Aktionen als R ckgabewert erl utert Der Abschnitt 4 1 4 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 beispielsweise 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 requestlId zur ckgeliefert Mehr zu Statistiken ist in Abschnitt 3 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 Bosch Software Innovations 34 47 Kapitel 4 Aufrufen von Regeln im Execution Server lt pricing VRResponse xmlns vr http www visual rules com xmlins pricing http www visual rul lt output gt lt price gt 7
40. er Ausf hrungen weiter einschr nken k nnen Eine genauere Beschreibung finden Sie in Abschnitt 3 3 1 Anzeige der Ausf hrungen von Rule Services 3 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus 2 ffnen Sie die Detailseite des Rule Service dessen erforderliche Bibliotheken Sie anzeigen m chten indem Sie im Abschnitt Rule Services auf den zugeh rigen Link in der Versionsspalte klicken 3 W hlen Sie in der Aufgabenleiste der Detailseite den Eintrag Erforderliche Bibliotheken aus worauf die Seite Erforderliche Bibliotheken ge ffnet wird Die Seite Erforderliche Bibliotheken enth lt den Abschnitt Bibliotheken in dem alle Bibliotheken die dieser Rule Service ben tigt angezeigt werden Eine genauere Beschreibung finden Sie in Abschnitt 3 4 1 Anzeige bereitgestellter Bibliotheken 3 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 Men leiste der Webkonsole den Eintrag Ausf hrungen um diese Sicht zu ffnen Hier haben Sie folgende M glichkeiten e Abschnitt 3 3 1 Anzeige der Ausf hrungen von Rule Services e Abschnitt 3 3 2 Filterung angezeigter Ausf hrungen e Abschnitt 3 3 3 L schen von Ausf hrungen von Rule Services e Abschnitt 3 3 4
41. er geladen und angezeigt werden siehe Kapitel Anzeigen von extern generierten Statistiken im Regel Modellierung Handbuch Weiterf hrende Aufgaben e Abschnitt 3 3 1 Anzeige der Ausf hrungen von Rule Services 3 4 Verwaltung bereitgestellter Bibliotheken In der Sicht Bibliotheken des Visual Rules Execution Servers k nnen Sie bereitgestellte Bibliotheken verwalten W hlen Sie in der Men leiste der Webkonsole den Eintrag Bibliotheken um diese Sicht zu ffnen Hier haben Sie folgende M glichkeiten e Abschnitt 3 4 1 Anzeige bereitgestellter Bibliotheken e Abschnitt 3 4 2 Filterung angezeigter Bibliotheken e Abschnitt 3 4 3 Anzeige von Eigenschaften und Verwendung einer Bibliothek e Abschnitt 3 4 4 L schen einer bereitgestellten Bibliothek 3 4 1 Anzeige bereitgestellter Bibliotheken W hlen Sie in der Men leiste der Webkonsole den Eintrag Bibliotheken aus um die Sicht Bibliotheken zu ffnen Die ge ffnete bersichtsseite enth lt den Abschnitt Bibliotheken in dem alle auf dem Visual Rules Execution Server bereitgestellten Bibliotheken angezeigt werden Bibliotheken Artetakt ID version Sruppen ID O activation 1 1 javax activation a commons collections 3 2 1 commaons collections O ctommons lang 2 5 commons lang B lt oMM6ONS loctgjing 1 0 3 cammaons logging G mail 1 42 javax mail G stax 1 2 0 stax B Stax api 1 0 stax B visualrules runtime gt 0 0 S5NAFSHOT de vizualrule
42. er 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 5 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 allerdings 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 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
43. erver und befindet sich im Benutzerverzeichnis des Betriebssystembenutzers der den Execution Server startet Es ist auch m glich einen anderen Ordner anzugeben wie in Abschnitt 1 5 Konfiguration des Execution Server beschrieben wird Bei Bedarf wird der Ordner automatisch angelegt Tabelle 1 3 Execution Server Home Inhalt vrdbartifacts Ordner der die Datenbank enth lt wenn die eingebettete Apache Derby verwendet wird logs Ordner der die Protokoll Dateien des Execution Servers enth lt derby log Protokoll Datei der Apache Derby vr_logging config Konfigurations Datei f r die Laufzeit Protokollierung 1 7 Laufzeitprotokollierung Ab der Version 5 4 wird die Laufzeitprotokollierung vom Execution Server automatisch eingerichtet Bitte beachten Log4j wird nicht mehr verwendet 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 LogAction log enth lt Nachrichten die in Rule Services von Aktionen
44. ervice 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 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 Als n chstes kommt das configuration Element dass Einstellungen zur Ausf hrung des Rule Services spezifiziert un
45. es aus Klicken Sie im Abschnitt Rule Services auf die Schaltfl che Zervicei3 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 5 1 Verf gbare Rollen und Berechtigungen Der folgende Dialog erscheint Rule Service s hinzuf gen x Archiv Fra Durchsuchen Klicken Sie auf die Schaltfl che urchsvehen 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 Klicken Sie auf die Schaltfl che A um die spezifizierte Datei hochzuladen Wenn die Operation abgeschlossen ist wird eine Statusmeldung angezeigt Zudem erscheint nach erfolgreicher Operation ein Dialog in dem alle hinzugef gten Rule Services und Bibliotheken aufgelistet sind Bosch Software Innovations 18 47 Kapitel 3 Arbeiten mit der Webkonsole Hinzugef gte Rule Services und Bibliotheken x Rule Services bS Kinokarte kinokarte 0 0 1 5NAPSHOT Bibliotheken xmlbeans org apache xmlbeans 2 4 0 cammons logging Commanz logging 1 0 3 activation Qavax actvaton 1 1 stax stax 1 2 0 commons colections Commoans colectons 3 2 1 xl nn nn nn m T
46. etadata custom mapper Der voll qualifizierte Klassenname eines benutzerdefinierten Metadata Mappers Die Benutzung eines benutzerdefinierten Metadata Mappers ist in Abschnitt 6 2 1 3 Benutzerdefinierter Metadata Mapper genauer beschrieben visualrules executionserver artifactstorage transactionManager In manchen Umgebungen kann es notwendig sein den von iBatis verwendeten TransactionManager auszutauschen Bitte lesen Sie im Execution Server Integration Handbuch nach f r welche Umgebungen das Setzen dieser Einstellung erforderlich ist visualrules executionserver artifactstorage transactionManager defaultAutoCommit Diese Einstellung wird an den TransactionManager von iBatis weitergereicht Bitte lesen Sie im Execution Server Integration Handbuch nach f r welche Umgebung das Setzen dieser Einstellung erforderlich ist visualrules executionserver artifactstorage transactionManager setAutoCommitAllowed Diese Einstellung wird an den TransactionManager von iBatis weitergereicht Bitte lesen Sie im Execution Server Integration Handbuch nach f r welche Umgebung das Setzen dieser Einstellung erforderlich ist visualrules executionserver artifactstorage transactionManager commitRequired Diese Einstellung wird an den TransactionManager von iBatis weitergereicht Bitte lesen Sie im Execution Server Integration Handbuch nach f r welche Umgebung das Setzen dieser Einstellung erforderlich ist 1 5 1 Konfiguration der Authentifizierung und Berechti
47. ezeigten Eigenschaften beeinflussen indem Sie beispielsweise e bestimmte Eigenschaften ein bzw ausblenden Neben den standardm ig angezeigten Eigenschaften gibt es noch weitere Eigenschaften wie Artefakt ID 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 3 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalten verschieben siehe Abschnitt 3 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 3 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge Rule Services mit identischem Namen werden gruppiert d h sie werden immer als Einheit direkt untereinander aufgelistet Initial werden alle Rule Services einer Gruppe angezeigt M chten Sie die einzelnen Rule Services einer Gruppe nicht betrachten so k nnen Sie diese durch Klicken auf die zur Gruppe geh renden Schaltfl che ausblenden und durch Klicken auf auch wieder anzeigen Weiterf hrende Konzepte e Abschnitt 2 1 1 Rule Service Weiterf hrende Aufgaben e Abschnitt 3 2 2 Filterung angezeigter Rule Services e Abschnitt 3 2 3 Hinzuf gen eines Rule Service mittels Visual Rules Archiv e Abschnitt 3 2 4 L schen eines bereitgestellten Rule Service e Abschnitt 3 2 5 Anzeige der WSDL Datei eines Ru
48. f hrende Konzepte e Abschnitt 2 1 2 Regelbibliothek e Abschnitt 2 1 4 Visual Rules Archiv 3 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Rule Services aus 2 ffnen Sie die Detailseite des Rule Service dessen Eigenschaften Einstellungen Sie sehen wollen indem Sie im Abschnitt Rule Services auf den zugeh rigen Link in der Versionsspalte klicken Auf der Detailseite werden im Abschnitt bersicht allgemeine Eigenschaften des Rule Service angezeigt bersicht Mame kinokarte wersion 0 0 1 5W4PSHOT Bereitgestellt won admin Bereitgestellt am 25 01 2011 09 22 42 Gruppen ID kinokarte Artefakt ID Kinokarte Bosch Software Innovations 20 47 Kapitel 3 Arbeiten mit der Webkonsole Neben den Eigenschaften werden auch ver nderbare Einstellungen des Rule Service angezeigt siehe Abschnitt 2 1 5 Rule Service Einstellungen Einstellungen Mame der aktiven konfiguration Statistiklevel Quiet w G ltigkeitszeitraum von E w Bis E w I Aktiv Speichern Zur cksetzen Die nderung einer Einstellung k nnen Sie 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
49. fizieren 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 Protokolldatei zu finden sein Bosch Software Innovations 7 47 Kapitel 2 Erstellung und Bereitstellung von Rule Services Kapitel 2 Erstellung und Bereitstellung von Rule Services 2 1 Konzepte 2 1 1 Rule Service Der Visual Rules Execution Server ist eine Ausf hrungsumgebung f r 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 f r jegliche andere Applikationen oder Systeme welche die Regeln aufrufen m chten zur Verf gung Der Visual Rules Execution Server stellt eine Web Service Schnittstelle zur Verf gung um Regeln aufzurufen Auf diese Weise wird jede Regel zu einem separaten Service ein sogenannter Rule Service Die Regeln f r einen Rule Service m ssen f r die Anwendung in eine Regelbibliothek gepackt werden Diese Bibliothek und die entsprechenden Services haben Versionsnummern um eindeutig w hrend des Lebenszyklusses eines Regel
50. gte Skript is spezifisch f r das Datenbankfabrikat und enth lt nur die Befehle um die analysierte Datenbank zu migrieren 1 3 3 Migration der eingebetteten Datenbank Die eingebettete Datenbank die standardm ig vom Execution Server verwendet wird kann ebenfalls mit dem Maintenance Tool migriert werden 1 3 3 1 Migration der eingebetteten Datenbank im interaktiven Modus Der interaktive Modus des Maintenance Tools kann benutzt werden um die eingebettete Datenbank zu migrieren Gestartet wird dieser durch Eingabe von MaintenanceTool i e 1 3 3 2 Migration der eingebetteten Datenbank mit Kommandozeilen Optionen Maintenance Tool kann die eingebettete Datenbank direkt von der Kommandozeile migrieren Dazu ist die Angabe notwendig wo sich die eingebettete Datenbank befindet Das ist ein Ordner mit Namen vrdbartifacts welches sich im Standardfall im Benutzerverzeichnis des angemeldeten Benutzers befindet Der Ordner kann sich auch in einem anderem Verzeichnis befinden was durch die Einstellung visualrules executionserver home bestimmt wird Das folgende Beispiel zeigt die Verwendung unter der Annahme dass sich vrdbartifacts in C tmp db befindet MaintenanceTool e embeddedLocation C tmp db Beispiel 1 2 Migration der eingebetteten Datenbank 1 3 4 Migration von der Version 4 Die Codebasis des Execution Servers hat sich zwischen der Version 4 und 5 ge ndert Das betrifft haupts chlich Anwender welche einen benutzerdef
51. gungen Der Execution Server verwendet einen einfachen datei basierten Security Provider und unterst tzt den Java Authentication and Authorization Service JAAS Beides ist immer aktiv und wird unterschiedlich konfiguriert 1 5 1 1 Konfiguration des datei basierten Security Providers Der datei basierte Security Provider wird mit einem Standardbenutzer admin mit dem Passwort admin ausgeliefert Dies muss als erstes ge ndert werden wenn dieser in einer produktiven Umgebung eingesetzt wird Um dies durchzuf hren kann der Execution Server so konfiguriert werden dass die Benutzer aus einer Datei gelesen werden Siehe Abschnitt 1 5 Konfiguration des Execution Server f r Details zur Konfiguration Die Eintr ge in der Datei m ssen ein bestimmtes Format haben Der folgende Ausschnitt beschreibt das Format und einen Benutzer format login password rolel roleN known roles ROLE ADMIN administrator ROLE USER any authenticated user example pass ROLE USER admin admin ROLE ADMIN ROLE USER Bosch Software Innovations 5 47 Kapitel 1 Installation und Konfiguration des Execution Server 1 5 1 2 JAAS Konfiguration Der Java Authentication and Authorization Service JAAS ist Teil des Java Sicherheitskonzepts und dessen Konfiguration w rde den Rahmen dieser Dokumentation sprengen Eine detaillierte Beschreibung kann in Java SE Security gefunden werden JAAS ist extern konfiguriert und wird wenn es
52. iehe Abschnitt 3 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 3 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 Rule Service anzeigen lassen siehe Abschnitt 3 2 9 Anzeige der Ausf hrungen eines Rule Service Weiterf hrende Aufgaben e Abschnitt 4 2 1 Aufrufen eines Rule Service e Abschnitt 3 3 4 Herunterladen einer Statistik zur Ausf hrung eines Rule Service e Abschnitt 3 3 3 L schen von Ausf hrungen von Rule Services e Abschnitt 3 6 Konfiguration der Anzeige von Tabelleninhalten 3 3 2 Filterung angezeigter Ausf hrungen Auf der bersichtsseite der Sicht Ausf hrungen befindet sich der Abschnitt Filter Ausf hrungen in dem Sie Filterkriterien spezifizieren k nnen um nur Ausf hrungen die von Interesse sind anzuzeigen Filter Ausf hrungen Request ID Filter anwenden Fiter zur cksetzen Erweitert 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 Bosch Software In
53. ifikation eines Datums und einer Uhrzeit haben folgendes Aussehen 20 01 2011 EA 12 30 w Zur Eingabe eines Datums klicken Sie auf das Symbol E 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 Bosch Software Innovations 31 47 Kapitel 3 Arbeiten mit der Webkonsole In dieser Ansicht k nnen Sie mit der Maus einen Monat in einem bestimmten Jahr ausw hlen Best tigen Sie Ihre Wahl anschlie end mit OK Zur Eingabe einer Uhrzeit klicken Sie auf das Symbol neben dem zweiten Eingabefeld Es ffnet sich eine Liste aus der Sie einen Zeitpunkt Stunden und Minuten ausw hlen k nnen 3 7 2 Anwenden eines Filters Soll die Filterung der Objekte einer Tabelle ausgef hrt werden klicken Sie im Filterabschnitt auf die Schaltfl che Fiter anwenden 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 32 47 Kapitel 4 Aufrufen von Regeln im Execution Server Kapitel 4 Aufrufen von Regeln im Execution Server 4 1 Konzepte 4 1 1 Format der Rule S
54. igenschaften in der visualrules executionserver properties Datei spezifiziert werden welche im Ordner config auf dem Klassenpfad des Execution Servers gefunden werden muss Dies ist gew hnlich nicht der bevorzugte Weg Bei der Benutzung der Properties Datei m ssen unter Umst nden bestimmte Zeichen maskiert Ta werden Es ist generell nicht ratsam beide Wege gleichzeitig zu verwenden Sollten jedoch aus irgendeinem Grund beide Konfigurationen aktiv sein so werden die Kontextparameter gegen ber den Eigenschaften in der visualrules executionserver properties Datei bevorzugt Unten aufgelistet finden Sie die m glichen Optionen zur Konfiguration des Execution Servers visualrules executionserver license file G ltiger Dateipfad zu der Lizenzdatei des Execution Servers Wird nur ben tigt wenn sich die Lizenz nicht im Standardverzeichnis befindet visualrules executionserver 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 javax servlet context tempdir bestimmt ist Der Wert muss ein Pfad zu einem les und beschreibbaren Ordner sein v isualrules executionserver home Stellt den Ordner ein der als Execution Server Home verwendet wird Der Wert muss ebenfalls ein Pfad zu einem les und beschreibbaren Ordner sein visualrules executionserver security simple file Der Pfad einer existierenden
55. inamen der WAR Datei des Execution Servers http localhost 8080 executionserver 5 x y services wsdl ruleModel Movie 20Ticket 20Pricing amp rulePath Movie 20Ticket 20Pricing Pricing gseffectiveDate 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 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
56. inierten Metadata Mapper einsetzen In der nachfolgenden bersicht sind die wichtigsten Anderungen und Hilfestellungen f r die Migration aufgelistet e Der Gro teil der nderungen kommen von einer neuen Struktur und Paket Namen Das kann schnell gel st werden durch die Anwendung eines Refactorings zum Verwalten der Imports welches in den meisten modernen Java Entwicklungsumgebungen enthalten ist e Die IMetaDataMapper Schnittstelle wurde entfernt Benutzerdefinierte Metadata Mapper Klassen erweitern jetzt die abstrakte Klasse AbstractMetaDataMapper Die Methoden Signaturen haben sich ebenfalls ge ndert Anstatt eines Arguments vom Typ IArtifactStorage haben diese eins vom Typ IArtifactStorageReadAccess Der IArtifactStorage darf in benutzerdefinierten Metadata Mapper Implementierung nicht mehr verwendet werden e Veraltete deprecated Methoden wurden entfernt Bosch Software Innovations 3 47 Kapitel 1 Installation und Konfiguration des Execution Server 1 4 Installation der Lizenz Der Execution Server ben tigt eine g ltige Lizenzdatei da ansonsten keinerlei Anfragen bearbeiten werden Es gibt zwei M glichkeiten wie der Server eine Lizenzdatei finden kann 1 Die Lizenzdatei liegt im Ordner visualrules5 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 visualrules executionserver license file a
57. ip 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 4 1 4 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 gt lt address gt lt zip gt 12345 lt zip 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 zip gt 99999 lt zip gt lt address gt lt value gt lt entry gt lt customerMap gt 4 1 4 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 lt bonus card gt GOLD lt bonus card gt 4 1 5 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 Se
58. k nnen dass Sie die Aktion wirklich durchf hren m chten Klicken Sie zur Best tigung auf die Schaltfl che ie j 3 5 Wartung des Execution Servers 3 5 1 Anzeige von Lizenzinformationen W hlen Sie in der Men leiste der Webkonsole den Eintrag Wartung aus Die ge ffnete Lizenzseite enth lt den Abschnitt Lizenzinformationen in dem Informationen ber alle Lizenzen angezeigt werden die f r den Visual Rules Execution Server relevant sind Lizenzinformationen Datei Lizenznehmer Typ version Wartung endet arm G ltig 1 license_exec_server_1 txt Evaluation 4 19 01 2010 15 02 2009 2 licenze_exec_ server Zt Exec Server Full 4 23 02 2010 25 03 2010 Es werden folgende Lizenzeigenschaften angezeigt e Name der Lizenzdatei e Lizenznehmer e Lizenztyp e Version e Wartungsende e G ltigkeit Weiterf hrende Konzepte Abschnitt 1 4 Installation der Lizenz 3 5 2 Konfiguration und Anzeige von Nachrichten der Laufzeitprotokollierung W hlen Sie in der Men leiste der Webkonsole den Eintrag Wartung aus Selektieren Sie danach den Punkt 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 Schieberegeler J liJ Der Schieberegeler kontrolliert die Einstellung des Detaillierungsgrades der Laufzeitprotokollierung Je h her der Grad desto mehr Nachrichten werden produ
59. ken von Drittanbietern maintenance Maintenance Tool manuals Handb cher 1 2 Installation des Execution Server Der Execution Server wird als gepacktes Web Archiv WAR ausgeliefert und kann installiert werden indem er auf einem Application Server bereitgestellt wird Der genaue Vorgang der Bereitstellung h ngt vom eingesetzten Application Server ab Nach der Bereitstellung auf dem Application Server sollte probehalber die Webkonsole aufgerufen werden Dies ist in Abschnitt 3 1 Aufruf der Webkonsole beschrieben 1 3 Aktualisierung einer bestehenden Version In den folgenden Abschnitten wird davon ausgegangen dass Java ber die Kommandozeile ausf hrbar ist Dies kann beispielsweise dadurch erreicht werden dass die Umgebungsvariable JAVA_HOME gesetzt und auf den Pfad des Betriebssystems genommen wird Dies ist in der Java Dokumentation beschrieben Die Aktualisierung von einer bestehenden Version wird mit dem Maintenance Tool durchgef hrt welches ein Bestandteil der Execution Server Distribution ist Die grunds tzlichen Schritte um dies durchzuf hren sind 1 Backup des verwendeten Datenbank Schemas dies trifft auch zu wenn die eingebettete Datenbank verwendet wird als auch der vorgenommen Konrfigurationseinstellungen 2 Ausf hrung des Maintenance Tool um das Datenbank Schema und die Daten zu migrieren 3 Erneutes Bereitstellen der neuen Version des Execution Servers auf dem Application Server 4 Konfiguration vo
60. le Service e Abschnitt 3 6 Konfiguration der Anzeige von Tabelleninhalten 3 2 2 Filterung angezeigter Rule Services Auf der bersichtsseite der Sicht Rule Services befindet sich der Abschnitt Filter Rule Services in dem Sie Filterkriterien spezifizieren k nnen um nur Rule Services die von Interesse sind anzuzeigen Filter Rule Services Hame Fiter anwenden Filter zur cksetzen Erwreitert 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 Bosch Software Innovations 17 47 Kapitel 3 Arbeiten mit der Webkonsole Filter Rule Services Mame version Bereitstellungszeitraum on 19 01 2011 3 00 00 R Bis 26 05 2011 11 00 5 Filter anwenden Filter zur cksetzen Erweitert Mehr Informationen zur Eingabe der Filterkriterien und der Anwendung des Filters finden Sie in Abschnitt 3 7 Filterung angezeigter Objekte 3 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 Men leiste der Webkonsole den Eintrag Rule Servic
61. liebigen 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 3 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 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 3 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 Alterna
62. 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 1 3 2 Migration externer Datenbanken Wenn f r den Execution Server bisher eine der unterst tzten externen Datenbanken verwendet wurde dann kann das Maintenance Tool zur Migration verwendet werden Vor der Migration sollte zur Sicherheit ein Backup der gegenw rtigen Datenbank erstellt werden C gt Wie man ein Backup f r die verwendete Datenbank erstellt ist dem entsprechenden Datenbank Handbuch zu entnehmen Das Maintenance Tool kann entweder mit allen notwendigen Optionen als Kommandozeilen Parameter ausgef hrt werden oder in einem interaktiven Modus der die Einstellungen abfr gt Der f r die Migration verwendete Benutzer der Datenbank ben tigte administrative Rechte darunter die Berechtigungen zum Anlegen create ndern alter und L schen delete von Tabellen 1 3 2 1 Migration externer Datenbanken im interaktiven Modus Im interaktiven Modus werden alle notwendigen Einstellungen abgefragt Der Modus kann durch nachfolgende Eingabe gestartet werden MaintenanceTool i 1 3 2 2 Migration externer Datenbanken mit Kommandozeilen Parameter Es ist m glich das
63. n 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 Abw rtskompatibilit t werden weiterhin zwei spezielle Metadaten n mlich e ffectiveFrom 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 43 47 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 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 Standardinstallation des Execution Servers angenommen die unter der URL http localhost 8080 executionserver 5 x y verf gbar ist 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 Date
64. n Visual Rules Builder separat verf gbar enthalten Bosch Software Innovations 12 47 Kapitel 2 Erstellung und Bereitstellung von Rule Services F r die Bereitstellung muss der Benutzer ber die erforderliche Berechtigung verf gen Siehe auch Abschnitt 5 1 Verf gbare Rollen und Berechtigungen 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 Als Web Service bereitstellen Rule Service definieren und hochladen Bibliothek und Yerbindungseinstellungen festlegen sruppen I0 kinokarte Artefakt Ib Kinokarte version 1 0 Exportiertes Regelmodell gt Kinokarte Optionale Rule Service Einstellungen Aktiv Execution Serwer Einstellungen URL http localhost 5080 executionserver adminiupload Benutzer admin FasswuorE 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 f r die Regelbibliothek selbst und den Rule Service der bereitgestellt wird 4 Wenn das Regelprojekt mehrere Regelmodelle enth lt m ssen Sie ausw hlen welches Regelmodell exportiert werden soll Erweitern Sie den Abschnitt Exportiertes Regelmodell und w hlen Sie das Regelmodell zum Exportiere
65. n 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 eingestellt 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 und das Passwort Bosch Software Innovations 13 47 Kapitel 2 Erstellung und Bereitstellung von Rule Services Die URL endet immer mit admin upload Der Host Name und der Kontext Name h ngen 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 2 1 1 Rule Service e Abschnitt 2 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e Abschnitt 2 2 1 Regeln festlegen die als Rule Service exportiert werden sollen Bosch Software Innovations 14 47 Kapitel 3 Arbeiten mit der Webkonsole Kapitel 3 Arbeiten mit
66. n eines Rule Service die im Regelmodell gespeichert sind und nach der Bereitstellung des Rule Service nicht mehr ver ndert gel scht werden k nnen Name und Wert dieser Metadaten werden auf der Metadatenseite des Rule Service im Abschnitt Modellbezogene Metadaten angezeigt Modellbezogene Metadaten Marne Wiert author Erika Mustermann entry rule Freisberechnung Zudem gibt es zus tzliche Metadaten die Sie ber 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 Mame Wert priority hoch Das Editieren ist nur verf gbar wenn der angemeldete Benutzer ber die entsprechende Berechtigung verf gt Siehe auch Abschnitt 5 1 Verf gbare Rollen und Berechtigungen 3 2 8 1 Hinzuf gen von Metadaten Sie haben die M glichkeit einem Rule Service weitere Metadaten hinzuzuf gen 1 7 Klicken Sie im Abschnitt Zus tzliche Metadaten auf die Schaltfl che Metadaten hinzuf gen Eine leere Tabellenzeile wird hinzugef gt 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 _ PEIChern Die Metadatenliste wird um diesen Eintrag erweitert 3 2 8 2 L schen von Metadaten L schbare Metadaten bekommen im Abschnitt Zus tzliche Metadaten
67. nd Konfiguration des Execution Server ssseessseeccseeccsseeccseeeessee L Le DISINDUNON aa ee een ee ee 1 1 2 Installation des Execution Server 20s2s20ssnsnnonennnnnnnsnnnnennnnnnnsnnnnsnnsnennsnnsnsnnsnenssnnsnsnnsnenssnssnsnnsnen 1 1 3 Aktualisierung einer bestehenden Version sssssssssssensensensennnnnnnnnnnnnsnnennnnnnnnnnnennennsnnsnnsnssnnsnennen 1 1 31 Maintenaniee TOO 2er see Bee EEEE 1 1 3 2 Migration externer Datenbanken 2z222s2sssssssensnennnnnnnennnnnnnnnnnnnnnnnnnennnennnnnnnennnsnnnssenssnnesnnennn 2 1 3 2 1 Migration externer Datenbanken im interaktiven Modus z222222202sesesnesennnnennnnenennnnensnennennnennn 2 1 3 2 2 Migration externer Datenbanken mit Kommandozeilen Parameter z2s22s220ssssesnnnennnnennesnnenn 2 1 3 3 Migration der eingebetteten Datenbank sseessssssessssssoeessssssecesssseoeesssssoeesssseeeeesssseeeesssseeeessseeee 3 1 3 3 1 Migration der eingebetteten Datenbank im interaktiven Modus z222222202s0seseesnnnnnenennnnennennnennn 3 1 3 3 2 Migration der eingebetteten Datenbank mit Kommandozeilen Optionen zss0s0ssssenennesnnennn 3 1 3 4 Migration von der Version 4 zessesesessessssesensnnennnnnnennnnnnnnnennnnnnsnnenensnnsnnennnsnnennnsnnsnnenensnnennesnnenn 3 1 2 In Tallation der Eizenz nee ee ee a a a a een 4 1 5 Konfiguration des Execution Server ssssssseesssseeeesssseocessssseceessssoeeess
68. ngegeben werden Dies wird nur ben tigt wenn sich keine Lizenzdatei im Standardverzeichnis befindet Lesen Sie Abschnitt 1 5 Konfiguration des Execution Server um mehr Details dar ber zu erhalten wie dies bewerktstellig werden kann Im Fall einer ung ltigen oder fehlenden Lizenz wird eine Fehlermeldung auf der Startseite der Webkonsole angezeigt 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 1 5 Konfiguration des Execution Server Der Execution Server ben tigt keinerlei Einstellungen f r die Konfiguration da er angemessene Standardwerte verwendet In Produktionsumgebungen ist es ratsam bestimmte Einstellungen beispielsweise die Datenbank und Punkte in Bezug auf Sicherheit zu ndern Um dies durchzuf hren gibt es zwei m gliche Wege 1 Verwendung der Kontextparameter des Web Containers Dies sind Name Wert Paare welche verwendet werden k nnen um die bereitgestellte Applikation zu konfigurieren Dies ist wiederum f r jeden Application Server spezifisch Zum Beispiel erwartet der Apache Tomcat dass diese pro Applikation in der web xml oder global in der context xm1 Datei definiert werden F r Details zur Konfiguration der Kontextparameter schauen Sie in der Dokumentation des Host Servers nach 2 Die Einstellungen k nnen als E
69. nicht nur Nummern enthalten sondern Bosch Software Innovations 9 47 Kapitel 2 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 spezifizierte Version aufgerufen wird dann wird der Rule Service ohne qualifier als neuer angesehen Weiterf hrende Konzepte e Abschnitt 2 1 1 Rule Service Abschnitt 2 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e Abschnitt 2 2 4 Bereitstellen von Regelprojekten vom Visual Rules Modeler 2 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 2 1 1 Rule Service e Abschnitt 2 1 2 Regelbibliothek Weiterf hrende Arbeitsschritte e
70. niert 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 einen 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 4 1 3 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 effectiveDate zwischen den Grenzen von g ltig von und g ltig bis inklusive befindet 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 ei
71. novations 24 47 Kapitel 3 Arbeiten mit der Webkonsole 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 Ausf hrungszeitraum Dazu steht ein erweiterter Eingabedialog zur Verf gung Filter Ausf hrungen Request ID Rule Service version Regelpfad Ausf hrungszeikr aum von 20 01 2011 A 07o gt Bis 31 12 2011 A 18 00 w Fiter anwenden Filter zur cksetzen Erweitert Mehr Informationen zur Eingabe der Filterkriterien und der Anwendung des Filters finden Sie in Abschnitt 3 7 Filterung angezeigter Objekte 3 3 3 L schen von Ausf hrungen von Rule Services Sie haben die M glichkeit eine bestimmte Ausf hrung oder alle im Abschnitt 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 Men leiste der Webkonsole den Eintrag Ausf hrungen aus 2 Wenn Sie eine einzelne Ausf hrung l schen m chten dann klicken Sie im Abschnitt Ausf hrungen auf das Symbol x der Ausf hrung die Sie l schen m chten oder wenn Sie alle aktu
72. oolean 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 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 null repr sentiert kann dies durch Angabe das xsi nil Attributes erreicht werden Dazu ist es erforderlich in der Anfrage auch den Namespace xmilns xsi http www w3 org 2
73. projektes 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 ber die Execution Server Webkonsole zugegriffen werden Weiterf hrende Konzepte e Abschnitt 2 1 2 Regelbibliothek e Abschnitt 2 1 3 Versionen von Regelbibliothek und Rule Service Weiterf hrende Arbeitsschritte e Abschnitt 2 2 1 Regeln festlegen die als Rule Service exportiert werden sollen e Abschnitt 3 2 5 Anzeige der WSDL Datei eines Rule Service 2 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 2 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 we
74. r WSDL Datei eines Rule Service seissriirisrsisiriirittiri istisini tiike Essar EESE EEEE E 19 3 2 6 Herunterladen eines Rule Service 0ssss0ssnsnnonennnnnnnsnnnnennnnennsnnsnennsnsnnsnnsnsnnsnenssnnsnsnnsnennnne 20 3 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service cesseeseessenseeneeneenn 20 3 2 8 Verwaltung der Metadaten eines Rule Service 2s22sssssesesesesesesenenenenenennnenenenenenenenenenenennnenenenn 21 3 28 1 ANZU en von Melidaten sense een 22 3 2 8 2 L schen v n Metadat r ss ssicrsirsivsreresrireoitodsssevesedrsanisensniandi ekki derenn ndira inde eirinn 22 3 2 8 3 Editieren von Metadatennamen und werten essssessssossssecesssossssoeesssocessoessssocessoesessoeesseeeesso 22 3 2 9 Anzeige der Ausf hrungen eines Rule Service 22222ssssssesnensnennnnnnnnnnnennnennnnnnnnnnnnsnnensnesnnennen 23 3 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service s222ss22sssesnensnsnnnnnnnnnnnnnnnnennee nen 23 3 3 Verwaltung der Ausf hrungen von Rule Services 222222222sssssnensnennnennennnensnennnnnnnennensnessnensneenen 23 3 3 1 Anzeige der Ausf hrungen von Rule Services 22222222sssssesesesenenenenenenenenenenenenenenenenenenenenenenene 23 3 3 2 Filterung angezeigter Ausf hrungen 22222s22sssesssenenenenenennnnnennnnnnnennnennnennnenenennnsnnnennnsnnnennnen 24 3 3 3 L schen von Ausf hrungen von Rule Services
75. r 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 SOAP Nachrichtenteil spezifiziert der Web Service Client einen VRRequest wie im Abschnitt 4 1 1 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 2 Optional kann das target Element als das erste Element im VRRequest hinzugef gt werden um genau zu spezifizieren welche Version des Regelmodells aufgerufen werden soll Wenn dies weggelassen wird ruft der E
76. rden 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 8 47 Kapitel 2 Erstellung und Bereitstellung von Rule Services Rule Project XYZ Rule Library XYZ 1 0 0 Rule Service A 1 0 0 Rule 1 PIE Input Rule Model A WSDL for A er Rule Model B Rule 2 input Rule Code A mn Rule Code B A Abbildung 2 1 Regelprojekt 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 abh ngigen Regelmodellen enthalten Die Regelbiblothek beinh lt auch alle Klassen von anderen Bibliotheken und Java Projekten auf dem Erstellungspfad des Projekts Auf diese Weise enth lt 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 2 1 1 Rule Service e Abschnitt 2 1 3 Versionen von Regelbibliothek und Rule Service Weiterf hrende Arbeitsschritte e Abschnitt 2 2 1 Regeln festlegen die als Rule Service exportiert werden sollen 2 1 3 Versionen von Regelbibliothek und Rule Service Eine Reg
77. rnehmen soweit notwendig Bestehende Rule Services unterst tzen nach der Aktualisierung nicht alle Funktionalit ten der neuen Version So sind neue Eigenschaften wie Bereitgestellt Von hinzugef gt worden die keine Werte haben 1 3 1 Maintenance Tool Das Maintenance Tool ist ein Kommandozeilenprogramm um ein bestehendes Datenbank Schema und die enthaltenen Daten zu migrieren Es kann ebenso verwendet werden um Tabellen in einem leeren Datenbank Schema anzulegen Es ist Bestandteil der Execution Server Distribution und da es als Zip Archiv packetiert ist muss es als erstes entpackt werden damit es verwendet werden kann Zum Aufruf des Programms dient entweder 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 Bosch Software Innovations 1 47 Kapitel 1 Installation und Konfiguration des Execution Server Die jar Datei des Treibers muss dazu nur in das driver Verzeichnis kopiert werden dass sich im Verzeichnis des entpackten Archivs befindet Dies ist nicht notwendig wenn die eingebettete Datenbank migriert werden soll 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
78. rvice genannt wird e Jede exportierte Regel wird durch eine Operation in einem portType repr sentiert die mit dem Regelnamen endet Bosch Software Innovations 38 47 Kapitel 4 Aufrufen von Regeln im Execution Server 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 Datentypen 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 Abschnitt 3 2 5 Anzeige der WSDL Datei eines Rule Service 4 2 Arbeitsschritte 4 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 de
79. s a visualrules runtime 5 0 0 de vizualrules a visualrules runtime 5 1 0 5MAFSHOT de visualrules O mlbeans 2 4 0 org apache x mlbeans Seite 1 von Pli go Standardm ig werden folgende Eigenschaften der Bibliotheken angezeigt Bosch Software Innovations 26 47 Kapitel 3 Arbeiten mit der Webkonsole 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 3 6 1 Ein und Ausblenden von Spalten e zugeh rige Spalten verschieben siehe Abschnitt 3 6 2 Verschieben einer Spalte e das Sortierkriterium und die Sortierreihenfolge ndern siehe Abschnitt 3 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge Sind Sie nur an den Bibliotheken interessiert die ein bestimmter Rule Service ben tigt dann k nnen Sie sich diese Ansicht ber die Detailseite des Rule Service anzeigen lassen siehe Abschnitt 3 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service Weiterf hrende Aufgaben e Abschnitt 3 4 4 L schen einer bereitgestellten Bibliothek e Abschnitt 3 6 Konfiguration der Anzeige von Tabelleninhalten 3 4 2 Filterung angezeigter Bibliotheken
80. sseecesssseoresssssoeeesssseeeesseeeee 4 1 5 1 Konfiguration der Authentifizierung und Berechtigungen 22222220ssssssensnnennnnennnnennnnnnennennnennen 5 1 5 1 1 Konfiguration des datei basierten Security Providers 22222220220ssssesnnnnenennnnennnnnnennennnnnnennnnnnennn 5 1 3 1 2 JAAS K nfieurat n sacs ee ea ee ae 6 1 5 2 Konfiguration externer Datenbanken zs22s220ssssesnenenennennnnnnennnnennnnennnnnnennenensnnennenensnnenensnnen 6 1 9 EXe eUNON Server FON een ee ee ae een T 1 7 Laufzeitpr tokollier ng uses ea a i T 2 Erstellung und Bereitstellung von Rule Services sesesseecseccsscccsccccseccsecesseeese 21 KONZEN nenne niederen 8 ALi Rulo G OVCE ve ee ee ee E ee esse 8 2 1 2 RegelbiDlIamek srisresnsrarses ininde enaA E OEE E a 8 2 1 3 Versionen von Regelbibliothek und Rule Service ssssosssneeoeeessssssssseeeceeeessssssssseeeeceessssssssseeeee 9 2 1 4 Visual R lES ATCHIV ae ERE EE AE R i 10 2 1 5 R le Service Einstel ngen sus ai nn ae 10 DR IB 2 9 ARUN GREEN E EIER EIER EEEUED RER EOBESELEEOEREEESCOERERUEOEESEEOBESUEREDERBURIEDERSUEUESPEGESGREREN 10 2 1 5 2 GUWE Von Und GUlle DIS au a inne 10 2 1 5 3 Name der aktiven Konfiguration Active Configuration Name sssssssseesesseseeeesseseesessssseeesssseee 10 212 S AUS REN ea ee een 11 2 2 ADESSO en ee ee ee re er serie 11 2 2 1 Regeln festlegen die als Rule Service exportiert werden sollen 22
81. ten 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 serviceViews 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
82. thek angezeigt bersicht Gruppen ID de visualrules Artefakt ID sualrules runtirne version 2 1 0 SM3PSHOT Bereitgestellt von admin Bereitgestellt am 26 01 2011 13 36 22 Neben den Eigenschaften werden auf dieser Seite im Abschnitt Ben tigt von Rule Services alle Rule Services angezeigt die diese Bibliothek verwenden Ben tigt von Rule Services version Bereitgestellt von Bereitgestellt am J Rule Service Kinokarte x inai pe 2 0 admin 26 01 2011 13 36 26 K dao admin 26 01 2011 13 33 47 jd d Seite 1woni b AI Eine genauere Beschreibung der Tabelle finden Sie in Abschnitt 3 2 1 Anzeige bereitgestellter Rule Services 3 4 4 L schen einer bereitgestellten Bibliothek 1 W hlen Sie in der Men leiste der Webkonsole den Eintrag Bibliotheken aus 2 ffnen Sie die Detailseite der Bibliothek die Sie l schen wollen indem Sie im Abschnitt Bibliotheken auf den zugeh rigen Link in der Spalte Artefakt ID klicken Ungenutzte Bibliothek l schen Klicken Sie auf die Schaltfl che a A A EAA l 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 5 1 Verf gbare Rollen und Berechtigungen Bosch Software Innovations 28 47 Kapitel 3 Arbeiten mit der Webkonsole 4 Es ffnet sich ein Dialog in dem Sie best tigen
83. tiv k nnen Sie die Sortierreihenfolge auch ber das Kontextmen der Spalte festlegen 1 Bewegen Sie die Maus ber die Spalten berschrift und klicken Sie auf a um das Kontextmen zu ffnen a Aufsteigend sortieren En Zul Absteigend sortieren A Selektieren Sie den Men punkt Bosch Software Innovations 30 47 Kapitel 3 Arbeiten mit der Webkonsole 3 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 3 7 1 Eingabe von Filterkriterien Filterkriterien werden in einem eigenen Abschnitt der Benutzeroberfl che spezifiziert Der Filterabschnitt befindet sich meist vor der Tabelle auf 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 taina Den erweiterten Dialog k nnen Sie wieder verlassen indem Sie dort auf die Schaltfl che ouies klicken Sie k nnen die Eingabe aller Filterkriterien r ckg ngig machen indem Sie auf die Schaltfl che PESAS AEE a klicken Die Filtereingabefelder sind danach leer Zudem wird die Anzeige der zugeh rigen Tabelle aktualisiert 3 7 1 1 Eingabe von Datum und Uhrzeit Die Eingabefelder zur Spez
84. ue 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 4 1 4 XML Repr sentation von Datentypen Beispiel 4 3 Generic VRRequest format 4 1 4 XML Repr sentation von Datentypen 4 1 4 1 Einfache Typen Einfache Typen werden auf folgende XML Schema Typen abgebildet String Werte werden einfach als Text abgebildet ohne Anf hrungszeichen Zum Beispiel wird in diesem XML Fragment f r ein Datenelement nane 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 n0 gt 199 seat ng 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 Bosch Software Innovations 36 47 Kapitel 4 Aufrufen von Regeln im Execution Server 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 ist xsd b
85. ur 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 http localhost 8080 executionserver 4 x y services wsdl rating PD amp author John Doe Bosch Software Innovations 46 47 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 Regel 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 angeben werden muss Der folgende Ausschnitt zeigt die Implementierung der Methode mapRuleInvocationTarget Auch
86. v e Abschnitt 3 2 4 L schen eines bereitgestellten Rule Service e Abschnitt 3 2 5 Anzeige der WSDL Datei eines Rule Service e Abschnitt 3 2 6 Herunterladen eines Rule Service e Abschnitt 3 2 7 Anzeige der Eigenschaften und nderung der Einstellungen eines Rule Service Abschnitt 3 2 8 Verwaltung der Metadaten eines Rule Service e Abschnitt 3 2 9 Anzeige der Ausf hrungen eines Rule Service e Abschnitt 3 2 10 Anzeige der erforderlichen Bibliotheken eines Rule Service 3 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 enth lt den Abschnitt Rule Services in dem alle auf dem Visual Rules Execution Server bereitgestellten Rule Services angezeigt werden Rule Services Service z aus Archiv hinzuf gen version Bereitgestellt vor Bereitgestellt am J Rule Service Kinokarte w inai pi 2 0 admin 26 01 2011 13 36 26 u 8 1 admin 25 01 2011 13 33 47 B Rule Service Provisionsberechnung Ka p 321 admin 27 10 2010 11 15 29 13 Seite 1 von i rl ae Bosch Software Innovations 16 47 Kapitel 3 Arbeiten mit der Webkonsole Standardm ig werden folgende Eigenschaften der Rule Services angezeigt e Name Aktiviert oder deaktiviert e Version e Bereitgestellt von e Bereitgestellt am Sie k nnen das Layout der ang
87. vom Typ Log Eintrag schreiben geschrieben werden Die Kategorie Eigenschaft von Aktionen vom Typ Log Eintrag schreiben wird nicht unterst tzt Wird dies verwendet so werden die Nachrichten nicht in die LogAction 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 3 5 2 Konfiguration und Anzeige 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 spezi
88. xecution Server die neueste Version auf 3 Wenn der Regelaufruf erfolgreich ist erhalten Sie eine VRResponse wie in Abschnitt 4 1 2 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 die Regel und die Version Bosch Software Innovations 39 47 Kapitel 4 Aufrufen von Regeln im Execution Server lt pricing VRResponse xmlns vr http www visual rules com xmlins pricing http www visual rules com vrp 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 4 1 1 Format der Rule Service Anfrage e Abschnitt 4 1 2 Format der Rule Service Antwort Weiterf hrende Arbeitsschritte e Abschnitt 3 2 5 Anzeige der WSDL Datei eines Rule Service Bosch Software Innovations 40 47 Kapitel 5 Rollen des Sicherheitskonzepts Kapitel 5 Rollen des Sicherheitskonzepts 5 1 Verf gbare Rollen und Berechtigungen Ein
89. ziert 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 Bosch Software Innovations 29 47 Kapitel 3 Arbeiten mit der Webkonsole Logs Name executionserver log NA 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 1 7 Laufzeitprotokollierung beschrieben Mit dem Log Datei herunterladen beschrifteten Link kann die ausgew hlte Protokolldatei heruntergeladen werden 3 6 Konfiguration der Anzeige von Tabelleninhalten Die tabellarische Anzeige von Informationen in der Webkonsole kann oftmals auf folgende Art und Weise ver ndert werden e Abschnitt 3 6 1 Ein und Ausblenden von Spalten e Abschnitt 3 6 2 Verschieben einer Spalte e Abschnitt 3 6 3 Ver ndern des Sortierkriteriums und der Sortierreihenfolge 3 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 be

Server Handbuch - Bosch Software Innovations

Contents

Download Pdf Manuals

Related Search

Related Contents