Define Object Types for Access Control

Explanation

This activity is used to specify the object types that can grant access to documents. When these objects are connected to documents, the access given to the documents will be able to depend on the access specified on the objects. The Enabled check box will be a way to enable or disable access through objects. When it is selected, objects of this type will control access. However, default access levels should also be specified in the Document Basic/Default Object Access Levels tab in order to make this functionality active. For more information about object controlled document access, see Document Access.

It is important to note that, if an object is allowed to control the document access, it will not be the sole source of access for the document. The other ways to grant access is still available and getting access through the object is just one possibility for each particular document.

Prerequisites

• First of all, and most important: in order for an object to control document access, code must be developed. At installation time, and depending on what components that are installed, certain objects can control the document access (see Document Access for details). For any other objects that you want to control access, a customization has to be done. It is not possible to select any kind of object and expect that it can control document access.
• To perform this activity, the object types to be defined should be document-aware. An administrator could do this in Solution Manager/User Interface/Object Connections window by creating a record for the logical unit representing the business object and entering the View Name, Package Name and the service DocReferenceObject^ under the Service List.
• As mentioned above, code must be developed for new objects to control document access. Concretely, a function (e.g. Get_Document_Access) should be implemented in the API for the object. The function must accept the following attributes; LuName, KeyRef, DocClass, DocNo, DocSheet, DocRev, PersonId of type VARCHAR2.

System Effects

As a result of this activity, the enabled objects can be used to define access for documents. The first time this is done, if there are many objects of the specified type connected to documents, then this operation can take a long time. Each document that is connected to the particular object that is enable to control access will get a new access line, to be controlled through the object.

If an object type is disabled in this form, or if it is deleted, then all access lines on all documents that has objects of this type connectes will be deleted. This is also an operation that can take a long time to finish, since all object access lines will be deleted, for the particular object, for all documents that are connected to such objects.

Window

Document Basic

Related Window Descriptions

Document Basic
Document Basic/Object Types for Access Control

Procedure

1. Open the Document Basic window and click the Object Types for Access Control tab.
2. Double-click on the table to create a new record (F5).
3. Enter a value in the Object Type field. Use the List of Values to select an object type. Please note that the object type must either have been allowed to controll access at installation time, or a customization must have been done, to add code that can control the access.
4. Enter the API where the method in the next field is places in the Package Name field. Use the List of Values to select a package where access control code has been added.
5. Enter the method to be used to get the access level in the specified Package API in the Method field. (E.g. Get_Document_Access) Use the List of Values to select a suitable value.
6. Select the Enabled check box to enable access control from the object.
7. Save the record (F12). This operation may take a long time to finish.