> For the complete documentation index, see [llms.txt](https://docs.theconfigteam.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theconfigteam.com/prebilt-for-im-wm-strm/applications/document-capture/configuration.md).

# Configuration

{% hint style="info" %}
**Note**

This configuration guide refers to PreBilt transactions beginning '*PB2\_*' and details the standard process without additional features or enhancements. You should [copy these transactions](/prebilt-for-im-wm-strm/configuration-guide/transaction-codes.md#create-a-transaction) with a different prefix to maintain a backup and protect the originals.

The guide displays the standard PreBilt screens and gives details of the structures in which the on screen fields can be found. Fields within these structures can be used to customise and enhance the screen. For instructions on how to use structures to find fields, please see [Available data structures](/prebilt-for-im-wm-strm/app-master-data/screen-framework/features/available-data-structures.md). For instructions on how to maintain the configuration elements in AMD, please see [General configuration elements](/prebilt-for-im-wm-strm/app-master-data/general-configuration-elements.md).
{% endhint %}

## PB2\_DOC\_CAPTURE\_ALL and others

All the document capture transactions are a subset of the PB2\_DOC\_CAPTURE\_ALL transaction.

### Selection options

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2FKcIiSA68fonusGuWBKTk%2Fimage.png?alt=media&amp;token=4d7d458c-b2da-4ed2-b873-974fecc8ec21" alt="" width="236"><figcaption></figcaption></figure>

<table><thead><tr><th width="242">Configuration element</th><th width="502">Available structures/fields</th></tr></thead><tbody><tr><td>SELECT_OPTS</td><td>OBJECT_TYPE - Object list from the list OBJECT_TYPE_LIST.
<br>OBJECT_KEY - Material number, document number or in case of the material documents, the material document number followed by year.</td></tr><tr><td>SELECT_OPTS_ACTIONS</td><td><p>BACK - back to previous screen.</p><p>CLEAR_INPUT -clear all input fields.</p><p>VAR_CHOOSE – select saved variants.</p><p>VAR_SAVE – save the selection entries as a variant.</p><p>SELECT – proceed to next screen.</p></td></tr></tbody></table>

### Document list

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2F11zfGMvoOyv5pHjm7P4Q%2Fimage.png?alt=media&amp;token=0434e0b7-24e7-44d6-84c8-842f5e6ed8aa" alt="" width="236"><figcaption></figcaption></figure>

<table><thead><tr><th width="260.888916015625">Configuration element</th><th>Available structures/fields</th></tr></thead><tbody><tr><td>LIST_SUMMARY</td><td>Primary: /TCTM/SOFOLENTI1_S<br>Secondary: None</td></tr><tr><td>LIST_SUMMARY_ACTIONS</td><td>CONTINUE - continues to cycle through the signature=>comments=>images screens.
<br>CAPTURE_COMMENT - go to Comment Capture screen.
<br>CAPTURE_SIGNATURE - go to Signature Capture screen.
<br>UPLOAD_IMAGE - go to Image Capture screen.
<br>CAPTURE_IMAGE - open camera on device.
<br>BACK - back to previous screen.</td></tr><tr><td>LIST_SUMMARY_HEADER</td><td>TOTAL_NO_ITEMS - Total number of items.</td></tr><tr><td>LIST_SUMMARY_HEADER_EX</td><td>n/a</td></tr><tr><td>LIST_SUMMARY_SORT</td><td>Primary: /TCTM/SOFOLENTI1_S</td></tr></tbody></table>

### Image capture

<div><figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2FQ48G9IVEawdfBYm3VDhV%2Fimage.png?alt=media&amp;token=cea32540-01bb-41aa-865d-b7ed450198ca" alt="" width="237"><figcaption></figcaption></figure> <figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2F08PNFpBEU7WWjZMXsfkI%2Fimage.png?alt=media&amp;token=77e80e98-9fd6-45ed-a0f1-598b4a7a820b" alt="" width="235"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="277.5555419921875">Configuration element</th><th>Available structures</th></tr></thead><tbody><tr><td>LIST_IMAGE_CAP</td><td>DOC_TITLE - proposed file (which will be prefixed by value in UTILITY_OPTS and suffixed with the file extension type from IMAGE_CAP_FILE_EXT).
<br>CREAT_NAME - Name of user.
<br>CREATED_DATE - Create date.
<br>CREATED_TIME - Create time.</td></tr><tr><td>LIST_IMAGE_CAP_ACTIONS</td><td>UPLOAD_IMAGE - Uploading an image from the device folders.
<br>CAPTURE_IMAGE - Opening the camera to take a picture.
<br>SKIP - Skip/continue without saving.
<br>SAVE - Saving the change.
<br>BACK - Back to previous screen.</td></tr><tr><td>LIST_IMAGE_CAP_HEADER</td><td>TOTAL_NO_ITEMS - Total number of items.<br>MAX - Maximum number of items that can be added by transaction.<br>MIN - Minimum number of items required by transaction.</td></tr><tr><td>LIST_IMAGE_CAP_HEADER_EX</td><td>n/a</td></tr></tbody></table>

### Filename popup

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2F1O9tPgnReHXevEPxaLob%2Fimage.png?alt=media&amp;token=fda12f76-d58a-4e02-b682-e4965d9cf71c" alt="" width="239"><figcaption></figcaption></figure>

<table><thead><tr><th width="277.5555419921875">Configuration element</th><th>Available structures</th></tr></thead><tbody><tr><td>INPUT_IMAGE_CAP</td><td>FILE_NAME_IN - proposed file name for the taken or uploaded picture.</td></tr><tr><td>INPUT_IMAGE_UPLOAD</td><td>FILE_NAME_IN - proposed file name for the taken or uploaded picture.</td></tr><tr><td>IMAGE_FILENAME</td><td>Structure of the proposed file name.</td></tr><tr><td>IMAGE_CAP_FILE_EXT</td><td>Extension to be used for the file.</td></tr><tr><td>IMAGE_FILE_TYPE_LIST</td><td>List with the allowed image file extensions.</td></tr></tbody></table>

### Signature capture

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2FVdDyE1UX0S9hqLHUaLK0%2Fimage.png?alt=media&amp;token=3474cfd9-dab3-48e5-9171-e5b217a426e0" alt="" width="235"><figcaption></figcaption></figure>

<table><thead><tr><th width="300.8887939453125">Configuration element</th><th>Available structures</th></tr></thead><tbody><tr><td>LIST_SIGNATURE_CAP</td><td>DOC_TITLE - proposed file (which will be prefixed by value in UTILITY_OPTS and suffixed with the file extension type from SIGNATURE_CAP_FILE_EXT).
<br>CREAT_NAME - Name of user.
<br>CREATED_DATE - Create date.
<br>CREATED_TIME - Create time.</td></tr><tr><td>LIST_SIGNATURE_CAP_ACTIONS</td><td>
CAPTURE_SIGNATURE - Opening the popup to allow on screen signature.
<br>SKIP - Skip/continue without saving.
<br>SAVE - Saving the change.
<br>BACK - Back to previous screen.</td></tr><tr><td>LIST_SIGNATURE_CAP_HEADER</td><td>TOTAL_NO_ITEMS - Total number of items.<br>MAX - Maximum number of items that can be added by transaction.<br>MIN - Minimum number of items required by transaction.</td></tr><tr><td>LIST_SIGNATURE_CAP_HEADER_EX</td><td>n/a</td></tr><tr><td>INPUT_SIGNATURE_CAP</td><td>SIGNEE - Signee name.<br>Secondary: /TCTM/TOJTT_S</td></tr><tr><td>SIGNATURE_FILENAME</td><td>Structure of the proposed file name.</td></tr><tr><td>INPUT_SIG_WATERMARK_TEXT</td><td>Structure of the proposed file name.</td></tr><tr><td>SIGNATURE_CAP_FILE_EXT</td><td>Extension to be used for the file.</td></tr><tr><td>SIG_FILE_TYPE_LIST</td><td>List of extensions that can be used for the file.</td></tr><tr><td>INPUT_SIG_WATERMARK_IMAGE</td><td></td></tr></tbody></table>

### Comments capture

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2FTaGWug67PXQk7SQanZuc%2Fimage.png?alt=media&amp;token=4c0dd101-c244-4668-9936-f72033b0173f" alt="" width="235"><figcaption></figcaption></figure>

<table><thead><tr><th width="319.77783203125">Configuration element</th><th>Available structures</th></tr></thead><tbody><tr><td>LIST_COMMENTS_CAP</td><td>DOC_TITLE - proposed file (which will be prefixed by value in UTILITY_OPTS and suffixed with the file extension type from COMMENTS_CAP_FILE_EXT).
<br>CREAT_NAME - Name of user.
<br>CREATED_DATE - Create date.
<br>CREATED_TIME - Create time.</td></tr><tr><td>LIST_COMMENTS_CAP_ACTIONS</td><td>CAPTURE_COMMENT - Opening the popup to allow comments to be entered.
<br>SKIP - Skip/continue without saving.
<br>SAVE - Saving the change.
<br>BACK - Back to previous screen.</td></tr><tr><td>LIST_COMMENTS_CAP_HEADER</td><td>TOTAL_NO_ITEMS - Total number of items.<br>MAX - Maximum number of items that can be added by transaction.<br>MIN - Minimum number of items required by transaction.</td></tr><tr><td>LIST_COMMENTS_CAP_HEADER_EX</td><td>n/a</td></tr><tr><td>INPUT_COMMENTS_CAP</td><td>FILE_NAME_IN - proposed file name for the comments.</td></tr><tr><td>COMMENT_FILENAME</td><td>Structure of the proposed file name.</td></tr><tr><td>COMMENT_CAP_FILE_EXT</td><td>Extension to be proposed for the file.</td></tr><tr><td>COM_FILE_TYPE_LIST</td><td>List of extensions that can be used for the file.</td></tr></tbody></table>

### Object display

<figure><img src="https://3149936122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CkvzIq48sLzTY4bfcWl%2Fuploads%2F4mrGrv5PoGWGaZO3R0OG%2Fimage.png?alt=media&amp;token=4667124c-4fcc-4bf9-87c7-2169c51c21cc" alt="" width="235"><figcaption></figcaption></figure>

<table><thead><tr><th width="313.1112060546875">Configuration element</th><th>Available structures</th></tr></thead><tbody><tr><td>OBJECT_DISPLAY_DOC</td><td>n/a</td></tr><tr><td>OBJECT_DISPLAY_DOC_ACTIONS</td><td>DELETE - Delete attachment.
<br>SAVE - Save changes and continue.
<br>EDIT - Edit attachment.
<br>BACK - Back to previous screen.</td></tr><tr><td>OBJECT_DISPLAY_DOC_HEADER</td><td>Primary: /TCTM/SOFOLENTI1_S (ATTACHMENT)</td></tr><tr><td>OBJECT_DISPLAY_DOC_HEADER_EX</td><td>n/a</td></tr></tbody></table>

### General configuration elements

<table><thead><tr><th width="242">Configuration element</th><th width="502">Description</th></tr></thead><tbody><tr><td>FE_APP</td><td>Frontend class to use in running the transaction.<br><br>Reference to the platform specific frontend application that should be used to run the transaction. Included in the App Master Data file supplied for setting up the initial transactions.</td></tr><tr><td>APP_CLASS</td><td>Sets the app processing class.</td></tr><tr><td>UTILITY_OPTS</td><td>Sets the features used in the app for PDF, image, signature and comments.</td></tr><tr><td>PDF_FILE_TYPE_LIST</td><td>Configure the file types that should be shown in the summary list.  Any file types not configured, will not show in the list.</td></tr><tr><td>APP_TEXTS</td><td>Defines standard app text to be used in screen headers, buttons etc.</td></tr><tr><td>TRANS_INFO</td><td>Information about the transaction.</td></tr></tbody></table>

## UTILITY\_OPTS details

The **UTILITY\_OPTS** table defines the behaviour of each utility configured within an application. The following utility types are supported:

* Signature Screen
* Comments Screen
* Image Capture
* PDF Screen

Each utility can be configured using the settings described below.

### Capture Mode

Defines how content can be captured or uploaded within the utility.

#### Signature Screen

| Value | Description                |
| ----- | -------------------------- |
| X     | Signature capture enabled  |
| Blank | Signature capture disabled |

#### Comments Screen

| Value | Description              |
| ----- | ------------------------ |
| C     | Comment capture enabled  |
| Blank | Comment capture disabled |

#### Image Capture

| Value | Description                            |
| ----- | -------------------------------------- |
| C     | Capture images using the device camera |
| U     | Upload existing images                 |
| B     | Capture and/or upload images           |
| Blank | Image capture and upload disabled      |

#### PDF Screen

PDF documents are display-only and cannot be uploaded through the application.

### Display Mode

Controls whether captured objects are displayed on the Summary List screen.

#### All Utilities

| Value | Description                            |
| ----- | -------------------------------------- |
| X     | Object is displayed in the application |
| Blank | Object is hidden from the application  |

### Delete Mode

Controls whether captured objects can be edited or deleted.

#### Signature Screen, Image Capture, PDF Screen

| Value | Description              |
| ----- | ------------------------ |
| X     | Object can be deleted    |
| Blank | Object cannot be deleted |

#### Comments Screen

| Value | Description                          |
| ----- | ------------------------------------ |
| E     | Comments can be edited               |
| D     | Comments can be deleted              |
| B     | Comments can be edited and deleted   |
| Blank | Comments cannot be edited or deleted |

### Minimum Number of Captures

**Applicable to:** Signature Screen, Image Capture, Comments Screen

Defines the minimum number of items that must be captured or uploaded. If this value is greater than **0**, the utility becomes mandatory.

### Maximum Number of Captures

**Applicable to:** Signature Screen, Image Capture, Comments Screen

Defines the maximum number of items that can be captured or uploaded.

### Filename Prefix

**Applicable to:** All Utilities

Only objects whose filenames begin with the configured prefix are displayed on the Summary List screen.

#### Example

If the filename prefix is configured as **SIG**:

* **SIG UNAME 20210505** → Displayed
* **GIF UNAME 20210505** → Not displayed

### File Type

**Applicable to:** All Utilities

Only files with the configured file type can be displayed by the application.

This setting references the file types defined in **XXX\_FILE\_TYPE\_LIST** (see Section 3).

#### Example

If **PNG** and **JPG** are configured as valid file types:

* PNG signature files → Displayed
* JPG signature files → Displayed
* GIF signature files → Not displayed