Oracle® Fusion Middleware Developer's Guide for Oracle IRM Server 11g Release 1 (11.1.1) E12326-02 |
|
![]() Previous |
![]() Next |
Home > Developer's Guide for Oracl... > Working with Domains, Conte... > Concepts
This section contains the following topics:
Access to context-classified documents is governed by rights, such as the right to open a document, the right to print it, and the right to copy information from it and paste it into another document. The rights are defined and assigned centrally by administrators, who group combinations of rights and end user identities into one or more "contexts".
A domain is the top level entity that contains document roles and context templates.
DomainRef
Domains are identified by a UUID value. Web services operations that need to identify a domain use the DomainRef
type. A DomainRef
contains only the information required to uniquely identify a domain; the UUID. The other properties of a domain, such as its labels, are not part of a DomainRef
type.
DomainRef domainReference = new DomainRef(); domainReference.setUuid("29499ec3-4ded-4138-9ea4-cc1f5dbf8db1");
An example method that uses a DomainRef
type is the delete domain
method:
DomainOperations domainOperations = new DomainOperationService().getDomainOperations(); domainOperations.deleteDomain(domainReference);
Domain
A Domain
contains all the information about a domain, including the UUID. For operations that require or return all the domain properties, a Domain
is used.
An example that uses the Domain
type is the list domains
method:
DomainOperations domainOperations = new DomainOperationService().getDomainOperations(); Domain[] results = domainOperations.listDomains();
Context templates are identified by a UUID value within the owning domain. Web services operations that need to identify a template use the ContextTemplateRef
type. A ContextTemplateRef
contains the information required to uniquely identify a template: the UUID and the owning domain. The other properties of a template, such as its labels and roles, are not part of a ContextTemplateRef
type.
ContextTemplateRef
ContextTemplateRef templateReference = new ContextTemplateRef(); templateReference.setUuid("96c512a7-e44b-47d5-a70d-0ef2c0283f25"); templateReference.setDomain(domainReference);
It is valid for two templates in different domains to have the same UUID value. The templates that are automatically installed when the first domain is created all have fixed UUID values. For example, the standard template has the UUID value 474dbb07-718b-4c4e-8f43-d2b723469573
. Using these predefined UUID values means there is no need to look up a context template UUID before creating a ContextTemplateRef type.
Contexts are identified by a UUID value. Web services operations that need to identify a context use the ContextInstanceRef
type. A ContextInstanceRef
contains the information required to uniquely identify a context, the UUID. The other properties of a context, such as labels and item exclusions, are not part of a ContextInstanceRef
type.
ContextInstanceRef
ContextInstanceRef contextReference = new ContextInstanceRef(); contextReference.setUuid("a3c41a86-a1b4-4d5d-9fe5-f4077bbc2b17");
A document role defines a set of criteria that specify how sealed content can be used. A document role is assigned to a user or group, allowing the user to use sealed content in the way the role defines.
DocumentRoleRef
Document roles are identified by a UUID value within the owning domain. Web services operations that need to identify a role use the DocumentRoleRef
type. A DocumentRoleRef
contains the information required to uniquely identify a role; the UUID and the owning domain. The other properties of a role, such as its labels and features, are not part of a DocumentRoleRef
type.
DocumentRoleRef roleReference = new DocumentRoleRef(); roleReference.setUuid("96c512a7-e44b-47d5-a70d-0ef2c0283f25"); roleReference.setDomain(domainReference);
It is valid for two roles in different domains to have the same UUID value. The roles that are automatically installed when the first domain is created all have fixed UUID values. For example, the contributor role has the UUID value a456140d-24dc-4cc2-8f23-1a72fb6c2d81
. Using these predefined UUID values means there is no need to look up a context template UUID before creating a ContextTemplateRef type.
Rights are identified by a UUID value. Web services operations that need to identify a right use the DocumentRightRef
type. A DocumentRightRef
contains the information required to uniquely identify a right, the UUID. The other properties of a right, such as assigned account and role, are not part of a DocumentRightRef
type.
DocumentRightRef
DocumentRightRef rightReference = new DocumentRightRef(); rightReference.setUuid("35aa8611-abff-43e3-a5ae-ffe71345d9d4");