This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

Profiles management in Bonita Portal

This page explains what a user with the Administrator profile can do with profiles in Bonita Portal. In all Bonita editions, those users can change the mapping between a provided profile and the organization entities. In Enterprise, Performance, and Efficiency editions, they can also create new profiles and edit them.

Here is a view of this page: Profiles in Portal

View profiles

In Organization/Profiles, the list shows all profiles sorted by alphabetical order:

  • Three provided profiles: "User", "Administrator", and for subscription editions,"Process Manager"

  • All custom profiles created, for Enterprise, Performance, and Efficiency editions

Edit a profile mapping with the organization

In specific situations, the Administrator may need to add or remove entities to the profile mapping. To do so:

  1. Go to Organization>Profiles

  2. Select a profile in the list

  3. Click on More…​

  4. To add, click on one of the for Add buttons depending on the right entity to add, select the entities, and click on Add To remove, click on the remove link in the table row of the entity you need to remove, and confirm the deletion

Edit a custom profile name and description

In specific situations, the Administrator may need to edit the name and/or description of a custom profile.
This is not allowed for default profiles.
To do so:

  1. Go to Organization>Profiles

  2. Select a profile in the list

  3. Click on More…​

  4. Click on the Edit button

  5. Edit the name and or description

  6. Click on Save

Edit a custom profile Portal navigation

In specific situations, the Administrator may need to add, remove, or reorganize pages and menus in a profile’s Portal navigation.

  1. Go to Organization>Profiles

  2. Select a profile in the list

  3. Click on More…​

    1. To edit or remove a menu, hover over the menu option and click on the pencil or trash can icon, then edit and save, or confirm the removal

    2. To reorganize the menu, drag and drop the menu horizontally to the right location

    3. To edit or remove a menu option, hover over the option and click on the pencil or trash can icon, then edit and save, or confirm the removal

    4. To reorganize options within a menu, drag and drop the option vertically to the right location

    5. To create a new menu, click on the Create button

    6. Name the menu, and select the default or custom pages for the menu, and click on Create

Export a profile

It may happen that the Administrator needs to export a profile, to reimport it in a Bonita Studio or install it on another Bonita Portal. To do so:

  1. Go to Organization>Profiles

  2. Click on the checkbox close to the profile or profiles to export

  3. Click on the Export button at the top of the list

  4. Confirm the exportation

  5. Select where to download it

  6. Click on Save

Add a profile

It may happen that the Administrator needs to import a profile, from a Bonita Studio or another Bonita Portal.
Less frequently, the Administrator may have to create a custom profile from Bonita Portal. To do so:

  1. Go to Organization>Profiles

  2. Click on the Add button

  3. Select whether you want to "import" or "create" a profile

    1. To import, click in the file field, select your .xml file, click on Open, and then on Import. It is possible to import a profile file made of several profiles. The file is imported and checked.
      A popup reports the status of the import. It shows the number of profiles successfully imported, partially imported, or with errors.

Note: The default profiles defined in Bonita have the flag isDefault set to "True" in the XML file. Do not change the setting of isDefault for any profile, or you will get an error message on import.

  1. To create, type the name and description, and click on the Create button. This will take you to the details page. Create the mapping with the organization entities, and if needed, create a Portal navigation.

Starting with Bonita 2021.1, because Bonita Portal is deprecated, we strongly encourage to create applications instead of Custom Profiles with navigation for Bonita Portal.

Delete a profile

Very rarely, the Administrator may have to delete a profile. It is not possible for Bonita default profiles.
Deleting a profile will not delete the mapped entities, but if the custom profile has a Portal navigation, this will be deleted.
To do so:

  1. Go to Organization>Profiles

  2. Click on the profile to delete

  3. Click on the Delete button

  4. Confirm the deletion