Skip Headers

Oracle® Internet Directory Application Developer's Guide
10g (9.0.4)
Part Number B10461-01
Go To Documentation Library
Home		 Go To Product List
Solution Area		 Go To Table Of Contents
Contents		 Go To Index
Index

Go to previous page Go to next page

10
DAS_URL Interface Reference

This chapter describes the Oracle extensions to the DAS_URL Service Interface. It contains these sections:

Oracle Delegated Administration Services Units and Corresponding Directory Entries

Table 10-1 lists each Oracle Delegated Administration Services unit and the corresponding entry in Oracle Internet Directory which stores the relative URL.

Table 10-1  Service Units and Corresponding Entries
Service Unit Entry

Create User

cn=CreateUser,cn=OperationURLs,cn=DAS,cn=Products,cn=OracleContext

Edit User

cn=EditUser,cn=OperationURLs,cn=DAS,cn=Products,cn=OracleContext

Edit User when GUID is passed as a parameter

cn=EditUserGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Delete User

cn=DeleteUser,cn=OperationURLs,cn=DAS,cn=Products,cn=OracleContext

Delete User when GUID of the user to be deleted is passed as a parameter

cn=DeleteUserGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Create Group

cn=CreateGroup,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Edit Group

cn=EditGroup,cn=OperationURLs,cn=DAS,cn=Products,cn=OracleContext

Edit the group whose GUID is passed through a parameter

cn=EditGroupGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Delete Group

cn=DeleteGroup,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Delete group with the GUID passed through a parameter

cn=DeleteGroupGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Assign privileges to a user

cn=UserPrivilege,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Assign privileges to a user with the GUID passed through a parameter

cn=UserPrivilegeGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Assign privilege to a group

cn=GroupPrivilege,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Assign privilege to a group with the given GUID

cn=GroupPrivilegeGivenGUID,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

View User account information/Profile

cn=AccountInfo,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Edit User account Information/Profile

cn=Edit My Profile,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Change Password

cn=PasswordChange,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Search User

cn=UserSearch,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Search Group

cn=GroupSearch,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Search User LOV

cn=UserLOV,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

Search Group LOV

cn=GroupLOV,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

EUS Console

cn=EUS Console,cn=OperationURLs,cn=DAS,cn=Products,cn=OracleContext"

Delegation Console

cn=DelegationConsole,cn=OperationURLs,cn=DAS,cn=Products,
cn=OracleContext

DAS Units and Corresponding URL Parameters

The following table lists all the available DAS units and the URL parameters that can be passed to DAS units.

Table 10-2  DAS Units and Corresponding URL Parameters
DAS Unit Parameter Return Values

Create User

homeURL, doneURL, cancelURL,enablePA

returnGUID

Edit User

homeURL, doneURL

cancelURL, enablePA 

EditUserGivenGUID

homeURL, doneURL, cancelURL, enablePA , userGUID

EditMyProfile

homeURL, doneURL, cancelURL

Delegation Console

DeleteUser

homeURL, doneURL, cancelURL

DeleteUserGivenGUID

homeURL, doneURL, cancelURL, userGUID

UserPrivilege

homeURL, doneURL, cancelURL

UserPrivilegeGivenGUID

homeURL, doneURL, cancelURL, userGUID

CreateGroup

homeURL, doneURL, cancelURL, enablePA , parentDN

returnGUID

EditGroup

homeURL, doneURL, cancelURL, enablePA 

EditGroupGivenGUID

homeURL, doneURL, cancelURLenablePA , groupGUID

DeleteGroup

homeURL, doneURL, cancelURL

DeleteGroupGivenGUID

homeURL, doneURL, cancelURL, groupGUID

GroupPrivilege

homeURL, doneURL, cancelURL

GroupPrivilegeGivenGUID

homeURL, doneURL, cancelURL, groupGUID

AccountInfo

homeURL, doneURL, cancelURL

PasswordChange

homeURL, doneURL, cancelURL

UserSearch

homeURL, doneURLm, cancelURL

GroupSearch

homeURL, doneURL, cancelURL

UserLOV

base, cfilter, title

dasdomain

GroupLOV

otype, base, cfilter, title

dasdomain

DAS URL API Parameter Descriptions

The following parameters are used with DAS units.

Table 10-3  DAS URL Parameter Descriptions
Parameter Description

homeURL

