Defining permission mappings for BMC Helix Knowledge Management by ComAround


As an administrator, you can map companies and support groups from your BMC application to a

WarningSome content is unavailable due to permissions.

portal and user groups to set the knowledge permissions in

WarningSome content is unavailable due to permissions.

. These mappings enable your users to access knowledge articles in

WarningSome content is unavailable due to permissions.

. Users can access the knowledge articles based on their knowledge permissions as defined in your BMC application.

Before you begin

Make sure that the following actions are performed to create the knowledge structure in

WarningSome content is unavailable due to permissions.

:

Action

Role

Create portal.

BMC team

Create user groups.

BMC team

Create folders.

Administrator who must run the synchronization job in

WarningSome content is unavailable due to permissions.

 to create folders.

Map user groups to portal and folders.

BMC team


To map companies and support groups from your BMC application to BMC Helix Knowledge Management by ComAround

After the portal and folders are created in

WarningSome content is unavailable due to permissions.

, and BMC has created and assigned user groups to them, you can map companies and support groups from your BMC application to a

WarningSome content is unavailable due to permissions.

portal and user groups to set the knowledge permissions. You can also modify the defined mappings.

  1. Log in to

    WarningSome content is unavailable due to permissions.

    and navigate to the Administration tab. 
  2. Select Knowledge management Knowledge access mapping.
  3. Select the company and support group for which you want to define or modify the mapping:
    1. In the Company field, select one of the following options:
      1. All companiesWhen you select this option, the table displays all the companies available to you. The support groups are not displayed. Therefore, with this option, you can only map the companies to

        WarningSome content is unavailable due to permissions.

        user groups. 

        Warning

        Important

        If you want to define or modify the mapping for a specific support group associated with a particular company, select this company from the Company list first. 

      2. Specific company—A particular company for which you want to define or modify the mapping. When you start entering the name of the company, the Company list is instantly filtered based on your input. 
        For example, Apex Global.
        The list of support groups is displayed in the table for the selected company.

        Warning

        Important

        BMC Helix Digital Workplace Advanced or BMC Helix Virtual Agent users don't belong to any support groups. Therefore, you cannot map specific support groups to user groups in

        WarningSome content is unavailable due to permissions.

        . You can only map companies to which these users belong in BMC Helix Digital Workplace Advanced or BMC Helix Virtual Agent to

        WarningSome content is unavailable due to permissions.

        user groups.

    2. In the Line of business field, select one of the following options to filter the list of support groups by a line of business:

      Warning

      Important

      • If you have selected the All Companies option from the Company list, skip this step. Filtering by a line of business doesn't work for the list that displays only the companies. 
      • Association with a line of business is available only for support groups in

        WarningSome content is unavailable due to permissions.

        .

        WarningSome content is unavailable due to permissions.

        doesn't support lines of business.
      1. All—All support groups defined for the selected company are returned. This option returns groups for both

        WarningSome content is unavailable due to permissions.

        and 

        WarningSome content is unavailable due to permissions.

        .
      2. None—Only support groups for

        WarningSome content is unavailable due to permissions.

        are returned.
      3. Specific line of business— Only support groups associated with this line of business in

        WarningSome content is unavailable due to permissions.

        are returned. 
        When you start entering the name of the line of business, the Line of business list is instantly filtered based on your input. 
    3. Select the support group for which you want to define or modify the mapping. 
      For example, Apex Global Helpdesk.
  4. Click Map access. 
  5. Map the selected support group or the company with the appropriate user group in

    WarningSome content is unavailable due to permissions.

    :
    1. On the New knowledge access mapping page, from the Knowledge management portal list, select the portal with which you want to map the company. 

      Warning

      Important

      You must map companies to the portal selected in your knowledge configuration.  

      For example, Apex Global.
      In Permission groups, the support group or the company that you selected in step 3 is displayed. 

    2. From the Knowledge management user group, select a single or multiple user groups that you want to map with the selected support group. 
      For example, select all Apex_Global_helpdesk groups.

      Warning

      Important

      In

      WarningSome content is unavailable due to permissions.

      , user groups are created for each KCS role. Multiple groups may belong to the same group set and have the same base name but different suffixes to represent different KCS roles. For example, the Apex_Global_helpdesk group set includes the following user groups:

      • Apex_Global_helpdesk_reader
      • Apex_Global_helpdesk_candidate
      • Apex_Global_helpdesk_contributor
      • Apex_Global_helpdesk_publisher
      • Apex_Global_helpdesk_manager
      • Apex_Global_helpdesk_coach

      When mapping support groups or companies to user groups, you must consider the KCS roles of the users. Select the user group that corresponds to the highest-level KCS role selected for a user under Application Permission and IS Personas on the CTM:People form. For

      WarningSome content is unavailable due to permissions.

      users, also account for assigned functional roles. For more information, see Knowledge permissions and roles mapping from BMC Helix Business Workflows to BMC Helix Knowledge Management by ComAroundFor more information about defining user roles in general, see Permission-mapping-overview-for-BMC-Helix-Knowledge-Management-by-ComAround.

      In Accessible folders, a list of folders accessible to the selected user group is displayed. 

      This is a read-only list that displays the parent folders only. To view the child folders, click the parent folder. 

  6. Click Save
    On the Knowledge access mapping page, the status of the support group that you selected is changed to Mapped

The following image shows an example mapping:

Knowledge_mapping_UI.png


To view access permissions for users in

WarningSome content is unavailable due to permissions.

After mapping knowledge permissions from BMC applications to

WarningSome content is unavailable due to permissions.

, you can easily view the permissions assigned to users in

WarningSome content is unavailable due to permissions.

. You can see each user's role and the support groups to which the user belongs. You can view the access permissions for users belonging to companies for which you have defined knowledge access mappings. 

By using this capability, you can quickly understand user access, making it easier to verify, troubleshoot, and correct any issues with roles and permissions in

WarningSome content is unavailable due to permissions.

To view access permissions for a particular user, perform the following steps:

  1. Log in to

    WarningSome content is unavailable due to permissions.

    and navigate to the Administration tab. 
  2. Select Knowledge management Knowledge access mapping.
  3. Click the Test access button.
    test_access_button.png
  1. In the User name field, select the required user from the list. 
    When you start entering the user's full name, login ID, or email address, the list of users is instantly filtered based on your input. If you enter invalid user details, no matches will be returned. 
    Select_user.png

After selecting a user, their access permission details are shown. Expand the Role and HKM user groups sections to view these details. To view the access permissions of another user, start typing that user's full name, login ID, or email address in the User name field.

access_details.png

You can see the following information about the access permissions of a particular user:

Permission details

Description

Example

Role

You can view the role assigned to a user in

WarningSome content is unavailable due to permissions.

. User roles in

WarningSome content is unavailable due to permissions.

are based on a user's existing application permissions or functional roles.

WarningSome content is unavailable due to permissions.

identifies the user's role to be the highest-level KCS role out of all roles selected under Application Permission and IS Personas on the CTM:People form. For

WarningSome content is unavailable due to permissions.

users,

WarningSome content is unavailable due to permissions.

also accounts for assigned functional roles. For more information, see Knowledge permissions and roles mapping from BMC Helix Business Workflows to BMC Helix Knowledge Management by ComAround
In addition to the user's role in

WarningSome content is unavailable due to permissions.

, you can view the application permissions or functional roles that were used to assign the role. 

role.png

HKM user groups

You can view the user groups that a user belongs to, along with an explanation for why the user is assigned to these groups based on access mapping.

groups.png

Learn more about how user roles and user groups are assigned in Permission-mapping-overview-for-BMC-Helix-Knowledge-Management-by-ComAround.


Result

When users search for knowledge articles in your BMC application,

WarningSome content is unavailable due to permissions.

returns the articles based on the defined mapping and the KCS role of a user in

WarningSome content is unavailable due to permissions.

This rule applies to the articles synchronized from

WarningSome content is unavailable due to permissions.

or

WarningSome content is unavailable due to permissions.

to

WarningSome content is unavailable due to permissions.

and the articles created directly in

WarningSome content is unavailable due to permissions.

.

When users launch

WarningSome content is unavailable due to permissions.

directly from your BMC application, their access to knowledge articles is determined by the defined mapping and the KCS role of a user in

WarningSome content is unavailable due to permissions.

Warning

Important

After you map companies and support groups from your BMC application to

WarningSome content is unavailable due to permissions.

portal and user groups, you can change the folder names and structure in 

WarningSome content is unavailable due to permissions.

, if necessary. However, when you move a folder to a new location in

WarningSome content is unavailable due to permissions.

, it inherits the knowledge permissions and user groups of the new parent folder. Therefore, if support groups from your BMC application haven't been mapped to the user groups of the new parent folder, your users won't be able to access the moved folder.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Innovation Suite 25.1