Render (Activity)

⚠	This article was migrated from an older version and has not been updated for the current version of Grooper. This tag will be removed upon article review and update.

This article is about the current version of Grooper.

Note that some content may still need to be updated.

2025

2024

2023

2.80

The Render activity's property panel

print Render is an Activity that converts files of various formats to PDF. It does this by digitally printing the file to PDF using the Grooper Render Printer. This normalizes electronic document content from file formats Grooper cannot read natively to PDF (which it can read natively), allowing Grooper to extract the text via the format_letter_spacing_wide Recognize Activity.

You may download and import the file(s) below into your own Grooper environment (version 2024). There is a Batch with the example document(s) discussed in this tutorial.
Please upload the Project to your Grooper environment before uploading the Batch. This will allow the documents within the Batch to maintain their classification status.

Media:2024_Wiki_Render_Batch.zip

About

Render effectively "prints" the document as a PDF file, outputting a PDF document containing a scanned image of that document and any native text data. This is done using the Grooper Render Printer. In order to do this, four conditions must be met:

The Grooper Render Printer must be installed on the machine running the Render activity. For information on how to install the Grooper Render Printer visit the How To section of this article.
The Grooper Render Printer must be set as the default printer under for the user account running the Render activity.
The native application for the file type must be installed on the machine running the Render activity. For example, Word must be installed in order for Render to render .docx files as PDFs.
The native application must provide a shell print verb. In other words, when you right click the file in Windows File Explorer, a "Print" option is present.

Once the document is processed with the Render activity, you will be able to manipulate the document as if it is a PDF document in Grooper. You will be able to use other PDF related activities, such as Split Pages to split out individual pages of multi-page PDFs and the native PDF text extraction functionality of the Recognize activity.

Before rendering to PDF using Render

After rendering to PDF using Render

Render and Activity Processing

For Batch processing, the Render activity can only run on one individual machine at a time, using a single thread of processing resources. This means a Grooper Activity Processing service must be created using a Processing Queue with its Concurrency Mode set to PerMachine.

Processing Queues control how much of your system's resources are allocated to processing Activities. Most activities can take full advantage of your system's parallel processing resources and grab multiple threads at a time. Furthermore, multiple instances of an activity can generally run on multiple machines.

For example, four workstations working in the same Grooper Repository could each run two instances of the Recognize activity as long as there are the threads available to process each task.

However, the Render activity is different. It can only run on one machine at a time, using a single thread. To reiterate, that means only one Render task can perform at a time on a single machine at a time.

Each document rendered by the Render activity must be converted to a PDF one at a time.
Furthermore, if multiple machines are attempting to execute the Render activity, they have to wait their turn until the machine ahead of them is finished.

For more information on how to set this up, visit the How To section of this article.

How To

There are several components to consider for configuration of the Render activity.

Install the Grooper Render Printer

1. Download the Grooper Render Printer installer

First, download the Grooper Render Printer Installer. Click this link to download the installer files.

2. Extract the installer files and run the installer

Locate the downloaded zip file in Windows File Explorer. Right click the zip file and select "Extract All..." In the next window, choose the location to extract the installer files and press the "Extract" button.

Navigate through the extracted folders until you locate the "Setup.exe" file, seen below. Right click the "Setup.exe" file and select "Run as administrator"

3. Step through the installer prompts

Upon opening the "Setup.exe" file, the Grooper Render Printer Installer will run. Click the "Next" button to continue through the installer's prompts.

Press the "Finish" button to finish installing the Grooper Render Printer.

4. Set the Grooper Render Printer as the default printer

Open the Devices panel in your machine's Windows Settings. You will see the Grooper Render Printer listed in the "Printers & scanners" tab.

To make the Grooper Render Printer your default printer, select the Grooper Render Printer from the list of printers and scanners and press the "Manage" button.

On the following screen, press the "Set as default" button. Ensure that the "Printer status:" is listed as "Default"

Set up Activity Processing for Render

1. Add a new Processing Queue

In order to use the Render activity in a Batch Process, you will need to create a new Processing Queue.

