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
- Open the
Document Basic window and
click the Object Types for Access Control tab.
- Double-click on the table to create a new record
(F5).
- 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.
- 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.
- 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.
- Select the Enabled check box to enable access control
from the object.
- Save the record (F12). This operation may take a long time
to finish.