Index Categories Bulk Add Page

Purpose

This screen will allow you to select a list of INXtree categories (through the usual Category Selector) and then add them in one go to all fully-fledged objects that you marked using the appropriate controls on the Advanced Search Result Page before reaching the current page.

This process has been designed so as not to create duplicate INXlink entries, even in cases where both selections (objects and categories) could lead you to believe that it might.

Getting There...

This management page is common to all supported fully-fledged object types. To reach it:

Using the toolbar icons and navigation tabs, first go to the Advanced Search Page and use the drop-down control to select one of the fully-fledged object types as target for your search
Set suitable search criteria to select all the objects you want to process (don't worry if you select slightly more objects then really necessary -- you will be given the ability to ignore the extraneous ones before processing them)
Run the query, which leads you to the Advanced Search Result Page
Once there, mark all objects to be processed using the checkbox control next to their ID, and push on the INXlink button
You then reach the Index Categories Bulk Add Page

Please note that the object list you selected on the Advanced Search Result Page will be stored as a set of session variables for the duration of the processing. If you leave the page before the processing is over and then return to it, the content of those variables will be lost (which simply means that you will have to re-select the objects by going through the Advanced Search Page again.)

Supported actions

The Index Categories Bulk Add Page supports the following actions:

Remember: adds the selected INXtree category to the session variable used as temporary storage until the list is ready for processing. That action results from clicking the Select action link at the bottom of the list and then clicking on a particular category in the Category Selector window.
If the same category is selected multiple times, it will still only feature once in the list diplayed on the current page.
Level-1: replaces in the session variable used as temporary storage the specified category by its father in the INXtree. This action results from clicking on the Level [-] action link. No further confirmation is required.
Forget: removes the specified category from the session variable used as temporary storage. This action results from clicking on the Unlink action link. No further confirmation is required.
Update: replaces in the session variable used as temporary storage the specified category by a new one selected in the INXtree. This action results from clicking on the Level [+] action link and then clicking on a particular category in the Category Selector window.
Inject: loops through all selected objects and all selected categories and inserts the requested new INXlink entries in the database. This action results from clicking on the Add button located below the categories list. Once done, all session variables are cleared.

Fields

The "object - category relationship" record doesn't have any field at this stage that could be edited separately here, outside of what the action links and selector screens already described provide.

Controls

Link actions

For each selected relationship in the list, the last column of its row contains links that correspond to actions to be performed on the (prospective) relationship record.

Level-1: replaces in the session variable used as temporary storage the specified category by its father in the INXtree. This action modifies an existing session variable entry, it doesn't create a new one. No further confirmation is required.
Unlink: removes the specified category from the session variable used as temporary storage. No further confirmation is required.
Level+: opens the Category Selector in the same window. This enables you to select any other category, anywhere in the INXtree (either below, above or in a completely different branch), and replace the current entry in the session variable used as temporary storage with it.

In addition to this, a global action is available on the last row (bottom right corner) of the list:

Select: opens the Category Selector in the same window. This enables you to select any category in the INXtree (whether or not you already selected it previously) to be stored in a session variable until you are satisfied with your selection and ready to create the new relationships with all the objects currently selected.

Page actions

Once at least one category has been selected and is listed on the page, a new button is displayed below it:

Add: based on the current contents of the session variables, loops through all selected objects and all selected categories and inserts the requested new INXlink entries in the database. The process has been designed in such a way that no duplicate INXlink entries could be created this way (potential duplicates will be silently ignored, something that can be detected by observing the number of impacted rows reported for each query).
Once done, all session variables are cleared.