# Card Scan

## Introduction

The **GBS CardScan** is a web application for capturing identification forms with biometric data such as fingerprints, palm prints, facial photos, signatures and textual biographical data. The application captures the form data and registers them in the GBS biometric database. It employs flexible and configurable field extraction, allowing it to operate with multiple form templates.

This manual is updated for CardScan version 1.6.2.

### Access and Authentication

You must access CardScan with a browser and we recommend Google Chrome. The access URL is specific to each environment.

{% hint style="info" %}
If necessary, contact the Griaule support team to obtain the correct URL.
{% endhint %}

Authentication is required to access the application. The credentials required by CardScan are username and password.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-e2375c69973ad178740033df403978db36bd1108%2Flogin.png?alt=media)

{% hint style="info" %}
At the bottom of the screen there is an option to change the language to the desired one. This option is also available in settings after login.
{% endhint %}

### Two-Factor Authentication (2FA)

When two-factor authentication (2FA) is enabled, the first time you log in, after entering your username and password, a QR Code will be shown that must be registered in Google Authenticator.

{% hint style="info" %}
Google Authenticator is an authentication code generator available as a smartphone app [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=en\&gl=US) and [iOS](https://apps.apple.com/us/app/google-authenticator/id388497605).
{% endhint %}

![Google Authenticator QR Code for two-factor authentication](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-8c851f0036863e95cc0e0cd352c0cd2bc6aa58c9%2F2FA_qrCode.png?alt=media)

After successfully registering the QR Code in Google Authenticator, enter the six-digit code generated and click Submit.

You will only need to register the QR Code once. However, on each subsequent login, you will need to enter the six-digit code generated by Google Authenticator.

![Two-Factor Authentication](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-1395263f1b55852ea3387c8e78fb7e5234e8ae66%2F2FA.png?alt=media)

There is a limited number of unsuccessful login attempts that a user can make. Whenever an incorrect code is entered, an error message will be displayed:

![Two-Factor Authentication - incorrect code](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-b45daf45e1de591f55eb743b6c7967dd916674f8%2F2FA_incorrectCode.png?alt=media)

If you reach the maximum number of unsuccessful login attempts, your account will be automatically locked.

![Two-Factor Authentication - account locked](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-f093828b7d143a9fdb1f0f55ed6f78e590fbb709%2F2FA_blockedAccount.png?alt=media)

{% hint style="warning" %}
If your account is locked, contact the system administrator.
{% endhint %}

### Simultaneous Logins and Browser Registration

Only one session per user is allowed. It is not possible to log in simultaneously with the same profile more than once in the application. If a user is already connected and another access occurs using the same username and password, the user with the older session will be notified and disconnected on the next action.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-a8ff32a265c76c465e05f017eebc317c74964bd5%2FsimultaneousLogin.png?alt=media)

Additionally, only one browser can be used at a time. When attempting to log in using a different browser, the user will be informed that it is necessary to authenticate the new browser. Authenticating a new browser will revoke access from the previous browser.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-63913ca2e47dcb93c0d2c36dd343ea1f1ac76a2e%2FbrowserEnrollment1.png?alt=media)

To authenticate a new browser, click Authenticate and then enter the verification code that will be sent to the email associated with the user's account.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-057a4f98078e6eb9a12c32b0eb500165738761a2%2FbrowserEnrollment2.png?alt=media)

If authentication is successful, a notification will appear in the upper right corner of the screen after login.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-dcf4d6e20b27f7f4763b6c949fb3c27eb9fbeb77%2FbrowserEnrollment3.png?alt=media)

### Reset Password

You can reset your password if you forget it.

To reset your password, on the login screen, click Forgot your password?:

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-b5e3af1417b2eeb8e48cff0301f7a8fe339b2b6a%2FresetPassword1.png?alt=media)

Then enter the profile username and click Submit.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-ec6cea4dfcfcbdf9ec48ed5696296358bc92b3b9%2FresetPassword2.png?alt=media)

An email containing a verification code will be sent to the email address associated with that profile. Enter the verification code and click Submit code.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-057a4f98078e6eb9a12c32b0eb500165738761a2%2FresetPassword3.png?alt=media)

If the code is correct, you will be able to create a new password. Enter the new password twice. Make sure to meet the password requirements, they are listed below the new password field and will turn green when met. Finally, to confirm the reset, click Reset password.

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-1de4c68bca096e18a963d4ceeccabba30465e254%2FresetPassword4.png?alt=media)

## User Interface

### Main Screen

The main screen displays the application's main features:

![Home page](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-e261acafc51592aaa1f05b7437841c0d815cf21c%2Fhome-screen.png?alt=media)

The features are distributed in 3 groups: **Request**, **List** and **Edit**. These features can also be accessed via the navigation bar at the top of the page.

### Request

This group of features is used to capture and register forms with biographical and biometric data. This operation can be performed in 3 ways: **Single form**, **Multiple forms in a file**, and **Multiple forms on server**.

#### Single Form

This operation is used to process a single.

![Single form](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-c8fce0f86d949199cedcb23a45cb46a78eb3f0b4%2Funitary-card.png?alt=media)

A single form request requires 4 parameters:

**Process name**

> An identifier (free form) for the operation.

**Resolution**

> Scanning resolution of the image(s). For best results, the form should be scanned at the same resolution as the selected layout.

**Layout**

> The form layout used to interpret the image. A thumbnail of the selected layout will be displayed.

**Files**

> One or more image files containing the scanned form. If the form has multiple pages, or has front/back content, multiple images must be uploaded (one per page).

After filling in the parameters and uploading the images, the user can reorder the uploaded images to match the layout order by dragging the icons on the left side of the screen. Images can be removed by clicking the icon `X`:

![Single form](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-e04011462a8ce99de84dec7944dd128972b37b24%2Fmultiple-images-request.png?alt=media)

Click **Submit** to send the request for processing on the server.

To check the progress of the operation, select **List > Processes** in the navigation bar at the top of the screen.

#### Multiple forms in a file

This type of operation is used to process a package containing multiple scanned forms. The package must be a single *Zip* file containing all scanned images.

The *CardScan* will process the files following the lexicographical order of their names. **It is recommended to start file names with numbers to ensure a predictable processing order.**

![Multiple forms in a file](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-2d43595bef9ee9fd5f904e815bbc3a5258fba8a1%2Fmultiple-on-file-cards.png?alt=media)

#### Multiple forms on server

This operation is used to process a list of files located on the server that runs the CardScan service. It will process the files following the lexicographical order of their names. **It is recommended to start file names with numbers to ensure a predictable processing order.** This operation is suitable for large-scale data migration, and may require administrative credentials on the server.

### List

This group of features allows the user to list the **profiles** generated for registration when processing requests; To list submitted requests and inspect their status; And to inspect **logs** of operation.

#### Profiles

This section displays a list of existing profiles created by the system. It is possible to filter the list by process ID, profile ID, key, biographic data and/or status, allowing the location of specific profiles.

![List profiles](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-2ae897f88e02fec0dab21f0f86de3f099eb19b67%2Fprofile-list.png?alt=media)

Clicking on a line in the profile listing displays its details, such as original form images and biometric images extracted from the form (fingerprints, palm prints, facial photo, signature, etc.).

![Profile details](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-54b8271d95624b257bb6363e1aa7a2e9ade06124%2Fprofile-detail.png?alt=media)

On this page it is also possible to edit textual fields obtained by OCR (Optical Character Recognition), remove the profile, refresh the listing and reprocess the profile data.

**Editing OCR fields:**

On the profile details page the user can edit textual fields such as biographic data, keys and labels (*labels*). To do this, click **Edit**:

![Edit profile details](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-1c47c651038a479cdb14484aecffbb9e8e6b7700%2Fclicking-edit-profile.png?alt=media)

After clicking **Edit**, the profile fields can be edited manually by the user. The fields can be Keys, Biographics and Labels. When OCR is unable to extract Biographics, Keys or Labels information from the scanned image, they must be entered manually using this option.

The displayed fields are those configured by the system administrator. If you have the necessary permissions, you will be able to view and modify these fields in the GBS BCC application. For more information, consult the [Fields](https://docs.griaule.com/gbs/en/bccweb#campos) section in the [GBS BCC manual](https://docs.griaule.com/gbs/en/applications/bccweb).

After editing the fields, click **Save changes** to confirm the changes. If the user wants to cancel the changes, click **Cancel**. To clear the fields, click **Clear fields**.

{% hint style="info" %}
Some fields may be mandatory, indicated by the message "This field is required". If a mandatory field is left blank, the user will not be able to submit the profile to GBDS.
{% endhint %}

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-2b5a6d3b89a71b6a8d14467e1f0daff80ad7d950%2Fedit-profile-ocr-modal.png?alt=media)

**Manual review:**

When using the request type **Multiple forms on server**, depending on your environment configuration, profiles may require manual review if the ID number read by OCR is not included in a range indicated in the server folder name.

For example, if the folder name is `cartoes_1000_2000` and this feature is enabled in your environment, the system will check whether the ID number read by OCR is between 1000 and 2000. Those that are not within this range will receive the status `Pending manual review` and will await manual review.

