Home

User Manual - centeractive

1. Daemon Port Publishes the current displayed Tibco Rendezvous message on the transport defined within the transport options dialog The transport can be changed temporary through the menu item Tools gt Rendezvous Transport which will display the above shown option dialog Send Message Each tree node has its own popup menu that is displayed when you right click on it Some of the actions available in the popup menu may also be performed by pressing a button from the toolbar appearing on top of the tree Button Description i Add Sub Message Adds a sub message message field group to the selected node Add Message Field Adds a message field to the selected node copyright centeractive ag Page 94 of 156 e User Manual Opensphere Release 2 5 Button Description Tam Duplicate Sub Message Makes a copy of the selected sub message message field group node and adds it to the parent node w Duplicate Message Field Makes a copy of the selected message field node and adds it to the parent node PE Move Up Moves the selected node up to the previous position within its parent node FR Move Down Moves the selected node down to the next position within its parent node 7 Expand All Expands the node and all its dependent nodes recursively TE Collapse All Collapses the node and all its dependent nodes recursively Fai Remove Removes the selected node and all its dependent nodes 4 5 2 RV PUBL
2. opensphere Release 2 User Manual Opensphere Release 2 5 centeractive 1 INTRODUCTION 1 1 INTRODUCING OPENSPHERE 1 1 1 OVERVIEW Developing large projects in distributed environments is never a simple task Being dependent from other teams makes it hard or sometimes even impossible to develop and test parts of the project under one s responsibility Opensphere can simulate system components which aren t available yet allowing to progress with development on schedule and independently from other teams The built in testing framework enables executing regular regression test runs making sure the product is thoroughly tested before the delivery Opensphere is a client application that supports and simplifies the daily work of people that have to deal with technical aspects within a complex system integration environment EAI consultants software developers system integrators and testers through Opensphere get offered an easy to use and powerful framework that speeds up analysis development and testing of message based middleware database dependent applications and custom components Opensphere is based on persistent projects that can freely be structured and configured to meet personal needs and preferences OpenSphere 2 5 0 C temp samples Rendezvous Rendezvous osp f 5 fos x File Project Testing Message Tool Window Help ES S gt ESRF RB B m Tl i fe 2 x Test Case Logic Test Step Consol
3. lt convert the specified fileset to comma separeted absoulte paths gt lt pathconvert property projectPaths refid projects gt lt run Opensphere projects in a separate virtual machine gt lt target name runOSTest depends init description defines the Opensphere test task gt lt java classname com centeractive opensphere batch OpenSphereTestTask fork true gt copyright centeractive ag Page 142 of 156 User Manual Opensphere Release 2 5 lt classpath refid classpath gt lt jvmarg value DopenSphereHome S openSphereHome gt lt jvmarg value DtestReportDir S testReportBaseDir S TODAY gt lt jvmarg value DmaxRuntimePerTestSuite S maxRuntimePerTestSuite gt lt jvmarg value DshowResult showResult gt lt jvmarg value Dfileset S projectPaths gt lt java gt lt target gt lt copies the Ant log file to the test result directory gt lt target name copyLogFile depends runOSTest description copies the log to the test result directory gt lt project gt 6 4 TEST RESULT Quick information about the result successful or failed of a test suite a test case or even a single test step can be obtained from the project tree where the nodes are represented by an icon according to their execution state Detailed information however is displayed within the detail view of the nodes The test suite detail v
4. S Properties SQL Query Compare m Name SOL Query Compare Compare Function equal to verbose Reference Data Data Data Type 5 SQL Query Manually Edited eli eis id user_id name power 1 1 Alfa Romeo 110 Add 2 2 Ford Mustang 200 EEES 3 3 Citroen C5 150 la 4 3 Fiat Panda 75 10 Ji Skoda Fabia J30 z 20 l4 Volvo V40 120 21 l Saab 93 180 OK check cancel copyright centeractive ag Page 128 of 156 User Manual Opensphere Release 2 5 centeractive The buttons that appear on top of the manually entered reference data table are the following Item Description ta Open File Opens an XML file and loads its content into the table Any previous loaded data will be removed and the table structure will correspond to the one defined in the loaded file Saves the table data back to the XML file If no file has been defined yet a file chooser dialog is displayed and lets the user chose the file lie Save As Saves the table data into an XML file chosen by the user a gt Opens a dialog that lets the user Columns define the table columns Single columns can be added removed or simply moved to iota another position Ei Load from Opens a dialog that lets you load data using an SQL query on a database of your Database choice JDBC Driver Definition MySQL Database URL jdbe my
5. 1 Full comparison The XML document shown in the Comparison Rule View acts as the reference document driving document meanwhile another document is the one that is checked Comparison is done by checking if the value of the text nodes from corresponding elements in both documents is the same Rule only comparison All comparison rules define their expected values as literals The payload XML data of the reference document in the Comparison Rule View is not considered and may be empty Specified node comparison All comparison rules define their expected values as XPath expressions The reference document is expected to contain all the referenced nodes with some useful value combination of 2 and 3 RUN COMPARISON The comparison is started through the Run Comparison button gt that gets only activated if the editor contains two documents one of them being in the Comparison Rule View When comparison is started the XML Editor first arranges the internal frames one beside the other the reference document expected data always appearing right to the checked document actual data The comparison result is shown in a new message pane in the bottom part of the editor Page 37 of 156 copyright centeractive ag ee E User Manual Opensphere Release 2 5 centeractive SR XML Editor C workspaces open sphere open sphere src main external etc runtime projects OS Demo ref 2employees xml File Edit Sear
6. In the Message Filter field at the bottom of the dialog you can define filter criteria When you choose a message listener with a non empty message filter the program automatically creates a tabbed message filter panel on the Message Detector When a new message gets detected the program checks the filter value against the whole message destination name properties body Messages will be added to the tabbed filter panel only in case they match the defined filter criteria Defining a message filter does not reduce network traffic since message filtering is done by the message consumer Filtering voluminous messages slows down the receiving program that has to check for the occurrence of the specified value within the whole message Name Test 2 JIMS Connection Use INDI JMS Provider Tibco EMS EJ Server Url top localhost 7222 r Destination Type TOPIC User Name admin i User Password Destinations Senarafed by semicolon SS TOPIC Destinations JMS Message Selector topic sample exported topic sample imported Message Filter messages must contain this sining Optional Filter Name copyright centeractive ag Page 120 of 156 User Manual Opensphere Release 2 5 4 6 6 3 JMS QUEUE BROWSER When launching the Message Detector in JMS Queue mode you can define different persistent listener definitions with their own JMS connection and one or several queues to download messages from
7. ML Message File C Data Opensphere projects Opensphere Test Publisher 1 Person rym Subscriber options are explained in the table below Reply Forward Message Description Reply Forward all Indicates whether all predefined messages should be replied and or defined messages forwarded together in response to an inbound message together If the check box is selected all messages are sent according to their definition If the check box is not selected a single predefined message is sent each time an inbound message is detected The messages are processed sequentially starting with the first message in the table up to the last one Reply Forward table The table columns Reply and Forward indicate for each predefined columns message individually whether they should be replied and or forwarded in response to an inbound message If the Reply column check box is selected the message is sent to the reply address of the inbound message ore simply ignored it the inbound message does not have a reply subject defined Messages that have the Forward column check box selected are sent to the send subject defined for them Page 103 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Reply Forward Message Definition Option Description Name The name that appears in the project tree together with the node representing the subscriber Use Project Settings This checkbox defines what Tibco
8. Rk Run Starts comparing the two XML documents currently loaded in the editor Comparison 1 Toggle Work Shows or hides the tabbed pane that contains the results or already performed Tab Pane XML comparisons Select Node Select the current tree node in text Edit Text Node Opens an editor dialog and lets the user edit the current selected text tree node Er y Expand All Expands the selected tree node and all its dependants TE Collapse All Collapses the selected tree node and all its dependants 3 1 1 EDITOR ASSISTANTS XML content assistant is available for three parts 1 Element completion from a schema like DTD or W3C Schema Entity completion from DTD declaration and default ones 3 System completion like CDATA or comment This completion is enabled by inserting lt I in The syntax assistant works in several ways 1 By reading a DTD relative to the current document or not The DTD will be automatically read for your current XML document each time it is saved loaded or parsed 2 By reading a Schema relative to the current document or not The schema will be automatically read for your current XML document each time it is saved loaded or parsed Page 31 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 A bookmark appears in the text editors left bar as an icon together with the colored line it belongs to The mark is set by a single mouse click inside the text editors left
9. centeractive 3 5 2 MANUALLY EDITED DATA If you select the top left located radio button labeled Static Data the data has to be entered manually into a table The table structure number and name of the columns gets defined by the user within a dialog that pops up upon mouse click on the button Table rows can be arranged by moving them up or down The entered data is finally stored to a user chosen XML file from where it will be read again at component runtime DataType SQLQuery Static Data a le ke iS M ove D own The items that appear on top of the manually entered reference data table are the following Description Opens an XML file and loads its content into the table Any previous loaded data will be removed and the table structure will correspond to the one defined in the loaded file Saves the table data back to the XML file If no file has been defined yet a file chooser dialog is displayed and lets the user chose the file Lar Open File Define Columns Opens a dialog that lets the user define the table columns Column Name name firstname location Single columns can be added removed or simply be moved to another position copyright centeractive ag Page 44 of 156 Load from Database Load from CSV File Page 45 of 156 User Manual Opensphere Release 2 5 centeractive Description Opens a dialog that lets you load data using an SQL
10. copyright centeractive ag Page 82 of 156 e User Manual Opensphere Release 2 5 Option Description Destination The name of the destination either a topic or a queue Opensphere lets you discover destinations through the search button located right to the destination field This is a feature that requires a JMS connection with administrator privileges If you have such a user temporary specify the corresponding connection discover and select your destination Don t forget to specify a non administrator connection for further use As an example if you work with Tibco EMS and you want to know about valid destinations you may also launch the EMS Administration Tool and connect to the JMS provider specified by hostname and port You could for example type connect tcp localhost 7222 Once the connection is established enter the command show queues or show topics and you get a list of available destinations Communication Type You can choose between communication type Send and Request While Send does not expect any reply message Request expects one on a temporary destination created on the fly Request Timeout The number of seconds the publisher must block until it receives a reply message when sending messages using the communication type Request Message Time To Live Time in seconds from its dispatch time that a produced message should be retained by the message system The
11. Create backup copy when saving messages Store text data within CDATA section Description Defines whether the last visited project should be loaded automatically if the application is launched Specifies whether a backup copy of the previous file content should be created each time the project file is saved The backup copies are saved into the backup folder of the current project directory The name of the backup file has the following format lt yyyyMMss_HHmmss gt _ lt project file name gt i e 20040728 154619 myProject osp Specifies whether message files are automatically created to a location that corresponds to the project structure If this option is selected and a property dialog of a messaging component i e RV Publisher or JMS Consumer is closed without indicating where to save the message s the messaging component node path will determine the location of the message file and the messages get stored automatically by Opensphere when the property dialog is closed by pressing the OK button If this option is not selected the user must himself specify the location of the message file within a file chooser dialog Specifies whether a backup copy of the previous file content should be created each time a Tibco Rendezvous message file is saved The backup copies are saved into the same directory as the original message The name of the backup file has the following format bck lt yyyyMMss HHmmss gt lt file nam
12. lt operation name sayHello parameterOrder String_1 gt lt input message tns sayHello gt lt output message tns sayHelloResponse gt lt foperation gt lt fportType gt lt binding name HelloBinding type tns Hello gt lt soap binding style rpc transport http f schemas xmlsoap org soap http gt lt operation name sayHello gt lt soap operation soapAction gt lt input gt lt soap body namespace http f hello jaxrpc samples use literal gt lt finput lt output gt lt soap body namespace http hello jaxrpc samples use literal gt lt foutput gt lt foperation gt lt binding gt lt service name HelloWorld gt lt port binding tns HelloBinding name HelloPort gt lt soap address location http localhost 8080 axis Hello gt lt port gt lt jservice gt refix lt definitions gt e tType ame lo definitions pornType 1 copyright centeractive ag Page 30 of 156 User Manual Opensphere Release 2 5 centeractive The buttons appearing on the XML Editor s main tool bar and the one located on top of each structure tree are explained in the table below Button Description P New Creates a new XML document Open File Opens an existing XML file Save Saves the XML document to the file system Eg Paste a text Formats the current XML text applying indentation eat Split Split the current editor in two ones
13. 09 06 2012 10 36 779 classpath 2012 06 09 12 34 48 27 04 2012 08 14 563 project 2012 06 09 12 34 48 27 04 2012 08 14 lt DIR gt settings 2012 06 09 12 34 48 08 06 2012 17 12 25 151 pom xml 2012 06 09 12 34 48 27 04 2012 07 29 765 README txt 2012 06 09 12 34 48 06 06 2012 11 19 lt DIR gt SOAP_over_HITP Test _Suite 2012 06 09 12 34 48 27 04 2012 07 29 lt DIR gt arc 2012 06 09 12 34 48 26 05 2012 12 55 lt DIR gt target 2012 06 09 12 34 46 4 File s 27 258 bytes 2012 06 09 12 34 48 6 Dir s 364 363 368 926 bytes free 2012 06 09 12 34 48 return code 0 2012 06 09 12 34 48 process terminated Completed successfully Page 147 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 K 6 5 4 EXECUTABLE The Executable test step executes an independent program that has the extension exe on Windows operating systems It may also be used to execute a batch file bat or any other executable file Its property dialog looks much like the one of the OS Command test step 6 5 5 WEB SERVICE SERVER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description It is good practice to have a web service server located outside of a test case To make sure the server is running when the test is executed a confirmer test step can be added to the test case flow Its task is to notice the user that he ha
14. 4 soto oO TN 7D w Message File C Data OpenSphere projects O penSphereT est Message_Comparisons Nested_XML_Comparison MLDocMessage rvm Page 93 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive E Messages File Edit view Search Tool SAR thRKR HAD HW Mh B amp O Send Subject Size Byte opensphere test xml data s a o lt famil version 1 0 encoding UTF 8 gt person dl Created by OpenSphere Enterprise Release 1 3 0 at Friday 2004 12 17 10 56 25 G9 Documen H name lt person gt BEL eae name Muller name gt aaa firstname C line firstname address E streel street Aua Gonzalez street Sl ZIP lt ZIP gt 2001 lt 21P gt BE text K city Gen ves city city lt faddress gt lt person gt k F Message File C Data O penSphere projects t0 penSphereT est Message_Comparisons Nested ML Comparson MLDochessage rm The Rendezvous message specific items appearing in the menu and or the tool bar of the message list editor offer the following functionality Item Description Save as rvscript Saves the messages currently contained in the editor to a file that can be used by an rvscript The file extension by default is rvs Rendezvous Transport Pops up a dialog where you can F change the transport options used by the publisher Rendezvous Transport Service Network
15. A by centeractive expand all collapse all Test Suite 3 Test Case SSL Gh SOAP over HTTP Test Suite A olan Tests SOAP over HTTPS WS server and client use SSL certificate they have both the same keystore file defined Lg Sta y WS Client2 fq WS Server Test Result 4 Check request g Check response Name Execution Status Execution Start Execution End Duration QJ Batch SSL Terminated with error 11 06 2012 06 34 01 11 06 2012 06 34 03 2 sec Cg Start WS Se ara aE WS Server Completed successfully 11 06 2012 06 34 01 11 06 2012 06 34 03 2 sec Ws Client2 OQEssi WS Client2 Completed successfully 11 06 2012 06 34 01 11 06 2012 06 34 01 0 sec Cg Start Check response Terminated with error 11 06 2012 06 34 01 11 06 2012 06 34 02 1 sec WS Server Check request Ready for execution ay WS Client2 a Check response Test Case Logic 4 Check request Row set WS Client2 Test suites are published with the aim to share test results with other team members but also for maintaining a test history The Opensphere application in fact does not hold the information on test results over session boundaries it only maintains the test definition which includes the test structure the test flow and logic of single test steps 6 4 1 1 CUSTOMIZING When a test suite is published some files contained in the directory lt Opensphere HOME gt pubresources are used as template and some ot
16. As an alternative to monitoring messages you may create a JMS destination bridge that will automatically duplicate every message to a second destination a topic or a queue There is no impact on the original message sent to the queue If for example we got a queue named sample queue the following entry in the EMS configuration file bridges conf would make sure that every message gets replicated to the topic named sample topic queue sample queue topic sample topic 5 DATABASE SUPPORT Opensphere offers support for direct database operations You may use a simple SQL Query Viewer SQL Processor executable node a SQL Comparison test step 5 1 DATABASE CONNECTION Prior to be able to establish a database connection you have to define the appropriate JDBC driver class and add the corresponding JDBC library to the classpath of Opensphere Open the tool options dialog by selecting the menu item Tool gt Tool Options Properties and select the node Database JDBC Activating the Add button will then add a new JDBC driver definition to the list The name appearing in the list can be freely chosen Each driver definition must define the driver class as well as a sample URL that helps the user specifying a real URL at connection time copyright centeractive ag Page 124 of 156 S Preferences 4 ee E User Manual Opensphere Release 2 5 centeractive Paths File GUI Console JMS Provider Database
17. E Body Text MSExpiration WeProty SSS MscorelatinID S C lt CS C CS S NCOUOOUU METypE D MsBesination OOS MaMessageID SSCS Mstmestamp OOS MeRepyTO SSS MSRedelivered False IMSDeliveryMode Message Header custom Properties Message header fields are editable only if they appear with white background color Most other fields are set by the JMS provider when a message is sent The JMSExpiration is set by the JMS Message Producer when a message is sent its value depends on the Message Time To Live field that can be found in the property dialog 4 4 2 2 ADDITIONAL FEATURES Except the configurable behavior that is defined in the property dialog a JMS Message Producer offers a number of additional features Like any other executable node or test step a Message Producer node can be exported to an XML file through the export button located in the main toolbar or through the corresponding menu item from the specific pop up menu It may then be re imported to a folder or a test case regardless whether it was exported from an executable node or a test step Page 85 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 4 4 3 JMS MESSAGE CONSUMER a The JMS Message Consumer allows you to receive JMS messages and provides support for both the point to point and the publish subscribe domains The dialog shown below lets you configure t
18. When defining Tibco Rendezvous subjects feel free to use the known wildcards such as the asterisk that substitutes whole elements or the greater than gt which matches all the elements remaining to the right The field accepts multiple topics subject entries separated by the semicolon each For each entered destination string subjects topics or queues the Opensphere Message Detector creates a separate listener regardless whether two destinations are identical or whether one copyright centeractive ag Page 108 of 156 User Manual Opensphere Release 2 5 represents a subset of another destination Every single listener reports received messages independent from the other listeners Therefore if for example you define the same destination twice within the destination list messages intercepted on that destination would be reported twice as well When the Message Detector gets started it detects messages that are sent on the specified destination subject topic or queue buffers and displays them up to the configured buffer size Buffered messages of the selected row can be displayed within a Message List Editor by pressing the appropriate button from the tool bar Fi Eig The messages may through that editor be modified and saved to an XML formatted file for further use The Message Detector has two default views tabs on received messages The Message Sequence View on the other hand displays every sing
19. already contain all names of message files defined in such test steps within the same test case This file name can also be selected from the file system through the message editor or the path can be entered manually Select the Compare Mode from the appropriate combo box This will determine how message fields are compared in general The compare mode does not influence whether the send and the reply subject will be checked for equality between a compared message and the reference message Subject comparison is done only in case you select on or both of the appropriate checkbox For details about the comparison process and how the test step reports its results consult the description of the Message Editors that behind the scenes uses the same functionality 6 5 16 1 COMPARISON OPTIONS Compare Mode Compare all for equality All message fields of the compared messages must be identical with the message fields of the reference message This applies to the field names the field ID s the values and the message structure compare all for equality All elements of a compared message must be identical to that of the include nested XML reference message The actual message must not contain fields that are not present in the reference message This also the checks the structure and values of nested XML content Compare equality not All fields of the compared message must be equal to that of the structure reference message Fields that are in th
20. for detailed information about the row set editor When running the Web Service Client the rows from the row set regardless if resulting from an SQL query or from static data are traversed one by one until the last row is reached Every row corresponding to one iteration will trigger the invocation of all operations present in the operation list The values from the current row can be used as string type substitution values in the operation data of that one iteration To make the substitution happen you simply place the column name enclosed by the appropriate pre and postfix wherever you wish within your operation same as you do with ordinary substitution values see 2 3 Substitution Variables This field is visible only if the operation invocation trigger selection is Data Row Set Sets the time in milliseconds the client should wait between operations invocations If the operations being invoked send a result back then the publisher waits the time specified after having received that result The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Select this check box if you want the client to write result messages responses to a file specified in the below located text field copyright centeractive ag User Manual Opensphere Release 2 5 4 4 JMS 4 4 1 JMS MESSAGE EDITOR JMS messages within Opensphere can be s
21. 41aa 12b42972 j 300826 1 783c 404e 9041 14dbdb775fa7 1 10 7a88cd2 ff96 40 14 afb3 5e531f4a0F7b i opensphere test person create 10 10 opensphere test person create advisory Ji test person 10 10 4 6 3 TOOL BAR AND POP UP MENUS The table below gives an overview of the toolbar buttons of the Message Detector Button Description Open File Lets you select and open a message event file that was previously written to a message event swapping directory see 0 Message Event Swapping Please keep in mind that the current defined message buffer size may prevent the Message Detector from loading all message events from the selected file If the Message Detector is launched in Tibco Rendezvous or JMS Topic Mode Starts detecting messages on the specified destinations subjects topics or queues and keeps doing this until it gets stopped through the Stop button or until the Message Detector dialog gets closed If the Message Detector is launched JMS Queue Mode Removes all current displayed messages from the Destination Summary View and the Message Sequence Views and starts downloading the messages from all specified queues The program stops as soon as all messages are downloaded from the queues or if the user presses the Stop button Keep in mind that the messages are not physically removed from the queues but re
22. Deletes the selected WSDL definition from the cache 4 3 2 WEB SERVICE MESSAGE EDITOR Web service components within Opensphere use XML formatted messages file extension wsm to define what data to exchange and how to address the counterpart Such messages can be operation invocations or the result to such invocation Operation invocation messages are requests that are sent to a web service server Operation result messages let you define the data a web service server component shall send back as a response to a corresponding operation invocation You ll always need a WSDL file that describes the location of the service and the operations the service exposes Operation invocations are typically defined for the web service client results are defined on the server component for one or several service operations In some cases those messages are defined independently from a client or a server This can be done through the standalone message list editor menu item Message gt Message Editor and through the multi message document editor menu item Message gt Multi Message Doc Editor copyright centeractive ag Page 60 of 156 e User Manual Opensphere Release 2 5 centeractive Operation Invocation Messages anb e RX WAP MH HB Context Path AddressSoapBinding update Address REQUEST Janis services Address tz ig 2 G X RabB Pexkb 68 H B F B gd AddressSoapBinding updateAddress REQUEST lt soapenv Envelop
23. Encoder Decoder In the bottom area of the panel you can define a class that is responsible for encoding and or decoding Rendezvous user types Description Handler Class The full name of a class that implements the interfaces Name com tibco tibrv TibrvMsgEncoder and or com tibco tibrv TibrvMsgDecoder User Data Types Comma separated integer values between TibrvMsg USER_ FIRST 128 and TibrvMsg USER_ LAST 255 each The class TibrvMsg is in the package Com CLOCOs CDI 4 6 6 2 JMS TOPIC LISTENER When launching the Message Detector in JMS Topic mode you can define different listeners with their own JMS connection and one or several topics to listen on In case you enter more then one topic they must be separated by a semicolon each You can either freely edit the destinations Page 119 of 156 copyright centeractive ag e ee Se User Manual Opensphere Release 2 5 centeractive topics field or detect and add single topics to the list by selecting them from a dialog that pops up if you press the Add button located top right to the field The JMS Message Selector lets you specify what messages to be detected based on the values of message headers and properties The SQL like criteria reduces the set of received messages please consult standard JMS documentation Defining message selectors prevents the JMS provider of delivering certain messages to the consumer and can significantly reduce network traffic
24. Icon Description Import SSL Certificate Imports an SSL certificate to the selected keystore F Remove Certificates Removes all certificates from the selected keystore 9 Create Keystore Creates a new empty keystore and adds it to the cache FA Add Keystore File Addes an existing keystore file to the project specific cache 2 Delete Keystore Deletes the selected keystore from the cache Page 17 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 2 2 1 4 TIBCO The Tibco pages let you define project default settings for Tibco Rendezvous Project Properties General Rendezvous Advanced WSDL Cache Custom Editors SSL Keystore Cache Tibco mercendezvous Advanced Field Name Data Type Editor Class Name Field Name Field ID Data Type Any Type Editor Class Name User Data Type Handler Encoder Decoder Handler Class Name User Data Types Comma separated values between TibrvMsg USER_FIRST 128 and TibrvMsg USER_LAST 255 each Option Description Tibco Rendezvous Tibco Rendezvous transport settings used for sending and receiving Transport messages from inside the project Rendezvous String Character encoding for converting between Java Unicode strings and Encoding Rendezvous wire format strings The default encoding depends on the locale where Java is running ee ee ee TIBCO RENDEZVOUS ADVANCED Select the Tibco Rendezvous Advance
25. JDBC Database JDBC JDBC Driver Definitions Orade Thin Driver Driver Class com mysql jdbc Driver Sample URL jdbc mysql Aocalhost 3306 dbname v Specific database connections are defined in different places Allows Attributes within Opensphere According to the JDBC driver definition you Please choose the JDBC connection or template entered you get the non editable driver class name together MySQL jdbc mysq localhost 3306 dbname with the editable sample URL displayed in the top most text Oracle Thin Driver jdbc oracle thin host port SID fields Depending on the driver you will then have to define the user name and the password together with additional arguments One or several of those entries may be optional however 5 2 SQL QUERY VIEWER The SQL Query Viewer executes an SQL select statement on the database and presents the result in a table The data can be saved to an XML formatted file Page 125 of 156 copyright centeractive ag i User Manual Opensphere Release 2 5 centeractive wecowervefaten Md OO SO Database URL jdbo mysql ocalhost 3306 cars1 SELECT car name FROM user car WHERE user name Dorothy AND user id car user_id 5 3 SQL PROCESSOR The SQL Processor executes one or several DDL or DML statements on the database Se RS ir Database URL jdbe mysql localhost 3306 ears Aocalhost 3306 cars1 User Pass
26. Person Job History Job text is excluded from comparison msg Person Job History Job Desc text expected lt Consultant gt but was lt Senior Consultant gt msg Person Job History Job Company text expected lt centeractive ag gt but was lt IBM gt msg Person Job History Job Hire Date text expected lt 01 01 1999 00 00 00 gt but was lt 01 04 2000 00 00 00 gt msg Person Job History Job text is excluded from comparison msg Person Job History Job Desc text expected lt Business Analist gt but was lt Senior Consultant gt msg Person Job History Job Company text expected lt Microsoft gt but was lt IBM gt msg Person Job History Job Hire Date text expected lt 01 07 1998 00 00 00 gt but was lt 01 04 2000 00 00 00 gt msg Person Job History Job text is excluded from comparison msg Person Job History Job Desc text expected lt Programmer gt but was lt Senior Consultant gt msg Person Job History Job Company text expected lt Microsoft gt but was lt IBM gt msg Person Job History Job Hire Date text expected lt 01 02 1994 00 00 00 gt but was lt 01 04 2000 00 00 00 gt 1 incorrect message found totally copyright centeractive ag Page 58 of 156 User Manual Opensphere Release 2 5 Below you can see the result of a non verbose sample comparison where a message field contains nested XML content start comparing messages compare defined only excluded tree paths are prefixList tracking 1 message
27. Rendezvous transport shall be used for this component If the checkbox is selected the Tibco Rendezvous transport defined in the project properties dialog is used If the checkbox is not selected the transport parameters defined on the RV Subscriber properties dialog are used Service Tibco Rendezvous service Network Tibco Rendezvous network Daemon Tibco Rendezvous daemon Listen on Subject The subject or subject hierarchy the process should subscribe to Protocol Determines the quality of delivery of Rendezvous reply or forward messages Available protocols are Reliable Delivery and Certified Delivery If Certified Delivery is selected the Advanced button at the dialog bottom gets activated it offers additional configuration of the certified delivery transport The Advanced options dialog settings are explained in detail in the chapter Rendezvous Generic Publisher Time out Time out in milliseconds the listener call back method has to wait before to process the next inbound message Message Filter The message filter field lets you enter the filter criteria That field and the two check boxes located to right to it determines whether a detected message is retained or ignored by Opensphere When a message gets detected Opensphere by default both check boxes unselected examines whether this value is contained somewhere in the message If this is not the case the message gets discarded and the user won
28. Step Console Test Result H ActiveMQ SEA A A E T a Simple Communication WE Queue Message Producer yf Queue Message Consumer WB Topic Message Producer yf Topic Message Consumer J Request Reply H O Message Selectors and Filters 6 0 Substitution Node Detail View Gh Test Suite saq ii Start J IMS Message Producer i ug JMS Message Consumer Msg Compare Q Test Case XML QJ New Test Case int gf Start Msg Compare Project Browser Text Initialize test case Test Case XML Initialize test step JMS Message Producer Test step JMS Message Producer initialized Initialize test step JMS Message Consumer Worker Panel Test step JMS Message Consumer initialized Initialize test step Msg Compare Test step Msg Compare initialized Test case Test Case XML initialized ph Test Suite OF New Test Case Of Test Case QJ Test Case XML Page 5 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Window Element Description Main Menu Provides access to many menus such as File Project and Tools Main Toolbar Provides shortcuts to commands Its buttons are grouped by functionality Some of them are activated or deactivated respectively according to the current selected project node Project Browser Displays the content structure of the current project Place the mouse pointer on a node and press the left mouse button to get its relevan
29. When this option is selected and the static row set data was never saved to a file you will see File not yet defined right to the Define button That s there because Opensphere will not automatically assign a file name and save the data to it until the property dialog gets closed through the OK button Please consult the chapter 3 5 Row Set Editor for detailed information about the row set editor When running the RV Publisher the rows from the row set regardless if resulting from an SQL query or from static data are traversed one by one until the last row is reached Every row will trigger the sending action of all messages present in the message list hence corresponds to one iteration The values from the current row can be used as string type substitution values in the messages of that one iteration To make the substitution happen you simply place the column name enclosed by the appropriate pre and postfix wherever you wish within your message same as you do with ordinary substitution values see 2 3 Substitution Variables This field is visible only if the message sending trigger selection is Data Row Set Sets the time in milliseconds the publisher should wait between messages when sending them If the message being sent is a request where the publisher waits on a reply message inbox then the publisher waits the time specified after having received the reply Indicates whether an error shoul
30. as specified 5 The program to be debugged or tested My Program maintains one or several subscriptions and receives the published messages While performing some tasks it may send reply messages but also send independent request messages that target another adapter or application 6 The JMS Message Producer reports expected reply messages or writes error messages if it does not receive them 7 The JMS Message Consumer receives the message from My Program and writes them to an XML file 8 The expected messages get compared to the messages that were received by the JMS Message Consumer The Message Comparator component goes through the predefined comparison rules and reports the detailed result 6 1 3 JMS QUEUES TESTING The figure below shows a test scenario where Opensphere components interact with a custom program using JMS queues i e with TIBCO Enterprise Message Service queues copyright centeractive ag Page 134 of 156 User Manual Opensphere Release 2 5 centeractive The EMS Queue Browser records messages from a dedicated JMS queue The Message List Editor is invoked directly from the EMS Queue Browser It lets you edit the recorded messages and make them look like messages you expect My Program to produce 3 The triggering message that gets feed into the JMS Message Producer can be created the same way 4 The XML file is loaded into the JMS Message Producer and the contained messages are pub
31. compress the message e ifthe name does not start with JMS the property is an application specific property Any of these fields can be used in a message selector to select incoming messages Page 77 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 4 4 1 2 JMS MESSAGE BODY The JMS API defines five types of message body Bytes Map Object Stream and Text For each body type Opensphere offers specific editors A Text message can be edited either as plain text without any formatting it may be edited using the built in XML editor To switch between both editors simply click on the appropriate tab located at the bottom of the node detail view E Messages Fie Edit wiew Search Tool ap EX WAP DH String Message BERR RP BREXIRaBB FexRRG ALt wl JMS A J m m lt Tamil version 1 0 encoding UTF 8 gt person Created by OpenSphere Enterprise Release 1 3 0 at Tuesday 2004 11 23 17 12 51 B name ea B firstname SPEREN pe jae addins name gt Muller name gt firstname gt Hanes firstname lt address gt a ia sml ata sheet Emmenweg lt street lt citiy Ramsel fcitiy gt AP 3464 lt lF lt address gt sumata l CDAT Al lt name gt lt first gt Bille first gt lt last gt Gates lt last fname gt gt lt xmlData gt lt person gt personfaddress 1 k F Plain Text KIL Byte messages are shown and edited within the built in
32. content assistant see below Left of the text view the document structure is represented by a tree where each element including text elements appears as single tree nodes The XML element detail view appears below the structure tree view it shows the element name together with the element attributes All of the three views are synchronized if for example a certain tree node gets selected its text representation gets marked and its element detail view gets displayed The XPath expression that uniquely identifies the selected element is shown in addition in the status bar below the text view raga A SR XML Editor C temp samples WebService gen wsdl HelloWorld wsdl fame File Edit Search View Tool Window Ra BR FJe XRG e2t 2 OB ane HelloWorld wsdl CE a lt xml version 1 0 encoding UTF 8 gt OHO ON lt definitions name HelloWorld targetNamespace http hello jaxrpc samples xmins http schemas xmlsoap orgjwsdl definitions xmins soap http schemas xmlsoap org wsdl soap xmlins tns http hello jaxrpc samples xmins xsd http www w3 org 2001 XMLSchema gt i types lt types gt message lt message name sayHello A x _ t lt part name String_1 type xsd string gt i ioe pa lt message gt SS message lt message name sayHelloResponse gt H lt part name result type xsd string gt H binding lt message gt H service lt portType name Hello gt
33. different WSDL file simply click the button labeled Switch WSDL and make your choice ho Choose Operation Invocation Options Build Headers Indude Optional Elements C Add Sample Values Skip Comment Add Type Comment SOAP Message WSSampleServiceSoapBinding login REQUEST WSSampleServiceSoapBinding searchitem REQUEST WwSSampleServiceSoapsindng fegster REQUEST O O WSSampleServiceSoapfindng buyltem REQUEST TC The payload of the operations to be invoked can contain markers that are replaced by the value of project dependent substitution variables Markers can also be replaced by the corresponding data of a single row when the driving component for invoking operations is a row set Row sets can be defined as static data within an editor but they can also be the result of an SQL select statement that gets executed each time the Web Service Client gets started copyright centeractive ag Page 70 of 156 User Manual Opensphere Release 2 5 centeractive Use JNDI JMS Provider ActiveMQ 5 j Broker URL tep flocalhost 6 16 16 Destination Communication Communication Type Request Timeout Message Time To Live 0 seconds 0 unlimited Message Producing Control Message Sending Trigger Iterator Counter Number of Iterations For ever Interval ms between each Program Termination _ Generates error when no reply message is received within timeout period Message Retention Messa
34. factory By pressing the P button or the button you can easily add or remove single or multiple selected properties The buttons ay and let you change the position of single assigned properties You can define a default value for individual properties if you like this is especially useful if the final property value needs to comply to a certain pattern i e tibjmsnaming host port copyright centeractive ag Property User Manual Opensphere Release 2 5 Description This panel lets you define a template for JMS queue connection definitions The Connection Factory combo box contains all classes found in the defined Java archive files that implement the following interface jJavax jms QueueConnectionFactory The Available Properties list contains all properties available for the selected queue connection factory except the ones that are already assigned to it The Selected Properties table shows the properties already assigned to the selected queue connection factory By pressing the gt button or the button you can easily add or remove single or multiple selected properties The buttons and let you change the position of single assigned properties You can define a default value for individual properties if you like this is especially useful if the final property value needs to comply to a certain pattern i e tcp host 7222 This panel lets you define a template for JMS
35. how detailed information you like to get printed to the work panel compare defined only 7 E Verbose Excluded Paths comma separated XPath expressions Mud coneet_ Page 55 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Description Comparison Mode The comparison mode can be selected from the combo box Compare all for equality All message fields of the compared messages must be identical with the message fields of the reference message This applies to the field names the field ID s the values and the message structure Compare all for equality is selected by default Therefore if you define comparison rules and you don t get the expected result please check first the selected comparison mode Compare equality not structure All fields of the compared message must be equal to that of the reference message Fields that are in the compared message but not in the reference message are ignored Compare defined only Only message fields explicitly defined for comparison are considered A message field is defined when the check box Check on its node detail view is selected The message structure beside the defined fields is not considered Compare all but defined inverse comparison Compares all message nodes except those a comparison rule is defined for Verbose The comparison process by default only reports detail results in case single comparisons
36. it at rvscript tibco com The Source Message Template is a hypothetical inbound message that is used for defining mappings within a Tibco Rendezvous simulator process Structured Query Language that lets you select data from a database TIBCO Software is the leading global provider of business integration solutions The Uniform Resource Locator is a standard way to specify the location of a resource i e a file available electronically XML is the Extensible Mark up Language It is designed to improve the functionality of the Web by providing more flexible and adaptable information identification It is called extensible because it is not a fixed format like HTML a single predefined mark up language Instead XML is actually a meta language a language for describing other languages which lets you design your own customized mark up languages for limitless different types of documents copyright centeractive ag Page 156 of 156
37. lt msgField gt lt msgField name Name type STRING id 0 gt lt CDATA XMLComparison gt lt msgField gt lt msgField name Document type MSG id 0 gt lt msgField name XMLData type STRING id 0 gt lt CDATA lt xml version 1 0 encoding UTF 8 gt lt person gt lt name gt Muller lt name gt lt firstname gt C line lt firstname gt lt address gt lt street gt Rua Gonzalez lt street gt lt ZIP gt 2001 lt ZIP gt lt city gt Gen ve lt city gt lt address gt lt person gt gt lt msgField gt lt msgField gt lt msg gt lt comparison gt lt xMsg gt lt msgArray gt Command file C temp XMLMessage rvm xpath msgField name XMLData text xpath person firstname text Resulting Value C line copyright centeractive ag Page 28 of 156 User Manual Opensphere Release 2 5 centeractive 2 3 9 SYSTEM PROPERTY SUBSTITUTION VARIABLES This substitution variable allows you to use all Java System Properties available at runtime After naming your variable you can choose from the available System properties from a drop down box Initial Value Class Name Method Signature Script etc Increment By ID Sequence 0 5 none UND StaticMethod avautl UD random SS G seve sting tes focahost 7202 ses sss fine Seng eis sss now 2 StaticMethod _ com centeractive opensphere substitution inbuilt CurrentDateFormatter format yyyy MM dd hh
38. message SMT drag the mouse pointer to the desired field within the target message and release the mouse button A selected mapping is removed by pressing the delete key To select a mapping move the mouse pointer on it pointer gets changed to a hand and press the left mouse button Message mapping is subject to the following constraints e The names of the mapped field and of all its parent nodes must not include a forward slash ie e Identical node names on the same hierarchical level must be avoided Page 107 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Except the configurable behavior that is defined through the option dialog a Rendezvous Application Simulator offers a number of additional features Like any other executable node or test step an application simulator node can be exported to an XML file through the export button E located in the main toolbar or through the corresponding menu item from the specific pop up menu It may then be re imported to a folder or a test case regardless whether it was exported from an executable node or a test step By selecting the menu item Save as rvscript from the nodes pop up menu the application simulator is saved as rvscript to a file defined by the user This ready to use script can be run unchanged or adapted to your needs Together with the application simulator script Opensphere generates a client test rvscript that is used to tes
39. message time to live is unlimited if the entered value is zero Message Sending Determines how the message producing process shall be triggered Trigger According to the selection some controls in this box get visible some others non visible Number of iterations Number of iterations the publisher should send messages each time it is started This number has no effect if the publisher was told to send messages forever This field is visible only if the message sending trigger selection is Iterator Counter Infinite Indicates if messages should be sent published until the process is stopped by external intervention If this check box is unchecked Number of Iterations setting determines how many messages are sent This field is visible only if the message sending trigger selection is Iterator Counter Row Set This line shows what kind of data row set is used to control the message sending process Row sets are tabular data that can be defined in a separate dialog by pressing the Define button In that dialog you can either define an SQL query on a database of your choice or you can define your own static table data that will be stored to an XML file If you define a row set based on an SQL select statement the statement gets executed every time the JMS Message Producer is started When you decide to define static data Opensphere lets you do that from scratch but it also offers the possibility to impor
40. on the Unicode value of each character in the strings greater or equal to The actual value must be lexographically greater then or equal to the expected value The comparison is based on the Unicode value of each character in the strings empty The actual value must be empty not empty The actual value must not be empty length The length of the actual value must the one specified by the expected value The expected value must be a valid integer value contains The actual value must contain the expected value as a substring is contained in The actual value must be contained in the expected value as a substring starts with The actual value must start with the expected value ends with The actual value must end with the expected value Expected Value The expected value is also known as the reference value It is usually a predefined value that is specified either by an XPath expression or by a litter value The expected value is interpreted as literal in case it is enclosed by un quotation marks otherwise it is always considered to be an XPath expression User Message The optional User Message gets added to the function message and lets you produce some customized output copyright centeractive ag Page 36 of 156 User Manual Opensphere Release 2 5 3 1 4 COMPARISON MODES According with the above explanations we distinguish between the following comparison modes supported by the XML Editor
41. other can only be set by the message producer itself To see the properties you have to select to message root node within the structure tree As you may notice in the figure below you can also define custom properties in the table that appears at the bottom of the node detail view copyright centeractive ag Page 74 of 156 e User Manual Opensphere Release 2 5 centeractive S Message Editor File Edit View Search Tool Qe tHEX KAD A RAAB Message ID Destination Type ID EMS SERVER 10144FB506F83 2 queue sample Text Message ea a a 3 ID eMs seRveR sbeowrDs0Fe121 auevessamle et Message 4 IID ext Message EMS SERVER 1D804FD30FE 12 3 ext Message 6 ID EMS SERVER 1D804FD30FE 12 4 ext Message 7 ID EMS SERVER 1D804FD30FE 12 5 i ext Message a ID EMS 5ERVER 1D804FD30FE19 2 o D EMS SERVER 10804FD30FE19 4 10 ID EMS SERVER 1D804FD30FE19 6 ext Message 11 ID EMS SERVER 1D804FD30FE19 8 ext Message tg i 3 G xX af i E Body Text 1970 01 01 01 00 00 oe IMSCorrelationID IJMSDestination O sienn SERVER 10144FB506F83 2 JMSTimestamp 2012 05 17 16 14 03 see MsRedivered fre OoOO Message Header Custom Properties The JMS header fields are explained in the table that follows Header Fields Description Delivery Mode Client marks a message as persistent if it feels that the application will have problems if the message is l
42. part of the dialog when a row is selected All you got left to do is editing the result data within the SOAP Content node The payload SOAP Content of the operation response can contain markers that are replaced by the value of project dependent substitution variables S Properties WS Server Definition Operation Response Messages Qa EX KdIAPHW AAR Col 2 E E a searchItem RESPONSE WSSampleServiceSoapBinding ts ts 2 72 5 x RaBG Paexadla ez 2 e d WSSampleServiceSoapBinding searchltem F 7 y Ba oy h lt soapenvEnvelope xmins soapeny http schemas xmlsoap org soa lt soapeny Header gt lt soapeny Body gt lt samisearchlbemResponse gt lt l Zera or more repetitions gt lt return l m searchItemResponse lt l kype ink gt H a ids lt Jid gt lt l ptional lt l bype string gt lt name gt lt name gt lt fl ptional gt lt cl Eype string lt price gt lt j price gt lt samisearchikemResponse gt lt Isoapenv Body gt lt soapenv Envelope gt elope Body 1 searchltemResponse t return 1 Page 65 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 4 3 4 WEB SERVICE CLIENT SOAP OVER HTTP The Web Service Client is able to invoke the web service operations with different data SOAP Content each This component uses SOAP over HTTP or HTTPS to communicate with the remote service When a new client is created y
43. query on a database of your choice Please limit the number of rows by carefully editing the SQL query Any previous loaded data will be removed and the table structure will correspond to the data retrieved from the database Be aware that the loaded data will have to be stored into a file This button is used if you want to load data contained in a CSV file When pressing the button the user is prompted to choose the CSV source file and then he ll see the following dialog where he can specify how the file content should be processed Column Names Line Number Field Separator p Comment Identifier Any previous loaded data will be removed and the table structure will correspond to the data retrieved from the CSV file Be aware that the loaded data will have to be stored into a file other than the CSV source file copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 4 1 MESSAGING PROGRAM NODES Certain tree nodes acting like independent programs are used to send and or receive messages using different types of protocols such as Tibco Rendezvous JMS or HTTP SOAP The detail view of such messaging program tree nodes is a tabbed pane that holds the Console tab where all program activities are shown in textual mode The console view is the basic detail view that is also available on other none messaging executable nodes The additional Messages tab shows all inbound and outbo
44. related configuration JMS Provider Pile GLI IMS Providers i ActiveM 5 gt Console Database JDBC IMS Provider Details Name ActiveMQ 5 Java Libraries C Program Files x86 Apache activemg 5 5 1 lib optional slf4jtog4j12 1 5 11 jar C Program Files x86 Apache activemg 5 5 1fib activemg core 5 5 Ljar C Program Files x86 Apache activemg 5 5 1 activema all 5 5 Ljar Connection Factory dass org apache activemg ActiveMOConnectionFactory Available Properties Selected Properties Property Name Property Name Default Value Always Session Async I tcp ocalhost 61616 Always Sync Send Audit D Audit Maximum Producer Nu Blob Transfer Policy Check For Duplicates Page 7 of 156 copyright centeractive ag Ae PATHS The Paths panel lets you define the following file system options Projects Directory Test Publishing Directory Description The parent directory on the file system where the program proposes to save new Opensphere projects Default location directory from the file system to be proposed by the application when test suite results are published If this option is not set the location proposed will be the pub directory within the current project folder On the File panel you can define the following options Open last project on program start Create backup copy when saving project Automatically define name and location of messaging component files
45. rvMsgField name Location id 0 type STRING gt lt CDATA Lausanne gt lt rvMsgField gt lt rvMsgField name State id 0 type STRING gt lt CDATA VD gt lt rvMsgField gt lt rvMsgField name Country id 0 type STRING gt lt CDATA Switzerland gt lt rvMsgField gt lt rvMsgFieldGroup gt lt rvMsg gt lt os xMsg gt lt os msgArray gt copyright centeractive ag Page 154 of 156 7 User Manual Opensphere Release 2 5 centeractive 8 APPENDIX 8 1 DISCLAIMER Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and or its affiliates in the U S and other countries This product includes software developed by the Apache Software Foundation http www apache org TM Tibco and all related products such as Rendezvous EMS etc are trademarks or registered trademarks of TIBCO Software Inc in the U S and other countries Other names may be trademarks of their respective owners 8 2 TERMS AND ABBREVIATIONS CM Certified Message Delivery is a TIBCO Rendezvous protocol Certified delivery features offer greater certainty of delivery even in situations where processes and their network connections are unstable DML The SQL Data Manipulation Language is a portion of the SQL standard that is concerned with manipulating the data in a database as opposed to the structure of a database The core verbs for DML are SELECT INSERT D
46. t see it at all Regular Expression If this check box is selected Opensphere checks if the string representation of the entire message matches the specified filter criteria Inverse The application of the message filter can be inversed by selecting this check box Defining a message filter does not reduce network traffic since message filtering is done client side in the message consumer Filtering voluminous messages slows down the receiving program that has to check for the occurrence the match of the specified value within the whole message copyright centeractive ag Page 104 of 156 User Manual Opensphere Release 2 5 centeractive Reply Forward Message Terminate after The selected check box together with the number in the behind located text field tells the subscriber to stop after the specified number of messages have been received and processed In case the trailing check box Exceeding message generates error is selected the subscriber however does not stop immediately when the specified number of messages is received It only stops when an additional message is detected or if the idle timeout is reached An additional message in this case generates an error To get a subscriber checking that no message is sent on a certain subject for example you would have to specify O message s and to select the check box Exceeding message generates error As soon as it detects a message it would then gen
47. tab You can add new filters and inherently new tabs if you select the Add new tab check box Defining a message filters does not reduce network traffic since message filtering is done by the message consumer Filtering voluminous messages will even slow down the receiving program that has to check for the occurrence of the specified value within the whole message The message filter can be inversed by selecting the check box located top right on the dialog Shows or hides the message details in the message sequence view This button appears only in case the Message Detector is run as a standalone application Docks the Message Detector at the bottom of the application in its own tabbed panel Undocks the Message Detector from the bottom of the application and shows it as standalone dialog This text field accepts the destination Rendezvous subject JMS topic or queue the Message Detector shall work with This button lets you search for available destinations to be added to the destination field The function is available only if the current selected JMS Provider has an admin class defined see Error Reference source ot found Error Reference source not found copyright centeractive ag Page 114 of 156 e User Manual Opensphere Release 2 5 Button Description Sequence Buffer Size This combo box lets you change the size of the message buffers which corresponds to the message table size for the message seq
48. tab of the test case detail view 6 3 TEST EXECUTION Test cases as well as test suites can be executed independently by simply select the corresponding node in the project tree and press the Run button d on the main tool bar Test steps are controlled and executed by the owning test case and cannot be run independently If a test suite is executed it will first simultaneously initialize all its test cases and run them afterwards in the same order as they appear in the project tree A test case must finish execution before the next test case within the sequence is started only one test case per test suite can be running at a given time Test cases in turn first initialize all dependent test steps before they start executing the defined process flow The sequence and parallelism of test step execution is defined in the test case flow chart Page 139 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 and also dependent on the execution time and user intervention during the test run A test step is started as soon as all preceding test steps have finished execution preceding test steps are those that have a connection line pointing to a specific test step Each test step performs a certain task when it gets activated It stops when certain predefined criteria are fulfilled or if the test case as a whole gets stopped either through user intervention or because another test step got an error Test steps w
49. the value assigned when it was sent The JMSMessagelD header field contains a value that uniquely identifies each message sent by a provider When a message is sent JMSMessagelD can be ignored When the send or publish method returns it contains a provider assigned value A JMSMessagelD is a String value that should function as a unique key for identifying messages in a historical repository The exact scope of uniqueness is provider defined It should at least cover all messages for a specific installation of a provider where an installation is some connected set of message routers All JMSMessagelD values must start with the prefix ID Uniqueness of message ID values across different providers is not required The JMSTimestamp header field contains the time a message was handed off to a provider to be sent It is not the time the message was actually transmitted because the actual send may occur later due to transactions or other client side queueing of messages When a message is sent JMSTimestamp is ignored When the send or publish method returns it contains a time value somewhere in the interval between the call and the return The value is set as milli seconds copyright centeractive ag Page 76 of 156 Header Fields Reply To Redelivered User Manual Opensphere Release 2 5 Description The JMSReplyTo header field contains the destination where a reply to the current message should be sent If it is empty
50. user table and afterwards his cars are added to the car table Meanwhile on the other branch a new car for preexisting user Alen is inserted Finally the branches join together in an SQL Query Compare component which tests for the same number of cars owned by both men E Show individual detail view of selected test step 3 3 HEXADECIMAL EDITOR Frequently message and other data is present in raw format that cannot be interpreted as such by the application Sometimes however you know about the internal format of such data and you want to be able to edit it The Opensphere embedded Hexadecimal Editor that gets invoked through the menu item Tool gt Hex Editor enables you to see and edit binary data The capture below shows how the editor looks like 20 76 65 72 73 69 OF GE 3 6E 63 6F 64 69 6E 67 3D 3E OA OA 3C 21 2D 2D OA 20 61 74 65 64 20 62 79 20 32 2E 79 20 32 35 36 2A 67 41 72 22 68 74 74 72 65 61 63 65 3E OA 20 20 20 3C 70 65 3D 22 3E OA 73 61 67 40 53 4 32 22 20 3D 22 30 3D 22 34 69 6F 6E 49 44 3D 22 73 74 69 6E 61 74 69 6F 6E 22 20 4A 4D 53 54 69 6D 65 73 74 61 6D 70 3D 22 OVERWRITE offset 0 size 1Byte nw oan Oo ANA wnsanin V U Ww w aJ eea Aon J E ae r i i op Ome 1 omDT gt 5 v OF O 7 e 5 7 2 0 m n ti mm OQ J or U N TIMAN RI S NIMB PER W hw OJ o 1 74 69 6 72 69 7 2 72 65 6C E e a a
51. w Pop Up Compare Dialog Ref File C workspaces open sphere open sphere src main external etc runtime projects OS Demo ref 2employees csv Character Encoding S o File C workspaces open sphere open sphere src main external etc runtime projects OS Demo CRM_Test_Suite_1 Add_Employees employees csv Character Encoding Sy 9 CSV Compare Options Column Names Line Number 1 Field Separator Comment Identifier Induded Columns all v Compare Function equal to X V Verbose Cancel The combo box labeled File Content lets you define the type of files you want to compare Current available types are text XML and CSV The check box labeled Pop Up Comparator Dialog is available for XML file content only It indicates if message comparison should be done in the XML Editor when the test step is executed e f the check box is selected the XML Editor is displayed containing the content from the reference file and the compared content from the specified files The user will then have to execute the file comparison by activating the appropriate button and he will also be allowed to change the comparison rules and to edit the file content The comparison result will be reported to the result pane of the dialog and disappear as soon as it gets closed When closing the dialog the user is free to decide if the file comparison and with it the test step was successful or if it failed Test step executi
52. will be compared to 1 reference message message number 1 is not correct msg Document XMLData nested XML content person name 1 text expected lt M ller gt but was lt Muller gt person address 1 street 1 text expected lt Rua Gofizalez gt but was lt Rua Gonzalez gt 1 incorrect message found totally 4 3 SOAP WEB SERVICES Opensphere lets you define SOAP web service clients and server simulators based on existing WSDL files through a few mouse clicks SOAP is an XML based protocol for exchanging information between computers 4 3 1 WSDL FILE CACHE The Web Services Description Language WSDL is an XML based language that is used for describing the functionality offered by a web service A WSDL description of a web service usually contained in a WSDL file provides a machine readable description of how the service can be called what parameters it expects and what data structures it returns WSDL files constitute a contract between clients and servers The WSDL files used to generate web service clients or server stubs are stored within the gen wsdl folder of the Opensphere project directory they belong to When a new project is created this folder is empty but as soon as you invoke any SOAP web service related function Opensphere asks you to select a local or a remote WSDL file The selected WSDL file is then parsed and added to the WSDL file cache for subsequent user selections The WSDL file is also sto
53. 1 1 TIBCO RV TESTING The figure below illustrates a simple use case that points out how Opensphere can be used to debug and test a Tibco Rendezvous RV enabled program TIBCO Rendezvous 1 The RV Message Detector records messages with a well defined subject 2 The Message List Editor is invoked directly from the RV Message Detector or from the AE data import facility It lets you edit the recorded messages and make them look like messages you expect My Program to produce 3 The triggering message that gets feed into the RV Publisher can be created the same way 4 AnXML file is loaded into the RV Publisher and the contained messages are published on the predefined subject recursively as long as specified The purpose of those messages is to trigger some process in My Program The XML file that gets loaded into the RV Publisher may have been edited directly in the property dialog or it may previously have been recorded using the RV Message Detector 5 The program to be debugged or tested My Program maintains one or several subscriptions and receives the published messages While performing some tasks it may send reply messages but also send independent request messages that target another adapter or application copyright centeractive ag Page 132 of 156 F User Manual Opensphere Release 2 5 centeractive 6 The RV Publisher reports expected reply messages or writes error messages if it does not receiv
54. 12 keep this line unchanged when no main function is defined var weekday new Array Sunday Monday Tuesday Wednesday Thursday Friday Saturday var now new Date return weekday now getDay now getDate now getMonth now getFullYear Date Formatting Sample with main method If you remove the first line keep this line unchanged Opensphere expects a main method it tries to execute This main method must be parameter less and its last instruction must return the substitution value Feel free to define other functions that are invoked from within the main method The script in the box below formats the date time that is one hour in the future Depending on the current date following code will produce a value similar to 27 04 2012 16 24 38 returns the specified number in two digit format function format num if num lt 10 return 0 num return num returns the current date time 1 hour in the format dd MM yyyy HH mm ss function main now new Date new Date getTime 3600000 return format now getDate format now getMonth 1 now getFullYear n format now getHours format now getMinutes format now getSeconds File Reading Sample Java Style The following code reads a file on the local file system and provides its content keep this line unchan
55. 9 06 2012 12 26 09 06 2012 12 26 10 Msa Compare 09 06 2012 12 26 1 09 06 2012 12 21 a 6 4 1 PUBLISHING Pressing the publish button D located in the main toolbar lets you publish one or several test suites that have been executed Alternatively this can be achieved by selecting the menu item Testing gt Publish Test Results Page 143 of 156 copyright centeractive ag r g am pee User Manual Opensphere Release 2 5 centeractive Publishing Test Suites Test Suites e Message Comparisons rh RV Communication Within beside shown dialog simply select the test suites you want to publish and confirm your choice by pressing the OK button The selected test suite together with all dependent test cases will be generated to HTML formatted pages that can be viewed in a standard web browser copyright centeractive ag Page 144 of 156 User Manual Opensphere Release 2 5 Same as if you were using the project tree within the Opensphere application you can navigate between the pages by simply selecting the corresponding node within the tree structure The sample pages below give you an impression on how published test cases may look like Sc OpenSphere Test Result Publisher file C temp SOAPoverHTTP pub 20120611_063421_SOAP over HTTP index html W Wikipedia de Pit BD e S opensphere Test Result Project SOAP over HTTP 11 06 2012 06 34
56. AA Aly ee d E a E HER ew PR o 6 2 2 TEST STEPS Test steps belong to a test case and are integrated in its logical flow O22 1 TEST STEP INITIALIZATION Test steps by default are initialized when the owner test case is initialized The listener of an RV Subscriber test step for example is set up at initialization its dispatcher however starts working only when the step is started The test initialization can be changed in the test case property dialog If you want specific test steps have to be initialized just before running them select the corresponding check box on the Execution Control tab S Properties j per a Individual Test Step Initialization Test step initialization by default is done when the test case is initialized To have inidividual test steps initialized just before running them the corresponding checkboxes must be selected Insert sample data Insert Will Insert cars Will Insert cars Alen Will and Allen have same number of cars copyright centeractive ag Page 138 of 156 O22 TEST STEP TYPES Test steps are of a certain type with specific configurable behavior each Test steps are owned by a test case that controls their execution according to the definition made in the test flow chart The table below shows test steps that are available some of them simply wrap existing executable nodes and behave basically the same as th
57. AQAA Bo Baoms lt 4 n O ll a 30 fuunwnea euwuwe x wm DO copyright centeractive ag Page 40 of 156 User Manual Opensphere Release 2 5 centerdactive The editor shows two horizontally arranged panes that offer both a different view on the same data and that let you both edit that data The left located pane shows a byte wise representation of the document content Depending on the current selected button the representation the base is hexadecimal decimal or octal The right pane shows for each line the corresponding textual representation using the character encoding currently selected within the combo box located on the tool bar Functions within the Hexadecimal Editor are triggered either through tool bar buttons or menu items according to the following table Button Description Open File CTRL 0 Load the content of the file into the editor Save CTRL S Save data into a file ie Save As Undo CTRL Z Redo CTRL Y Save data into the specified file Undo previous changes Redo undone changes eh Search Replace Search and maybe replace a given pattern CTRL F db Cut CTRL X Cut selected data Copy CTRL C Copy selected data Paste data from clipboard Paste CTRL V mr Goto Go to the specified index H F Display bytes in hexadecimal representation Hexadecima D Display bytes in decimal representation Decima O Display bytes in octal representation Octal Enc
58. CESSOR This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 15 SQL COMPARISON This test step behaves the way it is described in the section Database Support Please consult the related detailed description 6 5 16 MESSAGE COMPARISON This test step compares XML formatted messages contained in two distinct files that must be specified within the property dialog H S Properties Msg Compare Name Msg Compare Pop Up Message Compare Dialog 4 Ref Message File Users Allan Rendezvous Message_Comparisons Full_Msg_Comparison 1Person_ref rvm oa En E Message File C Users Allan Rendezvous Message_Comparisons Full_Msg_Comparison 1Person rvm Comparison Rules compare all for equality Verbose Excluded Paths comma separated XPath expressions The check box labeled Pop Up Comparator Dialog indicates if message comparison should be done in the Message Compare Editor when the test step is executed e f the check box is selected the Message Compare Editor is displayed containing the reference messages and the compared messages from the specified files The user will then have to execute the message comparison by activating the appropriate button and he will also be allowed to change the comparison rules and to edit the messages The comparison result will be reported to the result pane of the dialog and disappea
59. ELETE UPDATE COMMIT and ROLLBACK EAI Enterprise Application Integration consists of special software called middleware that sits between different applications and intelligently translates and routes data between them It eases the frustration with IT felt by business managers of large corporations who find themselves with many different systems that don t work well together As IT is now so strategic for almost every business anything that adversely impacts its effectiveness has a business cost Therefore EAl normally brings substantial benefit and financial return to those organizations that implement it EMS The TIBCO Enterprise Message Service is a Java Messaging Service JMS implementation GUI Graphical User Interface HTML The HyperText Mark up Language is a language to specify the structure of documents used in the Internet JDBC Java Database Connectivity is a standard vendor independent Java interface for connecting to relational databases It allows you to access a wide range of SQL Page 155 of 156 copyright centeractive ag Rendezvous RV rvscript SMT SQL TIBCO URL XML User Manual Opensphere Release 2 5 databases with exact same syntax TIBCO Rendezvous software is an industrial strength messaging tool that allows application developers to build scalable distributed applications See Rendezvous All purpose scripting tool for TIBCO Rendezvous To get a copy of the product request
60. ISHER Tj The RV Publisher acts as publisher for one or several predefined Tibco Rendezvous messages using the default reliable message delivery or the certified message delivery protocol You can import modify or create messages to be published define the number of iterations and the interval to be observed between Each message in the defined list may be different in structure and value and may have different send and reply subject The messages defined in the list are published sequentially starting from the first to the last occurrence and then restarting with the first one The messages to be published can contain markers that are replaced by the value of project dependent substitution variables Markers can also be replaced by the corresponding data of a single row when the driving component for sending messages is a row set Row sets can be defined as static data within an editor but they can also be the result of an SQL select statement that gets executed each time the RV Publisher gets started The RV publisher can also be run using request reply together with an INBOX or with your self defined reply subject There are many scenarios an RV Publisher can be employed some of them are listed below e Simulate an adapter e Kick off a business process by sending one or several initialization messages e Senda set of recorded messages for help debugging an existing program e Publish a bunch of previously recorded messages to test a new
61. MS provider of delivering certain messages to the consumer and can significantly reduce network traffic Page 113 of 156 copyright centeractive ag Button Show Message Filter Dialog Toggle Message Detail View Dock Undock Destination Field Find JMS Destination User Manual Opensphere Release 2 5 Description Displays a dialog where the user can define message filter options in order to have corresponding messages displayed on a separate tab The user can enter a simple value that shall be contained in a message or he may define a regular expression that is applied on the string representation of the entire message SS Message Filter Message Filter messages must contain this string Regular Expression Inverse Error Optional Filter Name Add new tab The message filter field lets you enter any value at any time Additionally you may also define a name for the filter When you define the first filter a new tab gets added to the message detector and messages from the Message Sequence tab immediately also appear in the table of that tab if their content matches the filter criteria Newly detected messages are checked by Opensphere and are added to the filter table in case their content matches the filter criteria Existing filter criteria can be changed on the fly if you press the iS button when the corresponding tab is selected or the corresponding button that appears directly on the
62. Path Expected Value SOAP Content _ SOAP Content 4 3 3 WEB SERVICE SERVER SOAP OVER HTTP p This program simulates a HTTP server that hosts a number of web services with user defined responses to specific operation invocations When the server node gets created its property dialog lets you define a few options related to the server as a whole The most significant option is the HTTP port on which the server listens on incoming web service operation invocations copyright centeractive ag Page 62 of 156 e User Manual Opensphere Release 2 5 centeractive ad S Properties WS Server Program Termination Terminate after 1 operation invocation s Exceeding generates error Abort after 60 second s of idle time Generates error security SSL Client Certificate Keystore Use Cached Keystore Default Project Keystore ma Keystore Password sssssseseset essage Retention Web Service Server options are defined on the first tab within the properties dialog a detailed description is explained in the following table Option Description Name The name that appears in the project tree together with the node representing the web service server Protocol Choose HTTP or HTTPS Port HTTP or HTTPS port on which the server listens on incoming web service operation invocations Terminate after The selected c
63. ROCESSING Opensphere lets you execute test suites defined in a project from the command line The class com centeractive opensphere batch OpenSphereBatchTestRunner implements the functionality for running all active test suites within a specified project file and publishes the HTML formatted test result to the location of your choice The example presented below demonstrates how to run the batch runner through the use of Apache Ant a powerful Java based build tool You may use additional predefined tasks from the Ant framework to send notification with the test result to publish the result to a web server using FTP to archive the test result directory and much more Please consult the Ant documentation to learn more Each Opensphere project is supplemented with a sample Ant build xml file located in the bin batch folder Adjust that file in order to run a specific test 1 Set the properties listed in the table mentioned below 2 Set the project fileset indicating Opensphere project files osp to run the test suites for openSphereHome Path to the Opensphere installation home directory yes testReportDir Path of the directory where to store the HTML formatted test report This directory will contain an index html file once the tests have been executed maxRuntimePerTestSuite Defines the maximum number of seconds a test suite must run before it gets stopped automatically The default is 3600 seconds which is 1 hour showResult Indic
64. Test suites with all their dependent nodes can be published after execution in order to be shown within a web browser Test suites only appear as direct dependents of the project node only 2 2 6 TEST CASE g Test cases depend on test suites and represent a certain number of test steps that are part of a graphical definable process flow The test case detail view is composed of several tabbed panels that show a different aspect of the test case each You have the choice between the test flow chart test logic the test step consoles execution monitor and the result panel 2 2 7 TEST STEP Test steps test tasks are part of a test case and controlled by its test flow engine The appearance of them within the project tree depends on their functionality which may be as simple as the sleeper test step B that interrupts the test case processing during the specified time or it may be complex such as the SQL Comparison test step Hed that compares and reports data retrieved from one or two distinct databases 2 3 SUBSTITUTION VARIABLES Opensphere lets you define substitution variables on project level within a single dialog This is useful where the same variable values are defined at several places within the project and especially also when a project at some point needs to be adapted to a different environment The substitution variable dialog is invoked from the main menu through the menu Project gt Substitution Variables or directly
65. The detail view of message field nodes by default appears with fields that let you edit their name the identity the data type and the value of course Depending on the data type a certain edit format is required Opensphere provides data type related support by displaying the expected format pattern through popup editors and through specific built in editors Editing date time binary and XML data for example is fast and seamless and does not require to switch to any tool external to Opensphere copyright centeractive ag Page 92 of 156 F User Manual Opensphere Release 2 5 centeractive E Messages Fie Edit View Search Tool ABB EX HIP Ah AYR opensphere test person create opensphere test person create le opensphere test person create opensphere test person create o b EEE LLTE al AW Message o Type DATETIME ea Person al oer O Title a Name Value dd MM yy HH mm s8 i ee _ Fikihame 01 01 1999 00 00 00 Minute Birthdate Second H 0 Address a Job aaeaed Desc Message File 0 47 emp Person ryvm Messages Eg File Edit View Search Tool anG EX HAD NW Hh amp OR Oo Send Subject Size Byte 1 83 tg tz 4 p cl x BinaryD ata O Type OPAQUE a Document i H D O windows 1252 6F 6E 3D 22 31 lt 67 3D 22 55 5 2D 20 43 72 65 53 70 68 69 65 20 52 30 61 74 20 2D a K 2D 20 61 61
66. The queue listener definition dialog gets invokes through the EP button In case you enter more than one queue they must be separated by a semicolon each You can either freely edit the destinations queues field or detect and add single queues to the list by selecting them from a dialog that pops up if you press the amp button located top right on the field The JMS Message Selector lets you specify what messages to be detected based on the values of message headers and properties The SQL like criteria reduces the set of received messages please consult standard JMS documentation Defining message selectors prevents the JMS provider of delivering certain messages to the consumer and can significantly reduce network traffic In the Message Filter field at the bottom of the dialog you can define filter criteria When you choose a message listener with a non empty message filter the program automatically creates a tabbed message filter panel on the Message Detector When a new message gets detected the program checks the filter value against the whole message destination name properties body Messages will be added to the tabbed filter panel only in case they match the defined filter criteria Defining a message filter does not reduce network traffic since message filtering is done by the message consumer Filtering voluminous messages slows down the receiving program that has to check for the occurrence of the specified
67. The string appender value is not reset unless the start button gets pressed per test suite The string appender value gets reset to its initial value each time a test suite starts running per test case The string appender value gets reset to its initial value each time a test case Starts running per test step The string appender value gets reset to its initial value each time a test step starts running 2 3 4 SEQUENCE SUBSTITUTION VARIABLES Sequence substitution variables supply a value and get incremented each time they are used The first value supplied is the initial value defined within the substitution variable dialog The number to be used for incrementing the variable is defined in the dialog as well column Increment By The value of a sequence variable is reset to its initial value each time the start button gets pressed It can also be reset during test execution depending on the value chosen in the column titled Reset The following table explains in detail the behavior of the distinct values Page 23 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Reset Value Description none The sequence value is not reset unless the start button gets pressed per test suite The sequence value gets reset to its initial value each time a test suite starts running per test case The sequence value gets reset to its initial value each time a test case starts running per test s
68. a result back then the publisher waits the time specified after having received that result Use HTTP Basic Indicates whether the web service operation invocation uses HTTP basic Authentication authentication Username Username to be used for authentication This value is used only in case the Use Authentication checkbox is selected Password User password to be used for authentication This value is used only in case the Use Authentication checkbox is selected SSL Client Certificate Defines an X 509 client certificate s to whom the client should trust while connecting to the web service endpoint over a secure socket layer A certificate also known as a public key certificate is a digitally signed statement from one entity person company etc saying that the public key and some other information of another entity has some specific value When data is digitally signed the signature can be verified to check the data integrity and authenticity Use Cached If this checkbox is selected you must choose a truststore from the project Truststore specific cache Prior to be able to use cached truststore they must be defined in the dialog that pops up when you activate the a button If this checkbox is not selected the ay button lets you choose an existing truststore from the file system This file is referenced externally and is never copied to the project directory Message Table Size The maximum number of messages that are co
69. ain part of XML formatted data The commands tell the program from where to read the XML content and how to extract the relevant part Commands are separated by the pipe character and each command hands over its result to be taken as the source by the following command The table below lists available commands Command Description file lt location gt references an XML file that gets read from the file system http lt location gt references an XML file that gets read over HTTP xpath lt XPath gt reads the value at the referenced XPath location This command expects an XML formatted string as input and has to be preceded by file lt location gt http lt location gt or another xpath lt XPath gt The value entry must start with a command to be interpreted as a command or a sequence of commands It cannot just include it somewhere Example The following example shows how to extract a derived substitution value from an XML formatted structure that is itself nested inside an XML file present on the local file system The XML file represents a Tibco Rendezvous message with XML payload created through Opensphere lt xml version 1 0 encoding ISO0O 8859 1 gt ee Generated by Opensphere Release 1 3 0 Tuesday 2005 05 28 08 39 30 gt lt msgArray gt lt xMsg replyEnabled true forwardEnabled false gt lt msg sendSubject _ replySubject gt lt msgField name ID type I16 id 0 gt 10
70. alue is contained somewhere in the message If this is not the case the message gets discarded and the user won t see it at all Regular Expression If this check box is selected Opensphere checks if the string representation of the entire message matches the specified filter criteria Inverse The application of the message filter can be inversed by selecting this check box Defining a message filter does not reduce network traffic since message filtering is done client side in the message consumer Filtering voluminous messages slows down the receiving program that has to check for the occurrence the match of the specified value within the whole message Message filtering is not available if the destination type QUEUE is set copyright centeractive ag User Manual Opensphere Release 2 5 Description Terminate after The selected check box together with the number in the behind located text field tells the subscriber to stop after the specified number of messages have been received and processed In case the trailing check box Exceeding message generates error is selected the subscriber however does not stop immediately when the specified number of messages is received It only stops when an additional message is detected or if the idle timeout is reached An additional message in this case generates an error To get a subscriber checking that no message is sent on a certain subject for example you wou
71. ame gt lt firstname gt Jaquline lt firstname gt lt address gt lt street gt Gartenstrasse 15 lt street lt ZIP gt 3008 lt JZIP gt lt city gt Bern lt jcity gt lt Jaddress gt lt Jemployee gt lt jemployees gt employees employee 1j address 1 city 1 text Value Path Function Expected Value employees employee 1 name 1 text0 equal to v employees employee 1 name 1 text0 employees employee 1 firstname 1 text0 S lequalto sw employees employee 1 firstname 1 text0 employees employee 1 address 1 street 1 text jE equalto employees employee 1 address 1 street 1 text0 employees employee 1 address 1 city 1 textQ leqalto l employees employee 1 address 1 city 1 text0 Comparison rules define what value certain elements from an actual XML structure should contain to be considered correct values To be able to successfully locate XML nodes they must be uniquely identified by an XPath expression that is either generated by the editor or edited by the user Each comparison rule by default contains two XPath expressions one for identifying the node to be checked actual value the other one for identifying the node that holds the expected value located in the reference document The expected value may alternatively be specified by a literal instead of an XPath expression When creating a new comparison rule
72. anged data from the database and compares it to the expected data read from the XML file The result gets reported in detail 6 2 TEST STRUCTURE A test structure is composed by Test suites me test cases OF and all kind of test steps the test suite being the top most node containing a user defined number of test cases which in turn contain a set of test steps Test suites and test cases can be enabled or disabled by simply clicking on the green or gray ball that appears in front of the node icon Newly created test nodes are enabled by default copyright centeractive ag Page 136 of 156 User Manual Opensphere Release 2 5 If you run a test suite only its enabled test cases get performed If you want to run a series of test suites Opensphere let you only select enabled test suites se hy Test Suite Fa ei No response from vendor von Start r gri Queries Producer oa a Vendor1 Peen Answears consumer a a Check empty answear gin niiina query no code and answer from 1 vendor a We o T oo t hl on us ae answer from 2 vendors fH A new test suite is created through the menu item Project gt Add Test Suite or by pressing on the corresponding button ap on the main tool bar When the test suite node gets added to the project structure tree it lets you define its name and description in a pop up dialog Single test cases are then added by selecting Add Test Case from the pop up menu that appears when right clicking
73. aphical configurable test flow each Comparison rules can be defined for entire messages through simple mouse clicks this also includes nested XML structures In Page 3 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 case of special needs experts get full control over generated XPath expressions and can even extend the powerful comparison rules generated by default 1 1 2 2 AUTOMATED REGRESSION TESTING Supporting a proven testing methodology Opensphere lets you build sets of regression tests adjusted to your project specific requirements Once the tests are built they can be run at any time yielding immediate and detailed reports of the test results This automated regression testing approach strongly improves the reliability of integration solutions It is a key enabler for enterprises to adapt their systems to changing requirements on time and to budget 1 1 3 TIBCO INTEGRATION Opensphere enables you to simply create edit change save and record Tibco Rendezvous and Tibco EMS messages Dedicated project tree nodes allow sending and receiving messages upon simple mouse click Subscriber or consumer nodes can automatically reply to the received messages by sending predefined messages whereas other dynamic nodes act as powerful application simulators Creating RV EMS Publisher and Subscriber JMS Message Producer and Consumer Webservice Client and Server components within Opensphere doesn t
74. as the RV Publisher also let you edit Rendezvous messages directly within their property dialog The message list editor lets you display and modify existing messages but it also offers the possibility to create messages from scratch A message can be read from a file and saved back either to the application specific XML format rvm or as rvscript rvs To save a message as rvscript select the menu item File gt Save As rvscript Each Rendezvous message has exactly one send subject and may have a reply subject While the send subject can be edited directly within the message table appearing on top of the dialog both subjects can be edited also within the detail view that gets displayed as soon as the message root node gets selected The message root node detail view contains also an area where the text representation of the entire message appears copyright centeractive ag Page 90 of 156 User Manual Opensphere Release 2 5 E Messages Fie Edit wiew Search Tool ane EX HAD Ah AHR Send Subject opensphere test person create opensphere test person create opensphere test person create opensphere test person create opensphere test person create opensphere test person create opensphere test person create Bo ipi Pg A Xd Send Subject opensphere test person create con Title Content a Name Person Title Mr Names Dufour Firstname Philipe Bithdate wed Mar 17 00 00 00 GMT 1971 Addr
75. ates whether the test result should be shown within a popping up browser window as soon as the Page 141 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 testing process has finished The possible values are true or false false being the default value failOnError Indicates if the osTest task shall fail in case an unexpected error occurs while processing one of the specified Opensphere project files The possible values are true or false false being the default value If an unexpected error occurs for every specified project the osTest task fails regardless the value of this attribute rvRoot Defines the root folder of TIBCO Rendezvous yes for RV product Do not change if RV_ROOT environmental variable is set emsRoot Defines the root folder of TIBCO EMS product Do yes for EMS not change if EMS_ROOT environmental variable is set The following listing presents a sample build xml encompassing all of the aforementioned configuration options lt project name Opensphere Batch Test default runOSTest gt lt property environment env gt lt description gt This Ant build file runs Opensphere tests defined in different project files publishes the testing result to a web server and notifies dedicated people about the newly available testing results lt description gt KARR RRR RRR RRR RNR RRR ARRIBA O KPa wynn ny y y ny y y n n
76. bar and removed by clicking on the icon When a bookmark is set it follows each line change thus it stays bound to the right element Bookmarks are not persistent and will therefore disappear when a document is reloaded from the file system 3 1 2 CUSTOMIZING There exists a convenient feature for application wide customizing of XML elements Select the menu item Tool gt Configure XML Nodes in order to get the corresponding definition XML node definition dialog displayed XML Node Definition Element Name Attribute Additional Attribute The dialog contains a pre configured entries used by Opensphere removing or changing them may have an impact on XML comparison results Feel free however to add new definitions in order to obtain a custom view of your XML documents and to optimize the result when comparing your XML documents To change the icon of a node definition click on the corresponding cell and simply choose an icon from the pop up dialog Icons that appear in the dialog are grouped by categories Each category corresponds to a direct dependent sub directory of the folder resources xmlNodelcons contained fil a amp in the Opensphere home directory To make your own icons available in the icon chooser copy them to one of the existing sub folders or create new ones that reflect the topic category t Ha El 3 P cp ci of the icons Since the images are loaded at application start up y
77. be defined in a separate dialog by pressing the Define button In that dialog you can either define an SQL query on a database of your choice or you can define your own static table data that will be stored to an XML file If you define a row set based on an SQL select statement the statement gets executed every time the Web Service Client is started When you decide to define static data Opensphere lets you do that from scratch but it also offers the possibility to import the data from a database In both cases you can alter the data immediately or at any time later to make it fit your needs When after defining a new static row set you close the Row Set Editor by pressing the OK button Opensphere may ask you to save the row set data to an XML file of your choice Opensphere can also be told to decide by its own where to store the XML file This can be achieved by selecting the option Automatically define name and location of messaging component files on the File panel within the tool options dialog select Tool gt Tool Options from the main menu When this option is selected and the static row set data was never saved to a file you will see File not yet defined right to the Define button That s there because Opensphere will not automatically assign a file name and save the data to it until the property dialog gets closed through the OK button Please consult the chapter 3 5 Row Set Editor
78. be sent until the process is stopped by external intervention If this check box is unchecked Number of Iterations setting determines how many operations invocations are sent This field is visible only if the operation invocation trigger selection is Iterator Counter Counter This line shows what kind of data row set is used to control the message sending process Row sets are tabular data that can be defined in a separate dialog by pressing the Define button In that dialog you can either define an SQL query on a database of your choice or you can define your own static table data that will be stored to an XML file If you define a row set based on an SQL select statement the statement gets executed every time the Web Service Client is started When you decide to define static data Opensphere lets you do that from scratch but it also offers the possibility to import the data from a database In both cases you can alter the data immediately or at any time later to make it fit your needs When after defining a new static row set you close the Row Set Editor by pressing the OK button Opensphere may ask you to save the row set data to an XML file of your choice Opensphere can also be told to decide by its own where to store the XML file This can be achieved by selecting the option Automatically define name and location of messaging component files on the File panel within the tool options dialog select Tool g
79. bose comparison is requested Document driven If a document is displayed in Comparison Rule View but it does not have any comparison rule defined the comparison is driven by this document reference copyright centeractive ag Page 38 of 156 comparison User Manual Opensphere Release 2 5 document It is considered to contain the expected data The comparison engine passes through the XML structure of the reference document and does the following for every single element or 4 3 Locate the corresponding element from the checked document appearing in the right part of the editor To do so it generates an XPath expression from the reference element Print an error in case the element in the checked document cannot be found This prints for example person 1 name 1 not found Compare the text values of both elements Print the result in case the values are not identical Optionally print a message in case verbose comparison is requested Once the whole reference document has been traversed and the corresponding option see below is selected the comparison engine passes through the checked document and does the following for every single element 6 Locate the corresponding element from the reference document again using XPath Print an error in case the element in the reference document cannot be found This prints for example person 1 haircolor 1 not expected The following comparison
80. cated within the directory lt USER_HOME gt opensphere projects samples and contain a detailed description that appears when the projects is loaded 7 2 TIBCO RENDEZVOUS XML FORMAT The document below shows a simple Tibco Rendezvous custom message that has been created from scratch within the RV Message Editor prior to be saved to the XML file lt xml version 1 0 encoding UTF 8 gt Generated by Opensphere Release 1 4 0 Tuesday 2005 08 04 21 21 50 gt lt os msgArray xmlns os http www centeractive com namespaces opensphere gt lt os xMsg gt lt rvMsg sendSubject opensphere test person create replySubject gt lt rvMsgFieldGroup name Person id 0 gt lt rvMsgField name Title id 0 type STRING gt lt CDATA Mr gt lt rvMsgField gt lt rvMsgField name Name id 0 type STRING gt lt CDATA Dufour gt lt rvMsgField gt lt rvMsgField name Firstname id 0 type STRING gt lt CDATA Philipe gt lt rvMsgField gt lt rvMsgField name Birthdate id 0 type DATETIME gt 17 03 1971 00 00 00 lt rvMsgField gt lt rvMsgFieldGroup name Address id 0 gt lt rvMsgField name Street id 0 type STRING gt lt CDATA Rue de la Gare gt lt rvMsgField gt lt rvMsgField name Housenumber id 0 type STRING gt lt CDATA 26 gt lt rvMsgField gt lt rvMsgField name ZIP Code id 0 type STRING gt lt CDATA 1010 gt lt rvMsgField gt lt
81. ce its reset method is invoked instead per test case Each time a test case starts running a new Java bean gets instantiated If the Java bean however implements the ResetableBean interface its reset method is invoked instead copyright centeractive ag Page 26 of 156 User Manual Opensphere Release 2 5 per test step Each time a test step starts running a new Java bean gets instantiated If the Java bean however implements the ResetableBean interface its reset method is invoked instead In the Java runtime environment you can find Java bean like classes with methods that can be used as data source for this type of substitution variables Below you find a few examples of method signatures that may help you solve a specific problem java lang Random nextInt java lang StringBuffer append jJava util concurrent atomic AtomicLong getAndIncrement 2 3 7 STATIC METHOD SUBSTITUTION VARIABLES The value of the static method substitution variable is obtained by invoking a static method that does either not expect any argument or expect a single string argument When specifying a static method it needs to be fully qualified by its class name the method name a pair of parenthesis and optionally the string argument The string argument must be enclosed in double quotes except if null for a null reference is explicitly specified In case you write your own class that provides a static method for this type of sub
82. ce Client JMS E Web Service Server H SQL Query Viewer SQL Processor User Manual Opensphere Release 2 5 Description The RV Application Simulator node is an extension of the RV Subscriber node and is useful where a dummy implementation of Rendezvous components such as adapters is needed to be able to test dependent programs The nodes property dialog contains a mapper where the fields of the hypothetical inbound message can individually be assigned to fields of one or several outbound messages with different structure each During program execution the values of those fields are automatically copied from the source inbound message to the target field and those dynamically built messages are replayed or forwarded on the defined subject The JMS Message Producer allows you to send JMS messages and provides support for both the point to point and the publish subscribe domains You can import modify or create the message to be sent define the number of iterations and the interval to be observed between The JMS Message Consumer allows you to receive JMS messages and provides support for both the point to point and the publish subscribe domains The JMS Queue Browser acts as the JMS Message Consumer but is restricted to Queue and allow you to download all messages currently in the specified Queue without removing them This node is responsible for invoking sends SOAP messages over HTTP to invoke operations on remote w
83. ch View Tool Window anels CXAG a eF B2 BOR sloyees Ea E employees xml a Bt lt xml version 1 0 encoding UTF 8 gt a Bt lt xml version 1 0 encoding UTF 8 gt E yoy lt l Created by Opensphere 2 5 0 on the Saturday 2012 0 E by lt Created by Opensphere 2 5 0 on the Saturday 2012 06 employees lt employee gt employees lt employee gt lt name gt Colombo lt name gt 4 employee lt name gt Colombo lt name gt lt firstname gt Benjamin lt firstname gt employee lt firstname gt Benjamim lt firstname gt lt address gt n lt address gt zstreet gt Rue de la Gare lt street gt lt ZIP gt 1001 lt ZIP gt lt ZIP gt 1001 lt ZIP gt lt city gt Lausanne lt fcity gt lt city gt Lausanne lt Jcity gt lt faddress gt lt faddress gt lt femployee gt lt femployee gt lt employee gt lt employee gt lt name gt Bernasconi lt name gt lt name gt Bernasconi lt name gt lt firstname gt Jaquline lt firstname gt lt firstname gt Jaquline lt firstname gt lt address gt lt address gt lt street gt Gartenstrasse 15 lt street gt lt street gt Gartenstrasse 15a lt street gt lt ZIP gt 3008 lt ZIP lt ZIP gt 3008 lt ZIP lt city gt Bern lt jcity gt lt city gt Bern lt jcity gt lt faddress gt lt Jaddress gt lt femployee gt lt femployee gt lt jemployees gt lt jemployees gt 4 m employees e
84. checkbox defines what Tibco Rendezvous transport shall be used for this component If the checkbox is selected the Tibco Rendezvous transport defined in the project properties dialog is used If the checkbox is not selected the transport parameters defined on the RV Publisher properties dialog are used Network Tibco Rendezvous network Daemon Tibco Rendezvous daemon Protocol Determines the quality of delivery of Rendezvous messages Available protocols are Reliable Delivery and Certified Delivery If Certified Delivery is selected the Advanced button at the dialogues bottom gets activated it offers additional configuration of the certified delivery transport Page 97 of 156 copyright centeractive ag Option Send Type Time out Message Sending Trigger Number of Iterations Infinite Row Set User Manual Opensphere Release 2 5 Description Messages can be published or sent as a request If a request is sent and the reply subject of the predefined message s is an inbox the program listens on messages sent to that inbox It blocks until a message is received or until the defined time out is reached An inbox is specified and automatically created by selecting the check box located beside the reply subject field If the send type is Request Reply and the message reply subject is empty the message is simply published Time in seconds to wait for a reply message when a reques
85. cific comparison rules can be defined inside the message node detail view The compare icon and the way it gets activated is the same described for tree nodes Message Document Edito C Users Urs opensp nsphere projects samples Rendezvous ref 1Person_ref rvm File Edit Search View Tool Window Dabba tEX M dA DPW AA BHR R 1Person_ref rvm R 1Person rvm Send Subject 1 opensphere test person create Send Subject opensphere test person create Person Title Mr Name Dufour Firstname Philipe Herol Birthdate Wed Mar 17 00 00 00 CET 1971 _ Housenumber _ ZIP Code av FXXK Expected Value User Message Nested XML Person Name Person Name l sendsubject sendSubject EEE 4 2 4 3 NESTED XML CONTENT RULES Some message nodes can contain XML formatted content Opensphere lets you define comparison rules for single XML element within such custom defined message payload Go through the following steps to create comparison rules for nested XML content 1 First define a comparison rule for the message node that contains the XML payload 2 Select the Nested XML check box within the comparison rule table 3 Define any XML element you want to add a comparison rule for copyright centeractive ag Page 54 of 156 User Manual Opensphere Release 2 5 S Message Document Editor C Users Urs opensphere projects samples Rendezvous ref 1Person_ref rvm Fil
86. coding W Default Character Set 8859 1 Service 7600 Network Daemon top 7600 Subjects Senarated by semicolon _RV gt _RVFT gt Message Filter messages must contain this sting Z Regular Expression Inverse Optional Filter Name If the entered subject is able to detect Rendezvous host status info advisory messages the Message Detector automatically creates two additional tabbed panels that will contain a row for every detected host and service as follows Host Status Info Total Each row contains a snapshot of the value from the last detected host status info advisory message for a given host and service The Statistic values within each snapshot are cumulative since the daemon began communicating on the service Host Status Info Per Minute The statistical values from each row are calculated using the last two detected host status info advisory message for a given host and service The amount corresponds to the value increase over a period of one minute 4 6 6 1 1 ADVANCED Activate the Advanced button to define optional settings for Tibco Rendezvous listeners Custom Editors In the top area of the panel you can define a number of custom editors for specific Rendezvous field data Those editors get used when Rendezvous messages will be edited in the message editor dialog copyright centeractive ag Page 118 of 156 User Manual Opensphere Release 2 5 centeractive Simply press t
87. comment and will not be loaded Any previous loaded data will be removed and the table structure will correspond to the data retrieved from the CSV file Be aware that the loaded data will have to be stored into an XML file in order to be available for comparison 5 4 4 COMPARISON RESULT When the SQL comparison is run the result with detected differences is reported to a dedicated message pane within the test result pane of the enclosing test case The following example shows such a result report Start comparing SQL select result with reference data row 3 FIRSTNAME row 5 FIRSTNAME row 9 FIRSTNAME comparison failed To get well formatted and detailed information of a single row within a dedicated dialog simply click on it The whole formatted report can be displayed by right clicking inside the message pane and choosing the item View gt Text Pane from the pop up menu It could look like shown below Start comparing SQL select result with reference data row 3 FIRSTNAME copyright centeractive ag Page 130 of 156 User Manual Opensphere Release 2 5 centeractive expected lt Gr goire gt but was lt Gregoire gt row 5 FIRSTNAME expected lt Henricson gt but was lt Henrichson gt row 9 FIRSTNAME expected lt Bernasconi gt but was lt Bernaconi gt comparison failed 6 TEST ENGINE 6 1 TESTING USE CASES This section illustrates the basic concept applied when testing diffe
88. compare function is applied on every single field You can choose between the following compare functions String comparison is done lexicographically and based on the 127Unicode value of each character in the strings Function Description greater or equal The checked value must be greater or equal to the corresponding reference to value empty The checked value must be empty the value of the corresponding reference value is not considered not empty The checked value must not be empty the value of the corresponding reference value is not considered length The length of the checked value must be identical to the number specified in the corresponding reference value contains The checked value must contain the corresponding reference value is contained in The checked value must be contained in the corresponding reference value starts with The checked value must start with the corresponding reference value Page 127 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 ends with The checked value must end with the corresponding reference value matches The checked value must match the regular expression specified in the corresponding reference value 5 4 2 SQL QUERY The actual data to be checked is retrieved from a database at runtime using a single SQL select statement entered on the Data panel If you select the SQL Query data type on the Reference Data panel a corresponding
89. contained in files have an application specific XML format Opensphere however first deducts the message type from the file extension Therefore it is important not to change the extension of message files Current known message types and their corresponding file extensions are listed below Page 47 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Message Type File Extension JMS Message jms Tibco Rendezvous Message rvm Web Service Message can contain wso and wsr When loading messages from a file the editor detects the message type from the file extension When creating a new message from scratch within a dialog that does S choose Message Type not contain any message yet you have first to select the message CO Rendezvous Message p WebService Message SOAP over HTTP type from the dialog shown beside The message types appearing _ Webservice Message SOAP over JMS within the dialog depend on the modules currently activated installed in Opensphere The message list editor can only contain messages of one type at the same time The message list editor contains a menu and a tool bar that contain generic items valid for all message types but also specific items that are shown only when editing a certain message type The generic items appearing in the menu and or on the tool bar are listed in the following table Button Description Open File Opens a file that c
90. create Person Name Cretegny Firstname Pascal Christia 2012 06 08 10 59 15 730 lopensphere test person create advisory STRING 13 a person has been created 2012 06 08 10 59 15824 jopensphere test person create Person Hennings Firstname Christopher Birthda N112 N6 NR 10 59 15 274 lanensnhere test nerson create adwisnrw IISTRING 14 a nerson has heen rreated Hire Date Sat Apr 01 00 00 00 CEST 2000 I Job Senior Consultant Company IBM Hire Date Sat Apr 01 00 00 00 CEST 2000 Job Desc Senior Consultant Company IBM Hire Date Sat Apr 01 00 00 00 CEST 2000 v p ob History ecee s8558 Field Group Direct Dependants When the Message Detector is started as standalone application the details of the selected message are displayed at the bottom of the view as shown in the figure above The message detail view can be hidden or displayed again using the Fg button 4 6 2 DESTINATION SUMMARY VIEW Each different destination subject topic or queue received by the program at runtime appears on the Destination Summary View in its own row together with a counter that reflects the number of messages totally received on that destination An additional column shows the message buffer size and the number of messages that are currently present in the buffer The current buffer fill
91. d page to define advanced options for Tibco Rendezvous Custom Editors In the top area of the panel you can define a number of custom editors for specific rendezvous field data Those editors get used when Tibco Rendezvous messages will be edited in the message editor dialog Simply press the add button and define what custom editor to use for what kind of field data Every definition must specify the editor class together with one or several field identifiers such as name ID or data type Opensphere always uses the editor where the most field identifiers match copyright centeractive ag Page 18 of 156 e User Manual Opensphere Release 2 5 centeractive Option Description Field Name Name of the Rendezvous message field Field ID ID of the Rendezvous message field Data Type Data type of the Rendezvous message field Editor Class Name The full name of a class that extends the editor class com centeractive opensphere msg JCustomDataEditor This abstract class has the following methods that are invoked by Opensphere to set Rendezvous field data and to determine whether this data is editable In case it is editable Opensphere makes sure the edited value gets written back to the corresponding Rendezvous message field public boolean isEditable This method indicates whether the field data is editable If this method returns true the method getData has to be overwritten to return the data contained in the editor p
92. d and adapted to the needs of the user Direct dependent nodes of the project node can be folders or test suites folder nodes may contain other folders or any Page 13 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 kind of executable node test suites contain 1 to n test cases Dependent nodes may themselves contain a certain number of dependents When a new node is added as a dependent of an existing node its property dialog is shown and lets you configure the component This property dialog can be shown again at any time by right clicking the node and choosing Properties from the popped up menu or by double clicking a selected node Most property dialogs are non modal to allow you to compare and copy the settings between different modes copyright centeractive ag Page 14 of 156 User Manual Opensphere Release 2 5 2 OPENSPHERE PROJECTS To take full advantage of the comprehensive functionality of the application you will have to work within a project An Opensphere project is a freely composed hierarchical tree structure containing group nodes and atomic nodes leafs that offer specific functionality each Meanwhile a folder node simply provides a view on console windows of dependent executable nodes multiple document interface a simulator node for example is fully configurable and acts like an independent server program 2 1 PROJECT STRUCTURE 2 1 1 FILE SYSTEM
93. d be generated if using request reply send type and no corresponding reply message is received within the defined timeout period An error will be generated only in case the reply subject is an inbox however The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Select this check box if you want the RV Publisher to write received reply messages to a file specified in the below located text field This feature is available only in case that the send type is Request Reply If Certified Delivery protocol is selected within the Communication box on the RV Publisher properties dialog the Advanced button gets activated and lets you display a dialog for configuring that protocol in detail Page 99 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Advanced Rendezvous Options Certified Delivery Transport CM Name _ Synchronize Ledger Request Old The advanced options for the certified delivery protocol are explained in the following table Description Name of the persistent correspondent If the CM Name is not set Tibco Rendezvous generates a unique non reusable name for the certified delivery transport A correspondent can persist beyond transport destruction only when it has BOTH a reusable name AND a file based ledger Ledger Name Name of the fi
94. d to the table within the comparison rule panel If you click on the enabled icon again the message rules get removed from the table The sequence of the comparison rules within the table can be altered through the up and down buttons When comparison is done the comparison rules are processed in the same sequence as they are present in the table the top most gets processed first Page 51 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive S Message Document Editor C Users Urs opensphere projects samples Rendezvous ref 1Person_ref rvm File Edit Search View Tool Window 7 Qew FtBRXKd DPN AA BBB R K 1Person_ref rvm isl 1Person rvm Send Subject 1 Opensphere test person create 2 S x kyl RV Message 6 G Person i DJ Tite Name Firstname LI LJ if _ Birthdate Fy E Address _ Street Housenumber _ ZIP Code _ Location Function Expected Value Person Name ppequlto v ETS Message File ref 1Person_ref rvm Comparison rules define what value certain elements from an actual messag should contain to be considered correct values To be able to successfully locate XML nodes they must be uniquely identified by an XPath expression that is either generated by the editor or edited by the user Each comparison rule by default contains two XPath expressions one for identifying the node
95. degree is represented by a yellow bar that turns more and more into red as the fill grade approaches the buffer limit The overall message buffer size can be changed by selecting the appropriate entry from the combo box located top right in the tool bar To change this value however message detecting must not be running The buffer size of single message summary rows may be changed by right clicking the corresponding row and selecting the menu item Change Buffer Size from the pop up menu this can be done while message detecting is running copyright centeractive ag Page 110 of 156 User Manual Opensphere Release 2 5 centeractive tor 7600 tcp 760 pary aly jg Message Sequence Host Status Info Total x Subject Summary Send Subject 1212da84 70c7 403e 8b 16 0 19862e77e73 30cb8afa 5e64 4943 a9 15 ba90a03c50e7 407350 2c 3d07 45ed afc3 df5 1ac043f75 47 1f6ff5 3e35 4a3b 90cc 6a276e465ee 1 48f43303 8927 407d 9 1fc F77d96cf00F5S 8ecc110 58c4 4f07 9c3e fcbcbbe38729 5b08c92f f8e5 4050 8ef2 b59 106a6698F 63798aa 1 8ce3 40fe aab7 bd6d36882e0b 8380 2e0e 705e 47c7 a7f2 84a26c5e5e4d 88 1068 1a 9212 4aaa Se78 9 9eb940ee43 945a0565 cc62 42e9 afSe 0bae634358a0 RV INFO SYSTEM HOST STATUS COA80141 RV INFO SYSTEM LISTEN START gt be0d09cc 7b29 41a4 8c04 b736311eec94 095d4d7 3329 4bcd b8F7 b6bb77cde863 8ba42e6 8280 4bed Saf3 6f95 14683538 146c62 b711 437f 9d6d
96. di backup When a new project is defined in the project property dialog a project folder m export J e file system within a directory you are free to choose The name of the project di pub B ay Pergee osp Opensphere uses by default for exporting node definitions publishing test suite folder named Welcome for the sample beside is automatically created on the folder is identically with the project name that was defined in the dialog The project folder initially contains the project file and some reserved folders results dynamically generating files and storing backup files of the project The project structure on the file system usually will grow as new nodes are added to the project Opensphere project files have the extension osp and contain the XML formatted definition of the project made through the graphical user interface Resources such as Tibco Rendezvous messages that can be defined in the property dialogs of specific program tree nodes are not stored within the project file itself The resources are saved as independent files i e extension rvm for Tibco Rendezvous message files and the project file will get that file path written to it This path is a relative reference to the project folder in case the resource file is underneath that folder or it is an absolute path in case the resource file is stored somewhere else outside the project file structure An overview of all file resources referenced used by the differe
97. disables message swapping if the dialog would also get closed through the OK button Maximum File Size The maximum size in kilobytes for message event swapping files Each time the size of the current file is exceeded a new file is created and gets the following message events written to it Since the message events stored in swapping files are most often aimed to be reloaded into the Message Detector program the file size should be chosen carefully The current buffer size defined in the GUI may prevent you from loading all message events contained in such a file Write all messages If this radio box is selected all detected message events that appear in the table of the corresponding tab will also be written to the swapping directory Write exceeding If this radio box is selected message events are written to the file system messages only only in case they get discarded from the table of the corresponding tab upon buffer overflow 4 6 6 PERSISTENT LISTENER DEFINITIONS Ep When the message detecting process is not running you can open a dialog that lets you define persistent listener definitions Simply add new listener definition by activating the SP button located top right on the dialog If the dialog gets closed through the OK button the current selected definition is copied to the Message Detector and determines how to detect and handle new messages 4 6 6 1 RV LISTENER When launching the Message Det
98. e Test Result EL Rendezvous start comparing messages compare defined only o Nested XML Comparison E amp Simple Communication 1 message will be compared to 1 reference message we Create Person Publisher i a Oene Penan Adr message number 1 is not correct Document XMLData nested XML content gg All Message Subscriber person name 1 text E Request Reply expected lt lt name gt MUller lt name gt gt but was lt Muller gt B Message Filtering ad Person Data Publisher 1 incorrect message found totally joi we Person Data Subscriber E Substitution 9 oh Message Comparisons Ha Q Full Msg Comparison aQ amp Q substitution cok gf Start R9 Another Publisher Name Execution Status Execution Start Execution End Duration PE RY Stbeotber BY Nested XML Compar Terminated with error 18 05 2012 11 36 09 18 05 2012 11 38 10 sec i Msg Compare iy RV Communication H Nested XML Comparison Terminated with error 18 05 2012 11 38 09 18 05 2012 11 38 10 1sec H Q Inbox Q No message allowed i QJ Max msg check 4 QJ Substitution a gt E x P amp E Subjects opensphere gt Summary Buffer Size 10 Send Subject Msg Count Buffer re test person create 1 re test person create advisory U RV Communication J Message Comparisons No message allowed 3 Tibco Rendezvous The Opensphere application
99. e Edit Search View Tool Window centeractive Qe tBXKdA DPN AA BOB R 1Person_ref rvm 1Person rvm opensphere test person create tg tz 2 S x ERa exala zje kyl RV Message yB Fi gt z9 lt xml version 1 0 encoding UTF 8 gt lt employee gt zname gt Colombo lt name gt lt firstname gt Benjamin lt firstname gt lt address gt street gt Rue de la Gare lt street gt lt ZIP gt 1001 lt ZIP gt lt city gt Lausanne lt jcity gt lt jaddress gt lt jemployee gt lt employee gt lt name gt Bernasconi lt name gt lt firstname gt Jaquline lt firstname gt employees employee 1 name 1 text Expected Value peequalto S sth Function Expected Value femployees ployee 1 name 1 text0 S CTE MS employees employee 1 name 1 text S amp S S lt l Created by Opensphere 2 5 0 on the Saturday 2012 06 09 17 30 04 gt lt employees gt User Message aa ad y Message File ref 1Person_ref rvm 4 2 5 COMPARISON PROCESS As soon as the multi message document editor contains exactly two message list editors and if one of them is in view mode Show Comparison Rules the Start Comparison button k gets enabled 4 2 5 1 COMPARISON OPTIONS When the message comparison can be started the Show Comparison Options button is also enabled The comparison options dialog lets you define the way how comparison should be done and
100. e compared message but not in the reference message are ignored Compare defined only Only message fields explicitly defined for comparison are considered A message field is defined when the check box Check on its node detail view is selected The message structure beside the defined fields is not considered Compare all but defined All message fields not explicitly defined for comparison are considered inverse comparison copyright centeractive ag Page 150 of 156 User Manual Opensphere Release 2 5 Other Options Excluded Paths Comma separated list of XPath expressions that identify elements branches that must entirely be excluded when comparison is done Comparison is done on the XML representation of individual messages Therefore for being able to define valid XPath expressions one has to know about the XML representation of messages Useful expressions for Tibco Rendezvous messages for example would be rvMsgFieldGroup name prefixList or rvwMsgFieldGroup name tracking Excluded paths are considered only in case the comparison mode is Compare all for equality 6 5 17 FILE COMPARISON This test step compares the content of two distinct files that must be specified within the property dialog shown below Depending on the selected file content type the dialog has a different look S Properties File Compare l Name File Compare File Content CSV
101. e gt i e bck 20040728 162613 employees rvm Indicates that text data contained in message components has to be put within CDATA sections when a message is transformed to XML If this radio box is selected and some text data contains itself a character sequence that terminates the CDATA section gt all special character get escaped and the data is not set within a CDATA section copyright centeractive ag Page 8 of 156 Option Use escape characters when storing text data User Manual Opensphere Release 2 5 e centeractive Description Specifies that text data contained in message components get all special characters escaped when a message is transformed to XML Select the GUI panel for defining options related to the behavior and appearance of the graphical user interface Message Editor Hide comparison rule panel by default XML Editor Hide attribute panel by default XML Editor Hide comparison rule panel by default Worker Panel Keep message detector tab always in front CONSOLE Description Determines whether the comparison rule panel in the message list editor shall be shown or hidden by default when switching to comparison rule editing menu item View gt Show Comparison Rules If this check box is selected the user is still enabled to show the comparison rule panel at any time by simply activating the related toggle button He on the editor tool bar Indicates whether the a
102. e ratin g syste m The C projects acd003 bin runExport bat command output is reported to the test step console at run time It may 5 r Successful Result Codes comma separated list of numbers be used as simple information as does 0 the simple command defined in the property dialog at the right it may on the other hand perform some processing that is required by further executed test steps On the dialog you can specify the result codes that indicate successful script execution Individual codes need to be separated by a comma each The test case will be interrupted and be considered as failed in case the actual script return code is not contained in this field The output on the console window of a simple dir command could look like follows Such output may be used to check if certain file has been written to a given folder for example To be able to react on the information it would be advisable to add a Check Confirm test step after such an OS Command test step Time Text 2012 06 09 12 34 47 process starts 2012 06 09 12 34 47 command cmd exe C dir 2012 06 09 12 34 48 Volume in drive C has no label 2012 06 09 12 34 48 Volume Serial Number is E663 B1D7 2012 06 09 12 34 48 2012 06 09 12 34 48 Directory of C workspaces open sphere open sphere 2012 06 09 12 34 48 2012 06 09 12 34 48 08 06 2012 17 12 lt DIR gt 2012 06 09 12 34 48 08 06 2012 17 12 lt DIR gt ee 2012 06 09 12 34 48
103. e test step property dialog shown beside Cancel 6 5 2 CHECK CONFIRM The Check Confirm test step interrupts the S properties New Confirm Task process flow during some manual intervention Name New Confirm Task When this test step is triggered started it Notification shows a modal dialog with the message that Please check whether the ActiveMQ has previously been defined in the property server is currently up and running dialog The message may tell the user to just check something to prepare some resources or what ever is needed to successfully run the test case The process flow continues as soon as the 7 S Confirmer Message Comparisons Full Msg Comparison New Contfir mE dialog is closed Processing may be stopped if the user detects an error Please check whether the ActiveMQ i server is currently up and running during his intervention In that case he will have to enter the reason that made C Operation Failed him abort the test execution this text will e Continue be reported in the result pane of the test SH n case copyright centeractive ag Page 146 of 156 a i g User Manual Opensphere Release 2 5 centeracti 6 5 3 OS COMMAND The OS Command test step lets you SS OS Command Definition define an operating system command that would otherwise be executed in a hat i ithi Shell Command cmd command window or within a console e of the op
104. e them 7 The RV Application Simulator simulates an application that is supposed to respond to requests In our case it receives the request message from My Program dynamically writes specific data into a predefined acknowledge message and sends it back on the reply subject It may also forward dynamically build messages to another involved program The RV Application Simulator writes all received Tibco Rendezvous messages to an XML file 8 The expected messages get compared to the messages that were received by the RV Application Simulator The Message Comparator component goes through the predefined comparison rules and reports the detailed result 6 1 2 JMS TOPIC TESTING The next use case illustrates how Opensphere components interact with a custom program using JMS topics i e with TIBCO Enterprise Message Service in order to test its functionality 7 a TIBCO EMS Page 133 of 156 copyright centeractive ag The EMS Topic Message Detector records messages with a well defined topic 2 The Message List Editor is invoked directly from the EMS Topic Message Detector It lets you edit the recorded messages and make them look like messages you expect My Program to produce 3 The triggering message that gets feed into the JMS Message Producer can be created the same way 4 The XML file is loaded into the JMS Message Producer and the contained messages are published on the predefined topic recursively as long
105. e through the export button Ei located in the main toolbar or through the corresponding menu item from the specific pop up menu It may then be re imported to a folder or a test case regardless whether it was exported from an executable node or a test step 4 5 4 RV APPLICATION SIMULATOR Ta The RV Application Simulator extends the RV Subscriber program It is extremely useful where an intermediate implementation of Tibco Rendezvous enabled components such as an adapter is needed It lets you test modules that depend on other components in case they are not yet ready The Reply Forward Messages panel of the simulator property dialog shown below contains a mapper To switch from the standard message editing to the mapping view you have to press the mapping view button 2 located in the toolbar Press this button again to switch back to standard message edit mode The top located message within the message table is the Source Message Template SMT a message that holds the structure of the expected incoming messages All other messages in the array are messages that can be used to be replied or forwarded to whatever subject you want such messages may have been recorded previously using the RV Message Detector or created manually through the Message List Editor The fields of the expected inbound message SMT can be assigned to fields of one or several outbound messages with individual structure each During program execution
106. e xmins add http address jaxrpc samples xmlns lt soapeny Header lt soapeny Body gt add updateaddress gt lt l type string streets lt street gt E updateAddress H 0 ind l type int H ini postcode gt lt postcode gt sinl gt lt jinl gt lt fadd updateaddress gt lt fsoapenv Body gt lt fsoapenv Envelope gt Message File AWS WS_Client 1 wsm The following figure shows an operation invocation result that s being edited inside a standalone message list editor The message is displayed using the Show Comparison Rules mode and can be saved to an XML file in order to be used as a reference message in a comparing component Page 61 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive File Edit View Search Tool ape X KH 4 DD dh Ga fl Context Path AddressSoapBinding updateAddress RESPONSE axis services Address amp i 2 S m x RaGSB laexXa 6 a e z gt Aaa updateAddress RESPONSE k lt soapenv Envelope xmins soapeny http schemas xmlsoap org soap envelope xmins adc O EELEE pallida bhi BA P i daii A lt soapeny Body gt lt add updateAddressResponse gt lt re return gt success lt jreturn gt lt jfadd updateAddressResponse gt Poeran Body gt Value Path Expected Value User Message Envelope Body 1 updateAddressR 3 ESTE aan JEnvelope Body 1 updateAddressR av aS Value
107. eb services The component gets generated from a WSDL file the user has to choose Available operations can be selected to create operation invocations with user defined arguments The client is easily configurable and able to invoke different operations with different arguments to repeat invocations to store the responses etc This node is similar to the above described Web Service Client HTTP except that it uses JMS as the communication transport This program node simulates a web server that offers a set of web services that are dynamically added or removed New service implementations are generated from a WSDL file chosen by the user For each operation the response can be freely defined and altered at any time The SQL Query Viewer executes a user defined SQL select statement on any JDBC compatible database and shows the result in a table The SQL Processor is used to perform SQL DDL and DML statements on any JDBC compatible database The status of executable nodes within the project tree is shown by a small icon that gets applied on top of the regular node icon The following status icons can appear 2 Initializing initialized EE running E terminated with error af successfully performed Page 21 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 22 3 TEST SUITE ub The folder like test suite node is used to logically group series of test cases and run them in the desired order
108. eck whether an element is empty or not The Comparison Rule View is different from the default view also in the way that it shows the comparison icon in front of each structure tree node The icon may be enabled or disabled in order to indicate whether a comparison rule is currently defined for the corresponding node Comparison rules can be created or removed by simply clicking on the icon Alternatively you can create or alter comparison rules directly within the bottom located rule table Such user defined rules however will not be reflected by an enabled icon within the structure tree unless they use exactly the same XPath expression as if they were created by Opensphere copyright centeractive ag Page 34 of 156 User Manual Opensphere Release 2 5 centeractive SS XML Editor C workspaces open sphere open sphere src main external etc runtime projects OS Demo ref 2emplovees xml File Edit Search View Tool Window 5G OB FeCRaA Gt S E 2employees xmi employees xml z my mA lt xml version 1 0 encoding UTF 8 gt kbp Mo lt l Created by Opensphere 2 5 0 on the Saturday 2012 06 09 17 30 04 gt lt employees gt employees lt employee gt zname gt Colombo lt name gt lt firstname gt Benjamin lt firstname gt lt address gt lt ZIP gt 1001 lt ZIP gt lt city gt Lausanne lt city gt lt Jaddress gt lt Jemployee gt lt employee gt lt name gt Bernasconi lt jn
109. ector in Tibco Rendezvous mode the listener definition dialog lets you define listeners with different Rendezvous transports Rendezvous string encoding as well as one or several subjects to listen on The Rendezvous listener definition dialog gets invokes through the EP button In case you enter more than one subject they must be separated by a semicolon each In the Message Filter field at the bottom of the dialog you can define filter criteria When you choose a message listener with a non empty message filter the program automatically creates a tabbed message filter panel on the Message Detector When a new message gets detected the program checks the filter value against the whole message send and reply subject and message content Messages will be added to the tabbed filter panel only in case they match the defined filter criteria Page 117 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Defining a message filter does not reduce network traffic since message filtering is done by the message consumer Filtering voluminous messages slows down the receiving program that has to check for the occurrence of the specified value within the whole message Rendezvous Listener Definitions Transport Encoding Subjects Development RY 7600 top 7600 8859 1 _RV gt _RVFT gt Development HAWK 7474 tep 7474 3359_1 HAWK gt Name Development RY Rendezvous Transport Rendezvous String En
110. em Test Step Description _ Acts as entry point for the test case process flow Every test case has exactly one start state shape that is direct or indirect source of all connections Sleeper Sleeps the specified number of seconds and interrupts the processing of the test case within the branch where it is located in the process flow chart Check Confirm Interrupts the process flow during a manual intervention The process flow continues as soon as the dialog is closed Processing may be stopped if the user detects and notifies an error a OS Command Wraps the executable node of same name Start State 7 RV Publisher Wraps the executable node of same name Wraps the executable node of same name Wraps the executable node of same name Wraps the executable node of same name Wraps the executable node of same name F JMS Queue Browser Wraps the executable node of same name Web Service Client Wraps the executable node of same name Web Service Server Wraps the executable node of same name SQL Processor Wraps the executable node of same name ae SOL Compatizen Compares the results from two SQL select statements The result is reported to the result tab of the test case detail view ES Message Comparison Compares messages contained in two distinct files and reports the result to the result tab of the test case detail view l File Comparison Compares the content of two distinct files and reports the result to the result
111. epresent column names from the local row set the remaining ones are defined for the entire project 3 5 1 SQL QUERY The SQL Query appears if you select the appropriate named radio button top left of the editor dialog You have to define a database connection and a single select statement that will retrieve the data result set at runtime Already defined database connections can be changed at any time S Row Set Definition Exa Data Type SQL Query Static Data JDBC Driver Definition MySQL New Database URL jdbc mysql localhost employees User test01 Password eeccce Plain Text Attributes Single SQL SELECT statement select name firstname hire date department from person The SQL editor offers basic syntax highlighting and allows to write comment either as line comment with leading double slashes line comment or as block comment that is delimited by a couple of a slash and a star block comment The syntactical correctness of the entered SELECT statements is checked when the Check button is pressed If the used JDBC driver supports pre compilation the check method will send the statement to the database for pre compilation Some drivers do not support pre compilation In this case the statement will not be sent to the database until it is executed and only the starting key word is then checked Page 43 of 156 copyright centeractive ag User Manual Opensphere Release 2 5
112. er tabs see figure below you ll find a button that lets you open the message swap options dialog La Message Sequence Ca Filter x Time Target Destinatic 2009 10 19 11 06 27 437 003 10 19 11 06 29 359 0093 10 19 11 06 29 437 opensphere test p opensphere defaL opensphere test g The button appears with a different icon depending whether message event swapping for that specific tab is currently defined or not Icon Description Liz Message swapping for this tab is currently not enabled not defined Message swapping for this tab is currently enabled If you click the button the Swap Options dialog below appears and lets you either remove the existing configuration or define a new one Swap Options Message Sequence Message Event Swapping Target Directory Maximum File Size 10000 KByte Write all messages Write exceeding messges only buffer overflow copyright centeractive ag Page 116 of 156 User Manual Opensphere Release 2 5 The different controls on the dialog are explained in the following table Control Description Target Directory The directory where message events shall be written to Message swapping is enabled as soon as this field contains a valid directory name The button opens a dialog where you can browse the file system and select an existing target directory The button removes the current entry from the target directory field and thereby
113. erate an error Abort after The selected check box together with the specified number of seconds indicates that the process has to stop after the specified time of inactivity The time of inactivity is the time elapsed since the last incoming message has been processed The trailing check box Generates error indicates if an error must be generated in case the defined idle time is exceeded without having received a message Message Table Size The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Write incoming Select this check box if you want the subscriber to write inbound messages to messages to file a file specified in the below located text field If Certified Delivery protocol is selected within the Communication box on the RV Subscriber properties dialog the Advanced button gets activated and lets you display a dialog for configuring that protocol in detail S Advanced Rendezvous Options Certified Delivery Transport CM Name Ledger Name Synchronize Ledger Request Old The advanced options for the certified delivery protocol are explained in the following table Description CM Name Name of the persistent correspondent If the CM Name is not set Tibco Rendezvous generates a unique non reusable name for the certified delivery transport A correspondent can persist beyond transport destruct
114. ering the tree node that represents XML element within structure tree Either the Icon or the Attribute must be defined 3 1 2 1 EXAMPLE The example in this section illustrates how the Opensphere Release 1 2 0 default XML node definitions shown in the table below affects the appearance of an XML document in the structure tree view of the XML Editor The node definitions are the following Element Hame Attribute Additional Attribute meq Our example XML document represents a Tibco Rendezvous message created through Opensphere The figure below shows a portion of that document as formatted text tan version 1 0 encoding UTF 8 gt gl Generated by OpenSphere Enterprise Release 1 2 0 7 2004 06 29 17 21 29 smaga sh1sg rep E nabled true forvandE nabled falze mg sendSubject opensphere default subject replys ubject megField name pirat type 116 id 0 gt 10 lt msgField magField name ver type 116 id 0 gt 302 magField magField name type type 116 id 0 1 lt magField meqField name encoding type 116 id 0 24 magField megField name prefisList type MSG id 0 Page 33 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 The result of the rather simple node definitions is the surprisingly more readable XML structure tree shown below Without XML node definitions With default XML node definiti
115. ess lad Firstname Street Fiue de la Gare Housenumber 26 ZIP Code 1010 Location Lausanne State YO Country Switzerland a E Birthdate ob History Job Desc Senior Consultant Company IBM Hire Date 5at Apr 01 00 00 00 BST 2000 Job 1 L E Add Desc Consuktant Company Opentrend GmbH Hire Date FriJan 01 00 00 00 GMT 1999 Job Desc Business e Analist Company Microsoft Hire Date Wed Jul 01 00 00 00 BST 1998 Job Desc Programmer Comparny Microsoft 7 o i Hire Date Tue Feb 01 00 00 00 GMT 1994 pia OUSENUMBer com ZIP Code ee Location aiiis O Gtate bats O Country H 0 Job History Message Direct Dependants Message File 0 47 emp Ferson rem Non root nodes are either message fields or message field groups represented either by a sheet or a folder The detail view of message field groups is similar to the root node you can choose between the two views The Field Group view however does not contain fields for editing subjects but others that let you edit their name and identity In both the root node and the message group detail view you can switch to the table view by selecting the bottom located Direct Dependents labeled tab This is useful for getting a quick overview of all direct dependent nodes The table view is an explorer like representation of the selected tree node If the top level message node or a sub message is selected the detail view sh
116. ework does not only reuse proven components it also provides comprehensive support in multiple domains e Project specific test configuration and structuring e Test suites e Graphical test case editor e Graphical comparison rule editor e Message reporting publishing and comparing for WebService JMS and Tibco Rendezvous e Comparing of XML structures applying user configured comparison rules e Comparing of data retrieved from databases e Automatic reporting publishing of testing results e Running tests in batch mode through Apache Ant The result of an integration test is often limited to a statement reflecting its success and it hopefully provides some information on the source component and the data that got produced Within an systems integration environment a business process may fail due to an unavailable system an incompatible interface some version mismatch etc If a test fails we need more information than just above mentioned items we are also interested in intermediate data messages being exchanged system availability and further details that will help us to quickly locate the source of a potential problem And of course we also need detailed information about the cause of an error Opensphere enables you to build tests that generate such detailed reports that you will be able to quickly find most errors The application contains a test engine driven by user defined test suites that contain a number of test cases with a gr
117. exported from an executable node or a test step By selecting the menu item Save as rvscript from the nodes pop up menu the publisher is saved as rvscript to a file defined by the user This ready to use script can be run unchanged or adapted to your needs Below listing shows an rvscript generated from a simple Rendezvous Generic Publisher node copyright centeractive ag Page 100 of 156 User Manual Opensphere Release 2 5 4 5 3 RV SUBSCRIBER This node subscribes to a Tibco Rendezvous subject or a subject hierarchy and receives corresponding messages to which it is able to reply with predefined messages Depending on the user settings it buffers inbound messages and or displays their content in a message dialog The subscriber replies to received messages by sending one or several reply messages either as a bunch or sequentially Single messages or message collections can be imported freely edited and saved to a file using the message editor present in the option dialog An RV Subscriber can be used for the following tasks e Simulate a simple Rendezvous enabled application e Simulate an adapter including its automatic and condition depending shut down e Reply to incoming messages and help debug or test a new program e Record a predefined number of messages and save them to an XML file for further use in other programs or scripts o etc 4 5 3 1 SUBSCRIBER OPTIONS A subscriber is easy configurable throu
118. fail To get more detailed output select this check box Excluded Paths Comma separated list of XPath expressions that identify elements paths that must entirely be excluded when comparison is done Comparison is done on the XML representation of individual messages Therefore for being able to define valid XPath expressions one has to know about the XML representation of messages Useful expressions for Tibco Rendezvous messages for example would be rwMsgFieldGroup name prefixList or rvwMsgFieldGroup name tracking Excluded paths are considered only for comparison mode Compare all for equality copyright centeractive ag Page 56 of 156 User Manual Opensphere Release 2 5 centeractive 4 2 5 2 RUNNING THE COMPARISON If the Start Comparison button gets pressed a new work panel gets added to the bottom of the frame it will show the result as comparison goes on The two internal message list editors get arranged side by side the one that contains the reference messages comparison rules gets placed to the left Message Document Editor C Users Urs opensphere projects samples Rendezvous ref 1Person_ref rwm File Edit Search View Tool Window DaB FBEX Kd DH RA ELER a opensphere test person create EE S JeaBnraldiexasl ale a kyl RV Message XK my mh lt employee gt 0 O a 72 2 lt name gt Colombo lt name gt G ci aos firstname 7 lt firstname gt Benjami
119. from the popup menu of the project node Substitution Variables Variable Prefix Postfix ca 7 x Name Type Initial Value Class Name Method Signature Script etc Increment By Reset Sequence UUID Static Method __ java util UUID randomUUIDQ serverURL String tcp localhost 7222 topic String topic sample now Static Method com centeractive opensphere substitution inbuilt CurrentDateFormatter format yyyy MM dd hh mm ss sss i random Java Bean M java util Random snextintQ none user Static Method java lang System getProperty user name TE ox canei You may define as many substitution variables as you like simply click the add JP button then enter the variable name and choose its type in the dialog shown above The value of most substitution variables can be edited directly in the table row as soon as the dialog gets closed Some types of substitution variables i e JavaScript let you define the value in a specific editor dialog The copyright centeractive ag Page 22 of 156 User Manual Opensphere Release 2 5 substitution variable value can be used in many places within the project for replacing substitution variable markers strings that corresponds to the variable name enclosed by the specified prefix and postfix Given the example substitution variable definition from the dialog shown above the substitution variable
120. g Page 48 of 156 e User Manual Opensphere Release 2 5 centeractive Button Description show Comparison Switches the message list editor to the comparison rule mode Rules Opens the search dialog shown below and lets the user define and perform a search for data present inside the message contained in the message editor Text to find Options Match Case Search from start To move single rows within the message table to a new position or to remove waddRow them from there right click the corresponding row header and select one of the See Copy Row menu items contained in the pop up menu The same menu items are also f Remove Row available in the Edit menu A Move Up F Move Down Page 49 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 4 2 2 MULTI MESSAGE DOCUMENT EDITOR The multi message document editor gets invoked through the menu item Message gt Multi Message Doc Editor It contains a number of message list editors that are added dynamically Each internal message list editor may contain messages of the same or of a different type depending on the user s choice The multi message document editor lets you arrange the contained message list editors in several ways Either you prefer them appearing within a tabbed pane or you may want to see them as internal frames that can be tiled according to your choice Message Docume
121. g above mentioned JMSAdmin interface The javadoc for the JMSAdmin interface can be found in the appendix at the end of this document the binary code is contained in the openSphere nn jar that is located in the folder lt OPENSPHERE HOME gt 1ib copyright centeractive ag Page 12 of 156 1 1 6 6 DATABASE JDBC The Database JDBC panel lets you define options related to database connections please consult the section Database Support 1 1 6 7 STARTUP Here you can specify whether at program startup you want to be notified when a new version of Opensphere is ready for download 1 2 GETTING STARTED To work with Opensphere you must first create a project by choosing the menu item File gt New Project Within the displayed project options dialog you have to enter a project name and a working directory Optionally you can define project default settings for Tibco Rendezvous The entered options can be changed later on Project Properties General ee WSDL Cache Project Name MyProject gt SSL Keystore Cache Tibco Project Directory C Users Office opensphere projects MyProject When the dialog is closed through the OK button the project node appears in the project browser ready to get dependent nodes created underneath Such nodes are added using the Project menu within the main menu or by right clicking on the project node and choosing the appropriate add item The project structure can freely be compose
122. g will be active only when the message detecting process gets started next time by using the regular Start button E Disable Auto Refresh This button disables automatic refreshing of the displayed messages l chow Predefined Shows a dialog that lets you predefine message listeners by editing their Listener Definitions transport and destinations subjects These definitions are made persistent by the application fe Show Current Displays a dialog where the user can define the settings of the current Connection Definition used connection or transport for detecting new messages The settings can be changed only if message detecting is not running Restarting the message detecting process with changed settings does not automatically remove previous detected messages from the message tables copyright centeractive ag Page 112 of 156 3 User Manual Opensphere Release 2 5 centeractive Button Description Show Message Selector Dialog JMS Message Selector IMSCorrelationID user0024 Displays a dialog where the user can define a message selector when working with JMS listeners The message selector can only be edited if the JMS listeners defined on the message detector are not running The message selector field is available for JMS message listeners only it lets you define SQL like criteria that reduce the set of received messages please consult standard JMS documentation Defining message selectors prevents the J
123. ge Editor or by pressing the toolbar button showing the icon i The editor is basically divided into two parts the message list appearing on its top and the message view that on its bottom that shows the details of the message currently selected in the list The message view shows the message structure as a tree and lets you select single nodes The message dependent details of the selected tree node get displayed right to the tree Some tree nodes contain read only information some others are editable Some data may be edited directly within the message list table or within the message structure tree this is dependent on the message type however S Message Editor x File Edit View Search Tool aB xX K D A dh Sn Bw Size Byte opensphere test person create opensphere test person create lopensphere test person create 313 lopensphere test person create 219 lopensphere test person create in Go hm 2 S x vl RV Message Type STRING Person 0 Firstname Value Birthdate Dufour 9 Address _ Street Housenumber ZIP Code _ Location State Country C3 Job History Field XML Message File Simple_Communication 5Persons rvm When working with the message list editor you start creating new messages by activating the Add button or you load one or several messages from a file Open File button 5 Messages
124. ge Table Size Write incoming reply messages to file Web Service Client options are defined on the first tab within the dialog the detailed description is explained in the following table Option Description Name The name that appears in the project tree together with the node representing the web service client serverURL The URL of the JMS server i e tcp localhost 7222 userName The user name in case an identification is required userPassword The password in case an identification is required Destination Type Lets you choose between the destination type Queue or Topic Page 71 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Description Destination The name of the destination either a topic or a queue Opensphere lets you discover destinations through the search button located right to the destination field This is a feature that requires a JMS connection with administrator privileges If you have such a user temporary specify the corresponding connection discover and select your destination Don t forget to specify a non administrator connection for further use To know about valid destinations for Tibco EMS for example you may also open the EMS Administration Tool and connect to the JMS provider specified by hostname and port You could for example type connect tcp localhost 7222 Once the connection is established enter the command show queues o
125. ge result panel can also be shown as plain structured text by right clicking inside the table and choosing View gt Text Pane from the popup menu Page 57 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 The following figure shows an example of a comparison result in the text pane view The comparison was done in verbose mode see property dialog start comparing messages compare all for equality excluded tree paths are 4prefixList tracking excluded XPath s are msg msgField name prefixList msg msgField name tracking 1 message will be compared to 1 reference message message number 1 is not correct msg text is excluded from comparison msg Person text is excluded from comparison msg Person Title text is fine msg Person Name text is fine msg Person Firstname text is fine msg Person Birthdate text is fine msg Person Address text is excluded from comparison msg Person Address Street text is fine msg Person Address Housenumber text is fine msg Person Address ZIP Code text is fine msg Person Address Location text is fine msg Person Address State text is fine msg Person Address Country text is fine msg Person Job History text is excluded from comparison msg Person Job History Job text is excluded from comparison msg Person Job History Job Desc text is fine msg Person Job History Job Company text is fine msg Person Job History Job Hire Date text is fine msg
126. ged when no main function is defined data java lang StringBuilder fileReader new java io FileReader readme txt bufReader new java io BufferedReader fileReader while line bufReader readLine null data append line n bufReader close return data toString Page 25 of 156 copyright centeractive ag 2 38 1 REQUESTING USER INPUT The JavaScript substitution variable can also be used to request user input at runtime whenever the value of a particular substitution variable is requested To do so you can use standard Java Swing components The following one line code sample illustrates how to request the user name keep this line unchanged when no main function is defined return javax swing JOptionPane showlnputDialog Please enter the user name Each time the value of such a substitution variable is requested the following dialog will appear and the value entered by the user becomes the actual value of the substitution variable 2 3 6 JAVA BEAN METHOD SUBSTITUTION VARIABLES The value of the Java bean method substitution variable is obtained by invoking a method from a Java bean This method does either not expect any argument or expect a single string argument When specifying a method it needs to be fully qualified by its class name the method name a pair of parenthesis and optionally the string argument The string argument must be enclosed in double quo
127. gh the option dialog shown below The dialog is split into two panels that can be selected through the tabs Definition and Reply Forward Messages Page 101 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive E Properties RV Subscriber Definition Reply Forward Messages Name RY Subscriber Rendezvous Transport Use Project Settings Service Network Daemon Communication and Filtering Listen on Subject Protocol Reliable Delivery w Time out ol ms between messages Regular Expression Inverse Message Filter messages must contain this shing d p L Program Termination L Terminate after messages Exceeding message generates error Abort after seconds idle time Generates Error Message Retention Message Table Size Write incoming messages to file Le EEE Advanced copyright centeractive ag Page 102 of 156 User Manual Opensphere Release 2 5 centeractive RV Subscriber Eg Definition Reply Forward Messages Reply Forward all defined messages together aR X MHdDP HW dh ho BB Send Subject Reply Forward Size Byte test person create tf te na Ga x Ryl RY Message Mame Housenumber En ID o Type 5TRING i C Title EA Mame aan Firstname Birthdate B 03 Address e m Street Housenumber oom ZIP Code san ha Location ar B State a O Country 5 Job History Field
128. he add button and define what custom editor to use for what kind of field data Every definition must specify the editor class together with one or several field identifiers such as name ID or data type Opensphere always uses the editor where the most field identifiers match Option Description Field Name Name of the Rendezvous message field Field ID ID of the Rendezvous message field Data Type Data type of the Rendezvous message field Editor Class Name The full name of a class that extends the editor class com centeractive opensphere msg JCustomDataEditor This abstract class has the following methods that are invoked by Opensphere to set Rendezvous field data and to determine whether this data is editable In case it is editable Opensphere makes sure the edited value gets written back to the corresponding Rendezvous message field public boolean isEditable This method indicates whether the field data is editable If this method returns true the method getData has to be overwritten to return the data contained in the editor public Object getData This method returns the data contained in the editor This method gets invoked by Opensphere only in case the method isEditable returns true abstract public void setData Object data This method sets the data to be contained in the editor This method gets invoked by Opensphere each time the Rendezvous field node gets selected in the message editor User Data Type Handler
129. he time the server gets latest definition of the web service implementation If this check box is not started selected you have to manually deploy new and changed web service implementations through the server node popup menu Once you have defined the server options you have to define the operation response messages This is done on the second tab within the server property dialog Either you import an existing definition by opening an XML file file extension wsm or you press the SF button that lets you select a WSDL definition from the project specific WSDL file cache and then choose available operation responses from the dialog shown below The dialog lets you also select a set of self explanatory options that determine how the program initially generates the SOAP content of the response messages If you want to choose operation responses from a different WSDL file simply click the button labeled Switch WSDL and make your choice copyright centeractive ag Page 64 of 156 i User Manual Opensphere Release 2 5 centeractive Options Build Headers Indude Optional Elements Add Sample Values Skip Comment Add Type Comment Switch WSDL Operation Type WSSampleServiceSoapBinding login RESPONSE WSSampleServiceSoapBinding searchltem RESPONSE Within the Web Service properties dialog every defined operation response message is represented by a row on the top located table while its details are shown in the bottom
130. he JMS Message Consumer Properties JMS Message Consumer all Definition Reply Messages Mame JMS Message Consumer all Connection C Use INDI JMS Provider EMS w Server Url tcp ilocalhosk 7222 Destination Type QUEUE lt User Mame admin User Password Destination queue sample Communication Timeout ms between messages Message Selector and Filter Message Selector Message Filter messages must contain this string _ Requiar Expression _ Inverse Program Termination Terminate after message s Exceeding message generates error Abord after seconds idle time Generates Error fonly if above specified number of messqes is not reached Message Retention Message Table Size Write incoming messages to file ed JMS Message Consumer options are defined on the first tab within the dialog their signification is explained in the following table Option Description Name The name that appears in the project tree together with the node representing the Message Consumer serverURL The URL of the JMS server i e tcp localhost 7222 userName The user name in case an identification is required userPassword The password in case an identification is required Destination Type Let s you choose between the destination type Queue or Topic copyright centeractive ag Page 86 of 156 Destination Message Selector Message Filter Page 87 of 156 e Use
131. he built in XML editor Only Serializable Java objects can be used copyright centeractive ag Page 80 of 156 User Manual Opensphere Release 2 5 centeractive E Messages Fie Edit wiew Search Tool anm EX MII WH dh Sh Object Message Baw ee BeXIBRabBB aeXRE a Bz 9 B Message I Oy ah lt Tamil version 1 0 encoding UTF 3 gt Body Object a a i YF a e BA object class avar swing Button E object void method addActionListener gt object class java beans E yventH andler method create gt class gt java awt event ActionListener class object tdref myController gt lt shing dolts fstring gt lt r object roide java beans MLI k F Plain Text KIL 4 4 2 JMS MESSAGE PRODUCER af The JMS Message Producer allows you to send JMS messages and provides support for both the point to point and the publish subscribe domains You can import modify or create the messages to be sent define the number of iterations and the interval to be observed between The messages to be published can contain markers that are replaced by the value of project dependent substitution variables Markers can also be replaced by the corresponding data of a single row when the driving component for sending messages is a row set Row sets can be defined as static data within an editor but they can also be the result of an SQL select statement that gets executed each time the JMS Message Producer gets
132. he current row can be used as string type substitution values in the messages of that one iteration To make the substitution happen you simply place the column name enclosed by the appropriate pre and postfix wherever you wish within your message same as you do with ordinary substitution values see 2 3 Substitution Variables This field is visible only if the message sending trigger selection is Data Row Set Interval Sets the time in milliseconds the publisher should wait between messages Generates error when This checkbox is enabled only if the selected communication type is no reply Request If the checkbox is selected Opensphere generates an error considers the program run as failed Message Table Size The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Write incoming reply Select this check box if you want the JMS Message Producer to write message to file incoming reply messages to a file specified in the below located text field copyright centeractive ag Page 84 of 156 User Manual Opensphere Release 2 5 K centeractive The second tab appearing on the dialog lets you define the message or messages to be produced E Properties JMS Message Producer Message Producer Messages apt t RR HAP H AHM Message ID Destination Text Message Tz Tz F aa x Name Value FS hM5 Message Persistant
133. heck box together with the number in the behind located text field tells the server to stop after the specified number of operation invocations have been accepted and processed In case the trailing check box Exceeding generates error is selected the server however does not stop immediately when the specified number of operation invocations has occurred It only stops when an additional operation invocation is detected or if the idle timeout is reached An additional operation invocation in this case generates an error In order to get a server checking that no operation invocations is made on a certain web service for example you would have to specify O operation invocation s and to select the check box Exceeding generates error As soon as it detects an operation invocation it would then generate an error Page 63 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Description Abort after The selected check box together with the specified number of seconds indicates that the process has to stop after the specified time of inactivity The time of inactivity is the time elapsed since the last operation invocation has been processed The trailing check box Generates error indicates if an error must be generated in case the defined idle time is exceeded without having detected any operation invocation SSL Client Certificate Defines an X 509 client certificate to run the web service endpo
134. her are copied unchanged to the publishing location You may for example adapt the background color of the HTML frame page or change the banner to better reflect the project you are working in If you edit or replace the corresponding files please make first a copy of them to be able to restore the initial environment Page 145 of 156 copyright centeractive ag 6 4 1 2 TEST RESULT WEB SERVER A simple JSP based web application for showing published test results is shipped with Opensphere and available as web archive under resources webserver testreporting war This web archive can for example be copied to the webapps folder of a Tomcat application running on a server The testing results on the other hand must be published to the results folder within the unpacked web application same as Opensphere does it when running in batch mode with the sample Ant build file as described in the chapter above 6 5 TEST STEP DETAILS This section describes the details of individual test step types that are part of a test case and appear in its graphical test flow 6 5 1 SLEEPER The Sleeper test step sleeps the specified number of seconds and amp Define Sleep Time interrupts the processing of the test case within the branch a Please enter the number of seconds you would where it is located in the process flow chart like to have this process to sleep Number of Seconds The number of seconds the test step has to sleep is defined within th
135. hexadecimal editor that lets you switch between different base modes and character encoding copyright centeractive ag Page 78 of 156 User Manual Opensphere Release 2 5 centeractive E Messages File Edit wiew Search Tool ris dbb H ET BEX apa p 320 6D 65 73 73 61 67 65 73 20 6172 E o m G 6A GF 77 GE 20 61 GE 64 20 65 64 69 74 77 69 74 68 69 GE 20 74 68 65 20 62 75 20 69 GE 20 68 65 78 61 64 65 63 69 6D 65 64 69 74 GF 72 2E OVERWERITE offset 3 size 74b A dynamic table let you edit Map and Stream messages Single rows are added or removed moved to another position or altered as much you want Depending on the selected data type values are edited either directly in the table cell or within a specific editor dialog that pops up when a mouse click occurs on the cell or on the icon appearing right to it Page 79 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 E Messages Fie Edit wiew Search Tool apb EX M4 DH AS kl ap kl Btage Sip Ri BMxlit Zg av z JMS Message Type oe Body Map Integer ting String tel oolean Mame Value actonCode Coline Firstriarnie Jett signature s dA 97465 20 6D 65 73 7361 centeractive Object messages contain a JavaBeans component Opensphere uses the java beans XMLEncoder for serializing and java beans XMLDecoder for de serializing such data The data can be edited either as plain text or within t
136. hown and edited using the standalone message list editor menu item Message gt Message Editor and through the multi message document editor menu item Message gt Multi Message Doc Editor JMS specific program nodes such as the JMS Message Producer also let you edit JMS messages directly within their property dialog When adding a new message to the message list editor a Choose JMS Message Type A dialog pops up where you have to select the type of JMS message you want to add The JMS message type cannot be changed on an existing message but the message list editor can contain messages of different JMS type at the same time A Message without body does not contain a body at all and could be used for some kind of advisory A Bytes message object is used to send a message containing a stream of non interpreted bytes A Map message object is used to send a set of name value pairs An Object message object is used to send a message that contains a serializable object in the Java programming language Java object A Stream message object is used to send a stream of primitive types in the Java programming language A Text message object is used to send a message containing plain text This message type may also contain XML formatted content 4 4 1 1 JMS MESSAGE HEADER AND PROPERTIES The JMS message header contains a number of standard properties Few of them are editable within the message editor while the
137. iew for example lists all contained test cases by showing their state start and end time as well as the duration of the execution The top most entry in the list contains this same information as a summary for the whole test suite The test case detail view contains a Test Result pane which shows a list with execution information of all test steps and a top located line for the test case This looks pretty much the same as the detail view of the test suite If the test case contains one or several comparison test steps the results of them are displayed above the mentioned list The screen shot below shows a Test Result pane of a test case that contains a SQL Comparison test step Test Case Logic Test Step Console Test Result Text oa Msg Compare start comparing messages compare defined only 1 message will be compared to 1 reference message message number 1 is not correct XML reference data XML data Person Title is fine Person Name is fine Person Firstname Person Birthdate is fine Person Address Street is fine Person Address Housenumber is fine Person Address ZIP Code is fine Person Address Location is fine Person Address Country 1 incorrect message found totally Execution Status Execution Start Execution End Duration Terminated with error 09 06 2012 12 26 10 09 06 2012 12 26 11 1 sec Completed successfully 09 06 2012 12 26 10 09 06 2012 12 26 10 p sec me oma 0
138. igger selection is Iterator Counter Counter This line shows what kind of data row set is used to control the message sending process Row sets are tabular data that can be defined in a separate dialog by pressing the Define button In that dialog you can either define an SQL query on a database of your choice or you can define your own static table data that will be stored to an XML file If you define a row set based on an SQL select statement the statement gets executed every time the RV Publisher is started When you decide to define static data Opensphere lets you do that from scratch but it also offers the possibility to import the data from a database In both cases you can alter the data immediately or at any time later to make it fit your needs When after defining a new static row set you close the Row Set Editor by pressing the OK button Opensphere may ask you copyright centeractive ag Page 98 of 156 Interval Generates error Message Table Size Write incoming reply messages to file User Manual Opensphere Release 2 5 Description to save the row set data to an XML file of your choice Opensphere can also be told to decide by its own where to store the XML file This can be achieved by selecting the option Automatically define name and location of messaging component files on the File panel within the tool options dialog select Tool gt Tool Options from the main menu
139. iles contains the column Number names Lines appearing in front of this line will be ignored The first line in the file is number one If the checkbox is not selected the column names are generated by Opensphere Field Separator Indicates how single fields within the CSV files are separated This field can be left empty if the CSV files contain a single column Comment Identifier Specifies how lines with comment are marked in the CSV file If this field contains a value all lines that start with that value are considered to be comment and will not be included in the copyright centeractive ag Page 152 of 156 User Manual Opensphere Release 2 5 comparison Included Columns all All columns contained in the CSV files will be considered for comparison by name Only columns with the specified names are considered for comparison Individual column names need to be separated by a comma each by position Only columns at the specified position are considered for comparison Individual column positions need to be separated by a comma each Compare Function Defines the function to be applied when comparing individual fields The following function are available Function Description The checked value must be the same as the corresponding reference value equal to Page 153 of 156 not equal to less then greater then less or equal to greater or equal to not empty contains is contained in starts w
140. int over a secure socket layer A certificate also known as a public key certificate is a digitally signed statement from one entity person company etc saying that the public key and some other information of another entity has some specific value When data is digitally signed the signature can be verified to check the data integrity and authenticity You can run several web service servers with different keystores just bear in mind that if you specify a keystore that contains multiple X 509 certificates Opensphere randomly uses one of them Use Cached Keystore If this checkbox is selected you must choose a keystore from the project specific cache Prior to be able to use cached keystore they must be defined in the dialog that pops up when you activate the I button If this checkbox is not selected the oy button lets you choose an existing keystore from the file system This file is referenced externally and is never copied to the project directory Keystore Password The password used to access the keystore Message Table Size The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Write operation Select this check box if you want the server to write inbound messages to a invocations to file file specified in the below located text field Deploy services each Select this check box to make sure the server simulator runs always with t
141. ion only when it has BOTH a reusable name AND a file based ledger Page 105 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Description Ledger Name Name of the file based ledger If the Ledger Name is not set then the new transport stores its ledger exclusively in process based storage the correspondent is not persistent If this option specifies a valid file name Rendezvous uses that file for ledger storage If the transport is destroyed or the process terminates with incomplete certified communications the ledger file records that state When a new transport binds the same reusable name it reads the ledger file and continues certified communications from the state stored in the file Synchronize Ledger Specifies the way information must update the ledger If the check box is selected operations that update the ledger file do not return until the changes are written to the storage medium Request Old This parameter indicates whether a persistent correspondent requires delivery of messages sent to a previous CM transport with the same name for which delivery was not confirmed Its value affects the behavior of other CM sending transports 4 5 3 2 ADDITIONAL FEATURES Except the configurable behavior that is defined through the option dialog a Rendezvous Generic Subscriber offers the following features Like any other executable node or test step a subscriber node can be exported to an XML fil
142. is item gets activated only if the editor contains exactly two internal message list editor and if one of them is in view mode Show Comparison Rules Toggle Work Tab Shows or hides the work tabs that appear on the bottom of the editor Configure XML Nodes Shows a dialog where the user can define the appearance of XML nodes see Customizing 4 2 3 MESSAGE COMPARISON The multi message document editor can be used for comparing messages To do so it must contain two message list editors one that holds the reference messages and one that holds the messages to be checked 4 2 4 COMPARISON RULE EDITING Comparison rules on messages can be defined within a message list editor if its current view mode is Show Comparison Rules see menu item View gt Show Comparison Rules If you switch to this node the comparison rule panel appears at the bottom of the message list editor and comparison sensitive nodes are shown together with a disabled compare icon Message comparison rule editing is done in a similar as for XML documents the main difference is the way how paths appear in the comparison rule table Whereas XML comparison rule definition uses XPath only notation message comparison rule also uses a more readable unix like tree path notation 4 2 4 1 TREE NODE RULES A new message comparison rule is added through a click on the disabled icon located left to the tree node The icon gets then enabled and a row is adde
143. iscard it The JMS API does not define any form of notification of message expiration Clients should not receive messages that have expired however the JMS API does not guarantee that this will not happen Page 75 of 156 copyright centeractive ag Header Fields Priority Correlation ID Destination Message ID Timestamp User Manual Opensphere Release 2 5 Description The JMS API defines ten levels of priority value with O as the lowest priority and 9 as the highest In addition clients should consider priorities 0 4 as gradations of normal priority and priorities 5 9 as gradations of expedited priority The JMS API does not require that a provider strictly implement priority ordering of messages however it should do its best to deliver expedited messages ahead of normal messages A Client can use the JMSCorrelationID header field to link one message with another A typical use is to link a response message with its request message JMSCorrelationID can hold one of the following A provider specific message ID An application specific String A provider native byte value Since each message sent by a JMS provider is assigned a message ID value it is convenient to link messages via message ID All message ID values must start with the ID prefix In some cases an application made up of several clients needs to use an application specific value for linking messages For instance an application may use JMSCorre
144. ith ends with matches The checked value must not be the same as the corresponding reference value The checked value must be less then the corresponding reference value The checked value must be greater then the corresponding reference value The checked value must be less or equal to the corresponding reference value The checked value must be greater or equal to the corresponding reference value The checked value must be empty the value of the corresponding reference value is not considered The checked value must not be empty the value of the corresponding reference value is not considered The length of the checked value must be identical to the number specified in the corresponding reference value The checked value must corresponding reference value contain the The checked value must be contained in the corresponding reference value The checked value must start with the corresponding reference value The checked value must end with the corresponding reference value The checked value must match the regular expression specified in the corresponding reference value copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 7 SAMPLES 7 1 SAMPLE PROJECTS Opensphere is delivered with sample projects that illustrate how the different modules work together Most samples are kept simple and cover only the basic functionality of the application All sample projects are lo
145. ithin the project tree show their status by a small icon that gets applied on top of the regular test step icon The following status icons can appear gt initializing initialized E running E terminated with error af successfully performed On the test flow chart those icons appear as well but the status is also rendered by the color of the test step rectangles The default yellow color of test steps within the test case flow chart is changed to gray after its successful initialization A running test step has a green background meanwhile a test step that has terminated with an error gets red colored Test steps that were successfully executed return to be of yellow color 6 3 1 MONITORING During initialization and run of the tests test progress and status are reported on different levels The icon that represents a single node within the project tree changes its appearance depending whether a test item test suite test case or test step is running has successfully executed or terminated with an error A dedicated worker panel reports all status changes during the test run using colours that represent the status i e red text for errors Within the test suite detail view you can see the status of the test suite and all dependent test cases whereas the test case view presents the same information for all its test steps in a table but also in the flow chart Name Execution Status Ewecution Start Execution End Duratio
146. its default function is equals Another rule specific function can be chosen from the combo box that appears in the function table cell When comparison is done the selected function generates a default error text in case the expected value in not correct Page 35 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive The table below explains each item of a comparison rule in detail Comparison Rule Description Attribute Value Path This attribute specifies the actual value from the XML formatted data that has to be checked It must be a valid XPath expression Function This attribute specifies the function that must be applied either on the actual value only i e is empty or between the actual value and the expected value i e is greater than Available functions are the following ones equal to The actual value must be the same as the expected value not equal to The actual value must be different from the expected value less then The actual value must be lexographically smaller then the expected value The comparison is based on the Unicode value of each character in the strings greater then The actual value must be lexographically greater then the expected value The comparison is based on the Unicode value of each character in the strings less or equal to The actual value must be lexographically smaller then or equal to the expected value The comparison is based
147. lasses Such classes are the factory classes for creating connections to the related JMS server or admin classes that let you retrieve information about available destinations When adding a new JMS provider definition Opensphere automatically adds the Java archive files present in the folder lt OPENSPHERE HOME gt 1lib jmsAdmin These files contain a set of predefined admin classes for known JMS provider From the file chooser dialog that pops up you now have to select the required provider specific Java archive files Using the oF button you can add missing Java archive files at any time later or you can remove selected unnecessary ones using the X button Opensphere scans the specified Java archive files for factory classes and admin classes and provides them within the appropriate bottom located tab labeled INDI Queue Topic or Admin for further selection This panel lets you define a template for JMS connection definitions through the Java Naming and Directory Interface JNDI The Initial Context Factory combo box contains all classes found in the defined Java archive files that implement the following interface Javax aming spi InitialContekxtFactory The Available Properties list contains all available JNDI properties except the ones that are already assigned to the selected initial context factory The Selected Properties table shows the properties already assigned to the selected initial context
148. lationID to hold a value referencing some external information Application specified values must not start with the ID prefix this is reserved for provider generated message ID values Some JMS providers use a message repository that contains the definitions of messages sent by applications The JMSType header field may reference a message s definition in the provider s repository The JMS API does not define a standard message definition repository nor does it define a naming policy for the definitions it contains Some messaging systems require that a message type definition for each application message be created and that each message specify its type In order to work with such JMS providers JMS clients should assign a value to JMSType whether the application makes use of it or not This ensures that the field is properly set for those providers that require it To ensure portability JMS clients should use symbolic values for JMSType that can be configured at installation time to the values defined in the current provider s message repository If string literals are used they may not be valid type names for some JMS providers The JMSDestination header field contains the destination to which the message is being sent When a message is sent this field is ignored After completion of the send or publish method the field holds the destination specified by the method When a message is received its JMSDestination value must be equivalent to
149. ld have to specify 0 message s and to select the check box Exceeding message generates error As soon as it detects a message it would then generate an error Abort after The selected check box together with the specified number of seconds indicates that the process has to stop after the specified time of inactivity The time of inactivity is the time elapsed since the last incoming message has been processed The trailing check box Generates error indicates if an error must be generated in case the defined idle time is exceeded without having received a message Message Table Size The maximum number of messages that are contained in the message table This table appears on the Messages tab from the tree node detail view Write incoming Select this check box if you want the subscriber to write inbound messages to messages to file a file specified in the below located text field copyright centeractive ag Page 88 of 156 a User Manual Opensphere Release 2 5 centeractive 4 4 4 JMS QUEUE BROWSER F the JMS Queue Browser acts same as the JMS Message Consumer without being able to reply to messages This module lets you download messages from the specified queue without removing them The dialog below allows you to configure the JMS Message Browser E Properties JMS Queue Browser Mame JMS Queue Browser Connection Use INDI JMS Provider EMS we Server Url tcp localhost 7222 De
150. le based ledger If the Ledger Name is not set then the new transport stores its ledger exclusively in process based storage the correspondent is not persistent If this option specifies a valid file name Rendezvous uses that file for ledger storage If the transport is destroyed or the process terminates with incomplete certified communications the ledger file records that state When a new transport binds the same reusable name it reads the ledger file and continues certified communications from the state stored in the file Synchronize Ledger Specifies the way information must update the ledger If the check box is selected operations that update the ledger file do not return until the changes are written to the storage medium Request Old This parameter indicates whether a persistent correspondent requires delivery of messages sent to a previous CM transport with the same name for which delivery was not confirmed Its value affects the behavior of other CM sending transports 05 2 2 ADDITIONAL FEATURES Except the configurable behavior that is defined in the property dialog an RV Publisher offers a number of additional features Like any other executable node or test step a publisher node can be exported to an XML file through the export button Gi located in the main toolbar or through the corresponding menu item from the specific pop up menu It may then be re imported to a folder or a test case regardless whether it was
151. le node has its own console that may buffer message up to the specified size Choosing a high buffer size with lots of executable nodes may cause the application to run out of memory Background Color Determines the background color of the consoles Selection Color Determines the background color of the selected row or message Page 9 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Property Description Text Color Specifies the text color to be used for displaying messages of type Information Information Text Color Warnings Specifies the text color to be used for displaying messages of type Warning Text Color Errors Specifies the text color to be used for displaying messages of type Error Selected Text Color Determines the text color of a selected row or message Font Defines the overall font to be used in the console 1 1 6 5 JMS PROVIDER Opensphere is not shipped itself with any JMS product specific libraries The JMS Provider panel lets you define JMS providers required for using Opensphere with the JMS products of your choice The top located list on the panel contains an item for every JMS Provider defined for the current instance of Opensphere Using the right located buttons you can simply add a new JMS provider definition or you can remove the current selected one When configuring JMS providers you basically tell Opensphere where to find the Java clas
152. le received message in a chronological order the last arrived on its bottom When running the Message Detector in Tibco Rendezvous or JMS Topic mode all detected messages get displayed on the same and unique Message Sequence View to clearly show the chronologically sequence of detected messages The Destination Summary View is a condensed overview of all distinct destinations messages have been detected for When the Message Detector is run in JMS Queue mode a dedicated Message Sequence View appears for each defined JMS queue When the Message Detector is run in Tibco EMS Monitor mode two tabs named Monitor Message Sequence and Included Message Sequence are shown one beside the other The Monitor Message Sequence shows all detected monitor messages in a chronological order The Included Message Sequence shows the sequence of original messages extracted from monitor messages if there are any available All views have convenient pop up menus that appear as soon as the user right clicks on a table row Single menu items let you directly display message details save messages to a file resend a message etc 4 6 1 MESSAGE SEQUENCE VIEW This view shows every received message as a new table row New detected messages are added to the bottom of the table The table size is limited to what the user chooses from the combo box located top right on the dialog Sequence Buffer Size When a new mes
153. lished on the predefined topic recursively as long as specified 5 The program to be debugged or tested My Program maintains one or several subscriptions and receives the published messages While performing some tasks it may send reply messages but also send independent request messages that target another adapter or application 6 The JMS Message Producer reports expected reply messages or writes error messages if it does not receive them 7 The JMS Message Consumer receives the message from My Program and writes them to an XML file 8 The expected messages get compared to the messages that were received by the JMS Message Consumer The Message Comparator component goes through the predefined comparison rules and reports the detailed result Page 135 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 6 1 4 DATABASE TESTING The following scenario points out how a database enabled program could be tested in Opensphere 1 The SQL Compare component is used to load some data from a database This data can now be edit by the user to produce the expected data The so prepared data gets then saved to an XML file An SQL Processor runs some predefined SQL statements on a database My Program gets triggered by some data event occurring in the database and reacts by changing other data in the same database could also be another database 4 The SQL Compare component reads the ch
154. main unchanged there Page 111 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Button Description Stops the message detecting process It can be restarted at any time through the start button Cl Show Message Shows the most recent detected message represented by the selected row of the message summary table or the selected row from the message sequence table The message is shown within the Message List Editor Show Message Buffer Shows all currently buffered messages represented by the selected row of the message summary table or all messages from the message sequence table This messages are shown within the Message List Editor The same dialog is shown as well when double clicking the left mouse button on any table row The messages appearing in the table on top of the editor are ordered chronologically ascending the message with the highest row number being the most recent detected one Ti Enable Auto Refresh This button enables automatic S Define Interval refreshing of the displayed PENN TR messages The user has to Please enter the interval to be observed prior to automatically refresh the content of the queue s enter the number of seconds to be observed by the seconds application prior to automatically refresh the content of the message detector This button is only available in case the message detector is launched in JMS Queue mode Automatic refreshin
155. marker user would be replaced by the name of the current connected user The easiest way to enter a substitution variable marker in a text field is to click user String the right mouse button while the cursor is positioned at the desired location pa a ges subject String and then choose an entry from the substitution variable list see sample topic String shell String beside that pops up next to the mouse pointer 2 peer ke pwd JavaScript FIP JavaScript 2 3 1 STRING SUBSTITUTION VARIABLES Substitution variables by default are simple string literals that keep their value unchanged unless they are explicitly modified by the user within the dialog 2 3 2 PASSWORD SUBSTITUTION VARIABLES Password substitution variables are string literals Their real value is represented by a placeholder character in order to be hidden to non authorized people 2 3 3 STRING APPENDER SUBSTITUTION VARIABLES The string appender substitution variable can have an initial value or it can be empty at initialization Each time a substitution is made a user defined string gets appended to the previous value The value of a string appender variable is reset to its initial value each time the start button gets pressed It can also be reset during test execution depending on the value chosen in the column titled Reset The following table explains in detail the behavior of the distinct values Reset Value Description none
156. me XPath centeractive rvMsg rvMsqFieldGroup name Person rvMsgField name Name text This attribute specifies the function that must be applied either on the actual value only i e is empty or between the actual value and the expected value i e is greater then Available functions are the following ones equal to not equal to less then greater then less or equal to greater or equal to empty not empty length contains is contained in starts with ends with The actual value must be the same as the expected value The actual value must be different from the expected value The actual value must be lexographically smaller then the expected value The comparison is based on the Unicode value of each character in the strings The actual value must be lexographically greater then the expected value The comparison is based on the Unicode value of each character in the strings The actual value must be lexographically smaller then or equal to the expected value The comparison is based on the Unicode value of each character in the strings The actual value must be lexographically greater then or equal to the expected value The comparison is based on the Unicode value of each character in the strings The actual value must be empty The actual value must not be empty The length of the actual value must the one specified by the expected value The expected value must be a valid in
157. mm ss SSS nn an E jeventlRndomrertint e user_home System Prope FEVE 2 3 10 ENVIRONMENT VARIABLE SUBSTITUTION VARIABLES An environment variable substitution variable allows you to use any external environment that you may have set such as for example PATH After naming your variable you can choose from the available Environment Variables at start up from a drop down box Type Initial Value Class Name Method Signature Script etc ID Sequence 0 UUID StaticMethod _ java util UUID randomUUID serverURL String te topic String random Java Bean M java util Random nextint0 env Environment 00 02505 Se aaa Page 29 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 3 BUILT IN EDITORS 3 1 XML EDITOR Opensphere contains a highly featured multi document XML Editor that gets invoked as standalone application from the Windows start menu A single document XML editor can be shown inside Opensphere by selecting the menu item Tool gt XML Editor It also appears as inbuilt editor of other components i e inside the Tibco Rendezvous message editor enabling you to edit nested XML data The XML editor lets you create or load a single document but also multiple documents Each XML document appears within its own internal frame or as a tabbed pane depending on your choice Documents are shown in a text view with color highlighting and a
158. more detailed view of the desired time period you can zoom into the chart by simply mark the desired area with the mouse pointer Press the left mouse button and move the mouse top left to see the original chart area again By pressing the right mouse button you will see a pop up menu that lets you further customize the message chart and perform other functions like printing the chart for example Page 115 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 4 6 5 MESSAGE EVENT SWAPPING The Message Detector keeps detected messages in the buffer table up to the number defined in the combo box appearing right on the toolbar When newly added messages exceed the defined buffer size the oldest message gets discarded and cannot be retrieved anymore In order to be able to access such messages at some time later on the program lets you define a folder where it shall write such discarded message events to Optionally you can also instruct the Message Detector to write all detected message events to the file system and not only the ones that exceed the buffer size Message events are written to a file within the configured target directory up to the size defined by the user Each time the size of the message event file is reached a new one gets created The file names contain the name of the GUI tab together with the creation date in the format yyyyMMdd hhmmss In front of the message sequence and the message filt
159. mployee 1 address 1 city 1 itext Text XML reference data XML data employees employee 1 name 1 text is fine femployees employee 1 firstname 1 text employees employee 1 address 1 street 1 text is fine employees employee 1 address 1 city 1 text is fine done with errors RS XML Comparison The comparison is driven either by the comparison rules or if there are no comparison rules defined it is driven by the reference document Rule driven Every single comparison rule is evaluated and applied once starting from the comparison rule appearing in the table s first row going through the table until reaching the last row The following steps are performed for each rule 1 Locate the XML element in the left appearing reference document if the expected value is present as an XPath expression This step is omitted if the compare function does not expect a predefined expected value i e compare function not empty 2 Locate the XML element in the checked document actual data that appears in the right part of the editor 3 Check the actual value using the compare function from the rule Depending on the function it compares the value with the one extracted from the reference document but it may also be more basic such as checking the emptiness of the value 4 Print the result in case the check fails pn Optionally print a message in case ver
160. n F TS New Product Terminated with error 02 04 2003 00 13 48 02 04 2003 00 14 00 13 Sec E Create Product Terminated with error 02 04 2003 00 13 48 02 04 2003 00 14 00 13 Sac y Change Product Terminated successfully 02 04 2003 00 13 51 02 04 2003 00 13 54 2 sec Ae Delete Product Terminated successfully 02 04 2003 00 13 54 02 04 7003 00 13 55 1 sec as Check Dependen Terminated successfully 07 04 2003 00 13 56 02 04 2003 00 1 3 57 1 sec The test case detail view moreover contains a multiple document interface MDI containing the console windows of every test step that reports detailed processing information The start step does not have a console window since it acts only as entry point of the test step flow and does not do any processing itself copyright centeractive ag Page 140 of 156 User Manual Opensphere Release 2 5 centeractive Test Case Logic Test Step Console Test Result qi Check response Time Text 2012 06 09 12 23 26 read messages from file C temp SOAPoverHITP SOAP over_HTTP Test_Suite SSL responses wsm 2012 06 09 12 23 26 1 messages read 2012 06 09 12 23 26 read reference messages from file C temp SOAPoverHITP SOAP over_HTTP Test_Suite SSL WS_Server wsm 2012 06 09 12 23 26 1 reference messages read 2012 06 09 12 23 26 start comparing messages 2012 06 09 12 23 26 The message comparison was not successful Terminated with error 6 3 2 BATCH P
161. n firstname i lt address gt lt street gt Rue de la Gare lt stree _ 7ID 1NN1 7TO gn zr lagaRpaldiaexasl sale e la kvl RV Message Oy Cty lt xml version 1 0 encoding UTF 8 a Wim 4b bui BEG lt l Created by Opensphere 2 5 0 ont employees zname gt Colombo lt name gt lt firstname gt Benjamins lt firstname lt address gt lt street gt Rue de la Gare lt street lt ZIP gt 1001 lt ZIP gt city gt Lausanne lt jcity gt lt jfaddress gt lt femninver gt 4 employees employee 1 Value Path Function a xmlData Fe Jlequal to gt PETE Message File ref 1Person_ref rvm Message File ref 1Person rvm start comparing messages compare defined only 1 message will be compared to 1 reference message message number 1 is not correct xmlData nested XML content employees employee 1 firstname 1 text expected lt Benjamin gt but was lt Benjamins gt 1 incorrect message found totally ADS COMPARISON RESULT The detailed result of the message comparison is shown in a new message pane at the bottom of the comparison dialog The message pane by default shows some information about the comparison and a row for each failed comparison within a table Single rows are shown as structured text in a dedicated dialog when a mouse click occurs on them The entire messa
162. ng the Add button located top right of the Destination field Available destinations get copyright centeractive ag Page 122 of 156 User Manual Opensphere Release 2 5 shown within a pop up dialog from where they can be selected the program makes sure to generate the appropriate monitor topic If for example you choose the topic named topic test 5 the generated monitor messages would be Ssys monitor T topic test 5 Each topic in the Destination field must be separated by a semicolon Further details about monitoring topics can be found in the official EMS documentation When a new monitor definition gets added to the list a default JMS message selector appears in the corresponding field This is used for monitoring message communication and has the effect that you would see a monitor message only when a message gets posted by a producer Therefore the messages appearing on the Included Message Sequence tab would be unique You may be interested in other events as well when monitoring message communication so you have to remove the JMS message selector or adapt it to your needs Except the above described monitoring topics and the pre defined message selector the listener definition is done the same as would be a normal JMS Topic Listener ANY Listener Definition Dialog Provider Connection Development Tibco EMS serverUrl top focalhost 7222 use sys monitor Name Devel
163. no reply is expected The JMSReplyTo can be defined manually with the limitation that at runtime the entered value is always considered to be of the same type as the one from JMSDestination Therefore if a JMS Consumer tries to reply to a topic message the JMSReplyTo will be published as a topic as well The JMSReplyTo is automatically overridden if a JMS Publisher uses the communication type Request Indicates whether this message is being redelivered If a client receives a message with the JMSRedelivered field set it is likely but not guaranteed that this message was delivered earlier but that its receipt was not acknowledged at that time In addition to the header fields it is possible to define custom properties The type of properties can be boolean byte short integer long float double or String The name of properties must not be null or empty By convention e if the name of a property begins with JMSX the property is specified by JMS API like JMSXGroupID and JMSXGroupSeq to group messages and is expected to work with all provider JMS API 1 1 defines JMSXUserlD JMSXAppID JMSXDeliveryCount JMSXGroupID JMSXGroupSeq JMSXProducerTXID JMSXConsumerTXID JMSXRcvTimestamp and JMSXState See JMS API documention for more information e if the name starts with JMS vendor name the property targets the JMS provider and is specific to this provider like the property JMS _TIBCO_ COMPRESS which tells Tibco EMS to
164. nt Editor C temp samples Rendezvous Simple_Communication 5Persons vm mesm File Edit Search View Tool Window Rapt EX M140A amp hH BOB SPersons rvm RV_Subscriber rvm opens test person create O n aa 313 219 3 hore 5 lopensphere testpersoneate OOOO te fe hin BER Ke x N Address Value Address Street Rue de la Gare p Housenumber 26 amp 6 ZIP Code 1010 i Te Street Location Lausanne _ Housenumber State VD Country Switzerland Location 0 _ ZIP Code L _ State i gt f Country pa Job History Field Group Direct Dependants Most items of the menu and the tool bar appearing on the multi message document editor act on the current selected internal message list editor and have the same functionality as on the standalone message list editor Item Description Ce New Adds a new internal message list editor Shows a dialog where the user may define a few options that are considered when comparing messages This item gets activated only if the editor contains exactly two internal message list editor and if one of them is in view mode Show Comparison Rules Show Comparison Option copyright centeractive ag Page 50 of 156 e User Manual Opensphere Release 2 5 ente Description Start Comparison Starts comparing the messages currently contained in the two internal message list editors Th
165. nt components within your Opensphere project can be obtained by selecting the Resource Overview tab that appears in the detail view of the root project tree node In order to be able to easily move and or exchange entire Opensphere projects without losing any references to resources it is recommended to store all your resources underneath the owning project folder 2 1 2 PROJECT BROWSER The project structure appears as a tree within the Project Browser at the left side of the Opensphere application the top most and first appearing node being the project node The project structure is defined by the user by adding group and leaf nodes The project node itself allows you to add a restricted number of dependent node types the so called top level nodes folders and test suites Other group nodes accept dependent node types that make sense in the given context a test case node for example will only accept test step nodes Page 15 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Every node within the project tree can be exported to a file and imported to other projects or simply to another location within the same project Exported nodes are of XML format and can easily be shared with other people or archived for further use depending on your needs Beside this feature every node offers other functionality that is accessible through the application toolbar common functions only or through the pop up menu
166. ntained in the message table This table appears on the Messages tab from the tree node detail view Write operation Select this check box if you want the client to write result messages responses to file responses to a file specified in the below located text field 4 3 5 WEB SERVICE CLIENT SOAP OVER JMS G This Web Service Client uses SOAP over JMS for the communication with the remote web service When a new client is created you are asked to select a WSDL file from the WSDL file cache The Opensphere program will try to extracts the location and port of the target service from the initially selected WSDL file The property dialog of the Web Service Client lets you extensively customize its behavior within the first tab In order to complete the configuration you have to add define at least one operation invocation on the tab labeled Operation Invocations This is cone by opening an XML file file extension wsm or by by activating the SP button Latter lets you select a WSDL definition from the project specific WSDL file cache and then choose available operation invocations from the dialog shown below The dialog lets you also select a set of self explanatory options that determine how the program initially generates the SOAP content of the operation invocation messages If you want to choose operation Page 69 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive invocations from a
167. odes that can be added to a folder node Depending on how your Opensphere program was installed some of these nodes however may not be available Executable Type Description OS Command Represents an operating system command an independent program or a RV Publisher This node acts as publisher for a single or collection of distinct Tibco Rendezvous message It is easy configurable through its option dialog Depending on the user settings it re sends the message on the chosen interval The content of the published messages as well as the received replay message is be displayed in the console The message can be imported freely edited and saved to an external file using the in built tree based message editor RV Subscriber This node subscribes to a Tibco Rendezvous subject or a subject hierarchy and receives corresponding messages It is easy configurable through its option dialog Depending on the user settings it buffers inbound messages and lets them display in the message editor dialog It is also able to reply to received messages by sending one or several predefined reply and forward messages Single messages or message collection can be imported freely edited and saved to a file using the in built tree based message editor copyright centeractive ag Page 20 of 156 Executable Type ee RV Application Simulator JMS Message Producer i JMS Message Consumer ta JMS Queue Browser Web Service Client HTTP Web Servi
168. oding The character encoding used for representing the textual representation of the content can be changed at any time by selecting the appropriate value from the combo box 3 4 OBJECT FORM EDITOR This feature is in experimental mode and not yet activated The object form editor lets you edit a complex structured entity in an intuitive way Nested elements can be added or removed through a simple click on a button nested structures can be expanded and collapsed list elements moved to another position Specific field editors provide assistance to improve the edition of data of a certain type i e date time Page 41 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Bean Editor lt Enumeration Value choice 3 String 116 string data 116 Test Bean My Own String best sr Bean Array gt 0 bu vrl Date D E I L Dake Time lt Integer List 0 String 2 Load string data 2 The buttons appearing on the editor are the following Button Description Eur Add Adds a property field from the object or an element from the list x Remove Removes a property field from the object or an element from the list Se Collapses the sub structure Expands the sub structure b Tal Edit Date Time Shows an editor from where the user can easily choose the date and time for the field the editor button appears beside 3 5 ROW SET EDITOR The Row Set Editor is
169. offers a comprehensive but easy to use graphical user interface that lets you build projects with individual structure each easily configure and execute components based on copyright centeractive ag Page 2 of 156 User Manual Opensphere Release 2 5 Tibco Rendezvous JMS Apache ActiveMQ TIBCO EMS HornetQ OpenJMS SonicMQ SwiftMQ etc web services databases etc widely exchange data and run tests with complex comparison rules Opensphere makes use of XML for comparing complex data structures including nested XML to maintain the project structure single components and the application state over session boundaries Components and projects can easily be exported to XML files and shared with other team members that may import them into their projects or may use them in other tools such as rvscript The Application does not require any server installation itself but is ready to be used within a few minutes The program is based on Java and can therefore be used on most operation systems 1 1 2 TESTING Effective testing of integration solutions starts right at the beginning of integration projects The Opensphere testing framework lets you develop tests in parallel to the software engineering process and maintain them during the whole product lifecycle Reusability in software development is quite a common requirement this software applies it on test modules as well However the Opensphere automated testing fram
170. on with the XML Editor displayed is especially useful during test case set up e If the check box is not selected comparison is done automatically and the result is fully reported to the test case result pane This mode should always be used for automated regression tests The reference file is usually selected from the file system i since it is supposed to contain stable data maintained in a protected location The file name can also be imported through the text editor dialog i In some cases however it could make sense to select an entry from the combo box labeled Ref File This combo box contains the names of all files that are used in other test steps inside the same test case Page 151 of 156 copyright centeractive ag o PE User Manual Opensphere Release 2 5 centeractive Further you have to define the file containing the data that is compared with the reference data This will likely be a file that has been created by a messaging component such as the JMS Message Producer Consumer the Rendezvous Publisher Subscriber or a Web Service Client test step reply messages For this reason the combo box labeled File will already contain all names of message files defined in such test steps present in the same test case This file name can also be selected from the file system through the editor or the path can be entered manually If the content of the file or the reference file has specific character encoding the co
171. ons w msQarray Fa megAray Msg Sy uMeg S a meg 5 6 mg m megField E pint 116 E m megField a wer 116 iW megField a type 116 megField a encoding 116 fe megField al prefixList MSG W megField a tracking MSG H megField H a data MSG 3 1 3 XML COMPARISON Comparing XML structures is one of the core tasks within Opensphere Sometimes it is done behind the scenes but often it is explicitly defined and run by the user from within the XML Editor Comparisons run by the XML Editor always expect 2 loaded documents one being the reference document expected data the other one the checked document current data 3 1 3 1 COMPARISON RULE VIEW A reference document is obtained by either loading a document that was last saved being in the Comparison Rule View or by activating this view on any other document To switch to the Comparison Rule View select the menu item View gt Show Comparison Rules The view shows an additional panel on its bottom that is used for creating and maintaining comparison rules Except in full comparison mode the XML comparison engine always expects user defined rules to perform fine Such rules identify single XML elements from both documents and specify the function to be used when comparing their values Alternatively an XML element can also be compared against a literal value defined in the comparison rule or the function may simply ch
172. ontains the definition of one or several messages in the Opensphere specific XML format When a new message file is loaded into the editor that shows already one or several messages those messages are not simply replaced by the new ones Instead the user is asked how he wants the new messages to be loaded He can choose between the following options Replace current messages Append to the end of the message table Insert at the beginning of the message table Insert after the selected message Insert before the selected message Be aware that in case you press the save button or the corresponding menu item all messages are saved to the file from where the latest messages were loaded Saves the message contained in the message editor to its original file If the message was not initially loaded from a file this will save it to a new file using the appropriate file extension The file name and its location can be altered by the user Ty Save As Saves the message contained in the message editor to a file other then its original one The name and its location can be chosen by the user Switches to the mapping view and back to the normal view This button is available on embedded message editors for specific components only SP Add Message Adds a new empty message to the multiple message editor EE Duplicate Message Duplicates the selected message from the message A Remove Removes the selected message from the message copyright centeractive a
173. opment JMS Connection F Use INDI JMS Provider Tibco EMS EJ Server Url tcp localhost 7222 Y User Name admin Destination Type ANY Lug User Password Destinations senarafed by semicolon Ssys monitor Ssys monitor queue sample IMS Message Selector event_dass lt gt message or event_reason producer Message Filter messages must contain this sining Regular Expression _ Inverse Optional Filter Name Page 123 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 4 6 7 DETECTING TIBCO EMS QUEUE MESSAGES This section is applicable only if you work with Tibco Enterprise Message Service EMS software When you re using the Message Detector in the JMS Queue Browser mode you must be aware that messages sent to a JMS queue may be consumed by another program even before you can see them If you are interested in messages sent to a queue and you want to make sure you can see all messages arriving to that queue you have to switch off all other message consumer programs Using the EMS Monitor you can however see the queue messages when you add the appropriate monitor topic The queue queue test 1 for example can be monitored using the topic Ssys monitor Q queue test 1 When running the message detector the original message contained in the monitoring message gets extracted and displayed on a separate tabbed pane named Included Message Sequence
174. options can be selected or unselected through the menu Tool gt Options Verbose Comparison Full Structure Check Page 39 of 156 The comparison process by default only reports detail results in case single comparisons fail To get more detailed output select the menu item Verbose Comparison When a document driven comparison without explicit comparison rules is performed elements from the checked document by default are compared only in case they are also contained in the reference document Additional elements in the checked document are ignored If the Full Structure Check menu item is selected the comparison is done in both directions in order to get a full structure comparison copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 3 2 HTML EDITOR Opensphere contains a fully featured HTML Editor that is used for editing and formatting the main description of Opensphere projects as well as the description of various components The figure below shows the inbuilt HTML Editor on the test case property dialog The available buttons are self describing as they can be found same on most other popular text editors NumberOfCars Dile 4 elmli lt aar Ae E a 8 e Headingi Default font rjr B 7 Ux E S NumberOfCars Slightly more complicated test case which after inserting sample data splits into two concurrent branches On one branch a new user Will is added the the
175. ost in transit A client marks a message as non persistent if an occasional lost message is tolerable Clients use delivery mode to tell a JMS provider how to balance message transport reliability with throughput Delivery mode covers only the transport of the message to its destination Retention of a message at the destination until its receipt is acknowledged is not guaranteed by a PERSISTENT delivery mode Clients should assume that message retention policies are set administratively Message retention policy governs the reliability of message delivery from destination to message consumer For example if a client s message storage space is exhausted some messages may be dropped in accordance with a site specific message retention policy A message is guaranteed to be delivered once and only once by a JMS provider if the delivery mode of the message is PERSISTENT and if the destination has a sufficient message retention policy Expiration When a message is sent the JMSExpiration header field is left unassigned After completion of the send or publish method it holds the expiration time of the message This is the sum of the Message Time To Live value specified in the properties dialog of the JMS Message Producer and the GMT at the time of the send or publish If the time to live is specified as zero the JMSExpiration is set to zero to indicate that the message does not expire When a message s expiration time is reached a provider should d
176. ou are asked to select a WSDL file from the WSDL file cache The Opensphere program will try to extracts the location and port of the target service from the initially selected WSDL file The property dialog of the Web Service Client lets you extensively customize its behavior within the first tab In order to complete the configuration you have to add define at least one operation invocation on the tab labeled Operation Invocations This is done by opening an XML file file extension wsm or by by activating the F button Latter lets you select a WSDL definition from the project specific WSDL file cache and then choose available operation invocations from the dialog shown below The dialog lets you also select a set of self explanatory options that determine how the program initially generates the SOAP content of the operation invocation messages If you want to choose operation invocations from a different WSDL file simply click the button labeled Switch WSDL and make your choice Choose Operation Invocation Options Build Headers Indude Optional Elements E Add Sample Values C Skip Comment Add Type Comment C Targets Mock Service SOAP Message Operation WSSampleServiceSoapBinding login REQUEST WSSampleServiceSoapBinding searchltem REQUEST WSSampleServiceSoapBinding egister REQUEST PO WSSampleServiceSoapBinding buyItem REQUEST ee SE The payload SOAP Content of the operations to be invoked can contain marker
177. ou have to re launch the program to see new ones in the icon chooser dialog copyright centeractive ag Page 32 of 156 User Manual Opensphere Release 2 5 Each row from the dialogs table defines how to display an XML element in the structure tree of the XML Editor and may define how to identify the XML element using XPath expressions The following table explains in detail how to set the values of single fields Column Description Element The name of the XML element that is affected by this definition This may be the Name elements local name or the qualified name The qualified name consists of a namespace prefix and the local name separated by a colon i e ot person Attribute Name of the attribute that uniquely identifies the element The value of this attribute is displayed beside the tree node instead of the element name Either the Attribute or the Icon must be defined When an XML element is used for comparison and its node definition has the Attribute specified the XPath expression that identifies the element is different from the default one Accordingly the comparison result can be different as well Additional The Additional Attribute is optional The value of this element attribute is put inside Attribute parenthesis and appended to the name of the structure tree node There is no other side effect as the one explained for the Attribute setting Image that is used for rend
178. ows all its dependent nodes within a table All editable cells appear with white background while non editable cells appear with gray background Editable value cells have an icon on their right it invokes a specific editor dialog as soon as you click on it If a message field node other than a field group is selected data node the detail view of its parent node is shown but the row representing the selected node gets also selected in the table appears with blue background on Windows systems i e The send subject as well as the reply subject of the top level message node does not appear in the table detail view To display and edit them you will have to select the root node and switch to the default view for detail view Page 91 of 156 copyright centeractive ag l User Manual Opensphere Release 2 5 centeractive fe File Edit iew Search Tool anm EX HAP dh amp Send Subject Size Byte opensphere test person create fz Tg 3 TS By X FieldName TE T pl AV Message _ Title 0 Mr STRING 5 ee Firstname o Birthdate Firstname aAddess O f Street Rue de la Gare Housenumber 26 ZIF Code 1010 S Birthdate E3 Job Histo Qi Job Desc Senior Consultant Company IB M1 Hire Date 5a B 03 Address en Street ee Houserumber ZIP Code vee Location dad O State en County H 0 Job History Field Group Direct Dependants _ Message File 0 47 emp Ferson rem
179. pensphere project When a new project is created the proposed project name is New and is best replaced by some more appropriate name Changing the project name for a new project does automatically change the name of the project directory in the text field below When a project file is created for a new project it gets the name of the project together with the extension osp and it is placed in the project directory Project Directory Directory on file system that gets the project data written to it by default Opensphere proposes a directory that is composed by the base Projects Directory defined in the tool options dialog Paths tab and a dependent folder that has the same name as the project tool options can be changed through the menu item Tool gt Options The project directory can be set for new projects only For existing projects it is the folder that contains the project file 22i WSDL CACHE This panel shows the content of the project specific WSDL file cache and lets you add and remove WSDL definitions to it Please consult the section SOAP Web Services for further details A SSL KEYSTORE CACHE This panel shows the content of the project specific SSL keystore cache and lets you change its definition Opensphere uses keystores and trustores for performing web service communication over a secure socket layer The action buttons located on top of the panel are shortly explained in the table below
180. r show topics and you get a list of available destinations Message Body Type This combo box lets you choose between Bytes and Text messages Timeout Operation invocation timeout in milliseconds Op Invocation Trigger Determines how the operation invocation process shall be triggered According to the selection some controls in this box get visible some others non visible Number of Iterations Number of iterations the client should send operations invocations each time it is started This number has no effect if the client was told to invoke operations forever Accomplishing sending all operation invocations of the defined message array is considered to be one iteration This field is visible only if the message sending trigger selection Iterator Counter Counter Infinite Indicates if operations invocations should be sent until the process is stopped by external intervention If this check box is unchecked Number of Iterations setting determines how many operations invocations are sent This field is visible only if the message sending trigger selection Iterator Counter Counter copyright centeractive ag Page 72 of 156 Option Row Set Interval Message Table Size Write operation responses to file Page 73 of 156 User Manual Opensphere Release 2 5 Description This line shows what kind of data row set is used to control the message sending process Row sets are tabular data that can
181. r Manual Opensphere Release 2 5 Description The name of the destination either a topic or a queue Opensphere lets you discover destinations through the search button located right to the destination field This is a feature that requires a JMS connection with administrator privileges If you have such a user temporary specify the corresponding connection discover and select your destination Don t forget to specify a non administrator connection for further use To know about valid destinations for Tibco EMS for example you may also open the EMS Administration Tool and connect to the JMS provider specified by hostname and port You could for example type connect tep localhost 7222 Once the connection is established enter the command show queues or show topics and you get a list of available destinations Select this check box if you want to specify a condition on incoming messages Once you select the check box you can enter your message selector below If any syntax error is found the mistake is underlined By locating the cursor over the text area a tooltip appears and gives you information on the mistake The message filter field lets you enter the filter criteria That field and the two check boxes located to right to it determines whether a detected message is retained or ignored by Opensphere When a message gets detected Opensphere by default both check boxes unselected examines whether this v
182. r as soon as it gets closed When closing the dialog the user is free to decide if the message comparison and with it the test step was successful or if it failed Test step execution with the Message Compare Editor displayed is especially useful during test case set up Page 149 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 e If the check box is not selected comparison is done automatically and the result is fully reported to the test case result pane This mode should always be used for automated regression tests The reference message file is usually selected from the file system aa since it is supposed to contain stable data maintained in a protected location The file name can also be imported through the message editor ine where it can be edited in the reference message mode In some cases however it could make sense to select an entry from the combo box labeled Reference Message File This combo box in fact contains the names of all message files that are used in other test steps inside the same test case On the other hand you have to define the message file containing the messages that are compared with the reference messages This will likely be a file that has been created by a messaging program such as the JMS Message Producer Consumer the Rendezvous Publisher Subscriber or a Web Service Client Server test step reply messages For this reason the combo box labeled Message File will
183. red within the gen wsdl folder together with included WSDL files or reference schema files XSDs Every time an Opensphere project is opened its gen wsdl folder is scanned and the WSDL files are loaded to the WSDL file cache Page 59 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Whenever Opensphere needs a WSDL file to accomplish a 3 choose wspi web service related task the program requests it from the user through the dialog shown beside The dialog lists all globalweather asmx wsd soap wsdl entries from the project WSDL file cache When no WSDL file f ebservicesiatestebaysve wsdl was used for this project yet the WSDL file cache is empty ishani eee If no WSDL files are shown in the dialog or if the desired one is not listed yet you can import a new one to the WSDL file cache by pressing the appropriate button from the top located tool bar Their respective functionality is explained in the table below The WSDL file cache can also be viewed and altered on the project properties dialog that gets displayed if you select Project gt Project Properties from the main menu Description a Add WSDL File This function lets you select a WSDL file from the file system ka Add Remote WSDL This function lets you select a remote WSDL file by entering an HTTP URL in a pop up dialog Such an URL could look as follows http www mycompany com 8080 store ArticleService wsdl 2 Delete WSDL
184. rent types of programs modules with Opensphere The use cases typically show a single module that communicates with Opensphere components i e Message Detector over a unique communication protocol such as JMS Real test cases however may interact with several external modules and there may be different communication protocol involved To make distinction of the role the different components play in a scenario the items listed below got used Item Opensphere Component Expected Message Execution Message Flow P Setup Message Flow Execution Message Test Result Page 131 of 156 Description Configurable component such as a Rendezvous Publisher Message definition file that specifiies how the actual messages have to be compared It defines the data or data portions expected at a certain point during test execution Message flow that happens during the test execution This may comprise a triggering messages messages from and to Opensphere components and the program that gets tested Messages captured prior to the actual test execution and prepared as expected data for comparison Message definition data file used for triggering the test execution and messages captured during that execution Comparison result viewable within the Opensphere program or within a web browser once the result has been published copyright centeractive ag User Manual Opensphere Release 2 5 centeractive 6
185. require any knowledge of the specific program libraries APIs nor any programming language skills at all It s as easy as to work with your preferred text editing program Opensphere projects are stored in XML files and automatically reloaded at application start up TIBCO Rendezvous messages recorded with the RV Message Detector or created through the RV Message Editor can individually be saved to XML files and be reused elsewhere The RV Subscriber and the RV Application Simulator modules as well can be configured to automatically write all recorded Rendezvous messages to a reusable XML file The configuration of program modules such as the RV Application Simulator can be exported to an XML file and be reloaded at any time into another project or be used in another application Messages and configured programs can also be saved to the rvscript format the all purpose scripting tool for TIBCO Rendezvous A program module present in the rvscript format is fully functional and behaves same as if run within the RV Tool Collection Generated RV programs however are not supposed to be used in a productive environment but will help build complex systems but also greatly improve and speed up the development and test process within your company copyright centeractive ag Page 4 of 156 e User Manual Opensphere Release 2 5 1 1 4 DATABASE SUPPORT Opensphere offers comprehensive database support in various functional areas SQL statement
186. rresponding charset name i e UTF 16 has to be entered in the Character Encoding field that appears right to the file name This charset is applied when the file is read in order to be shown in a dialog i e text editor and when the comparison is performed When a file is saved from a dialog however it always uses standard encoding and the entered charset is not taken into account 6 5 17 1 COMPARISON OPTIONS Depending on the selected content type the following compare options are available Content Option Type Comment Identifier Specifies how lines with comment are marked in the text file If this field contains a value all lines that start with that value are considered to be comment and will not be included in the comparison Excluded Lines Specifies the lines that shall not be included in the comparison The numbers of the excluded lines need to be separated by a comma each The first line number is number one Compare Mode Compare full structure All XML elements and attributes of the compared file must be identical with the ones from reference file Comparison Rules Only XML elements and attributes explicitly defined for comparison are considered The message structure beside the defined elements and attributes is not considered Comparison Rules Inversed All XML elements and attributes not explicitly defined for comparison are considered defined ones are ignored Column Names Line Indicates what line within the CSV f
187. rted as a test step of the same type i e Rendezvous Generic Publisher Page 19 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 2 2 3 FOLDER The folder Ca can contain any executable node and other folders This node is also named group viewer since it offers a view on all console windows of direct dependent executable nodes This way its detail view looks like a multiple document interface MDI or desktop Console windows can be arranged through the Window menu you have the choice between horizontally vertically and cascading arrangement The folder view has its own toolbox where a button appears for every node type that can be added to the folder The folder accepts other folders as well as executable node see below as its dependents When the start button is pressed while a certain folder within the project tree is selected all its direct dependent executable nodes are started The same if the stop button on a selected folder is pressed all its direct dependent executable nodes stop running 2 2 4 EXECUTABLE NODE The executable node is an embedded program module or process that runs under the control of the Opensphere application The complexity of the executable nodes varies a lot it may be a simple operating system command a SQL Processor or a configurable Tibco Rendezvous application simulator to mention only three of them The following table gives an overview of all executable n
188. s can also be executed from independent nodes or within test steps either to initialize tables to simulate a component or to compare values from different tables on a same or on distinct databases 1 1 5 GRAPHICAL USER INTERFACE The Opensphere graphical user interface GUI provides a single window that is equipped to handle the complete range of functionality provided The driving component is the left located tree based browser that shows the user defined structure of the active project Every tree node has its associated detail view that is displayed right to the project browser as soon as the node gets selected By right clicking a node a menu pops up that contains all functions that can be invoked on the specific node The main window contains a menu bar and a tool bar that offer global functions or functions shared by different node types Some of the detail views however contain additional tool bars offering context specific functionality An optional displayed tabbed pane located on the windows bottom contains a variable number of worker panels Extra non project specific tools such as the Tibco Rendezvous message detector may also be added to the window and stay there as floating dialog or can be docked as working panel S OpenSphere 2 5 0 C temp samples ActiveMQ ActiveMQ osp File Project Testing Message Tool Window Help Main Menu BS8S8 gt 8 88 5 amp amp amp Am 6 Main Toolbar Test Case Logic Test
189. s that are replaced by the value of project dependent substitution variables Markers can also be replaced by the corresponding data of a single row when the driving component for invoking operations is a row set Row sets can be defined as static data within an editor but they can also be the result of an SQL select statement that gets executed each time the Web Service Client is started copyright centeractive ag Page 66 of 156 e User Manual Opensphere Release 2 5 centeractive S Properties WS Client Definition Operation Invocation Messages Use HTTP Proxy Proxy Host i Proxy Port 3123 Use Proxy Authentication Username eee Password fe 3000 ms Response Timeout 4000 ms Operation Invocation Control Op Invocation Trigger Iterator Counter Number of Iterations For ever Interval 1000 s bet Security O Use HTTP Authentication Username Password SSL Client Certificate Truststore Use Cached Truststore Default Project keystore Message Retenton Message Table Size Write operation responses to file Web Service Client options are defined on the first tab within the dialog the detailed description is explained in the following table Option Description Name The name that appears in the project tree together with the node representing the web service client Host The name or the IP address of the target compu
190. s to check whether the server is running 6 5 6 WEB SERVICE CLIENT This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 7 JMS MESSAGE PRODUCER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 8 JMS MESSAGE CONSUMER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 9 JMS QUEUE BROWSER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 10 RV PUBLISHER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 11 RV SUBSCRIBER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 12 RV APPLICATION SIMULATOR copyright centeractive ag Page 148 of 156 User Manual Opensphere Release 2 5 This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 13 SQL QUERY VIEWER This test step behaves basically the same as the executable node with the same name Please consult the related detailed description 6 5 14 SQL PRO
191. sage is added to the buffer the oldest one gets discarded in case the new added message would make the buffer size exceed Page 109 of 156 copyright centeractive ag o PE User Manual Opensphere Release 2 5 centeractive Fe p ae Detector 7600 tcp 7600 mem fos ee Q gt 8 xig P bls Subjects gt Sequence Buffer Size 1000 Ci Message Sequence Host Status Info Total x Host Status Info Per Minute x Subject Summary x Time Target Destination Reply To Data 2012 06 08 10 58 07 191 _RV INFO SYSTEM LISTEN START gt _ HADV_CLASS INFO ADV_SOURCE SYSTEM ADV_NA a 2012 06 08 10 59 12 006 _RV INFO SYSTEM LISTEN START gt ADV_CLASS INFO ADV_SOURCE SYSTEM ADV_NA E 2012 06 08 10 59 15 387 opensphere test person create Person Name Dufour Firstname Philipe Birthdate 2012 06 08 10 59 15 387 pensphere test person create advisory STRING 10 a person has been created 2012 06 08 10 59 15 496 jopensphere test person create Person Name Casanova Firstname Mauro Antoni 2012 06 08 10 59 15 496 lopensphere test person create advisory STRING 11 a person has been created 2012 06 08 10 59 15606 opensphere test person create Person Name Depreux Firstname Claudine Birth 2012 06 08 10 59 15606 jopensphere test person create advisory lfSTRING 12 a person has been created 2012 06 08 10 59 15 715 lopensphere test person
192. select statement must also be defined for retrieving the reference data at runtime Together with the query you have to specify a database connection In both cases the SQL editor lets you write comment either as line comment with leading double slashes line comment or as block comment that is delimited by a couple of a slash and a star block comment The syntactical correctness of the entered SELECT statements is checked when the Check button is pressed If the used JDBC driver supports pre compilation the check method will send the statement to the database for pre compilation Most drivers do not support pre compilation In such cases the statement is not sent to the database prior to its execution and only the starting key word is checked 5 4 3 MANUALLY EDITED REFERENCE DATA The reference data type can be chosen by selecting the appropriate radio button top right on the Reference Data pane If you select Manually Edited the reference data has to be entered manually into a table The table structure number and name of the columns is to be defined by the user within a dialog that pops up upon mouse click on the button Table rows can be arranged by moving them up or down The reference data can also be loaded from a database 3 or a CSV file and be further edited within the dialog if required The entered data is finally stored to a user chosen XML file from where it will be read again at runtime
193. ses that are required to act as a client towards a particular JMS implementation product Depending on the available classes you then define one to three connection templates and optionally also an admin class The connection templates are then available within Opensphere when you define a JMS component i e JMS Message Consumer The JMS Provider Details box shows the details of the current selected JMS provider according to the table below Property Description Name of the JMS provider i e Tibco EMS that must be unique between all JMS provider definitions The JMS provider name gets referenced by JMS components you define in your project i e a JMS Queue Browser but also from within JMS listener definitions mad for the Message Detector Therefore be careful when choosing the name and avoid changing it if it is still referenced somewhere If you may think of working with different releases of the same JMS product simultaneously it is advised to include the release number in the name straight from the beginning copyright centeractive ag Page 10 of 156 Property Java Libraries Page 11 of 156 User Manual Opensphere Release 2 5 Description This list contains all Java archives jar and or zip files used by a client of the defined JMS provider Since Opensphere acts as a client through its configurable components Message Detector JMS Message Producer etc it needs to have access to related Java c
194. software module e Publish a huge amount of messages with variable data from a database for stress testing a software component e Send messages to test a RV Application Simulator configuration e etc Cee PUBLISHER OPTIONS An RV Publisher is easy configurable through the properties dialog shown below The dialog is split into two panels that can be selected through the tabs labeled Definition and Messages Page 95 of 156 copyright centeractive ag i User Manual Opensphere Release 2 5 centeractive _ Write incoming reply messages to file Ld copyright centeractive ag Page 96 of 156 User Manual Opensphere Release 2 5 centeractive RV Publisher Definition Messages ARB X KHIAP WY AAM AYUR Send Subject 1 test subject test subject test person create b ra a Ba Ey ea fo x Name Birthdate ml RY Message S Person ID O Type DATETIME a i as E Title E Name Value idd MM yyy HH mm ss seven E Firstname 17 03 1971 00 00 00 D0 5 03 Address a O Street i Housenumber _ ZIP Code l Da E Location one E State L E Country H 0 Job History Field tL Message File C iDatalOpensphere lprojects OpensphereTest Publisher Person rwm RV Publisher options are explained in the following table Description The name that appears in the project tree together with the node representing the publisher Use Project Settings This
195. sql ocalhost 3306 cars1 User root Password oeeeeane E Plain Text Attributes Single SQL SELECT statement select from car Any previous loaded data will be removed and the table structure will correspond to the data retrieved from the database Be aware that the loaded data will have to be stored into a file and limit the number of rows by carefully editing the query Page 129 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Load from This function lets you choose a CSV file from the file system and load its data CSV File according to the options you define in the dialog shown below SS CSV File Load Options W Column Names Line Number 1 Field Separator Comment Identifier Cance e Column Names Line Number Indicates what line within the CSV files contains the column names Lines appearing in front of this line will be ignored The first line in the file is number one If the checkbox is not selected the column names are generated by Opensphere Field Separator Indicates how single fields within the CSV file are separated This field can be left empty if the CSV file contains a single column Comment Identifier Specifies how lines with comment are marked in the CSV file If this field contains a value all lines that start with that value are considered to be
196. started Page 81 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 centeractive AALi JMS MASSAGE PRODUCER OPTIONS The dialog below allows you to configure the behavior of the JMS Message Producer Properties JMS Message Producer Message Producer Messages Mame JMS Message Producer Connection Use INDI IMS Provider Tibco EMS Ww Server Url tcp localhosk F222 Destination Type TOPIC s User Name admin User Password Destination topic sample Communication Communication Type Request Timeout 10 Message Time To Live 3600 seconds 0 unlimited Message Producing Control Message Sending Trigger Ikerator Counter w Mumber of Iterations For ever Interval mz Program Termination Generates error when no reply message is received within timeout period Message Retention Message Table Size C Write incoming reply messages to file RE JMS Message Producer options are defined on the first tab within the dialog according to the following table Option Description Name The name that appears in the project tree together with the node representing the Message Producer serverURL The URL of the JMS server i e tcp localhost 7222 userName The user name in case an identification is required userPassword The password in case an identification is required Destination Type Lets you choose between the destination type Queue or Topic
197. stination Type QUEUE y User Name admin User Password Destination queue sample Communication Timeout an ms between messages Message Selector and Filter _ Message Selector Message Filter messages must contain this string Regular Expression _ Inverse Message Retention Message Table Size write downloaded messages to file The options are similar to the Message Consumer options Compared to Message Consumer Queue Browser has no ending condition as it downloads messages from the specified queue and stops immediately after the last message There is no transacted feature either as the Queue Browser does not alter the downloaded messages Page 89 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 4 5 TIBCO RENDEZVOUS Tibco Rendezvous messages are self describing tree like structured data constructs The top level message node holds information on the send subject and the reply subject and it contains zero or more dependent message fields Such fields are sub messages field groups containing themselves other fields or they are payload data fields 4 5 1 RENDEZVOUS MESSAGE EDITOR TIBCO Rendezvous messages within Opensphere are shown and edited using the standalone message list editor menu item Message gt Message Editor and through the multi message document editor menu item Message gt Multi Message Doc Editor Rendezvous specific program nodes such
198. stitution variable you need to include it in a JAR file that gets stored in the libext folder of the Opensphere installation directory In the Java runtime environment you can also find classes with static methods that can be used as data source for the static method substitution variables Below you find a few examples of method signatures that could help you in a specific situation java lang Math random java lang System getenv JAVA HOME java lang System getProperty user name jJava util Locale getDefault jJava util UUID randomUUID Opensphere provides an inbuilt class with a handy static method that returns the current date as a formatted string The date time pattern is the one used by the Java class SimpleDateFormat see http java sun com j2se 1 5 0 docs api java text SimpleDateFormat html and can be freely composed by the user The method signature to be entered in the Initial Value column of the substitution variable dialog is the following com centeractive opensphere substitution inbuilt CurrentDateFor matter format lt pattern gt for example com centeractive opensphere substitution inbuilt CurrentDateFor matter format dd MM yyyy HH mm ss Page 27 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 2 3 8 DERIVED SUBSTITUTION VARIABLES The value of derived substitution variables is produced at runtime performing one or a series of commands that extract cert
199. t Tool Options from the main menu When this option is selected and the static row set data was never saved to a file you will see File not yet defined right to the Define button That s there because Opensphere will not automatically assign a file name and save the data to it until the property dialog gets closed through the OK button Please consult the chapter 3 5 Row Set Editor for detailed information about the row set editor When running the Web Service Client the rows from the row set regardless if resulting from an SQL query or from static data are traversed one by one until the last row is reached Every row corresponding to one iteration will trigger the invocation of all operations present in the operation list The values from the current row can be used as string type substitution values in the operation data of that one iteration To make the substitution happen you simply place the column name enclosed by the appropriate pre and postfix wherever you wish within your operation same as you do with ordinary substitution values see 2 3 Substitution Variables copyright centeractive ag Page 68 of 156 User Manual Opensphere Release 2 5 Description This field is visible only if the operation invocation trigger selection is Data Row Set Interval Sets the time in milliseconds the client should wait between operations invocations If the operations being invoked send
200. t details displayed right to the project browser Right click any node to get a pop up menu displayed that contains all available methods that can be invoked on that node A double click on most nodes displays their property dialog Node Detail View Shows the relevant runtime details of the current selected project tree node The detail view of a folder node for example contains several internal windows representing the console of all direct depending executable nodes the detail view of a test case detail view contains a tabbed pane showing different views on the test case each Further properties of a node can be shown by right clicking it and select the appropriate item from the popped up menu Worker Panel Shows information on processes running in the background or running in parallel to the interactive GUI process Most worker panels are instances of a message pane see below Lie NOTIFICATION PANES Opensphere uses special panes to show notifications on a specific topic they are used to report work progress results of comparison programs etc Notifications are displayed with different colors depending on their type The notification pane offers a table view and a text view the table view summarizes information and may hide details that would all be visible in the text view Details of a single table row are displayed in a dialog when a mouse click occurs on the row To give a quick overview on something and for performance reasons the
201. t message is published see Send Type The exact behavior depends on the type of reply subject defined for the published message If the reply subject is an INBOX the option defines the time in seconds the publisher blocks if no message is received on that inbox synchronous reply If the reply subject is a custom value the publisher simply holds on execution for the defined amount of seconds if no corresponding reply message is detected asynchronous reply Corresponding in this case means any message that has its send subject set to the value of the published message s reply subject If the reply subject is empty time out is ignored since such messages are simply published Determines how the message sending process shall be triggered According to the selection some controls in this box get visible some others non visible Number of iterations the publisher should send messages each time it is started This number has no effect if the publisher was told to send messages forever Finishing sending all messages of the defined message list is considered to be one iteration This field is visible only if the message sending trigger selection is Iterator Counter Counter Indicates if messages should be sent published until the process is stopped by external intervention If this check box is unchecked Number of Iterations setting determines how many messages are sent This field is visible only if the message sending tr
202. t the data from a database In both cases you can alter the data immediately or at any time later to make it fit your needs When after defining a new static row set you close the Row Set Editor by pressing the OK button Opensphere may ask you to save the row set data to an XML file of your choice Opensphere can also be told to decide by its own where to store the XML file This can be achieved Page 83 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 Description by selecting the option Automatically define name and location of messaging component files on the File panel within the tool options dialog select Tool gt Tool Options from the main menu When this option is selected and the static row set data was never saved to a file you will see File not yet defined right to the Define button That s there because Opensphere will not automatically assign a file name and save the data to it until the property dialog gets closed through the OK button Please consult the chapter 3 5 Row Set Editor for detailed information about the row set editor When running the JMS Message Producer the rows from the row set regardless if resulting from an SQL query or from static data are traversed one by one until the last row is reached Every row corresponding to one iteration will trigger the sending action of all messages present in the message list The values from t
203. t the mappings of the generated application simulator the test script name is the same as the one defined for the application simulator script but has prefix Test 4 6 MESSAGE DETECTOR The Message Detector is a module that detects messages of a certain type Tibco Rendezvous or JMS and presents them to the user through different views It provides powerful message filtering functionality and lets one easily edit store and re send detected messages The module gets started from inside the Opensphere application through the menu items Message gt Rendezvous Message Detector Message gt JMS Topic Message Detector Message gt JMS Queue Message Detector or Message gt EMS Monitor it may also be invoked by pressing the corresponding button from the main tool bar a This button starts the Message Detector in Tibco Rendezvous mode This button starts the Message Detector in JMS Topic mode pa This button starts the Message Detector in JMS Queue mode Pah Aea EE TENET Alternatively the Message Detector can be started as standalone Tibco Rendezvous application through the Opensphere menu group on the windows start menu In that case the user has to choose the message type he wants to listen on within the dialog shown beside The Message Detector listens on one or several destinations topics queues subjects or topic subject hierarchies the user Cancel defines in the field located in the dialog tool bar
204. table view is most often used by default You can change between table and text view by selecting the appropriate item in the pop up menu that appears when you right click inside the message pane Console Global Properties Property Screen Buffer Size Background Color Selection Color Text Color Informations Text Color Warnings Text Color Errors Selected Text Color Font Courier New Standard 12 copyright centeractive ag Page 6 of 156 aeaa ee User Manual Opensphere Release 2 5 centeractive Consoles are message panels that show process activity and add functions accessible through a pop up menu they are used to observe and control the execution of processes Consoles appear in the detail views of executable nodes The appearance of consoles can be changed through the option dialog shown beside that gets displayed if you right click inside a console and choose the item Console Options from the pop up menu Alternatively those same options can be changed in the tools options dialog that appears when the item Tool gt Tool Options from the main menu gets selected The new settings are applied to all consoles within the application 1 1 6 TOOL OPTIONS The basic behavior of Opensphere can be customized through the Tool Options dialog that is invoked by selecting the menu item Tool gt Tool Options from the main menu The left located menu tree lets you select the item of your choice in order to change the
205. teger value The actual value must contain the expected value as a substring The actual value must be contained in the expected value as a substring The actual value must start with the expected value The actual value must end with the expected value The expected value is also known as the reference value It is usually a predefined value that is specified either by an XPath expression or by a litter value The expected value is interpreted as literal in case it is enclosed by quotation marks otherwise it is always considered to be an XPath expression Instead of showing an XPath expression the comparison rule table shows a unix like notation that identifies the message node the comparison references If you start editing the path by clicking inside the cell you will actually see the previously hidden XPath expression and you can adapt it to your needs see also Value Path copyright centeractive ag User Manual Opensphere Release 2 5 centeractive Comparison Description Rule Attribute User Message The optiona User Message gets added to the function message and lets you produce some customized output Nested XML This check box indicates whether the referenced message structure node contains itself XML data If the check box is selected you are enabled to define comparison rules on the nested XML structure as well 4 2 4 2 NODE DETAIL RULES For some type of messages more spe
206. tep The sequence value gets reset to its initial value each time a test step starts running 2 3 5 JAVASCRIPT SUBSTITUTION VARIABLES The value of JavaScript substitution variables is generated at runtime from the execution of the JavaScript code defined by the user The feature uses the JavaScript engine Mozilla Rhino that complies with JSR 223 Rhino reaches beyond JavaScript into Java as it allows you to write powerful scripts quickly by making use of the many Java libraries available When editing JavaScript substitution variables an editor dialog see below pops up that lets you write the script code This code must be terminated by an instruction that returns the substitution value i e return myVar a returns the specified number in two digit format function format num if num lt 10 return 0 num return num pon nH OF ee WwW NH Fe returns the current date time 1 hour in the format dd MM yyyy HH mm ss 10 function main now new Date new Date getTime 3600000 return format now getDate format now getMonth 1 now getFullYear format now getHours format now getMinutes format now getSeconds copyright centeractive ag Page 24 of 156 User Manual Opensphere Release 2 5 Date Formatting Sample Depending on the current date following code will produce a value similar to Friday 27 4 20
207. ter that hosts the web service s to be invoked Port The port number the target computer listens for incoming web service operation invocations Use HTTP Proxy Select this check box and enter appropriate values for Proxy Host and Proxy Port if you communicate through an HTTP proxy Use Proxy Basic Select this check box and enter Username and Password next to it if the Authentication HTTP proxy needs basic authentication Connect Timeout Maximum number of milliseconds the client tries to establish a HTTP connection to the server Response Timeout Maximum number of milliseconds the client waits for receiving operation invocation responses Page 67 of 156 copyright centeractive ag Option Op Invocation Trigger Number of Iterations Infinite Row Set User Manual Opensphere Release 2 5 Description Determines how the operation invocation process shall be triggered According to the selection some controls in this box get visible some others non visible Number of iterations the client should send operations invocations each time it is started This number has no effect if the client was told to invoke operations forever Accomplishing sending all operation invocations of the defined message array is considered to be one iteration This field is visible only if the operation invocation trigger selection is Iterator Counter Counter Indicates if operations invocations should
208. tes except if null for a null reference is explicitly specified The specified class must have a parameter less that allows Opensphere to create new objects The chosen method may be present in the Java runtime environment or it may be written by the customer In the latter case you need to include it in a JAR file that gets stored in the ibext folder of the Opensphere installation directory If you write your own class you can implement the interface com centeractive opensphere substitution ResetableBean contained in the lib openSphere n n n obfuscated jar file This interface has a single method named reset The reset method will be invoked by Opensphere each time the start button gets pressed It can also be invoked during test execution depending on the value chosen in the column titled Reset If the Java bean does not implement the ResetableBean interface Opensphere creates a new instance of the class a new bean each time it would otherwise invoke the reset method The following table explains in detail the behavior of the distinct values of the Reset column Reset Value Description In case the start button gets pressed in no other case a new Java bean gets instantiated If the Java bean however implements the ResetableBean interface its reset method is invoked instead per test suite Each time a test suite starts running a new Java bean gets instantiated If the Java bean however implements the ResetableBean interfa
209. that appears when you press the right mouse button while its pointer is located on the node A left mouse button double click on a selected node brings up its property dialog that lets you customize the node 2 2 PROJECT TREE NODES EH The project node is the root of each project The subsequent described nodes may appear in the project tree structure Only common folders databases and test suites can be added as direct dependents to the project node 2 2 1 PROJECT PROPERTIES When creating a new project through the menu item File gt New Project the project properties dialog gets displayed automatically and requires some data to be entered The same dialog can be shown at any time later by selecting the menu item Project gt Project Properties from the main menu gs SS Project Properties General Rendezvous Advanced WSDL Cache Custom Editors SSL Keystore Cache Tibeo mendezvous Advanced Field Name Field ID Data Type Editor Class Name Field Name Field ID Data Type Any Type Editor Class Name User Data Type Handler Encoder Decoder Handler Class Name User Data Types Comma separated values between TibrvMsg USER_FIRST 128 and TibrvMsq USER_LAST 255 each copyright centeractive ag Page 16 of 156 User Manual Opensphere Release 2 5 centeractive 221i GENERAL On the General panel you define the name and location of the Opensphere project Description Project Name Name of the O
210. the test suite node Alternatively you may also press the button g from the main tool bar 6 2 1 TEST CASE LOGIC 6 24 TEST FLOW CHART The logical execution sequence of test steps is defined on the test case level through a test flow chart When a new test case is created underneath a test suite it gets automatically added the mandatory start state that acts as entry point of every test flow Any other test steps can then be added to the flow chart and connected to other steps through a few mouse clicks e Left click with the mouse on the desired button in the left located test step tool palette and again within the flow chart to have a new test step added to it e Press the left mouse button when the mouse pointer is at the center of test step source move the mouse to another test step target while keeping the mouse button pressed Release the button and you get a new connection between the two test steps The flow chart allows only forward connections given a source test step you may not target a test step that is already a direct or indirect predecessor of that source e Existing test steps and connections among them may be changed or removed from the flow chart the start state shape however cannot be removed e Atest case must have all its test steps connected to become executable Page 137 of 156 copyright centeractive ag ee EEE a ae User Manual Opensphere Release 2 5 centeractive Test Case Logic T
211. the values of the mapped fields are automatically copied from the source to the target field and those dynamically built messages are replayed and or forwarded according to the definition you made Some fields of course may also still contain their initial static values copyright centeractive ag Page 106 of 156 ee re User Manual Opensphere Release 2 5 centeractive S Properties Accept Request Reply Forward Messages E Reply Forward all defined messages together QaWE t xX KI PH RAB Send Subject Forward Size Byte SMT opensphere test customer create 546 opensphere test customer create Ta E Source Message Template SMT Ta E Target Message pd RV Message awl RV Message 5C Person G29 Customer he E ID Lastname Firstname 0 a Address Street i _ Housenumber ha E City Message File CRM_Test_Suite_1 Add_Customer Accept_Request rvm As mentioned above the first message row appearing in the application simulator property dialog is always that of the SMT it has no row number itself however The SMT is a message that can be edited the same way as would be any other message within the dialog The SMT must have the same structure including field names for fields that have mappings to target messages fields otherwise the field values cannot be copied to the target messages Mappings are defined between message fields To add a new mapping simply click on a field node of the source
212. to be checked actual value the other one for identifying the node that holds the expected value located in the reference message The expected value may alternatively be specified by a literal instead of an XPath expression When creating a new comparison rule its default function is equals Another rule specific function can be chosen from the combo box that appears in the function table cell When comparison is done the selected function generates a default error text in case the expected value in not correct The table below explains each item of a comparison rule in detail Comparison Description Rule Attribute Value Path This attribute specifies the actual value from the message that has to be checked It must be a valid XPath expression Instead of showing the XPath expression the comparison rule table shows a unix like notation that identifies the message node the comparison references If you start editing the cell by clicking inside the cell you will actually see the previously hidden XPath expression and you can adapt it to your needs As an example the below located path editor shows the XPath expression for a Tibco Rendezvous message node identified by the tree path Person Address ZIP Code copyright centeractive ag Page 52 of 156 Comparison Rule Attribute Function Expected Value Page 53 of 156 User Manual Opensphere Release 2 5 Description Value Path Custom Path Person Na
213. topic connection definitions The Connection Factory combo box contains all classes found in the defined Java archive files that implement the following interface JeavVvaks JMS ToOpLeConnecricnractory The Available Properties list contains all properties available for the selected topic connection factory except the ones that are already assigned to it The Selected Properties table shows the properties already assigned to the selected topic connection factory By pressing the button or the l button you can easily add or remove single or multiple selected properties The buttons and let you change the position of single assigned properties You can define a default value for individual properties if you like this is especially useful if the final property value needs to comply to a certain pattern i e tcp host 7222 This panel lets you define an administrator class used to show and retrieve available destinations The Admin Class combo box contains all classes found in the defined Java archive files that implement the following interface com centeractive opensphere msg jms admin JMSAdmin If the file openSphereJMSAdmin n n jar from the directory lt OPENSPHERE HOME gt 1lib jmsAdmin is defined in the list of java libraries a few admin classes for well known JMS providers will be available by default If there is no predefined admin class available for your JMS provider you can write your own by implementin
214. ttribute panel located below the XML tree structure panel has to be hidden when opening a new XML editor Determines whether the comparison rule panel in the XML editor has to be shown or hidden by default when switching to comparison rule editing menu item View gt Show Comparison Rules If this check box is selected the user is still enabled to show the comparison rule panel at any time by simply activating the related toggle button He on the editor tool bar Select this check box if you want to keep the Tibco Rendezvous message detector worker panel to stay always in front when new tabs get added This is especially useful when running a series of test suites that get all their own worker panel added to the bottom of the application That allows the tester to monitor the ongoing overall message flow The Console panel lets you define the look and feel of consoles Consoles are message panels that show process activity and add functions accessible through a pop up menu they are used to observe and control the execution of processes Consoles appear in the detail views of executable nodes Property Screen Buffer Size Description Specifies the number of messages the console should keep in the buffer If a new message gets added to the console and the buffer size exceeds the oldest message gets removed When choosing the buffer size consider the number of executable nodes within your Opensphere projects Every executab
215. ublic Object getData This method returns the data contained in the editor This method gets invoked by Opensphere only in case the method isEditable returns true abstract public void setData Object data This method sets the data to be contained in the editor This method gets invoked by Opensphere each time the Rendezvous field node gets selected in the message editor User Data Type Handler Encoder Decoder In the bottom area of the panel you can define a class that is responsible for encoding and or decoding Rendezvous user types Description Handler Class The full name of a class that implements the interfaces Name com tibco tibrv TibrvMsgEncoder and or com tibco tibrv TibrvMsgDecoder User Data Types Comma separated integer values between TibrvMsg USER_FIRST 128 and TibrvMsg USER_ LAST 255 each The class TibrvMsg is in the package COM LiPo LIOTA 2 2 2 EXPORTING AND IMPORTING NODES Every dependent project node can be exported to an XML file through the export button E located in the main toolbar or through the node specific pop up menu This allows you to share components with other users or to reuse them in other Opensphere projects To import a node under the new parent node you have to press the import button E or to select the corresponding menu item within the node specific pop up menu Executable nodes and test step nodes are interchangeable in the way that an exported executable node can be impo
216. uence and the filter tabs On the destination summary tab the buffer size is applied on a per destination way The buffer table size is limited to what the user chooses from the combo box When a new message is added to the table the oldest one gets discarded in case the new added message would make the buffer size exceed 4 6 4 MESSAGE TIMELINES FILTERED MESSAGES When one or several message filters are defined see Show Message Filter Dialog the Message Detector shows a chart on its bottom where a message timeline appears for every defined filter A message time line has a number of items attached that represent a message each 8 45 10 08 45 15 08 45 20 08 45 25 08 45 30 08 45 35 08 45 40 08 45 45 08 45 50 08 45 55 Bern Zurich Lausanne Ostermundigen When you move the mouse pointer over a message item its destination together with the message detection time will be displayed as a tool tip In case a message item represents more than one messages with identical detection time each this would be shown in the tooltip as well the figure below for example shows an item that represents two messages since the tool tip starts with 2x If you click on a message item a message editor dialog pops up and lets you edit store and resend the message 2x topic sample 2009 06 08 15 33 44 187 If a message timeline contains lots of message items you may not be able to distinguish between single messages To get a
217. und messages from messaging program components in an easy readable way Inbound message are shown by a left directed arrow while outbound message are represented by a right directed arrow Messages that are dependent on a previous message have their arrow shifted to the right This is shown in the figure below that belongs to a Rendezvous Subscriber node Each time the component received an inbound message on the subject test subject it replied on the subject test reply subject and sent another two messages on the subjects test forward subject abc and test forward xyz each Console Messages Target Destination Reply To P 2008 02 23 15 13 16 468 best subject test reply subject 2008 02 25 15 13 16 484 bestreply subject O00000 Mi message helo my name Tale 2008 02 25 15 13 16 500 best forward subjetabe O inemes Sh First nario 2008 02 25 15 15 16 500 test foward OOO O O OT 2008 02 29 15 19 17 718 fest subject E aat reply subje aT B 2008 02 23 15 13 17 718 festreply subject SYS M message hel my name is Jake 2008 02 23 15 13 17 734 best forward subjedtabe J inemes Sih First nario 2008 02 25 15 13 17 750 test forwardye OOOO o eO SOS 2008 02 25 15 13 18 921 best subject ltestrepysubedt fast be z 2008 02 25 15 13 18 937 kest replv subet O00000 M messagehelo my name Tale e 2008 02 25 15 13 18 953 fest forward subjectabe O Minamos mih First name ohn 2008 02 25 15 13 18 968 test for
218. used to define row sets tabular data that gets used as processing trigger for messaging components such as the JMS Message Producer the RV Publisher or the Web Service Client The source of a row set can be either an SQL select statement or static data that gets manually edited and stored in an XML file copyright centeractive ag Page 42 of 156 User Manual Opensphere Release 2 5 Each row of a row set is a trigger for sending publishing all messages or invoking the operations that are defined for the messaging component The field values from the triggering row can be used to replace substitution value markers anywhere in the published message ZIP JavaScript seq Sequence UUID Static Method pops up next to the mouse pointer The top six substitution variable from or operation invocation Substitution value markers correspond to the field EPEE column name enclosed by the substitution variable prefix and postfix that Street Ce House Number are defined in the substitution variable dialog menu Project gt Substitution oe Location T FIP Code Variables user String password Password The easiest way to enter a substitution variable marker in a text field is to E Be al opic String click the right mouse button while the cursor is positioned at the desired shell String location and then choose an entry from the substitution variable list that a eS a 2 a the sample beside r
219. value within the whole message Page 121 of 156 copyright centeractive ag User Manual Opensphere Release 2 5 QUEUE Listener Definition Dialog Provider Connection Destinations Development Tibco EMS serverUrl top focalhost 7222 use queue sample Name Development JMS Connection F Use INDI IMS Provider P EMS a Server Url top focalhost 7222 User Name admin Destination Type QUEUE User P d asswor Destinations secarafed by semicolon queue sample IMS Message Selector Message Filter messages must contain this string Regular Expression T Inverse Optional Filter Name This message detecting mode is applicable only if you work with TIBCO Enterprise Message Service EMS software Prior to be able to use the Message Detector as a TIBCO EMS Monitor you must define a JMS Provider for EMS When launching the Message Detector in Tibco EMS Monitor mode you can define different listeners with their own EMS connection and specific monitor topics that must all start with Ssys monitor When adding a new listener definition the topic sys monitor appears as the default value in the Destinations field This topic lets you detect all messages sent by the EMS server to notify about certain events To see monitor messages related to JMS message communication you have to add destination specific topics according to the EMS documentation This can be achieved by pressi
220. ward zye OoOo o o o o i ey 2008 02 25 15 13 20 156 bestureply subject O00000 O mesagero my name Take 2008 02 23 15 13 20 171 best forward subjedtabe inemes smth fret rn ob 2008 02 25 15 13 20 187 test forwardye OO O o o O 2008 02 23 15 13 21 359 fest subject testre sb a b 2 2008 02 25 15 15 21 37S fest reply subject O O O O O M mes sage hell my name Tak aS Ei Send Subject test subject EFV Message Ta aie Reply Subject test reply subject Pa LJ b Content Message Direct Dependants The maximum number of messages retained in the Messages tab is 100 by default Each time a newly added message exceeds this number the oldest message does get removed from the table automatically The limitation of 100 messages can be adapted for every single messaging program node in its property dialog in the field Message Table Size that appears in the Message Retention box copyright centeractive ag Page 46 of 156 User Manual Opensphere Release 2 5 4 2 MESSAGE EDITORS Tibco Rendezvous JMS and Web Service messages within Opensphere can be shown and edited using the standalone message list editor or the multi message document Some program nodes such as the RV Publisher or JMS Message Consumer let you edit messages directly within their property dialog 4 2 1 MESSAGE LIST EDITOR The message list editor gets invoked through the menu item Message gt Messa
221. word Attributes SOL DML amp DDL statements but no SELECT statment empty line between each DELETE FROM user DELETE FROM car INSERT INTO user id name VALUES 1 Alen 2 Greg 3 Dorothy INSERT INTO car id user_id name power VALUES 1 1 Alfa Romeo 110 2 2 Ford Mustang 200 3 3 Citroen CS 150 4 3 Fiat Panda 75 copyright centeractive ag Page 126 of 156 g User Manual Opensphere Release 2 5 centeractive 5 4 SQL COMPARISON The SQL Comparison is available as a test step within a test case It compares the results of an SQL SELECT statement against an expected result The expected result reference data can be retrieved at runtime from a database or it can be manually edited and stored in an XML file Properties SQL Query Compare 3 Name SQL Query Compare Compare Function equal to v verbose Reference Data Data Data Type SQL Query Manually Edited JDBC Driver Definition MySQL Database URL jdbc mysq flocalhost 3306 cars1 User root Password eeccccce Plain Text Attributes Single SQL SELECT statement select Alans cars that are for sale select name type from car where owner Alan and status 10 ox chek cans 5 4 1 COMPARE FUNCTION The comparison between the actual data retrieved from the database and the reference data is done on field level the selected
222. y n n y n n n n OPTIONS TO BE DEFINED BY THE USER 000000000 000 e er nrnrnnrnnee HH gt KN RRR RRR RRR RRR RRR RR RRR RRR gt lt set global properties for this build gt lt property name openSphereHome location TODO gt lt property name testReportBaseDir location TODO gt lt property name maxRuntimePerTestSuite value 60 gt lt property name rvRoot location env RV_ROOT gt ame emsRoot location env EMS ROOT gt n n lt property name ShowResult value false gt n lt property n lt declare the projects to execute gt lt fileset id projects dir TODO gt lt include name TODO osp gt lt fileset gt NNN OO gt lt l wenn nn nw nnnnnnn n DO NOT CHANGE UNLESS REALLY NECESSARY rnreeerereeeee gt NNN NO gt lt set classpath for standalone execution gt lt path id classpath gt lt fileset dir openSphereHome lib gt lt include name jar gt lt fileset gt lt pathelement location openSphereHome gen classes gt lt pathelement location rvRoot lib tibrvj jar gt lt pathelement location emsRoot lib tibjms jar gt lt path gt lt initializes timestamps and test report directory gt lt target name init gt lt tstamp gt lt format property TODAY pattern yyyy MM dd gt lt tstamp gt lt mkdir dir testReportBaseDir gt lt target gt

User Manual - centeractive

Contents

Download Pdf Manuals

Related Search

Related Contents