BPMN-‐Q installation manual
Contents
1. bpmngq outputdir the path to a folder where BPMNQ will generate files containing matches of processes to the input query bpmngq outputfile the name of the file containing paths to result file bpmng tempdir temproary folder used by BPMN Q while processing bpmnq database hostname used by the postgres jdbc classed must be as configured in the ODBC connection above bpmnq database databasename BPMN_GRAPH the name of the schema to connect to bpmnq database username postgres bpmnq database password postgres bpmng lola full lt example C SecBPMNQExt MyLolaFull Debug mylola gt this information is needed in case you want to use compliance checking features of BPMN Q Optional you don t have to configure change it bpmngq lola deadlock lt example C SecBPMNQExt MyLolaDeadlock Debug mylola gt this information is needed in case you want to use compliance checking features of BPMN Q Optional you don t have to configure change it bpmng lola bounded lt example C SecBPMNQExt MyLolaboundednet Debug mylola gt this information is needed in case you want to use compliance checking features of BPMN Q Optional you don t have to configure change it bpmnq nusmv lt example C SecBPMNQExt NuSMV 2 4 3 bin nusmvs gt this information is needed in case you want to use compliance checking features of BPMN Q Optional you don t have to configure change it Visio configuration file SecBPMNQVisio properties2. contains information that enable the macros communicate with the relathional repository as well as the folder in which the process model visio files are stored process model folder Contains the path to the folder where VISIO will save the process models files bpmngq engine contains the path to SecBPMNQ binaries bpmnq inputfile the file SecBPMNQ engine is expecting to contain the xml describing the query should be the same as that within BPMN Q configuration file bpmngq inputdir Contains the path to which Visio will create the query xml file that will be passed to SecBPMNQ engine for processing bpmngq outputfile same as with SecBPMN Q configuration file bpmnq outputdir same as with SecBPMN Q configuration file bpmnq database host must be as configured in the ODBC connection above bpmnq database username postgres bpmnq database password postgres WARNING all configuration variables corresponding to folders must end with the folder separator Normally folder separator is unless explicitly something else specified SecBPMIN Q usage You can use the BPMN model in models folder as starting case First of all you have to activate macros in Visio 1 goto Tools gt options gt security gt macro security 2 Select Low 3 Restart Visio To create models and upload it in the repository data base 1 Open a blank Visio file or the example If the stencil set is not load it open it manually by following the
3. menu File gt Shapes gt My Shapes gt SecBPMN Query Shapes v4 create your process models in this case only sequence flow edges are allowed and when connecting two nodes connect the edge always first to the source node then to the destination otherwise it will not work properly 2 3 ui e SD be sure that the file BPMNQ Inteface vsd is open in Visio while you are in the new file call the macros menu and let Visio show you macros from file BPMNQ Interface 5 1 go to Tools gt Macros Macros 5 2 in the Macros in menu select BPMNQ interface vsd from those macros choose loadConfiguration from those macros choose UploadToRepository 8 when upload is successful the new Visio file is uploaded to the database and automatically saved to the repository folder i e the folder you set in process model folder To run queries 1 open the BPMNQ Interface vsd from the place you saved it it should load automatically the stencil set 2 Ifthe stencil set is not load it open it manually by following the menu File gt Shapes gt My Shapes gt BPMN Query Shapes v4 3 Compose queries you like from macros menu see point 5 of the creating model procedure choose running either Execute Query or check Model 3 1 Check model checks if the query is satisfied in a specific model you will be asked to enter the model ID you want to check 3 2 Execute Query checks the query among all the business processes uploade
4. BPMN Q installation manual Content of the package SecBPMN Q binaries SecBPMN Q Interface vsd A Visio file that contains a set of macros Through this file users can i create SecBPMN models ii upload these models to repository iii create SecBPMN Q security policies A SecBPMN Q stencil set This file is required for both creating the process models as well as queries SecBPMN Q configuration file included in the JAR file contains necessary information for Visio to work Visio configuration file secBBPMNQVisio properties contains information that enable the macros communicate with the relational repository as well as the folder in which the process model Visio files are stored Database creation script SQL script to create the required tables and stored procedure Stencil set this is a Visio vss file containing shapes with which you can create both SecBPMN process models and SecBPMN Q queries Prerequisite Windows XP 32 bit JVM version 1 6 or higher Postgre SQL Microsoft Visio 2003 From now on called Visio select complete installation ODBC data source o download and install postgreSQL ANSI drivers o goto Control panel gt administrative Tools gt Data sources gt system DSN Administrative Tools Sel orite ODBC Data Source Administrator 5 Q Back 7 gt t Search Key Folders i UserDSN System DSN File DSN Drivers Tracing Connection Pooling About s 4B Administrative Tools Sys
5. d in the data base 4 Whenever there is a match matched models will be opened automatically with matching part to the query is highlighted WARNING If process models are created with other stencil set the interpretation of the query ies results can not be visualized using the above Visio macros Setup the configuration files
6. dministrator x User DSN System DSN File DSN Drivers Tracing Connection Pooling About PostgreSQL ANSI ODBC Driver psqlODBC Setup x Data Source PostgreS0L30 Description BPMN_GRAPH Database BPMN_GRAPH SSL Mode disable Server localhost Port 5432 User Name postgres Password Options Test Datasource Global _Datasouwce ata Save Cancel OK Cancel Figure 3 new ODBC PostgreSQL ANSI connection o Repeat the same steps for the tabs User DSN Installation Steps 1 Place the jar file in any folder you like 2 Place the SecBPMNQ Interface vsd in any folder you like you can leave the folder where it is when you unzip the compressed folder 3 place the secBPMNOQVisio properties in the same folder from step 2 you can leave the folder where it is when you unzip the compressed folder 4 run each sql file in the folder Database Scripts 4 1 execute PGAdmin II 4 2 connect to the database 4 3 create a database called BPMN_GRAPH G pgAdmin III mok File Edit Plugins View Tools Help Onr SHE H 9 Object browser Server Groups Servers 1 PostgreSQL 9 3 localhost 5432 postgres postgres default administrative connection database Te postgres Refresh A gt Tablespaces a Group Roles New Database of Login Roles 1 Reports Properties Statistics Dependencies Dependents Database Owner Comment lt SQL pane Retrievin
7. g details on databases Done 0 00 secs n Figure 4 new database 4 4 select the new database 4 5 go to Tools gt query Tools 4 6 from the query tool go to file gt open IO GP pgAdmin III ox Fie Edit Plugins view BEAST Help pA ariant a e t trigger enabled Object browser Server Groups l B Servers 1 oe aggers value I J PostgresoL g g Yaeate Foreign ke BPMIN_GRAPH B Databases alidate check constrain 16393 w O E Vaidate d NECK COrEITON postgres E EA Eve oe pg_default amp mA Disconnect server pg_default Sc a g Disconnect database UTFS Slor Craliek binikad Chakkar 190 postgre A Tablespace irz Group Role Login Roles Dependencies Dependents Query tool Scripts View Data pg_default English_United States 1252 Reports English United States 1252 Maintenance et a Backup Backup glob ls Retrieving details on databe Restore bpmn q_pa Taa pa bpmn q_pa pmn q_pa Server Status Figure 5 run SQL script 4 7 select the file in the folder Database script in the BPMN Q package 4 8 query gt execute 5 be sure that the default values given in file secBPMNQVisio properties are correct or edit them to values suitable for your settings 5 1 create the appropriate folders 5 2 if you want to edit the configuration values of the file bpmnqVisio properties please follow next indications set the process model fo
8. lder to a path to some folder where to decide to store your process models folder separator is not and it must end with the folder separator set the bpmng engine to the folder where you place the jar file is it must end with the folder separator here you can use folder separator set the bpmng inputfile to query xml in the file sent it is already set to this value please DO NOT change it otherwise things will not work set the bpmnginputdir to C BPMNQ _RESULT for instance as shown in the example file attached set the bpmngq outputfile to answer txt in the file sent it is already set to this value set the bpmng outputdir to C BPMNQ _RESULT for instance as shown in the example file attached set the database host to the address of the machine where you installed the postgres database this value must be the same as in ODBC connection created above set the database username to the username you created the database with usually postgres set the database password to the password you created the database with usually postgres 6 copy the vss file from folder Stencil set to folder called my shapes under my documents 6 1 if there is no such folder open Visio and it will create the folder SecBPMN Q configuration file included in the JAR file contains necessary information for Visio to work The contents of the file are bpmngq inputfile the path and name of the file that is created by Visio editor
9. tem Data Sources r Component Services Name Driver Add File and Folder Tasks Shortcut 2 KB f fm Rename this file iy Move this file Copy this file Publish this file to the Web 6 E mail this File X Delete this file Other Places so gt An ODBC System data source stores information about how to connect to se the indicated data provider A System data source is visible to all users G Control Panel on this machine including NT services My Documents Shared Documents Cancel Help ig My Computer My Network Places Details Figure 1 ODBC connection manager o create a new data source with the following information ODBC postgres SQL ANSI name BPMN GRAPH description BPMN_GRAPH server lt your configuration gt localhost if you have a local DBMS port lt default gt usually 5432 username lt your configuration of postgres gt usually postgres password lt your configuration of postgres gt usually postgres SSL Mode disable Bo a ee Ee eee Create New Data Source Microsoft Paradox Driver db Microsoft Paradox T reiber db Microsoft Text Driver txt csv Microsoft Text Treiber txt csv Microsoft Visual FoxPro Driver Microsoft Visual FoxPro Treiber PostgreSQL ANSI PostareSQL Unicode SQL Server mwwowo H f 4 S amp S Mn iw Cancel Figure 2 new ODBC PostgreSQL ANSI connection ODBC Data Source A
Download Pdf Manuals
Related Search