2023.1:Grooper Basics - Overview

WIP	This article is a work-in-progress or created as a placeholder for testing purposes. This article is subject to change and/or expansion. It may be incomplete, inaccurate, or stop abruptly. This tag will be removed upon draft completion.

This article is about an older version of Grooper. Information may be out of date and UI elements may have changed.
2025	2023.1

This article serves as a beginner's guide to Grooper. In this article we will go over the most basic concepts and activities within the Grooper software so you can start using it for your company's needs.

Introduction

Grooper is a powerful document processing software that can be tailored to your company's individual needs.

When first diving into Grooper, the software can be a bit overwhelming, especially if you have not worked with document processing software before. The purpose of this tutorial is to familiarize users with the fundamental basics of Grooper. By the end of this tutorial you should understand how to take a set of documents from beginning to end through a very simple process and export out of Grooper.

The 5 Phases of Grooper

From the time that documents are pulled in to Grooper to when those same documents are exported from Grooper, all those documents must go through what we call the "5 Phases of Grooper".

The 5 Phases of Grooper are as follows:

1. Acquire
2. Condition
3. Organize
4. Collect
5. Deliver

This tutorial is structured to go through each of the phases one by one. Other tutorials and courses will build on what we learn here. For now, let's break down each of these phases and see what we can expect as we build out our project.

Phase 1: Acquire
The "Acquire" phase involves bringing the documents to be processed into Grooper.

Phase 2: Condition
The "Condition" phase is where we take the documents we have brought into Grooper and edit them until we have something Grooper can work with. Before Grooper can do anything with a document, it needs to be able to Recognize the text on the document. That is one of the most important parts of the Condition phase.

Phase 3: Organize
Once Grooper can recognize text it then needs to be able to tell what the document is. Without our input, Grooper just sees the document as pages in a folder. We need to give the document a name or a "classification". We classify documents in the "Organize" phase.

Phase 4: Collect
In the "Collect" phase, Grooper can finally collect or "extract" information from the documents.

Phase 5: Deliver
The final phase of Grooper is the "Deliver" phase where we export the documents and metadata out of the Grooper software to wherever you wish to store the files.

These five phases encompass a full project in Grooper. In the next sections, we are going to put together a project step-by-step, going through each phase.

Navigating the Web Client

Before we continue, let's take a moment to look at Grooper's interface. For now we are only going to take a look at the Home page and the Design page as that is where we will be spending most of our time in this tutorial.

The Home Page

1. Context Toolbar: At the top of the screen you'll find a toolbar with several icons to the left, the page name, repository name, and Licensee information in the middle, and a few extra icons to the right. The leftmost icons will take you to different Grooper pages, with the first icon taking you to the Grooper home page. The rest of the icons are described more below as they are also found under "Navigation Links". The icons on the right allow you to change the Grooper Repository you are working in, look at your user information, and bring up the in-app Grooper help.

2. Navigation Links: In the first panel in Grooper at the top left you will find the Navigation Links. These icons will take you to the different Grooper pages:
   • Design: This is where we will be working for the majority of this tutorial. The Design page is where you configure your Grooper Project.
   • Batches: On the Batches page you can view all Batches that are currently in production. You can also add new Batches from this page.
   • Tasks: Here you can view any production that is pending review.
   • Imports: You can view a list of recent imports on the Imports page.
   • Jobs: Here you can see what jobs have been submitted and what stage each job is in.
   • Stats: The Stats page will take you to a place where you can view various Grooper statistics.
   • Learn: This icon will take you to the home page of our Grooper University courses at learn.grooper.com.
   • Wiki: This icon will take you to the home page of our Grooper Wiki website at wiki.grooper.com.

3. Repository Info: In the second panel on the home page you can get a lot of information about what is currently contained within and is being processed in the repository.

4. Recent Events: The final panel of the home page will show information regarding recent processing events and errors.

The Design Page

For now, we are going to focus on the Design page, as that is where we will be doing most of our work in this tutorial. In this section, we will look at the UI of the Design page and explain how things are organized to make it easier to navigate and follow along with the rest of this tutorial.

1. To navigate to the Design page, click on the hammer and wrench icon in the Context Toolbar or you can click on the same icon located on the home screen in the "Navigation Links" panel.
2. At the top-middle of the window, the page you are currently on will be displayed.
3. The first panel on the left side of the screen is the "Node Tree". This is where you will navigate through the different elements in your repository.
4. To the right of the Node Tree you will find different panels of information and configuration options for the element you have selected in the Node Tree. These panels will be different depending on the type of object you have selected.