When opening a profile that requires manual review, the user will see the profile screen with the fields in an editable state. The user must then review the scanned document, edit or enter the necessary information and click **Save**.

{% hint style="warning" %}
Some information, such as identification keys, can be checked against the ABIS database to ensure they are unique. If the key is already in the database, it will be displayed as **invalid**.
{% endhint %}

![](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-2dc1aaca1201809a6a39207e60da2d9de5604324%2Fedit-profile-ocr.png?alt=media)

**Sending the profile to GBDS:**

If the form was processed without errors, the button **Send to GBDS** will be enabled, allowing the user to send the profile for registration in the GBS biometric database.

{% hint style="info" %}
Some biographic fields may be mandatory. If a mandatory field is left blank, the user will not be able to send the profile to GBDS. To proceed, click **Edit** and fill in the mandatory fields.
{% endhint %}

![Send to GBDS](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-7b696aaa3b39aa8de998c93d6747c82fb1b3f803%2Fsend-to-gbds.png?alt=media)

{% hint style="warning" %}
Once sent to GBDS, the OCR fields can no longer be changed.
{% endhint %}

**Profile Status:**

All profiles have a status indicating their current situation. The profile status is normally associated with the process status.

When a process has the status **Processing**, the profiles associated with it may have the following statuses:

<table><thead><tr><th width="200">Status</th><th>Description</th></tr></thead><tbody><tr><td><strong>Generated</strong></td><td>Profile created.</td></tr><tr><td><strong>Segmenting</strong></td><td>Segmentation in progress.</td></tr><tr><td><strong>Validation</strong></td><td>Validation in progress.</td></tr><tr><td><strong>Segmentation Error</strong></td><td>Error in the segmentation process.</td></tr><tr><td><strong>Segmentation OK</strong></td><td>Segmentation was successfully performed, waiting for the user to send the profile to GBDS.</td></tr></tbody></table>

When processing is completed, the profile status may take other values:

<table><thead><tr><th width="200">Status</th><th>Description</th></tr></thead><tbody><tr><td><strong>Pending manual review</strong></td><td>The ID read by OCR is not in the expected range. Manual review is required.</td></tr><tr><td><strong>Manual review done</strong></td><td>Manual review completed, waiting for the user to send the profile to GBDS.</td></tr><tr><td><strong>Deleted</strong></td><td>Profile deleted before being sent to GBDS.</td></tr><tr><td><strong>Reprocessed</strong></td><td>The profile layout was edited and the profile was reprocessed with the new layout.</td></tr><tr><td><strong>Validation</strong></td><td>Validation in progress.</td></tr><tr><td><strong>Segmentation Error</strong></td><td>Error in the segmentation process.</td></tr><tr><td><strong>Ready for GBDS</strong></td><td>Ready to be sent to GBDS.</td></tr><tr><td><strong>Sending to GBDS</strong></td><td>Sending to GBDS.</td></tr><tr><td><strong>Sent to GBDS</strong></td><td>Sending to GBDS completed.</td></tr><tr><td><strong>OK in GBDS</strong></td><td>Registration successfully completed in GBDS, can transition to <strong>OK</strong>.</td></tr><tr><td><strong>OK</strong></td><td>Registration completed in GBDS and profile flow completed in CardScan - this is a final state.</td></tr><tr><td><strong>Error</strong></td><td>Error processing the profile.</td></tr><tr><td><strong>GBDS Failure</strong></td><td>Failure in registration in GBDS.</td></tr><tr><td><strong>Rejected in GBDS</strong></td><td>Profile was rejected by GBDS.</td></tr><tr><td><strong>Under review (MIR)</strong></td><td>Waiting manual quality review in the <em>GBS MIR</em>.</td></tr><tr><td><strong>Approved (MIR)</strong></td><td>Approved in quality review in the <em>GBS MIR</em>, can transition to <strong>OK</strong>.</td></tr><tr><td><strong>Rejected (MIR)</strong></td><td>Rejected in quality review in the <em>GBS MIR</em>.</td></tr><tr><td><strong>Under review (ETR)</strong></td><td>Registration generated an exception, awaiting resolution in the <em>GBS ETR</em>.</td></tr><tr><td><strong>Same biometrics (ETR)</strong></td><td>Resolution in GBS ETR: same biometrics found (<em>fraud in registration operation</em>).</td></tr><tr><td><strong>Different biometrics (ETR)</strong></td><td>Resolution in GBS ETR: different biometrics (<em>fraud in update operation</em>).</td></tr><tr><td><strong>Recollect (ETR)</strong></td><td>Resolution in GBS ETR: recollection required.</td></tr><tr><td><strong>Approved (ETR)</strong></td><td>Resolution in GBS ETR: approved, can transition to <strong>OK</strong>.</td></tr></tbody></table>

