Rights Repository (Magic xpa 3.x)
You can access the Rights repository by selecting Rights from the Project menu, pressing Shift+F5, or clicking Rights in the Navigator pane.
The Rights repository lists the name and keys of all the rights defined for the project.
The developer can define a bank of rights and assign them to the project's various repositories and elements. Any project element that has an access right assigned to it will be blocked to users who have not been assigned this right. Project-layer security can be defined only during project development.
The Rights repository has the following properties:
|
|
|
|
Name
|
Name is intended to be a description of the right, for example "Create-Customer". The name given here will appear as part of the title in Rights Assignment dialog boxes for this right.
This Name is used in the parameter of the Rights function.
|
|
Key
|
The internal name used to identify a Right. The example sets XYZ as the key for creating customer records. This key will be used to associate this Right to a user, by placing XYZ in that user’s Rights repository.
The maximum number of characters for this property is 10.
|
|
Public
|
The valid values for the Public property are:
Yes – The right is made visible outside of the project, in the Rights repository for the user or group of users. Whenever the Supervisor is working with the User ID or Groups repositories.
No – The right is concealed from the view of the Supervisor when with the User ID or Groups repositories. A developer may want to conceal rights to protect certain core elements of the project while allowing access to the others.
It is not necessary for the Supervisor to know the Key to a public right, because the right’s name will appear as the search argument in a selection list that returns the right’s Key. However, the Supervisor can assign a non-public right to users or groups only by directly typing in the Key - the selection list will not, of course, include the names of non-public rights.
The Rights function allows the developer to query whether a user has a particular right. To facilitate use of this function, the Expression Editor's context menu includes a Rights option that allows access to the Rights repository.
Because Public Rights appear in a Rights selection list that is external to the project, and because the Rights selection list returns a Right's Key, it is important that access to Public Rights be protected. This protection is accomplished when a developer defines the Public Rights Access Key in the Application Properties dialog box; if a Public Rights Access Key is specified, Magic xpa requires that this key also be specified in the supervisor's Rights repository, called the "Rights of [Supervisor]" repository. The supervisor cannot learn the Public Rights Access Key to a project from Magic xpa.
|
|
Folder
|
Displays the name of the folder in which the right entry is stored. You can create a folder by highlighting the Rights icon on the Navigator pane and clicking F4. Folders let you group rights entries. For more information on folders, see Folders.
|
|
Public Name
|
Defines the public name of the right entry by which it will be called by an external call (using a Command Line, Magic xpa or the Internet). The public name must be unique within the repository.
|
Defining a Right
How Do I Implement Roles?
