Converting Contents
This page explains conversion options provided by ADx Explorer. To convert a content, highlight it in Explorer, and open the Conversion menu at the bottom of the page. You can choose from the following options:
On this page
Resource Consumption
Refer to the below table showing resource consumption levels per job type. If you know the distribution of job types in your organization, it should help you estimate the load.
Job type | Expected resource consumption |
---|---|
Convert to image | Heavy |
Prepare for WebReader | Heavy |
Convert to PDF | Medium |
Merge documents | Medium |
Merge templates | Medium |
Apply watermark | Light |
Apply template | Light |
Extract text | Light without OCR. Otherwise, heavy |
Extract e-mail | Light to Medium, depending mostly on the presence of embedded e-mails in attachments as well as the size of the e-mail body. |
To Image
This operation converts any content type into an image.
For contents that have more than one page, each page is converted into a separate image.
-
Select the content you want to convert.
-
Click Conversion.
-
Click To Image.
-
Fill in the following fields:
Field Description Format
The output format Width
The width of the output image Height
The output image height Target Name
The name of the output image Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.
NEW_CONTENT
saves the output content as a new content that you can find in Explorer.Temporary
Shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
- updates the current working copy. -
Click Execute. You will get a notification that the conversion has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
To PDF
This operation converts any content type to PDF:
-
Select the content you want to convert.
-
Click Conversion.
-
Click To PDF.
-
Fill in the following fields:
Field | Description |
---|---|
Page Size | For example A4 |
Target Name | The name of the output image |
Result Action | CONTENT_REPRESENTATION saves the output content under Representations of the original content.NEW_CONTENT saves the output content as a new content that you can find under My Contents Temporary Shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.UPDATE_WORKING_COPY - updates the current working copy. |
Target PDF Format | Select one of the following:
|
- Click Execute. You will get a notification that the conversion has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Merge
To merge two or more contents:
-
Select the contents you want to merge (crtl + click or shift + click).
-
Click Conversion.
-
Click Merge.
-
Fill in the following fields:
Field Description Contents
Add contents to be merged (only visible if you select Merge option without selecting any contents). Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.NEW_CONTENT
saves the output content as a new content that you can find underMy Contents
Temporary
Shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
- updates the current working copy.Target Name
The name of the output content. -
Click Execute. You will get a notification that the conversion has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Merge Templates
This option works similarly to Merge, except it merges contents created from templates (for example Velocity templates). Additionally, it provides the option called Template Specifications, which you can use to define key-value mappings for variables found in the template (see Template Specification for more details).
Apply Watermark
Check the video below presenting a use-case for the watermark:
To add a watermark to a content:
-
Select the content in explorer.
-
Click Conversion.
-
Click Apply Watermark.
-
Fill in the following fields:
Field Description Text
The text of the watermark. You can use the following variables: ${ACTUAL_PAGE}
,${TOTAL_PAGES}
,${now(PATTERN)}
- replacePATTERN
with SimpleDateFormat: e.gyyMMddHHmmssZ
.Size
font size Rotation
Rotation in degrees Color
Font color Alignment
Left, center, right Position
Top-left to bottom-right OffsetX
Text position offset in x (horizontal) direction. OffsetY
Text position offset in y (vertical) direction. Target Name
The name of the output image. Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.NEW_CONTENT
saves the output content as a new content that you can find underMy Contents
Temporary
Shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
- updates the current working copy. -
Click Execute. You will get a notification that the job has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Apply Template
You can apply a template to one or more contents as follows:
-
Select the contents to which you want to apply the template.
-
Click Conversion.
-
Click Apply Template, and fill in the following fields:
Field Description Contents
Add contents to apply the template to (only available if no content has been selected already) Target Name
The name of the output image Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.NEW_CONTENT
saves the output content as a new content that you can find underMy Contents
Temporary
saves the output file in the Representations access without attaching it to any content and shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
- updates the current working copy.Template Specifications
Here you define the key-value pairs for the template. When the action is executed, each key in the original content is replaces with the value you have defined. See Template Specification -
Click Execute. You will get a notification that the job has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Template Specification
To add a template specification:
-
Click Add.
-
Under Types, double-click TemplateSpecification.
-
Under contentIds, click Add to select contents to which you want to apply this template.
If you do not select any contents, the template will be applied to all contents.
-
Under variables, click Add.
-
In the Adding Map Key window, type the key that you want to be mapped to a value from the template.
-
If you want to add more values, click Add. Otherwise, click Add&Finish.
-
In the Adding Map Value window, type a value or more to be mapped to the keys you have entered.
Make sure the number of keys matches the number of values.
-
Click Add&Finish. You can see the key-value pairs you have entered under Template Specification.
-
Click Apply to save your template specification.
Extracting Text from Content
With ADx, you can extract text from PDF contents and save it in a plain-text file.
-
Select the content.
-
Click Conversion.
-
Click Extract Text, and fill in the following fields:
Field Description Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.NEW_CONTENT
saves the output content as a new content that you can find underMy Contents
Temporary
saves the output file in the Representations access without attaching it to any content and shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
replaces the current working copy with the conversion result.Target Name
The name of the output file. -
Click Execute. You will get a notification that the job has started. Your content should be converted after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Prepare for WebReader
Use this option on contents which cannot be displayed in WebReader. Structure of the content changes as a result, making it possible to view it in Webreader. Examples of contents that cannot be viewed in WebReader are contents that do not have Representations automatically created at the time of content upload.
- Select one of the contents you want to prepare.
- Click Conversion.
- Click Prepare for Webreader. Your content should be prepared in a short while. You will get a notification that the job has started. Your content should be prepared after some time (depending on the current load on Conversion and the complexity of the content itself). You can check the current status of the job in Repository Cache Area.
Extract E-mail
This job can be run on e-mail documents. As a result, the e-mail body and attachments are extracted. Embedded resources (such as an image inside the e-mail body) can also be extracted.
-
Select the content.
-
Click Conversion.
-
Click Extract Email, and fill in the following fields:
Field Description Result Action
CONTENT_REPRESENTATION
saves the output content underRepresentations
of the original content.NEW_CONTENT
saves the output content as a new content that you can find underMy Contents
Temporary
saves the output file in the Representations access without attaching it to any content and shows a notification with a download button to download the output file. To find the file after the message has disappeared, click the Notifications Constellation (envelope) icon on the top right corner, and find the notification for this file.
UPDATE_WORKING_COPY
replaces the current working copy with the conversion result.Target Folder
Folder where conversion result will be stored Target Name
The name of the output file. Extract Embedded Resources
When selected, resources embedded in the e-mail body (such as images) will be extracted. When not selected, such resources will be skipped.