Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 7 Case Data Queue Parameters : Exporting CDQP Configuration Data

Exporting CDQP Configuration Data
You can export CDQP definitions and mappings - either for the entire system, or for specific queues - using the following command:
swutil QINFO EXPORT [queuename [GLOBAL]]
where:
queuename is the name of the iProcess queue for which CDQP mappings are to be exported. If queuename is omitted, all CDQP data is exported - CDQP definitions, default user/group mappings and all defined user/group queue mappings.
You can also use any of the following keywords in place of a queuename:
SW_DEFAULT_CASEDATAQPARAM_USER indicates that the default user queue mappings should be exported.
SW_DEFAULT_CASEDATAQPARAM_GROUP indicates that the default group queue mappings should be exported.
SW_DEFAULT_CASEDATAQPARAM_GLOBAL indicates that only CDQP definitions should be exported (without any queue mappings).
GLOBAL indicates that CDQP definitions are to be exported, along with whatever queue mappings are defined by the queuename parameter.
Using the command swutil QINFO EXPORT SW_DEFAULT_CASEDATAQPARAM_GLOBAL GLOBAL will generate only one copy of CDQP definitions.
You must be logged in as the IPEADMIN user to use this command. You can use the command whether or not the iProcess Engine is running.
See swutil QINFO Exit Codes and Error Messages for a list of exit codes and error messages that the command can return.
Configuration data is written to the standard output device, but can be redirected to a file - either for reference or for editing and subsequent re-importing. See CDQP Control File.
Export File Format
The exported file will contain some or all of the following sections, in this order:
1.
A Reset command (if a specific queue is not being exported).
2.
3.
4.
5.
CDQP Filter Identifiers
The queue mappings in the export file contain (as comments) unique filter identifiers for each mapped field in a queue, in the format:
dn
where n is a unique integer indicating the order that the field was mapped to the queue. For example, d3 is the 3rd field mapped to this queue.
You can use these filter identifiers to create additional filter parameters when starting TIBCO iProcess Workspace (Windows) from command line, to:
filter the work queue (staffw OPENWQS FILTER)
See TIBCO iProcess Workspace (Windows) User's Guide for more information about how to use these filter identifiers.
Export File Examples
Example 1
This example shows output from the command:
swutil QINFO EXPORT
which exports all CDQP configuration data on the system.

 
R

; CDQP definitions
F+DRIVER_NAME,30,Driver Name
F+TOWN,20,Town/City
F+AGE,3,Age

; Default Group CDQP mappings
Q+SW_DEFAULT_CASEDATAQPARAM_GROUP
; d1
C+DRIVER_NAME

; Default User CDQP mappings
Q+SW_DEFAULT_CASEDATAQPARAM_USER
; d1
C+DRIVER_NAME

; Queue CDQP mappings
Q+usr30
; d1
C+AGE
; d2
C+DRIVER_NAME

Q+usr31
; d1
C+AGE
; d2
C+DRIVER_NAME

Q+grp40
; d1
C+DRIVER_NAME
; d2
C+TOWN
; d3
C+AGE

 
Example 2
This example shows output from the command:
swutil QINFO EXPORT grp40
which exports just the queue mappings for the group queue grp40.

 
; Queue CDQP mappings
Q+grp40
; d1
C+DRIVER_NAME
; d2
C+TOWN
; d3
C+AGE

 
Example 3
This example shows output from the command:
swutil QINFO EXPORT usr30 GLOBAL
which exports both CDQP definitions, and the queue mappings for the user queue usr30.

 
; CDQP definitions
F+DRIVER_NAME,30,Driver Name
F+TOWN,20,Town/City
F+AGE,3,Age

; Queue CDQP mappings
Q+usr30
; d1
C+AGE
; d2
C+DRIVER_NAME

 
Example 4
This example shows output from the command:
swutil QINFO EXPORT SW_DEFAULT_CASEDATAQPARAM_USER GLOBAL
which exports the CDQP definitions and the default user queue mappings.

 
; CDQP definitions
F+DRIVER_NAME,30,Driver Name
F+TOWN,20,Town/City
F+AGE,3,Age

; Queue CDQP mappings
Q+SW_DEFAULT_CASEDATAQPARAM_USER
; d1
C+DRIVER_NAME

 

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved