# Analyze Single Page Document

> The **Analyze Single Page Document** activity uses the Amazon Textract [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html) API to synchronously analyze a local document (**DocumentPath**) or a document stored in an S3 bucket (**Bucket**,**DocumentName**, and **Version**). If your document includes a table, you have the option to indicate if the first row contains column headers (**DiscoverColumnHeaders**) and/or ignore empty rows (**IgnoreEmptyRows**).

The **Analyze Single Page Document** activity uses the Amazon Textract [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html) API to synchronously analyze a local document (**DocumentPath**) or a document stored in an S3 bucket (**Bucket**,**DocumentName**, and **Version**). If your document includes a table, you have the option to indicate if the first row contains column headers (**DiscoverColumnHeaders**) and/or ignore empty rows (**IgnoreEmptyRows**).

After analyzing the document, the activity returns the document properties in a `PageDetail` object (**Page**) that you can use as input variables in other activities outside of the Amazon Textract Activities Package.

## How It Works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-setup#setup) steps.
2. Add the [Amazon Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-scope#amazon-scope) activity to your project.
3. Add the **Analyze Single Page Document** inside the **Amazon Scope** activity.
4. Enter values for the [Local Path](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-analyze-single-page-document#local-path) or the [S3 Storage](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-analyze-single-page-document#s3-storage) input properties.
5. Create and enter a `PageDetail` variable for your [Output](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-analyze-single-page-document#output) (**Page**) property.
6. Run the activity.
   * Your input properties are sent to the [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html) API.
   * The API returns the `PageDetail` value (**Page**) to your output property variable.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-35322-242e506b-b08036af.webp)

## Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-33560-01d06be6-76fcb7d0.webp)

### Common

#### DisplayName

The display name of the activity.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *Amazon Scope* |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

### Local Path

#### DocumentPath

The local location of the file that you want to analyze.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes (if **S3 Storage** properties are empty) |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | Supported document formats: PNG and JPEG (PDF is not supported in synchronous calls). |

### Options

#### AnalysisType

Specifies the types of analysis to perform. Use Tables to return information about the tables that are detected in the input document and Forms to return detected form data.

| Attributes | Details |
| --- | --- |
| **Type** | enum |
| **Required** | No. |
| **Default value** | All |
| **Allowed values** | All, Tables, Forms |
| **Notes** | N/A |

#### DiscoverColumnHeaders

Indicates whether the tables in the document include column headers.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

#### IgnoreEmptyRows

Indicates whether empty rows in the document tables should be ignored when analyzing the document.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

### S3 Storage

#### Bucket

The name of the Amazon S3 bucket where the document is stored.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | The AWS Region for the S3 bucket that contains the document must match the **Region** that you selected in the **Amazon Scope** activity.  For Amazon Textract to process a file in an S3 bucket, the user must have permission to access the S3 bucket; for more information, see **step 6** in the [Create IAM User](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-setup#setup) section of the **Setup** guide. |

#### DocumentName

The case-sensitive name of the file in the specfied **Bucket** that you want to analyze.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| Notes | Supported document formats: PNG, JPEG, and PDF. |

#### Version

If the bucket has versioning enabled, you can specify the object version.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | No |
| **Default value** | Empty |
| **Allowed values** | Enter a `String` or `String` variable. |
| Notes | N/A |

### Misc

#### Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

### Output

#### Page

The properties extracted from the specified document.

| Attributes | Details |
| --- | --- |
| **Type** | `PageDetail` |
| **Required** | No (recommended if you plan to use the output data in subsequent activities) |
| **Default value** | Empty |
| **Allowed values** | Enter a `PageDetail` variable |
| **Notes** | See [Page Detail](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-page-detail#the-page-detail-object) for the description of the of the *PageDetail* object and its properties. |

## Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the [Quickstart](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-textract-quickstarts#quickstarts) guides.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-33971-b6c7cb36-c90ce059.webp)

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-23735-b2f101f2-1d58269a.webp)