8 Managing Commit Processing

As the final step in Capture processing, committing applies the settings in commit profiles defined for the workspace, and outputs batch documents and their metadata in a selected output format to a specific location or content repository. After batches are successfully committed, they are permanently removed from the Capture workspace.

This chapter describes how you configure and manage commit profiles and their processing for a workspace. It includes the following sections:

8.1 Introduction to Commit Processing

This section covers the following topics:

8.1.1 Methods of Committing Documents

Organizations choose to commit batches in a variety of ways, depending on configuration and needs.

  • Some organizations use the WebCenter Content Commit Driver or WebCenter Content Imaging Commit Driver to commit documents directly into these content repositories.

  • Some organizations use the Text File Commit Driver to output to a folder and list file, for later use in a variety of ways. Another process might process the documents for intelligent data recognition (for example, using Oracle WebCenter Forms Recognition), or import documents independently into their content management system. You can customize the contents of commit text files, but they typically contain a reference to each document file and associated metadata values.

You can configure multiple commit profiles to process for a workspace. For example, one commit profile may commit documents to a content management system, while another commits to a text file. A Service Bureau might output to a commit text file containing references to images, then FTP the information to clients. Still another organization might commit directly into their content management system and create a commit text file for backup, to be kept for 90 days or archived permanently.

Figure 8-1 Commit Profile General Settings

Description of Figure 8-1 follows
Description of "Figure 8-1 Commit Profile General Settings"

8.1.2 About Image Document Output Formats

Regardless of the format in which image documents were captured or stored in Capture, you can output them to one of the following formats upon commit:

  • TIFF Multi-Page: Outputs documents to multiple page, Group 4 TIFF format.

  • PDF Image-Only: Outputs documents to PDF/A format.

  • PDF Searchable: Outputs documents to PDF (portable document format) with hidden text to facilitate full-text searching of the document.

Caution:

The text generated from OCR results for Searchable PDF documents CANNOT be edited and may contain errors.

8.1.3 How Non-Image Documents Are Committed

Non-image documents include files such as Microsoft Word, Microsoft Excel, PDF, or EML documents. Depending on configuration, non-image files may be retained in their native format in Capture. At commit, non-image documents are processed differently than image documents:

  • Non-image documents remain in their native format and are not converted to TIFF or PDF format. The document output setting is ignored for all non-image documents in the batch, but applied to any image documents.

    For example, a Microsoft Word document committed by a commit profile configured to output Searchable PDF is committed to the repository as a Word document. Similarly, email messages captured and stored in EML format and output to Content Server are committed in EML format regardless of the commit profile's selected document output format.

  • Once non-image documents have been successfully committed by all online and applicable commit profiles, they are deleted from the Capture workspace just like image documents.

8.1.4 How Commit Profiles are Applied During Commit Processing

Batches arriving at commit processing are ready to undergo processing by one or more commit profiles defined for the workspace. A batch may be uniform (for example, consisting of all image documents that use the same document profile) or varied (for example, consisting of image and non-image documents assigned different document profiles). Regardless, batch committing follows this general process:

  1. For a batch to reach commit, Commit Processor must be selected as a post-processing step in the client profile or processor job.

  2. Capture runs all commit profiles defined for the workspace on the batch, subject to the following rules:

    1. Commit profiles run one at a time, in the order in which they are specified on the workspace's Commit tab.

    2. Commit profiles must be Online. Changing a profile to Offline deactivates its use in commit processing for the workspace.

    3. A commit profile skips processing any documents whose assigned document profile does not match the document profiles assigned to the commit profile. See Section 8.5.

    4. As Capture processes each document, it verifies that required metadata fields are complete. An error occurs for a document if required fields do not contain values.

    5. If an error is encountered, commit processing may skip the document, skip the commit profile, or cancel commit processing, as described in Section 8.1.5.

  3. Capture commits documents in the batch. If all documents are committed, the batch is deleted from the workspace.

    1. Capture continues to commit all the documents within the batch, repeating this process until all commit profiles have been executed or an error occurs which causes the entire commit process to be canceled.

    2. As each document is successfully committed within a batch, Capture removes the document's files and associated metadata from the batch. When there are no remaining documents in the batch, Capture deletes the batch.

      If a document fails to be committed, it remains in the batch and an error is generated.

    3. A commit batch audit record is added to the audit table.

8.1.5 About Commit Error Handling

Use a commit profile's error handling options to specify what happens when errors are encountered during batch committing. If an error is encountered, you can:

  • Skip to the next document

    This option skips committing the current document and begins committing the next document in the batch.

  • Skip to the next commit profile

    This option stops the current commit profile from executing and begins processing the next commit profile (if specified).

  • Cancel the commit

    This option stops the entire commit process, including any other commit profiles, from executing.

During commit, a record is maintained that indicates if a document has been successfully committed with a commit profile. When a document is about to be committed by a commit profile, a check is performed to see if the document has already been successfully committed by the commit profile. If it has, the document will not be reattempted.

Regardless of error settings, all documents in which an error is encountered remain in the batch until the error is resolved and they are successfully committed.

8.1.6 About Documents Remaining After Commit

If uncommitted documents remain in a batch after all commit profiles have been executed, the batch lock is cleared and the batch is put in a ready state so that it can be opened in the Capture client.

8.1.7 About Commit Processing Logging

The Capture system administrator can consult the Commit Processor performance metrics and logs to address commit processing issues and errors. For more information, see Oracle Fusion Middleware Administering Oracle WebCenter Capture.

8.2 Adding, Copying, or Editing a Commit Profile

To add, copy, or edit a commit profile:

  1. In a selected workspace, click the Commit tab.

  2. In the Commit Profiles table, click the Add button or select a commit profile and click the Edit button.

    You can also copy a commit profile by selecting one, clicking the Copy button, and entering a new name when prompted. Copying a commit profile allows you to quickly duplicate and modify it.

  3. Complete settings on the General Settings train stop.

    1. Enter a name in the Commit Profile Name field.

    2. Ensure that the Online field is selected. When online, the commit profile is executed whenever a batch for the workspace is processed by the Commit Processor. See Section 8.4.

    3. In the Commit Driver field, select the method by which the profile commits batches. See Section 8.1.1.

    4. In the Document Output Format field, specify the format in which to commit image documents. See Section 8.1.2 and Section 8.10.

    5. In the Error Handling Policy field, specify what happens if an error is encountered in one or more documents in the batch being committed. See Section 8.1.5.

    6. In the Restrict Commit to Document Profiles field, select one or more document profiles to restrict the commit profile to only documents assigned those document profiles. See Section 8.5.

    7. If adding a text file commit profile, complete date format, locale, and encoding settings to be used in text files in the Default Date Format, Default Locale, and Encoding fields.

  4. On the Commit Driver Settings train stop, complete driver-specific settings.

    1. For text file, see Section 8.6.

    2. For WebCenter Content, see Section 8.7.

    3. For WebCenter Content Imaging, see Section 8.8.

  5. On the Document Output Settings train stop, specify settings for PDF Searchable output such as optional text file and OCR options. See Section 8.10.

    This train stop is available only if you selected PDF Searchable in the Document Output Format field on the General Settings train stop.

  6. Review settings on the Summary train stop and click Submit to save the commit profile.

  7. Configure how batches flow to commit processing. See Section 8.11.

  8. Activate the commit profile and specify execution order.

    All the online commit profiles are processed in the order in which they are listed on the Commit tab. For more information, see Section 8.4.

  9. Test the commit profile by committing a batch (for example, from the client). Search for and view the document in the repository or location specified in the commit profile. See Section 2.5.4.

8.3 Deleting a Commit Profile

