manageQueryTable.py administrative script
Use the manageQueryTable.py administrative script to deploy, undeploy, and update query tables in Business Process Choreographer. This script can also list query tables and to list the XML definition of a query table.
Prerequisites
The following conditions must be met:- Run the script in the connected mode, that is,
do not use the wsadmin
-conntype noneoption. - Run the script on the deployment manager node.
- Include the wsadmin
-userand-passwordoptions to specify a user ID that has administrator or deployer authority.
Location
install_root\ProcessChoreographer\admin

install_root/ProcessChoreographer/adminSyntax

install_root/bin/wsadmin.sh
install_root\bin\wsadmin
-f manageQueryTable.py
-cluster clusterName
( ( -deploy (qtdFile | jarFile)) |
(-undeploy queryTableName) |
(-update definition (qtdFile | jarFile)) |
(-query names -kind (composite | predefined | supplemental)) |
(-query definition -name queryTableName))
Parameters
- -f
- This parameter specifies the script file to run.
- -cluster clusterName
- The name of the cluster where Business Process Choreographer is configured. In a multicluster setup, you must specify the application cluster because that is where Business Process Choreographer is configured.
- -deploy qtdFile | jarFile
- The file name, including the fully qualified path, of either the
query table definition XML file to be deployed or a JAR file that
contains the definitions. Use this option to deploy a query table.
On Windows, you must use either /
or\\\\
as the path separator. For example, to specify the filec:\temp\myQueryTable.qtdyou must specify it asc:/temp/myQueryTable.qtdorc:\\\\temp\\\\myQueryTable.qtd. - -undeploy queryTableName
- The name of the query table. Use this option to undeploy a query table.
- -update definition qtdFile | jarFile
- The file name, including the fully qualified path, of either the
query table definition XML file to be updated or a JAR file that contains
the definitions. Use this option to update an existing query table.
On Windows, you must use either /
or\\\\
as the path separator. For example, to specify the filec:\temp\myQueryTable.qtdyou must specify it asc:/temp/myQueryTable.qtdorc:\\\\temp\\\\myQueryTable.qtd.If a JAR file is provided, it can contain multiple QTD files and property files for each QTD file, which contain display names and descriptions. Use the Query Table Builder to export query table definitions as a JAR file.
- -query names -kind | composite | predefined | supplemental
- The type of query table: composite, predefined, or supplemental. Use this option to list the names of deployed query tables of a particular type.
- -query definition -name queryTableName
- The name of the query table, in uppercase. Use this option to list the XML definition of a deployed supplemental or composite query table.
Examples
Deploy composite and supplemental query tables:

Enter the following
command:
wsadmin.sh -f manageQueryTable.py -cluster myCluster -deploy sample.qtd
Enter the following command:
wsadmin -f manageQueryTable.py -cluster myCluster -deploy sample.qtd
Undeploy composite and supplemental query tables:

Enter the following
command:
wsadmin.sh -f manageQueryTable.py -cluster myCluster -undeploy COMPANY.SAMPLE
Enter the following command:
wsadmin -f manageQueryTable.py -cluster myCluster -undeploy COMPANY.SAMPLEUpdate composite and supplemental query tables:

Enter the following
command:
wsadmin.sh -f manageQueryTable.py -cluster myCluster
-update definition sample_v2.qtd
Enter the following command:
wsadmin -f manageQueryTable.py -cluster myCluster
-update definition sample_v2.qtd
Retrieve a list of query tables:

Enter the following
command:
wsadmin.sh -f manageQueryTable.py -cluster myCluster
-query names -kind composite
Enter the following command:
wsadmin -f manageQueryTable.py -cluster myCluster
-query names -kind composite
Retrieve the XML definitions of query tables:

Enter the following
command:
wsadmin.sh -f manageQueryTable.py -cluster myCluster
-query definition -name COMPANY.SAMPLE
Enter the following command:
wsadmin -f manageQueryTable.py -cluster myCluster
-query definition -name COMPANY.SAMPLE