#### Processes

The processes section displays a list of existing processes and their details. The list can be filtered by date, username, process ID and/or status.

![List processes](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-b364715583df4e51e1a4de60b906ce3ba43c583b%2Fprocess-list.png?alt=media)

Clicking on a line in the process list opens a page with process details and options to reload information, view associated profiles and process logs:

![Process detail](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-741f54552d4868f20479e1ffa0e1c00dc40288bd%2Fprocess-detail.png?alt=media)

**Process Status:**

Every process has a status indicating its current situation, which may take the following values:

<table><thead><tr><th width="200">Status</th><th>Description</th></tr></thead><tbody><tr><td><strong>Received</strong></td><td>Process received and created.</td></tr><tr><td><strong>Validating</strong></td><td>The process is being validated.</td></tr><tr><td><strong>Detecting layout</strong></td><td>Detecting the layout automatically.</td></tr><tr><td><strong>Layout not detected</strong></td><td>Error: system could not detect the layout.</td></tr><tr><td><strong>Layout detected</strong></td><td>Layout detection completed successfully.</td></tr><tr><td><strong>Ready for segmentation</strong></td><td>Ready to be segmented. Waiting user validation.</td></tr><tr><td><strong>Processing</strong></td><td>Processing profiles.</td></tr><tr><td><strong>Profiles generated</strong></td><td>Profiles successfully generated, user can send them to GBDS.</td></tr><tr><td><strong>Processed</strong></td><td>Processing completed.</td></tr><tr><td><strong>Error</strong></td><td>Process error.</td></tr></tbody></table>

#### Operation Logs

The operation logs section displays a list of existing logs and their details.

![Logs list](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-ef88ccc592dba320c795fd72557ec86a49b80593%2Flogs-list.png?alt=media)

This list does not offer a detailed view of each log entry, unlike the other lists.

### Edit

This group of features allows the user to edit application settings, as well as layouts.

#### Settings

This section allows the user to change general application settings:

![Settings](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-5e96287b137cfbf53879aaeee1c84dd69dbf65f9%2Fsettings.png?alt=media)

It is possible to change the application theme from dark to light, the language, the date/time format and the search type. These settings only affect the user interface, not the form processing operations.

#### Layouts

This section displays a list of existing layouts and allows the user to edit, clone and/or remove them. Note that a layout can only be edited or removed if there are no processes associated with it.

![Layouts list](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-f550581fe39c94c2d6b5c42a3456889d6d36e254%2Flayouts-list.png?alt=media)

Clicking on a layout in the list will open a page showing the layout with its fields highlighted:

![Layout detail](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-4ae9d02efe6041d3ccab18bf0b56362187b23e88%2Flayout-detail.png?alt=media)

## Layouts

A layout is a representation of a specific biometric form model. Each distinct form model must have a corresponding layout in the system.

In the following example we can see the fingerprints (blurred in this manual for anonymization) and a person's biographic data:

![Layout example](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-8e6d7bf57475fc726d51ce87b9e39efea1d50299%2Fexample.jpg?alt=media)

To create a corresponding layout, the user needs to specify the regions of the image where biometric and biographic data are present.

### Creating a new layout

To create a new layout, click **New Layout**:

![Create new layout](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-5fe6f03dffd5c99269b36d2c8809888996828267%2Fcreate-new-layout.png?alt=media)

The layout creation screen will be displayed:

![Create new layout (empty)](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-c77c1db7f36af40ef35fe49930122148b8ca15eb%2Fcreate-new-layout-empty.png?alt=media)

#### Import file or Acquire Image

The first step in creating the layout is to import an image file to serve as a base:

![Imported biometric form image](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-60e93e642041e8d34e9cab52755c16ffd7f9df77%2Fimported-image.png?alt=media)

#### Resolution

An important step is specifying the resolution of the imported image (given in dots per inch, *dpi* abbreviated). The resolution can be indicated manually in the right sidebar:

![Imported biometric form image: resolution](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-806ac6750324618db497577b9c08afa05a322878%2Fimported-image-resolution.png?alt=media)

The user can also click **Adjust resolution** in the toolbar on the left:

![Resolution adjustment tool](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-2c4c767970489a884f2be25e3175e0524eb429bb%2Fadjust-resolution.png?alt=media)

Choose the desired unit of measurement and inform the distance that will be marked on the image:

![Example of using the resolution adjustment tool](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-69aed4fff344bde4cb74dcdd4d087a97569476f5%2Fresolution-example.png?alt=media)

In this example, the first step (1) indicates 5 cm as the distance that will be marked on the image. The second step (2) is marking the distance on the image. After steps 1 and 2, the application will report the calculated resolution (3). In this example, 354 dpi.

{% hint style="warning" %}
The minimum allowed resolution is 300 dpi.
{% endhint %}

The following information can be added to the layout:

**Name**

> An identifier (free form) for the layout.

**Description**

> Layout description (e.g.: "forms from the state of Roraima, 1985-1993")

**Language**

> The language in which the form data are written.

![Layout properties.](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-9e5fe16d9e905a1c466a086da89022a8db5cd2e8%2Flayout-properties.png?alt=media)

#### Create region

Next, the user must specify one or more regions of the image that contain biometric or biographic data.

In the toolbar, click **Extract region**:

![Extract region with rectangle tool](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-1b59f8c06efe71217ed71752252b01f0cfd373fd%2Fextract-region-tool.png?alt=media)

Click and drag the mouse over the image to define a rectangle, and then use the right sidebar to fill in its details:

![Region details](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-48867e39f69fb30dbc1d163827d50b60b1a34fed%2Fregion-details.png?alt=media)

It is possible to adjust the region's position and size. On this screen, the user can also change the following settings:

* **Angle:**
  * No rotation: no change to the created region
  * Rotate 90° clockwise: rotates the region by this angle
  * Rotate 90° counterclockwise: rotates the region by this angle
  * Flip: 180° rotation
* **Type:**
  * Fingerprint: fingerprint
  * Palmar: palm print
  * Signature: signature
  * Key: for fields that will be keys (values that cannot repeat for different people). Keys will be stored in the GBS database.
  * Biographic: for fields with a person's biographic data. This information will be stored in the GBS database.
  * Label: for fields that will be treated as labels. Labels will be stored in the GBS database.
* **Subtype for Fingerprints:**
  * Single Fingerprint: for regions with a single fingerprint.
  * Two Thumbs: for regions with two thumbs.
  * Two Fingerprints: for regions with two fingerprints.
  * Four Fingerprints: for regions with four fingerprints.
* **Fingerprints:**

  > This option depends on the subtype above, and indicates which finger or fingers are present in the region.
* **Subtype for Palms:**
  * Left interdigital
  * Left thenar
  * Left hypothenar
  * Right interdigital
  * Right thenar
  * Right hypothenar
  * Left full
  * Left writing
  * Right full
  * Right writing
* **Subtype for Face:**
  * Frontal face
  * Left mugshot
  * Right mugshot
* **Subtype for Key:**
  * OCR Key: The field will be interpreted by OCR (optical character recognition).
  * Barcode Key: The field will be interpreted as a barcode.
* **Fields for Keys:**
  * Lists the fields registered on the GBS server for the `Key`:

    ![Key fields](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-b68882061fb7e6032637f5c571e888cb421f4b1f%2Fkey-fields.png?alt=media)
  * Examples of key fields: passport number, driver's license number, voter registration number.
* **Subtype for Biographic:**
  * Biographic OCR: The field will be interpreted by OCR (optical character recognition).
  * Biographic Barcode: The field will be interpreted as a barcode.
* **Biographic fields:**
  * Lists the fields registered on the GBS server for the `Biographic`:

    ![Biographic fields](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-ceea2b6040e7100d0430d112d01b3d2f73cb0392%2Fbiographic-fields.png?alt=media)
  * Examples of biographic fields: name, date of birth, mother's name, father's name.
* **Subtype for Label:**
  * Label OCR: The field will be interpreted by OCR (optical character recognition).
  * Label Barcode: The field will be interpreted as a barcode.
* **Label Fields:**
  * Lists the fields registered on the GBS server for the `Label`:

    ![Label fields](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-08a149421c73b6230ebb205d22cb803284045d2f%2Flabel-fields.png?alt=media)
  * Labels can be used to group and filter people in GBS search operations.

When the region creation is completed, the image will have the associated regions as in the image below:

![Demarcated biometric form](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-3a4eaf863040a656d7ec067671270bec3279c7ba%2Fsectioned-card.png?alt=media)

To adjust any created region, click on it. Its details will be highlighted in the sidebar and the options list will be displayed:

![Region editing window](https://3757157672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7Bx0xNdsdGHpCZ20yxbn%2Fuploads%2Fgit-blob-6c160300b1f83f785b495696630d9d1adb581c96%2Fedit-region.png?alt=media)