Processing Queues are created in the Queues folder.
Right click the Queues folder and select "Add" then "Processing Queue..."
Name the Processing Queue whatever you'd like. Press "Execute" to finish naming the Processing Queue and create it.
- Since we are configuring an Activity Processing Service to run the Render activity, it makes sense to name this Processing Queue "Render".

This creates a new Processing Queue object with the given name in the Node Tree.
Change the Concurrency Mode property from Multiple to PerMachine
- You may see a popup window saying "You must run Grooper as an Administrator to modify services." This is letting you know you will need to run Grooper Command Console as an administrator to create and edit the Activity Processing service that will use this Processing Queue. However, you must still create the Processing Queue from the Design page. Just press the "OK" button to get rid of this window.
Press the "Save" button when finished.

⚠	Render must run using a PerMachine Concurrency Mode

2. Set up the Activity Processing service

Next, you must Install an Activity Processing Service using the Tread Pool created in the previous step. Grooper Services are installed through the Grooper Command Console application. You must run Grooper Command Console as an administrator to install and edit services.

⚠	You must run Grooper Command Console as an administrator to install or edit a Service.

In Grooper Command Console enter the following command:

services install <connectionNo> <typeName> <userName> <password> [threadCount] [queueName]

<connectionNo> (required):

Replace this with the integer representing the appropriate connection. Use the connections list command to get a list of your connections.

<typeName> (required):

Since we are installing an Activity Processing service, replace this with ActivityProcessing.

<userName> and <password> (required):

Replace these with the appropriate Active Directory credentials of your Grooper Service User.

[threadCount] and [queueName] (optional):

If you want to specify a specific thread count, replace [threadCount] with an appropriate integer. This will need to be set to an integer of 1 for Render to function properly.
If you want to specify a queue name, replace [queueName] with the name of an appropriate Processing Queue object. Enter the name here of the Processing Queue that was created in the Queues folder object on the "Design" page.

3. Configure the Activity Processing service

Please refer to the command from the previous section. The configuration requirements for this service are set upon installation of the service in Grooper Command Console. The key considerations for configuration for Render is making sure the [threadCount] is set to 1 and the [queueName] is set to the name of the Processing Queue that was created in the Queues folder object on the "Design" page.

4. Set the Processing Queue in your Batch Process Step

Last, the Render step of your Batch Process must be told which Processing Queue to use.

Select the Render step of your Batch Process.
In the "Step Properties" panel, select the Queue Name property. Using the dropdown menu, select the Processing Queue created in Step 1 (Here, named "Render").

Set up Render Printer for multiple users and service accounts

Grooper Render Printer installs under the context of a single user: The account/user that is logged in when installing it for the first time.

In typical scenarios, this is the service account running the Activity Processing service processing Render tasks.

If only one account/user is ever going to process Render tasks, this is no problem. However, if multiple users need to process Render tasks, additional steps need to be taken to ensure multiple users can run the Grooper Render Printer.

To ensure a user/account who did not install the Grooper Render Printer can use it to execute Render tasks, perform the following configuration tasks:

Log in as the user/service account that will execute Render activity tasks.
Ensure the Grooper Render Printer is the default printer.
- Open the "Printers & Scanners" settings in Windows. Select the Grooper Render Printer. If it is not already listed as "Default", select "Manage". Then, select "Set as default".
Go to the local user/account's "Documents" folder in Windows File Explorer.
- C:\Users\<loggedInUser>\Documents\
Create a folder named GrooperRender
Next, you will need to edit the environment variables for the logged in user (not the system variables).
- An easy way to find these is to hit the Windows Start button and search for "Edit environment variables for your account".
In the "Environment Variables" window, click "New..." under the "User variables for <loggedInUser>".
- A "New User Variable" window will appear.
For the "Variable Name:" enter GROOPER_RENDERPATH
For the "Variable Value:" enter the path for the folder created in Step 3.
- C:\Users\<loggedInUser>\Documents\GrooperRender
Click "OK" in the "New User Variables" window.
You should see the new variable added to the "User variables for <loggedInUser>" list. Click "OK" to finish.