5. The first element at the top of the Node Tree is called the "Root Node". Here you can find various information about your repository, including your licensing information.
6. For each element in the Node Tree selected, there will be multiple tabs you can access with different information and options. These tabs are located at the top of the configuration panels.

The Batches Folder

1. The Batches folder in the Node Tree is where we will find all documents brought into Grooper as a Batch.
2. Inside of the Batches folder are two folders: Production and Test. We will be working in the Test folder.

3. Inside of the Test folder is where all Batches of documents you are using to test your project will be kept. You can create subfolders inside the Test folder to keep Batches organized. For now we are going to look at our first object in Grooper: a Batch object.
4. With the Batch object selected, click on the "Viewer" tab.

FYI

You might notice that the icon to the right of "2023.1_Grooper-Basics_Batch" looks different than the other folder icons. Different elements in the Node Tree have different icons depending upon what type they are. Folders have a folder icon where objects have an icon that represent the object itself. This icon represents a Batch object. It is recommended that you familiarize yourself with the different icons and what objects they represent as you learn Grooper. It will make navigating the Node Tree much easier and will help the object hierarchy make sense.

5. The first panel to the right of the Node Tree in the Viewer tab is the Batch Contents panel. Here you can see the various folders and pages of your Batch.
6. To the right of the Batch Contents panel is the Document Viewer. Here you can see a preview of the selected page.

7. If we open up the various folders in the Node Tree under the Batch object, we can see the same folders and pages shown in the Batch Contents panel.

The Projects Folder

1. The Projects folder will contain all of your various Grooper projects.
2. You can create various projects at once and make folders to keep things organized.

3. Inside of your project object, you will add various objects and folders that will build out your project.
4. Just like in the Batches folder, when you select an object, you will have different tabs you can access.
5. You will have a properties panel and various other panels depending on what tab you are accessing on which object.
6. At the bottom of the screen you will see a panel that contains the Grooper in-app help. It will display definitions, tips, and explanations of whatever object or property you have selected.

Building the Project

Now we are going to actually build out a project from start to finish showing the most basic functionality of Grooper. This will give you a basic understanding of Grooper's fundamentals and you can build out your knowledge from there using other tutorials and courses.

Before we start building, let's take a look at what we hope to accomplish in our project. For this project we have a few invoices we want to bring into Grooper. We want Grooper to take these documents and move them to a folder, but name them in such a way that they are organized and easier to search through. We want Grooper to create a folder named after the company listed on the invoice and then name the file based on the Invoice Number.

We want Grooper to do all the work for us in an automated fashion, so we are going to put together a Batch Process, which essentially tells Grooper how to process the document.

1. Within the Batch process we will have various Batch Process Steps which are the individual ordered instructions of what to do with a Batch.

According to our Batch Process Grooper will perform the following in order:

1. Split Pages: Grooper will take the Batch and split out the document into individual pages.
2. Recognize: For Grooper to be able to do anything with the documents, it first needs to understand and be able to "recognize" the text on the document. That happens in this step.
3. Classify: While we as humans might recognize our document as an invoice, Grooper has no way to know what a document is. In this step we give it a classification.
4. Extract: Grooper will then collect information from the document. For our needs we will be extracting the company name and invoice number.
5. Export: Finally, the documents will be exported into a new folder named after the company and the pdf file names will reflect the invoice number.

The file set below is our expected outcome:

Phase One: Acquire

Let's get started building our Project.

We need to start with the first phase of Grooper: Acquire.

Before we can do anything with Grooper, we first need to give Grooper something to work with. We need to bring documents into Grooper. The documents are brought into Grooper into a Batch object. So the first thing we need to do is create a Batch object where we can keep our documents.

1. In the Batches folder, right-click on the Test subfolder.
2. Hover over "Add" and then click on "Batch...".

3. When the "Add" window pops up, type in a name for your Batch.
4. Click "EXECUTE" to create the Batch object.

5. Now we should have a new Batch object in our Node Tree.
6. With the Batch object selected, click on the "Viewer" tab.

7. Now we have an empty Batch. In the viewer tab we can see we have a Batch Folder, but nothing inside.

8. We want to drag and drop the PDF documents from a file on our computer or server to the Batch Folder.

9. Now our documents are copied into Grooper. This completes the "Acquire" phase of Grooper for this project.

Folder Levels

Before we go any further, we need to talk about a concept called "Folder Levels" in a Batch.

---

---

---

In the Batch we just created, the original folder that was part of the Batch when it was created is at the "Batch Level" and the folders that were created when we added the documents to the Batch are at "Folder Level 1".

This will become important as we continue through the rest of the Grooper phases.