Deleting a commit profile makes it unavailable for batches for which commit processing is set as a post-processing step. You may want to change a commit profile to offline for a time before deleting it, allowing you to resolve unexpected issues with its deletion.

To delete a commit profile:

  1. In a selected workspace, select the Commit tab.

  2. In the Commit Profiles table, select a profile to delete and click the Delete button.

    To deactivate a commit profile instead, select it and click the Toggle Online/Offline button.

  3. When prompted, click Yes to confirm the deletion.

8.4 Activating and Ordering Commit Profiles

Commit profiles apply to their entire workspace. When you specify Commit Processor as a post-processing step in a client profile or other processor job, all online commit profiles begin processing in the order in which they are listed on the Commit tab. You can limit their processing in several ways:

  • You can change a commit profile to Offline, as described below, which temporarily deactivates it.

  • In the commit profile, you can restrict committing to documents assigned one or more selected document profiles. This enables you to commit different types of documents into separate content management systems based on document profile. See Section 8.5.

To activate and order commit profile processing.

  1. In a selected workspace, click the Commit tab.

  2. To activate or deactivate a profile, select a profile in the Commit Profiles table and click the Toggle Online/Offline button.

    Active profiles display Online in the Status column, and inactive ones display Offline.

  3. Use the up and down buttons to order the commit profiles as needed.

    Note:

    Documents in which an error is encountered remain in the batch until the error is resolved and they are committed again.

8.5 Restricting a Commit Profile Based on Document Profile

As described in Section 8.1.4, when a batch reaches commit processing as a final post-processing step, the commit processor runs the batch through all online commit profiles as ordered on the Commit tab. However, you can prevent a commit profile from processing a document by restricting the commit profile to processing only documents assigned to specified document profiles. For example, you might use this method to configure one commit profile to commit Purchase Order documents to WebCenter Content Imaging and another commit profile to commit Customer Agreement documents to Content Server.

To restrict a commit profile's execution based on document profile:

  1. In a selected workspace, click the Commit tab.

  2. In the Commit Profiles table, select a commit profile and click the Edit button.

  3. In the Restrict Commit to Document Profiles field on the General Settings train stop, select one or more document profiles to commit only those documents assigned the selected document profiles.

8.6 Configuring a Text File Commit Profile

A text file commit profile creates a delimited text file that contains the full path to each document file, followed by document metadata. The document files are extracted from the batch and inserted into a folder beneath the specified commit folder.

You can configure text file commit driver settings. For example, you can specify where files are written, which values are written and delimited in the text file, and how files are named.

Figure 8-2 Text Commit Driver Settings

Description of Figure 8-2 follows
Description of "Figure 8-2 Text Commit Driver Settings"

