Admin Client
The IX Admin Client is a Web Application which allows you to administrate a IX JEE Workflow Instance. The IX Admin Client can be deployed on any JEE Server independent from a workflow Application. So the IX Admin Client can be used to adminstrate different instances of the IX JEE Workflow Implemenation on the same JEE Application Server.
To administrate a existing Workflow Application the Admin Client uses a remote connection to the Imixs IX Entity Persitence Manager.
Installation & Deployment
The latest version of the IX Admin Client can be download form the ix-workflow.dev.java.net Download Center. As the client is supported as a single web module (.war file) it can be easily installed on a Applicaition Server like Glassfish in a web container.
After the deployment of the IX Admin Client the Web module is access able using the following url:
http://localhost:8080/org.imixs.workflow.jee.adminclient.web
Notice: You can manage multiple instances of Workflow Applications with the same IX JEE Admin Client on one machine! So on each JEE Server instance the IX Admin Client needs to be deployed only once.
The IX Admin Client requries the user to authenticate and also the authenticated user (Administrator) needs at least the the Role "IMIXS-WORKFLOW-Manager". To authenticate the users the IX Admin Client uses the default Realm "imixsrealm" which need to be configured on the Server. See the installation guide how to setup the security realm on a glassfish server.
EJB Names
After you have logged into the IX Admin client you will see the JNDI Name Page. On this page you can specify the remote connection to an existing IX JEE Workflow Instance on your JEE Server. Therefor it is necessary to enter the JNDI Name defined by the specific workflow application which you whant to administrate. Therefore each IX JEE Workflow Instance supports unique JNDI Names for the IX Entity Persistence Manager. If you did not know the JNDI Name you can use a jndi browser to search for valid EntityPersistenceManger Implementations.
In Glassfish Application Server use the "JNDI Browsing" function of the Application Server dmin Console:
In the JNDI Browser you can search for any deployed EJB JNDI Name.
For the IX JEE Admin Client you need to name an Instance of the IX JEE EntityPersistenceMangerImplemenation.
After you enter a valid JNDI Name and click on the refresh symbole behind the input field or press "Return" a green button in front of the jndi name field will indicate a valid connection. If the green button will not apear the JNDI Name is invalid or the user did not have access to that workflow instance. In this case see your server.log file for more details.
After connecting you can use the different function of the Admin client.
Additional to the Imixs Entity Persistence Manager you can also setup a valid connection to a Scheduled Workflow Service Instance of your Workflow Instance.
Notice: The jndi name for the Imixs Entity Persistence Manager is always necessary. The jndi name fo the Imixs Scheduled Workflow Service is optinal!
Index Managment
The Index management can be use to verfiy exisiting indexies inside a Workflow Instance. An index is necessary to query workitems by a EQL statement. Each workflow System and also the IX JEE Workflow Components are adding indexes automatically after deployment.
The Index Management allows you to delete an existing Index or add a new index one.
Notice: adding or deleting can take a long time if a lot of workitems need to be updated. Adding or deleting a index will not loose data.
Search Workitems
The IX JEE Admin client supports a function to search Workitems. This gives you a powerful feature to query workitems in a existing Workflow Instance. So a Adminstrator is able to control or verify the content of workitems. As the Administrator is granted to the Role "IMIXS-WORKFLOW-Manager" it is possible to read any dataset indpended form the individual read access of a singel workitem!
Also this feature gives you the possibility to test a EQL statement before implementing a statement into a business logic.
Read more about using Queries based on EQL here .
The search function also allows you to delete one or a set of worktiems.
Notice: Be carefull to use the delete/remove function!
View Model Versions
Using the funktion "Models" allows you to inspect all deployed workflow models on a running IX JEE Workflow Instnace.
For each deployed model you can see the creation date and the version number of the model. To delete a model version you can call the "delete" function for a specific model version.
Import & Export
With the Import and Export feature you can export Entities into a filesytem and later reimport them into a exsiting Workflow Instance
To export a Collection of Workitems you need to spcify a EQL Statement. You can test the statement befor a export using the search function. The export will be stored into a binary file specified by the export page.
With the import function you can import / reimport an exisitng export file int a workflow Instance. The import function will override exsisting Worktiems with the same $uniqueID. So be carfull if you import a subset of data.