The URL which is linked to the global button Home. When the calling application specifies this value, clicking the Home button will redirect the DAS unit to the URL specified by this parameter.

doneURL

This URL is used by DAS to redirect the DAS page at the end of each operation. In case of Create User, once the user is created, clicking OK will redirect the URL to this location. Hence the user navigation experience will be smooth.

cancelURL

This URL is linked with all the Cancel buttons shown in the DAS units. Any time the user clicks Cancel, the page is redirected to the URL specified by this parameter.

enablePA

This parameter takes a Boolean value of true/false. This will enable the section Assign Privileges in User or Group operation. If the enablePA is passed with value of true in the Create User page, then the Assign Privileges to User section will also appear in the Create User page.

userGUID

This is the GUID of the user to be edited or deleted. This corresponds to the orclguid attribute. Specifying this will skip the search for the User step in either editUser or deleteUser units.

GroupGUID

This is the GUID of the group to be edited or deleted. This corresponds to the orclguid attribute. Specifying this will skip the search for the group step in either editGroup or deleteGroup units.

parentDN

When this parameter is specified in CreateGroup, the group will be created under this container. If not specified, group creation will default to the group search base.

base

This parameter represents the search base in case of search operations.

cfilter

This parameter represents the filter to be used for the search. This filter is LDAP-compliant.

title

This parameter represents the title to be shown in the Search and Select LOV page.

otype

This parameter represents the object type used for search. Values supported are Select, Edit, and Assign.

returnGUID

This parameter is appended to the doneURL in case of a create operation. The value will be the orclguid of the new object.

dasdomain

This parameter is needed only when the browser is Internet Explorer and the calling URL and the DAS URL are on different hosts and same domain. An example value is us.oracle.com. Note the calling application also needs to set the document.domain parameter on the formload. For more details, refer to Microsoft support at:

http://support.microsoft.com/

User or Group List of Values Access

In DAS, the search page for users or groups is called the List of Values (LOV).

DAS uses Java scripts to access the LOV, and to pass values between the LOV calling window and DAS LOV page. Since the Java scripts have security restrictions, data cannot pass across the domains. Due to this limitation, only the pages in the same domain can access the DAS LOV units.

The example below is a simple HTML file which invokes the DAS User LOV. Note the Javascript functions are taken from the MarlinCore.js file published with UIX. Applications may use their own Javascript procedures or use the UIX library utilities. 

<html>
 <head>
  <title>test</title>
 </head>
 <script src="/cabo/jsLibs/MarlinCore.js">
 </script>
 <body>
  <form name="form1" method="GET" action="test.html">
    <script language="javascript">
       function doSelect(lovWindow, event)
       {
            var value = lovWindow.userName;
             if (value!=(void 0)){
                 document.form1.lov1.value = lovWindow.userName;
                 document.form1.lov2.value = lovWindow.userGuid
             }
        }
    </script>
 <table border="0" cellspacing="0" cellpadding="0">
<tr>
  <td align="right" nowrap>
   <span>&nbsp;
     <label for="M__Id2500">Manager</label>
    </span>
  </td>
<td nowrap>
  <span>
    <input id="M__Id2500" name="lov1" size="25" type="text">
     <a onclick="openWindow(top,
'/oiddas/cabo/jsps/frameRedirect.jsp?redirect=http://sneaker.us.oracle.com:7777/
oiddas/ui/oracle/ldap/das/search/LOVUserSearch?title=User',
'lovWindow',{width:600,height:600},
false, 'dialog',doSelect);
return false;"
href="">
                            <img src="/oiddas/oracle/ldap/das/Images/c-lov.gif"
   alt="Testing lov" border="0" align="absmiddle">
     </a>
   </span>
  </td> 
 </tr>
 <tr>
     <td align="right" nowrap>
       <span>&nbsp;
            <label for="M__Id2501">Guid</label>
       </span>
     </td>
     <td> 
        <input id="M__Id2501" name="lov2" size="25" type="text"> 
      </td> 
  </tr>
 </table>
 </form>
 </body>
</html>

More details about the UIX openWindow function are available at: 

http://cabo/cabo/marlin/docs/windowJS.html
Go to previous page Go to next page
Oracle
Copyright © 1999, 2003 Oracle Corporation.
All Rights Reserved.
Go To Documentation Library
Home		 Go To Product List
Solution Area		 Go To Table Of Contents
Contents		 Go To Index
Index