RoboFlowHelp.1.16

!!! warning "Legacy Documentation" This page contains documentation for the original RoboFlow application. Some features described here may not exist in the new Damtoolkit WAP interface.

WatchCategories (Process a list of categories)

The WatchCategory workflow launches a category query in every time-loop (or looks at the trigger-folder if specified). The results are categories that are processed one by one by calling the Action Script for Categories.

For each category, optionally, all its records (or a sub-selection via query) will be processed by calling the Action Script for Records.

After optionally processing the records, the Action Script for Post Categories is called.

Finally, an e-mail can be sent to notify about the categories processed.

Parameters

CumulusCatalog

Name of the catalog you want to watch (you can specify multi catalogs separated by semi-colon)

 Type in the name or click on the button to connect and select a catalog

CategoryQuery

Cumulus category query. For details on the syntax of the query see Cumulus Query Syntax.

RecordQuery

The Cumulus Record Query. Choose between:

• no-records-processed

• all-records-of-category

• ..type-in-a-value.. : for this option you have to specify the query to will be executed (narrow-search) on the records of the category

For details on the syntax of the query see Cumulus Query Syntax

e.g. ("Status" !*) || ("Status" != "offline")

EmailNotify

E-mail-address of person to notify for every record being processed (multiple e-mail-addresses separated by ;)

E-mail-Message-Configuration

Parameter file for the e-mail subject, body and message

Import Trigger Folder

Path of folder where trigger-files created by the Cumulus Server are stored for importing records categories instead of querying the whole catalog. To be able to use this functionality you need to install the RoboFlowTrigger in the Cumulus Server (see the RoboFlow installation guide)

Then for every category, new, modified or deleted (depending on your trigger-settings) a trigger-log-file is written to this folder by the Cumulus server application, containing the Catalog Name and Category ID.

In every loop of the workflow, if you specified this ImportFromStoredRecordTriggerFolder here, it will read these trigger-log-files and add the categories (watchcategories) to this collection and delete the processed trigger-log-files.

Then the workflow will perform the optional query specified above (narrow-search) on these categories instead of on the whole catalog.

If no trigger-log-files are found, no categories will be processed. Since the query on an empty collection is still an empty collection.

If you leave the Import Tigger Folder empty, the workflow will have its standard behavior, thus searching through the entire catalog using the query specified above...

Export folder for processed trigger

If specified, each trigger-file processed will be copied to this folder.