Creating P8 queues and workflows

Edit online

The documents that are to be linked must be available as work items in a P8 queue. You must create the P8 queues, and you must create the workflows that make these documents available in the P8 queues.

Before you begin

Documents with bar codes must have the property named Barcode, which is of data type string with a maximum length of 40 characters.

About this task

To enable the Collector Server instance to perform certain tasks, such as processing the bar codes of the documents, the workflow and the P8 queues must meet the following requirements:

Because a queue can contain documents from several workflows, the name of the workflow must have the following format: <sap_system>_<archive_id>_<p8_queue_name>

<sap_system>

Specify the ID of the SAP system that the instance is to log on to.
Where to find the information in Configuration Feature:
SAP System > General > General > SAP system ID

<archive_id>

Specify the ID of the logical FileNet® P8 archive that contains the documents that are to be linked.
Where to find the information in Configuration Feature:
Logical Archives > Overview > Logical Archive ID

<p8_queue_name>

Specify the name of the P8 queue that is to receive the documents that are to be linked.
Where to find the information in Configuration Feature:
Logical Archives > Logical IBM Content Manager Archive id > Linking of Documents in a P8 Queue > Queue name

The Linking of Documents in a P8 Queue section has been renamed to Document Linking.

Important: Ensure that the workflow name has a maximum length of 31 characters.

Example for a workflow name: EC5_Y5_BarcodeQueue
The workflow must have the following properties:
- A field of data type string, named DWRemark. This field is used to store error messages that might occur during bar-code processing. Documents are only linked if this field is empty.
  The length of the field must be specified in bytes. The field must be long enough to hold 100 English ASCII characters. If you use a multibyte character set, characters do not equal bytes. Check the code page of your database to determine the number of bytes per character and to calculate the minimum length of the DWRemark field in bytes.
- An attachment of a data type other than array, named DocumentNumber.
  This attachment contains the document ID of the document that is to be linked.
Create an index on the P8 queue. The name of the index must be DWIndex. The index must contain these fields in this sequence:
1. F_Class
2. F_LOCKED
3. DWRemark
4. F_EnqueueTime
Create the index by using Process Configuration Console. For more information, see the IBM® FileNet P8 product documentation (www.ibm.com/support/knowledgecenter/SSNW2F/welcome).
Expose the fields F_CLASS and DWRemark in the P8 queue. These fields are used in an internal search.
Expose the fields by using Process Configuration Console.

Note: The names Barcode and DWRemark are case-sensitive and must not be changed. If these names exist in your environment, you must create a property-name mapping file, in which you map these names to the names of your choice. For example, if you want to use bar_code instead of Barcode and remarks instead of DWRemark, specify the following entries in the property-name mapping file:

INTERNAL_BARCODE  bar_code
INTERNAL_DWREMARK remarks

Content Collector for SAP provides a sample workflow definition that is designed for processing bar codes. This workflow definition is available in the file WorkflowGeneration.pep, which you find in the following path:

InstallHome/samples
InstallHome\samples

Integrate this sample into your Workplace or Workplace XT and change it according to your needs.

For more information about how to create P8 queues and workflows, see the FileNet P8 Platform documentation (www.ibm.com/support/knowledgecenter/SSNW2F/welcome). The following procedure shows how to integrate the sample workflow definition into your Workplace XT:

Procedure

Start Workplace XT by using the following web address:
```
http://hostname:portnumber/WorkplaceXT
```
Log on to Workplace XT as an administrator.
Click Tools > Advanced Tools > Process Designer.
Accept any security certificates for signed applets that are displayed to you.
In the Process Designer window, click File > Open, go to InstallHome and then select the file WorkflowGeneration.pep.
The sample workflow definition is imported, the name of the workflow is displayed on the tab, and an icon is added to the Workflow area.
Click the new icon to view and change the workflow properties, which are shown on the right.