20 Oracle WebCenter Capture Custom WLST Commands

This chapter provides detailed descriptions of custom WLST commands for Oracle WebCenter Capture, including command syntax, arguments and command examples.

The following sections describe the custom WLST commands for Oracle WebCenter Capture. These commands enable you to access and modify various configuration parameters for Oracle WebCenter Capture from the command line. Topics include:

For information about Capture workspace console use, see Oracle Fusion Middleware Managing Oracle WebCenter Capture.

Note:

To use the Oracle WebCenter Capture custom commands, you must invoke the WLST script from the Oracle Common home in which the component has been installed. Either connect to the Oracle WebLogic Server managed server (default port 16400) on which the Oracle WebCenter Capture application is deployed, or connect to the Oracle WebLogic Server administration server and change your location to domainRuntime by executing the command: domainRuntime()

See "Using Custom WLST Commands" in Oracle Fusion Middleware Administrator's Guide.

Overview of WLST Oracle WebCenter Capture Command Categories

WLST Oracle WebCenter Capture commands are covered in the following category:

Table 20-1 WLST Oracle WebCenter Capture Command Categories

Command Category Description

Configuration Commands

View and manage configuration for Oracle WebCenter Capture.


Configuration Commands

Use the commands in Table 20-2 to configure Oracle WebCenter Capture.

Table 20-2 WLST Server Oracle WebCenter Capture Configuration Commands

Use this command... To... Use with WLST...

listWorkspaces

List all of the workspaces to which the administrator or workspace manager has access.

Online

listBatches

List all of the batches within a specified workspace.

Online

exportBatch

Export a batch including images and metadata to a specified file.

Online

exportWorkspace

Export an entire workspace including documents, metadata, scripts, profiles and jobs to an XML file.

Online

importWorkspace

Import a workspace from a XML file generated with the exportWorkspace command.

Online

unlockBatch

Delete the batch lock record for the specified batch.

Online

listLockedBatches

Display the list of locked batches.

Online

listCaptureConfig

Display the list of all Capture configuration attributes with their values.

Online

getCaptureConfig

Fetch the value of the attribute specified as an argument.

Online

setCaptureConfig

Set the value of the Capture attribute to the provided value.

Online

scanForClientBundles

Scan the client bundle directory for bundles.

Online

deleteBundle

Delete an existing bundle.

Online


listWorkspaces

Use with WLST: Online.

Description

Lists all workspaces to which the administrator or workspace manager has access.

Syntax

listWorkspaces()

Example

The following example lists all of the workspaces, preceded by their IDs.

listWorkspaces()
4 bills_workspace
2 certificates_workspace
5 receipts_workspace

listBatches

Use with WLST: Online.

Description

Lists all batches for the workspace specified by its ID. Each batch listed has five columns (displayed in this order): Batch ID, Batch Name, Created By (user), Last Updated By (user), and Last Modified (date).

Syntax

listBatches (WORKSPACE_ID)
Argument Definition

WORKSPACE_ID

ID number for a workspace. Can be optionally specified within single quotes. For example, both 3 and '3' are valid arguments for a workspace with ID 3.


Example

The following example lists the batches for the workspace ID 3.

wls:/base_domain/domainRuntime> listBatches(1)
14 ABI1 <anonymous> <anonymous> 4/26/13
15 ABI2 <anonymous> <anonymous> 4/26/13
1 BCP11 captureuser <anonymous. 4/17/13

exportBatch

Use with WLST: Online.

Description

Exports a batch including images and metadata to a specified file.

Syntax

exportBatch(BATCH_ID,'FILE_NAME')
Argument Definition

BATCH_ID

ID number for a batch. Can be optionally specified within single quotes. For example, both 3 and '3' are valid arguments for a batch with ID 3.

FILE_NAME

Name of the file to which the batch will be exported. The file name must be specified along with its complete path.


Example

The following example exports a batch.

exportBatch(8,'/home/abc/batch8.xml')
Batch successfully exported

exportWorkspace

Use with WLST: Online.

Description

Exports an entire workspace including documents, metadata, scripts, profiles and jobs to an XML file.

Syntax

exportWorkspace(WORKSPACE_ID,'FILE_NAME')
Argument Definition

WORKSPACE_ID

ID number for a workspace. Can be optionally specified within single quotes. For example, both 3 and '3' are valid arguments for a workspace with ID 3.

