This chapter discusses how to configure the client to launch from another web application.
The web application invokes the client via a web address. Parameters such as the workspace, capture source, client profile, document profile, and optional metadata values are passed within the address.
For example, you might add a Scan button to a line of business web application. After completing business application entry fields, the user clicks Scan. The client window displays to the user and Capture immediately begins scanning a document using a specified scanner and settings in the client profile specified in the web address. Once scanned, the document is displayed in the document pane. Metadata fields are automatically populated with user entries, which were passed in the web address. The user reviews the document and completes other metadata fields, then releases the batch, scans additional batches, or closes the browser. Upon close, the user returns to the line of business web application.
To configure an integration between a web application and the Capture client:
In the web application, add a launching point, such as a Scan button, from which to activate the client.
Configure the web address and its parameters.
Parameters are listed and described in Table 3-1.
See the example integration configuration in Section 3.1.1.
If needed, configure Single Sign-on (SSO) to prevent users from having to sign in to Capture before beginning scanning.
Table 3-1 Client Integration URL Parameters
Parameter | Description |
---|---|
CaptureWorkspace |
Specifies the workspace to which to capture documents. |
ClientProfile |
Optionally specifies the client profile with which to capture documents. If you specify a profile, the Client Profile field does not display in the client's batch pane. If no profile is specified, the client uses the client profile that was last used by the user on the system. |
CaptureDriver |
Specifies the driver to use to capture documents.
If neither driver ID or source name are specified, the last used driver and source are used. |
CaptureSource |
Specify the source to use to capture documents, based on the selected CaptureDriver.
If neither driver ID or source name are specified, the client uses the driver and source that were last used by the user on the system. |
SignOutOnRelease |
Specify whether the business user is signed out of Capture after releasing a batch.
|
SignOutAction |
Specifies the action that occurs after the user is signed out.
|
ShowAllBatches |
Specifies if batches display in a list to client users in the batch pane.
|
DocumentProfile |
Specifies the document profile for users to use to index documents.
|
Other |
Any other characters included in the URL are assumed to be a metadata names and values. |
Here is an example URL. (Note that this URL should be all on one line.)
http://svr-capture:16400/dc-client/faces/dc-client?CaptureWorkspace=Accounting&ClientProfile=Import%20Invoices&CaptureDriver=CAPTURE_IMPORT_DRIVER&CaptureSource=Import%20Source&SignOutOnRelease=1&SignOutAction=CloseBrowser&Company=MyCompany&Dept=Accounting
This web address configures the client integration as follows:
CaptureWorkspace=Accounting
- Specifies Accounting as the workspace to which to capture documents.
ClientProfile=Import Invoices
- Specifies Import Invoices as the client profile to use.
CaptureDriver=CAPTURE_IMPORT_DRIVER
- Specifies importing CAPTURE_IMPORT_DRIVER as the capture source rather than scanning.
CaptureSource=Import Source
- Specifies Import Source as the capture source.
SignOutOnRelease=1&SignOutAction=CloseBrowser
- 1&SignOutAction=CloseBrowser specifies that the user is signed out after releasing a batch and the browser closes.
Company=MyCompany
- Passes a value of MyCompany for the Company metadata field.
Dept=Accounting
- Passes a value of Accounting for the Dept metadata field.