'Rights Group Conversion' Action

enaio® 10.10

The 'Rights group conversion' action converts an index data field that has the rights group add-on into a 'rightsgroupcontrol' field.

'rightsgroupcontrol' fields have the same functionality (except for verification) as fields with rights group add-ons, except that the data in the database is stored in a different way to significantly speed up access to the data in systems with many users and groups.

'rightsgroupcontrol' fields differ from fields with permissions group add-ons in terms of how data is verified: Data that was previously assigned via scripts or imports and data of users and groups that no longer exist are retained during conversion. However, the index data of such objects can only be changed in enaio® client if the rights group control field is also changed.
'Rights group control' fields require a system that has been converted to the clause syntax version 8.50 or higher. Only clauses with the '#RIGHTGROUP#' reference and 'is null' clauses are allowed for these fields.
Certain field properties are not supported: During conversion, these field attributes are automatically reset to the default values.

Conversion takes place in two steps:

Data for those fields with rights group add-ons that are to be switched over to the rights group control is generate in step one. This step can be done while the system is running and takes some time, depending on the number of fields, users, and groups.

This step can be reset.

Step two can only be performed if the system is not being used. It is determined whether additional data has been added to the system after step one. Missing data is generated, the desired fields with rights group add-ons are converted to rights group control fields in the object definition, and the server engines are reloaded.

Conversion is completed in step two.

Fields with rights group add-ons and 'Rights group control' fields can be used on a system.

Fields with rights group add-ons can only be converted if no scripts refer to this field and if only clauses with the '#RIGHTGROUP#' reference and 'is null' clauses are used.
If clauses that block conversion are assigned to a field, these clauses are displayed. However, the field cannot be selected for conversion.

'Rights Group Conversion' Configuration

To use this action, add the axacpdfa.dll library (see ''Additions' Tab').

When setting up the automatic action, the configuration dialog opens immediately:

Select the index data fields that you want to convert.

Step 1: Confirm by pressing OK.

The dialog is closed.

Start the action or generate the command for enaio® start and execute the action there.

The data for the rights group control is generated in the database.

Open the configuration dialog.

Step 2: Select the option Only step 2 and confirm by pressing OK.

The dialog is closed.

This step may only be performed if it is ensured that data is not accessed.

Start the action or generate the command for enaio® start and execute the action there.

The object definition is changed and the server engines are reloaded.

Step one can be reset via the configuration dialog as long as step two has not yet been carried out.

If data is not accessed, steps one and two can be performed in succession via the configuration dialog.