FILE_NAME

Name of the file to which the workspace will be exported. The file name must be specified along with its complete path.


Example

The following example exports the workspace with the ID of workspace3.

exportWorkspace(3,'/home/abc/workspace3.xml')
Workspace successfully exported

importWorkspace

Use with WLST: Online.

Description

Imports a workspace from a XML file generated with the exportWorkspace command. The workspace being imported must not exist in the Oracle WebCenter Capture database.

Syntax

importWorkspace('FILE_NAME')
Argument Definition

FILE_NAME

Name of the XML file from which a workspace is imported. The file name must be specified along with its complete path.


Examples

The following example imports a workspace with the file name of workspace3.

importWorkspace('/home/abc/workspace3.xml')
Workspace successfully imported

unlockBatch

Use with WLST: Online.

Description

Deletes the batch lock record for the specified batch. The batch will be put into a READY state so that it can be opened by the client.

Syntax

unlockBatch('BATCH_ID')
Argument Definition

BATCH_ID

ID number for a batch. Can be optionally specified within single quotes. For example, both 3 and '3' are valid arguments for a batch with ID 3.


Example

The following example unlocks a batch ID 8.

unlockBatch('8')
Batch successfully unlocked

listLockedBatches

Use with WLST: Online.

Description

Displays the list of locked batches. Each batch listed has six columns (displayed in this order): Workspace ID, Batch ID, Batch Name, Created By (user), Workstation (name/IP address), Last Modified (date).

Syntax

listLockedBatches('WORKSPACE_ID')
Argument Definition

WORKSPACE_ID

ID number for a workspace. Can be optionally specified within single quotes. For example, both 3 and '3' are valid arguments for a workspace with ID 3.


Example

The following example lists locked batches for the workspace ID 3.

wls:/base_domain/domainRuntime> listLockedBatches(1)
1 14 ABI1 <anonymous> sic01lzz.example.com 4/26/13
1 15 ABI2 <anonymous> slc01lzz.example.xom 4/26/13
1 17 BCP16 <captureuser> 10 159 104 189 4/30/13

listCaptureConfig

Use with WLST: Online.

Description

Displays the list of all Capture configuration attributes with their values. If a value cannot be fetched, it will be shown as "VALUE CANNOT BE DISPLAYED". The most likely cause of an unfetched value is insufficient privilege.

Syntax

listCaptureConfig()

Example

The following example lists Capture configuration attributes and values.

listCaptureConfig()
CaptureSystemID CAPTURE_01
BatchRefreshLimit 5

getCaptureConfig

Use with WLST: Online.

Description

Fetches the value of the attribute specified as an argument. The attribute name must be a string.

Syntax

getCaptureConfig(['NAME_OF_ATTRIBUTE'])
Argument Definition

NAME_OF_ATTRIBUTE

Name of attribute (as a string) for Capture configuration.


Example

The following example fetches the value of the attribute for the Capture system ID.

getCaptureConfig('CaptureSYSTEMID')
CAPTURE_01

setCaptureConfig

Use with WLST: Online.

Description

Sets the value of the Capture attribute to the provided value.

Syntax

setCaptureConfig(['NAME_OF_ATTRIBUTE'],['VALUE_OF_ATTRIBUTE'])
Argument Definition

NAME_OF_ATTRIBUTE

Name of Capture configuration attribute to configure.

VALUE_OF_ATTRIBUTE

Value to set for the Capture configuration attribute.


Example

The following example sets the CaptureSystemID attribute to the value CAPTURE_02.

setCaptureConfig('CaptureSystemID','CAPTURE_02')
Attribute 'CaptureSystemID' changed to "CAPTURE_02'

scanForClientBundles

Use with WLST: Online.

Description

Scans the client bundle directory for bundles. Data for existing bundles will be updated and information for new bundles will be loaded and cached in the database.

Syntax

scanForClientBundles()

Example

The following example scans for bundles and lists processed bundles.

scanForclientBundles()
Processed capture bundle.jar

deleteBundle

Use with WLST: Online.

Description

Deletes an existing bundle.

Syntax

deleteBundle('bundlename')
Argument Definition

bundlename

Name of an existing bundle to delete.


Example

The following example deletes the specified bundle.

deleteBundle('Example'}