Configure the Security File

The security file allows you to establish connections between data from the Course Completions Manager Domain and the intended user profile, ensuring that a specific viewer will only see certain data deemed relevant by an administrator.

This section of the Manager View Case Study provides you with a ready-made security file primed to create the Manager View, with the necessary user profile and Domain attributes already entered. If you would rather configure a different view with the security file, see Creating Views and Next Steps.

To create the Manager View security file, complete the following steps:

Open your preferred text editor (i.e. Notepad).

Paste the following security file template into your text editor:

<securityDefinition xmlns="http://www.jaspersoft.com/2007/SL/XMLSchema" version="1.0" itemGroupDefaultAccess="granted">
        <resourceAccessGrants>
                <!--Row level security -->
        <resourceAccessGrantList id="JoinTree_1_List" label="ListLabel" resourceId="JoinTree_1">
        <resourceAccessGrants>
                <!--Row level for organisations -->
        <resourceAccessGrant id="Jointree_1_row_access_grant_20">
        <principalExpression><![CDATA[authentication.principal.attributes.any{it.attrName in ['userid'] }]]></principalExpression>
        <filterExpression>testProfileAttribute(mdl_pos_assignment.managerid,'userid')</filterExpression>
        </resourceAccessGrant>
        </resourceAccessGrants>
        </resourceAccessGrantList>
        </resourceAccessGrants>
</securityDefinition>

Save the security file XML on your computer with a unique name: "coursecompletion_manager_security.xml"

After creating the security file, you are ready to add it to the "Course Completions Manager Domain" to apply the security settings for the Manager View.

To add the security file to the Domain, complete the following steps:

From the Repository, open the new “Course Completions Manager Domain” from your private folder structure by right-clicking it and selecting Edit from the context-menu.
From the Edit Domain page, click the Add Security File link from below the Optional Information header. The Add Security File window opens.
Ensure that the Upload a Local File option is selected.
Click the Choose File button to open a browser of your local drive.
Select your security file (coursecompletion_manager_security.xml) and click Open. The name of your security file will now display next to the Choose File button.
Click the Select button to upload the security file.
Zoola™ validates the security file during the upload; if the file is invalid, it will not upload.
Once the file is uploaded, it will display in the Optional Information column in the Security File section. You can return to it in the future to edit or remove the file by clicking Change orRemove , as needed.
To save your changes to the Domain, click the Submit button.

The Course Completions Manager Domain is now secured to establish a connection between the "User ID" of the viewer (the Manager) and the "Manager ID" of all student data in the Domain. You are now ready to begin creating Views that will display customized information. Move on to Step 4: Creating Views and Next Steps to explore your options for making use of the Manager View.

Page tree

Configure the Security File