Introduction

Sometimes there may be a need to batch update a set of collection names. e.g. after a migration. This article explains how this may be achieved using the command line tool.

The Imago Connect+Tools application must be downloaded and installed before running the command line tool. The application provides two modes: A task based GUI for uploading/downloading images/attributes plus several other utilities A command line tool for downloading collections and images.

Batch Update Collection Names

I have a collection on the Imago Portal:

• Workspace: Sandbox
• Dataset: Drilling
• Collection: 2020A

However, I now want to rename the collection to 2020B.

This is the Collection on the Imago Portal before the update:

The Imago command line tool expects a parameter file, in csv format, to be passed which contains the relevant keys and changes. This is how it looks in Excel:

Column names must be as shown.

Assuming the csv file is in the folder "C:\Scratch", to execute the update, enter (using your own Imago login credentials, password masked in this example):

"c:\Program Files (x86)\Imago\imago-tools\imago-cmd.exe" updatecollections --user ImagoLiveKB --password xxxxxxx --filesource uid.csv

Output during and after execution:

The Collection has been updated:

Use multiple rows for multiple collections, one collection per row. This update can also be achieved using the Imago Connect Desktop application, be selecting the Upload Collections task.