Attached object configuration

This document describes the permissions and procedures related to the management of attached objects in the beqom Web Application.

Migrating Legacy Attached Process Objects

Different database tables are used in Admin Portal and in Web Application to manage process attached objects. In legacy versions, the table k_m_plans_form_report is used. In Web Application, the table bqm_object_relation is used.

Due to this difference in database structure an migration operation is required to be able to use legacy attached objects in the Web Application interface of the beqom application.

Permissions

In order to be able to manage attached objects in the Web Application, the profile used by the administrator needs to have been granted the following permissions:

• Admin > Technical Admin > Synchronization & Data Security > Create

• Access to the design component must be granted

This is an attention message.

These permissions must be specifically granted, even to super admin users.

To grant the permissions, proceed as follows:

1. Log into the beqom Admin Portal interface and then open the (Undefined variable: CompoVariables_AP.Admin).

2. Navigate to Functional Admin > Profiles > <ProfileName> > Admin.

3. In the Modules Tree section, click Technical Admin and then Synchronization & Data Security.

4. In the "Assign Rights" section, click Create.

5. Open the "Design" tab of the profile rights management panel.

6. Click the padlock icon to grant the profile access to the component.

Performing the Migration

To perform the migration of process attached objects from k_m_plans_form_report to bqm_object_relation, you need to execute the following API method:

Service	Action	Endpoint
Gateway	POST	/api/ProcessExplorer/SynchronizeProcessAttachedObjects

Once the migration is performed, the application will synchronize the changes performed to attached objects by automatically calling the object service each time an object is modified in the Admin Portal interface.

Changing the Order of Attached Objects Under a Process

By default, attached objects are displayed in process grids in the order which they are created. It is however possible to change the display order of attached objects. To do so, proceed as follows:

1. Execute the following API method:

Service	Action	Endpoint	Parameters
Object	GET	/api/objects/{id}/relation	Where: {id} is the UID of the parent object (in this case, the process)

2. Locate the ID of the object whose order you want to change.

3. Execute the following API method:

Service	Action	Endpoint	Parameters
Object	PATCH	/api/objects/{id}/relation/{idChild}/order	Where: {id} is the UID of the parent object (in this case, the process) {idChild} is the ID of the object order is the relation order that you want to give to the object