Overview

Export via IDM Utilities Tool

Business Problem

Your organization has a repository containing various document types. However, you now need to export a specific type of document to another repository. Since you manage multiple repositories, you want to transfer all documents of a particular type to a designated repository.

To achieve this, you can use the IDM Utilities tool, which allows you to export the chosen document type along with its metadata and associated files.

Description

📋 Requirements

To follow this guide, you should have:

A basic understanding of how to use the command line.
IDM-Administrator role
User privileges to:
ION Desk (IONDeskAdmin).
ION API Gateway (IONAPI-Administrator).
A local machine with at least 16GB RAM (for large imports/exports).
Java 8+ installed on the local machine.

Tutorial: Exporting Documents via IDM Utilities Tool

1

Downloading the IDM Utilities Tool

To access the Export function in IDM:

Navigate to the Control Center.
Select the Tools tab.
Click on Utilities, then Download.

2

Starting the Tool

After unzipping the downloaded utilities package, you will find two .jar files.

Run the file without "sources" at the end of its name.

Running the Tool in Command Line

Navigate to the folder containing the .jar file.
Open the command prompt in that folder by typing cmd in the address bar and pressing Enter.
Run the following command to open the GUI: java -jar <ExecutableJarFileName>.jar Example: java -jar Utilities-2022.08.00-47.20220728T090651Z.jar

3

Setting Up the IONAPI File

To connect the IDM Utilities tool to your environment, generate an IONAPI file:

Navigate to Infor ION API.
Click on Authorized Apps.
In the search bar, type IDM and look for an API labeled Backend Service.

Click on it, scroll down, and select Download Credentials.
Enable Create Service Account, enter your name, and click Download.

4

Running the Export Tool

Use the .jar command from earlier to start the tool.
Upload the IONAPI file you created.

Export Process

The export consists of two steps:

Exporting Metadata (must complete successfully).
Exporting Files (can be resumed if interrupted).

Key Settings in the Export Tab

Path: Directory where configuration XML files are saved.
User Access: Ensure your user has permission to access all documents.
Checked-in Documents: Only checked-in documents will be exported; checked-out documents are skipped.
Search Query: Used to specify which documents should be exported.

5

(Optional) Generating XQuery

If you need to refine your document search, use the IDM XQuery Builder:

Open IDM XQuery Builder in IDM.
Input the search criteria.
Click Enter Query Manually at the top to generate the XQuery.
Copy and paste the XQuery into the Batch Update section.

Video Guide

Watch the tutorial video here:

Command Line Arguments

If you prefer running the tool via the command line, use these arguments:

Argument