Skip Navigation Links | |
Exit Print View | |
![]() |
Oracle Directory Server Enterprise Edition Administration Guide 11g Release 1 (11.1.1.5.0) |
Part I Directory Server Administration
2. Directory Server Instances and Suffixes
3. Directory Server Configuration
6. Directory Server Access Control
7. Directory Server Password Policy
8. Directory Server Backup and Restore
9. Directory Server Groups, Roles, and CoS
10. Directory Server Replication
13. Directory Server Attribute Value Uniqueness
15. Directory Server Monitoring
Part II Directory Proxy Server Administration
16. Directory Proxy Server Tools
17. Directory Proxy Server Instances
19. Directory Proxy Server Certificates
20. Directory Proxy Server Load Balancing and Client Affinity
21. Directory Proxy Server Distribution
22. Directory Proxy Server Virtualization
23. Virtual Data Transformations
Configuring Virtual Data Transformations
To Add a Virtual Transformation
To Remove a Virtual Transformation
Virtual Transformation Examples
Deriving an Attribute From the Existing Attributes of an Entry
Mapping a Virtual Attribute to a Physical Attribute
Displaying a Second Virtual Value of an Attribute, Specified by Another Physical Attribute
Storing a Second Value to an Attribute Specified by Another Physical Attribute
Removing an Attribute From the Output
Masking an Attribute While Saving an Entry
24. Connections Between Directory Proxy Server and Back-End LDAP Servers
25. Connections Between Clients and Directory Proxy Server
26. Directory Proxy Server Client Authentication
27. Directory Proxy Server Logging
28. Directory Proxy Server Monitoring and Alerts
Part III Directory Service Control Center Administration
The following sections provide use cases in which virtual data views are required, and the combination of transformation models and actions required to implement the use cases.
Use the following transformation rule to derive an attribute from the existing attributes of an entry. For example, when the following transformation rule is applied, it displays the mail attribute derived from the givenName and sn attributes.
$ dpconf add-virtual-transformation dataview1 read add-attr \ mail \${givenName}.\${sn}@example.com
The following diagram indicates the transformation that occurs on user entries when they are returned in a search.
Use the following mapping transformation rule to add an attribute that is delivered as a part of a pure virtual attribute. For example, when the following transformation rule is applied, the givenName is stored in the server even when it is not specified in the entry. The value is taken from the pure virtual attribute which is defined as mail \${givenName}@example.com.
$ dpconf add-virtual-transformation dataview1 mapping add-attr \ mail \${givenName}@example.com
First add an entry that contains a virtual attribute, mail, but no givenName attribute. The virtual transformation generates the value for the givenName attribute and the entry is stored with givenName but without the mail attribute. Then, doing a search on using the uid attribute, retrieve the value for givenName, and the same virtual transformation generates the value of the virtual attribute mail.
The following diagram indicates the transformation that occurs on user entries.
Use the following transformation to display the value of an attribute that is specified by another attribute. For example, displaying uid as cn along with the value of cn that is already stored in the entry. The following does not store the additional value to cn but before the result is returned to the client, the transformation is applied.
$ dpconf add-virtual-transformation dataview1 read add-attr-value cn \${uid}
The following diagram indicates the transformation that occurs on user entries when they are returned in a search.
Use the following transformation rule to store the value of an attribute along with the value that you provide while adding a new entry. In this scenario, when you add an entry, an additional value for the mail attribute is stored. This transformation is applied only at the time of creating new entries.
$ dpconf add-virtual-transformation dataview1 write add-attr-value \ mail \${uid}@example.com
The following diagram indicates the transformation that occurs on an add request.
Use the following transformation rule if you do not want to display an attribute in the output. For example, when the following transformation rule is applied, the givenName is not returned in the output.
dpconf add-virtual-transformation dataview1 read remove-attr givenName
The following diagram indicates the transformation that occurs on user entries when they are returned in a search.
Use the following transformation rule if you do not want to store a specific attribute. For example, when the following transformation rule is applied, the givenName attribute is not stored in the physical database. This transformation is applied only at the time of creating new entries.
$ dpconf add-virtual-transformation dataview1 write remove-attr givenName
The following diagram indicates the transformation that occurs on an add request.
Use the following transformation if you want to display a default value assigned to an attribute. For example, when the following transformation is applied, a default telephone number in the entries that do not contain their own telephone number is displayed.
$ dpconf add-virtual-transformation data-view read 11111 telephoneNumber default-number
The following diagram indicates the transformation that occurs on user entries when they are returned in a search.
The default value is stored only if the value for an attribute is not specified during the creation of an entry. Use the following transformation rule if you want to store an attribute with the default value. For example, when the following transformation is applied, a default telephone number with each entry you create is added. This transformation is applied only at the time of adding an entry.
$ dpconf add-virtual-transformation dataview1 write 11111 \ telephoneNumber telephone-number
The following diagram indicates the transformation that occurs on an add request.