To configure text file commit driver settings:

  1. In a selected workspace, create a commit profile. See Section 8.2.

  2. Select settings on the General Settings train stop.

    1. Select Text File in the Commit Driver field.

    2. In the Default Date Format, Default Locale, and Encoding fields, complete date format, locale, and encoding settings to be used in text files.

  3. Select the Commit Driver Settings train stop.

    Because you selected Text File as the commit driver, this train stop displays settings specific to text file commits.

  4. On the Text File Folder tab, specify how to write commit text files.

    1. In the Commit Text File Folder field, enter a location to which to write the commit text files. Use a fully qualified folder path relative to the Capture server operating system.

    2. Select the Store in subfolders field and its related field to store commit text files in subfolders named based on year, year and month, or year, month and date.

    3. In the File Prefix and File Extension fields, specify an optional prefix and extension.

  5. On the Document Folder tab, specify how to write the document files.

    1. In the Document Folder field, enter a location to which to write the document files. Use a fully qualified folder path relative to the Capture server operating system.

    2. Select the Create a folder per committed batch field to create a folder for each committed batch, where folders are named using the syntax BatchID.WorkspaceID.

    3. Under Subfolder Options, select Store in subfolders to store document files in subfolders, then specify how to name the subfolders. You can name subfolders based on year, year and month, or year, month and date.

      You can also name subfolders based on one or more metadata field values. Select Metadata Field(s), click Configure, and select and order one or more metadata fields; the Subfolder Path field displays the specified metadata subfolder path.

    4. In the If folder name consists of invalid characters field, specify how Capture should handle any invalid characters found in folder names (remove the characters or cancel the document's commit).

  6. On the Formatting tab, specify the metadata fields and delimiters to use in the commit text file.

    1. In the Field Delimiter field, specify the character to use to separate fields. If you choose Other, enter a character in the Other Character field that becomes available.

    2. In the Text Qualifier field, specify the character mark to use to identify the beginning and end of text fields.

    3. From the Available Fields list, select metadata fields to include in the commit text file and move them to the Selected Fields list. For example, you might include the two document file fields <File Name (full path)> and <File Name (relative path)>. Reorder the metadata fields as needed.

  7. On the Document File Naming tab, specify how to name the document files.

    1. Optionally select the Name document file based on Metadata field values field to name the document file based on one or more selected metadata field values. (If this field is not selected, Capture names the document files using the default naming scheme that includes the internal batch ID, an underscore, and a numeric identifier.) From the Available Fields list, select metadata fields to include and move them to the Selected Fields list.

    2. In the Field Delimiter field, specify the field delimiter to use (a space is the default).

    3. In the If folder name consists of invalid characters field, specify how Capture should handle any invalid characters found in document file names.

  8. Click Submit to save the commit profile.

  9. Test the commit profile.

    After committing a batch, locate the commit folder and view its contents, including text file and document files.

8.7 Configuring a WebCenter Content Commit Profile

This section covers the following topics:

8.7.1 About the WebCenter Content Commit Driver

Use the WebCenter Content Commit Driver to commit documents from Capture to Content Server. This commit driver uses the Content Server RIDC API.

Configuring the driver settings involves the following main steps. Detailed steps are provided in Section 8.7.2.

  1. Create a commit profile and select WebCenter Content as the commit driver.

  2. Connect to the Content Server instance after entering login information.

  3. Specify how to make the documents visible in Content, including how to title them, and who can view and access them. You can assign type, security group, and account values to documents using one of these methods:

    • Assign them a static value

    • Assign them based on Capture metadata field values

    • Assign them based on choice list values users select

  4. Map Capture metadata fields to Oracle Content Server fields. As documents are committed using this driver, metadata values entered in Capture are written into the specified Content Server fields.

    You can also add or edit custom fields and write Capture values to them during commit.

  5. Set additional options, such as document file naming, workflow bypass, and web service overrides.

Figure 8-3 Content Commit Driver Settings

Description of Figure 8-3 follows
Description of "Figure 8-3 Content Commit Driver Settings"

8.7.2 Configuring WebCenter Content Commit Driver Settings

To create a Content commit profile, you need login credentials to a Content Server instance. To configure WebCenter Content commit driver settings:

  1. In a selected workspace, create a commit profile. See Section 8.2.

  2. On the General Settings train stop, select WebCenter Content in the Commit Driver field.

  3. Select the Commit Driver Settings train stop.

    Because you selected WebCenter Content as the commit driver, this train stop displays settings specific to WebCenter Content commits.

  4. On the Login tab, enter a user name, password, and server URL to log in to the Content Server instance during commit. This user must have permission to check in content into Content Server. The user name and password are case sensitive. Use the following format for the server URL:

    http://hostname:port/cs/idcplg

    Click Login. Upon successful login, the status changes to Connected, and the remaining tabs become available.

  5. On the Check-In tab, specify where to make documents visible in Content, how to title them, and who can view and access them.

    1. For information about document titles, see Section 8.7.3.

    2. For information about specifying Type, Security Group, and Account metadata values, see Section 8.7.4.

  6. On the Field Mappings tab, map Capture metadata fields to Content Server fields. As documents are committed using this driver, metadata values entered in Capture are written into the specified Content Server fields. To map a Content Server field, select one and click the Edit button. In the window that displays, select the Capture field.

    When Assign Values Dynamically and By Field Mappings are selected on the Check-In tab, the following additional fields are displayed in the Content Server Field column on the Field Mappings tab: <Account>, <Content Type>, and <Security Group>. Mapping these fields allows metadata values to be dynamically assigned at commit, based on these Capture field values.

    For information about mapping to custom Content Server fields, see Section 8.7.5.

  7. On the Options tab, specify settings to customize the document check-in process, such as naming document files and providing an alternative check-in service. See Section 8.7.3.

8.7.3 Titling and Naming WebCenter Content Document Files

When committing files to Content Server, you can specify a document title and a document file name for them using a similar process.

To specify document titles or document file names:

  1. While creating a WebCenter Content commit profile (Section 8.7), display the title/file name builder window:

    1. For document titles, click the Configure button next to Document Title on the Check-In tab.

    2. For document file names, click the Configure button on the Options tab.

      The title or name builder window is displayed, as shown in Figure 8-4.

      Figure 8-4 Document File Name Builder

      Description of Figure 8-4 follows
      Description of "Figure 8-4 Document File Name Builder"

  2. Construct a document title or file name.

    From the Available Fields list, double-click a Capture field to add it to the title or name.

    Use the Document Title or Document File Name list to build the title or name. You can include the following elements:

    • Literal characters: Enter alphanumeric characters

    • Capture metadata fields

8.7.4 Assigning Metadata During a Content Server Commit

You can assign values to Content Server fields:

8.7.4.1 Using Static Values

When you assign values using this method, documents committed using the profile are assigned the metadata values selected from those available for the specified Content Server.

  1. On the Check-In tab of the Commit Driver Settings train stop configured for a WebCenter Content commit, select values in the Default Type, Default Security Group, and Default Account fields.

8.7.4.2 Based on Capture Metadata Values

When you assign values using this method, documents committed using the profile are assigned metadata values based on Capture field values.

  1. On the Check-In tab of the Commit Driver Settings train stop configured for a WebCenter Content commit, select the Assign Values Dynamically field, then choose By Field Mappings. This adds <Account>, <Content Type>, and <Security Group> metadata mappings to the Field Mappings tab.

  2. On the Field Mappings tab of the Commit Driver Settings train stop configured for a WebCenter Content commit, select a Capture metadata field for each of the metadata mappings fields.

    Note:

    If you do not map the <Content Type>, <Security Group>, or <Account> fields, the value specified in the corresponding <Default Type>, <Default Security Group>, or <Default Account> field on the Check-In tab is used.

8.7.4.3 Based on User's Choice List Selections

When you assign values using this method, a combination of metadata values is assigned based on a user's choice list selection. For example, if a user selects a value of Invoice from a choice list metadata field, the document might be assigned a type of ACCTG, a security group of Finance, and no account value (<No Account> selected).

This configuration requires either a user defined choice list (Section 3.5) or a database choice list (Section 3.6).

  1. On the Check-In tab of the Commit Driver Settings train stop configured for a WebCenter Content commit, select the Assign Values Dynamically field, then choose By Metadata Field.

  2. In the Metadata Field field, select the Capture field whose choice list value is used to assign type, security group, and account.

  3. In the Choice List Source field, select Capture Source or a previously created database choice list source.

  4. In the Choice List field, select the choice list from those available for the source you selected.

  5. In the Content Attribute Mapping table, click the Add button.

  6. In the Add/Edit Metadata Mappings window that displays, select one or more choice list values and select options in the Type, Security Group, and Account fields.

    • The Type, Security Group, and Account fields each contain a default option (for example, <DEFAULT TYPE>). Select one of these default options to use the value specified in the corresponding default field on the Check-In tab (for example, Default Type field). This can simplify changing the default for many mappings by changing the default value on the Check-In tab.

    • The Account field contains a <No Account> option that you can select to skip assigning a value to the Account metadata field. (Type and Security Group are required and cannot be skipped.)

  7. Repeat steps 5 and 6 to continue mapping field values.

8.7.5 Mapping to Custom Content Server Fields

In addition to mapping Capture metadata fields to assign to Content Server fields on the Field Mappings tab, as described in Section 8.7.2, you can map Capture fields to custom Content Server fields. You might do this, for example, when you have custom code running on the Content Server that specifically references these fields. (Without custom code, these custom fields are ignored.)

To add, edit, or delete custom Content Server fields for metadata mapping:

  1. On the Field Mappings tab (Section 8.7.2), click the Add button in the Custom Fields table.

  2. In the Add/Edit Custom Fields window, enter the custom field's name and a description of the custom field in Field Caption field.

8.8 Configuring a WebCenter Content Imaging Direct Commit Profile

Use the WebCenter Content Imaging Commit Driver to commit documents from Capture to WebCenter Content Imaging using one of these methods:

  • Direct Commit, where Capture connects to a WebCenter Content Imaging instance and commits documents directly into it, as described in this section.

  • Input Agent Commit, where Capture creates input files from Capture batches, which are then uploaded in bulk to WebCenter Content Imaging by its Input Agent service. See Section 8.9.

Note:

To support multiple configurations, create and activate multiple WebCenter Content Imaging commit profiles. For example, you might create a profile to commit documents directly and another to commit them via Input Agent.

This section covers the following topics:

8.8.1 About Direct Committing

With a direct commit profile, Capture logs into WebCenter Content Imaging and commits documents directly using WebCenter Content Imaging's web services. Creating this type of WebCenter Content Imaging commit profile involves the following configuration. Detailed steps are provided in Section 8.8.3.

  1. Create a commit profile and select WebCenter Content Imaging as the commit driver.

  2. Enter login information for the WebCenter Content Imaging commit driver to automatically connect to the WebCenter Content Imaging system.

    Note:

    Each time you commit using a WebCenter Content Imaging direct commit profile, Capture connects to the specified WebCenter Content Imaging instance, then logs out after the commit is complete.

  3. Specify direct commit as the commit method.

  4. Map Capture metadata fields to WebCenter Content Imaging application metadata fields.

    Note:

    To successfully commit documents, the data types of mapped Capture metadata fields and WebCenter Content Imaging application fields must match. If the commit driver detects a problem, such as incompatible fields, it displays or logs a message and stops the commit process.

  5. Optionally set the commit driver to search for existing WebCenter Content Imaging documents and append to them, if found. To search for matches, you select a search definition created in WebCenter Content Imaging.

Figure 8-5 WebCenter Content Imaging Commit Driver Settings (Direct Commit)

Description of Figure 8-5 follows
Description of "Figure 8-5 WebCenter Content Imaging Commit Driver Settings (Direct Commit)"

8.8.2 Searching For and Appending to WebCenter Content Imaging Documents

You can set the commit profile to search for matching documents during direct commits. When searching, Capture compares metadata values for the document being committed to search parameters specified in the selected WebCenter Content Imaging search definition. For more information about creating WebCenter Content Imaging search definitions, see Oracle Fusion Middleware Administering Oracle WebCenter Content: Imaging.

When searching and appending:

  • If Capture finds a match to an existing document, it appends the new document to the matched document.

  • If Capture does not find a match, a new document is created.

  • If Capture finds multiple matching documents, the document commit stops.

Important Points About Searching and Appending

  • The Searching and appending option is available for documents output in multiple page TIFF format only. (On the commit profile's General Settings train stop, the Document Output Format field must be set to TIFF Multi-Page).

  • Because the performance of searches affects the performance of the commit process, searches should be carefully defined and tuned.

  • The WebCenter Content Imaging search definition is integral to matching, and must reflect client profile settings in the workspace. For example, if a client profile contains five metadata fields but the search definition contains three fields only, searches are less specific, and documents considered separate documents in Capture could be appended to in WebCenter Content Imaging. In addition, the search definition must use AND conditions, not OR conditions.

  • Depending on the database used for the WebCenter Content Imaging server, the search may be case sensitive, meaning that if metadata values are identical but their case differs, no matching occurs.

8.8.3 Configuring Direct Commit Settings

Follow these steps to configure a commit profile that writes documents from Capture to WebCenter Content Imaging.

  1. In a selected workspace, add or edit a commit profile. See Section 8.2.

  2. On the General Settings train stop, select WebCenter Content Imaging in the Commit driver field.

  3. In the Document Output Format field, select TIFF Multi-Page.

  4. On the Commit Driver Settings train stop, log in to the WebCenter Content Imaging instance by specifying the User ID, Password, Security Policy, and Imaging WebService URL fields and click Connect. This user must have permission to check documents into WebCenter Content Imaging.

    http://hostname:port/imaging/ws

    Upon successful connection, Capture displays the connection status as Connected.

    Note:

    Each time users commit using the profile, Capture uses this login information to connect to WebCenter Content Imaging through the specified web service.

  5. On the General tab, leave the Direct Commit field selected as the commit method.

  6. On the Field Mappings tab, select the WebCenter Content Imaging application to commit to, and map Capture fields to WebCenter Content Imaging fields. Make sure that the data type of mapped fields match. Select an Imaging field and click the Edit button, then select the Capture field to map to. Repeat to map additional fields.

  7. On the Advanced tab, specify options for searching and appending. See Section 8.8.2.

    Searching requires a previously created search definition in WebCenter Content Imaging administration that specifies how documents are matched. If you select the Search and Append to Matching Imaging Documents field, select a definition in the Search Definition field.

8.9 Configuring a WebCenter Content Imaging Input Agent Commit Profile

Use the WebCenter Content Imaging commit driver to commit documents from Capture to WebCenter Content Imaging using one of these methods:

  • Direct Commit, where Capture connects to a WebCenter Content Imaging instance and commits documents directly into it. See Section 8.8.

  • Input Agent Commit, where Capture creates input files from Capture batches, which are then uploaded in bulk to WebCenter Content Imaging by its Input Agent service, as described in this section.

Note:

To support multiple configurations, create and activate multiple WebCenter Content Imaging commit profiles. For example, you might create a profile to commit documents directly and another to commit them via Input Agent.

This section covers the following topics:

8.9.1 About Input Agent Committing

During an Input Agent commit, Capture writes a delimited input file for the batch, along with its images, to a specified Capture output directory. The input file lists document images along with their associated metadata values for bulk uploading into WebCenter Content Imaging. The WebCenter Content Imaging Input Agent service monitors a specified Input Agent input directory and upon finding input files that match its input mask, uploads the files' referenced documents in bulk into WebCenter Content Imaging.

Creating this type of WebCenter Content Imaging commit profile involves the following configuration. Detailed steps are provided in Section 8.9.2.

  1. Create a commit profile and select WebCenter Content Imaging as the commit driver.

  2. Enter login information for the WebCenter Content Imaging commit driver to connect to the WebCenter Content Imaging system for field mapping definition.

  3. Select Input Agent Commit as the commit method. Then specify the Capture output directory to which Capture writes input files and images upon commit. In addition, you also specify the Input Agent input directory from which the WebCenter Content Imaging Input Agent uploads documents.

    Note:

    These settings identify the same directory but in different ways. For example, if Capture is running on a Windows system and WebCenter Content Imaging is running on a Linux system, these fields would contain different paths to the same location.

  4. Map Capture metadata fields to a selected WebCenter Content Imaging input definition.

    Note:

    When committing documents indirectly using input files, Capture metadata and WebCenter Content Imaging application fields do not have to match. However, you must ensure that your input file definitions are correct so they correspond to the input files generated by Capture.

8.9.1.1 About Input Definitions

Configuring an Input Agent commit requires an input definition created in WebCenter Content Imaging's Manage Inputs area. For information, see Oracle Fusion Middleware Administering Oracle WebCenter Content: Imaging.

Creating an input definition in WebCenter Content Imaging includes these steps:

  1. Upload a sample file that specifies how input files from Capture are composed. The sample file also specifies how input files are named, as described in Section 8.9.1.2.

  2. Specify the application in which to write Capture metadata values as metadata values based on field mapping.

  3. Based on the sample file, define an input mask that the Input Agent uses to locate files for input. For example, if you specify a mask of ServiceReportsInput*.txt, the Input Agent finds and processes input files that begin with that name.

  4. Define a delimiter that specifies the character by which values in the input text file are separated. For example, enter a pipe (|) character.

8.9.1.2 How Capture Names Input Files Upon Commit

Capture names input files it creates upon commit based on the file attributes defined in the corresponding WebCenter Content Imaging input definition.

8.9.2 Configuring Input Agent Settings

Follow these steps to configure a commit profile that writes input files from Capture to WebCenter Content Imaging for processing by a WebCenter Content Imaging Input Agent. Also see Section 8.9.1.

Note:

A WebCenter Content Imaging input definition is required for configuring an Input Agent commit. For more information, see Oracle Fusion Middleware Administering Oracle WebCenter Content: Imaging.

Figure 8-6 WebCenter Content Imaging Commit Driver Settings (Input Agent Commit)

Description of Figure 8-6 follows
Description of "Figure 8-6 WebCenter Content Imaging Commit Driver Settings (Input Agent Commit)"

  1. In a selected workspace, add or edit a commit profile. See Section 8.2.

  2. On the General Settings train stop, select WebCenter Content Imaging in the Commit Driver field.

  3. On the Login tab of the Commit Driver Settings train stop, log in to the WebCenter Content Imaging instance by specifying the User ID, Password, Security Policy, and Imaging WebService URL fields and clicking Connect.

    http://hostname:port/imaging/ws

    Upon successful connection, Capture displays the connection status as Connected.

    Note:

    Each time users commit using the profile, Capture uses this login information to connect to WebCenter Content Imaging through the specified web service.

  4. On the General tab, select Input Agent Commit as the commit method.

  5. In the Input Agent Directory field, select a directory configured for the selected WebCenter Content Imaging instance.

  6. In the Capture Output Directory field, specify the directory into which to write the input files and images. Use a fully qualified folder path relative to the Capture server operating system.

    Note:

    The Capture output directory and the Input Agent input directory refer to the same location in different ways.

  7. In the Imaging Input Definition field on the Field Mappings tab, select the application to commit to, and map Capture fields to Imaging fields. Make sure that the data type of mapped fields match. Select an Imaging field and click the Edit button, then select the Capture field to map to. Repeat to map additional fields.

8.10 Configuring PDF Searchable Document Output

If you specified a document output format of PDF Searchable on the General Settings train stop, complete fields on the Document Output Settings tab to configure additional settings related to this output.

  1. In a selected workspace, add or edit a commit profile. See Section 8.2.

  2. Complete settings on the Document Output Settings train stop.

    1. In the Optional Text File Format field, select Text – Standard to create a text file along with the PDF output file that contains all text captured during the OCR process. Select (none) to skip creating a text file.

    2. In the OCR Language field, select the language to use for the OCR text file.

    3. In the OCR Code Page field, select the character set to use for the OCR text file.

  3. Click Submit to save the commit profile.

8.11 Configuring Batch Flow to the Commit Processor

To commit batches, a client profile or batch processor job must be configured to flow to the commit processor, as described in Section 8.1.4. You do this by setting the commit processor as the post-processing step in a client profile or other processor job. To configure batch flow from: