To Configure User Actions (Oracle Waveset 8.1.1 Deployment Guide)

Oracle Waveset 8.1.1 Deployment Guide

To Configure User Actions

Copy the User Actions Configuration configuration object into a new XML file.

Change the name of the new object to My User Actions Configuration.

Make any desired modifications to My User Actions Configuration.

Import the XML file into Waveset from the Import Exchange File page

Modify SystemConfiguration to change the userActionsConfigMapping attribute’s value to My User Actions Configuration

The configuration object consists of these configuration sections.

Attribute	Description
`findUsersButtons`	Contains a list of button definitions for the Administrator Interface User Account Search Results page.
`userApplet.userMenu`	Contains a list of menu item definitions for the user actions menu. This menu displays when you right-click a user in the applet on the Administrator Interface Accounts page.
`userApplet.organizationMenu`	Contains a list of menu item definitions for the organization actions menu. This menu displays when you right-click an organization in the applet on the Accounts page.

Each section contains a list of user actions to display in the interface. The button and menu configuration items have the same basic properties. Both include several extensions unique to the interface.

The following excerpt is an example of the user action configuration customized to add the Change Organization task to each list.

<?xml version=’1.0’ encoding=’UTF-8’?>
<!DOCTYPE Waveset PUBLIC ’waveset.dtd’ ’waveset.dtd’>
<Waveset>

<Configuration name=’My User Actions Configuration’>
  <Extension>
    <Object>
      <!-- Buttons for the find users results page. -->
      <Attribute name=’findUsersButtons’>
        <List>
          <Object>
            <Attribute name=’textKey’ value=’UI_NEW_LABEL’ />
            <Attribute name=’commandName’ value=’New’ />
            <Attribute name=’requiredPermission’>
              <Object>
                <Attribute name=’objectType’ value=’User’ />
                <Attribute name=’rights’ value=’Create’ />
              </Object>
            </Attribute>
            <Attribute name=’alwaysDisplay’ value=’true’ />
          </Object>
          ...
          <Object>
            <Attribute name=’textKey’ value=’UI_CHANGE_ORGANIZATIONS_LABEL’ />
            <Attribute name=’commandName’
value=’Change Organizations’ />
          </Object>
        </List>
</Attribute>
      <Attribute name=’userApplet’>
        <Object>
          <!-- The menu to display when a user is selected. -->
          <Attribute name=’userMenu’>
            <List>
              <Object>
                <Attribute name=’textKey’
value=’UI_ACCT_JAVA_MENU_NEW_ORG’ />
                <Attribute name=’commandName’
value=’New Organization’ />
                <Attribute name=’requiredPermission’>
                  <Object>
                    <Attribute name=’objectType’ value=’ObjectGroup’ />
                    <Attribute name=’rights’     value=’Create’ />
                  </Object>
                </Attribute>
              </Object>
              ...
              <Object>
                <Attribute name=’separator’ value=’separator’ />
              </Object>
              <Object>
                <Attribute name=’textKey’
value=’UI_CHANGE_ORGANIZATIONS_MENU_LABEL’ />
                <Attribute name=’commandName’
value=’Change Organizations’ />
              </Object>
            </List>
</Attribute>
          <!-- The menu to display when an organization is selected. -->
          <Attribute name=’organizationMenu’>
            <List>
              <Object>
                <Attribute name=’textKey’
value=’UI_ACCT_JAVA_MENU_NEW_JUNCTION’ />
                <Attribute name=’commandName’
value=’New Directory Junction’ />
                <Attribute name=’requiredPermission’>
                  <Object>
                    <Attribute name=’objectType’ value=’ObjectGroup’ />
                    <Attribute name=’rights’     value=’Create’ />
                  </Object>
                </Attribute>
                <Attribute name=’orgTypes’ value=’normal,dynamic’ />
              </Object>
              ...
              <Object>
                <Attribute name=’separator’ value=’separator’ />
              </Object>
              <Object>
                <Attribute name=’textKey’
value=’UI_CHANGE_ORGANIZATIONS_MENU_LABEL’ />
                <Attribute name=’commandName’
value=’Change Organizations’ />
              </Object>
            </List>
          </Attribute>
        </Object>
      </Attribute>
    </Object>
  </Extension>
  <MemberObjectGroups>
    <ObjectRef type=’ObjectGroup’ name=’All’/>
</MemberObjectGroups>
</Configuration>
</Waveset>

User action definitions support these core attributes.

Attribute	Description
`textKey`	Message catalog key for the text of the button or menu item.
`commandName`	Name of the command to execute. This can be a command that is natively supported (such as New or Delete User), or the name of a `TaskDefinition` to execute.
`requiredPermission.objectType`	Type of object that the rights are required on in order to display this item. This is applicable only for natively supported commands. Task Definitions should use AuthTypes for controlling access.
`requiredPermission.rights`	Comma-separated list of `Right` names required on the specified objectType to display this item. This is applicable only for natively supported commands. Task Definitions should use AuthTypes for controlling access.
`alwaysDisplay`	Optional. Specifies whether to always display this button. If set to a value of `true`, the button is displayed even if user search returns no results. The default value for this attribute is `false`. Applies to `findUsersButtons` section only.

User actions definitions in the userApplet section also support the attributes in the following table.

Attribute	Description
`orgTypes`	Comma-separated list of organization types for which to display the item in the organization menu. Possible values are normal, dynamic, and virtual for normal organizations, dynamic organizations, and virtual organizations, respectively. If this attribute is not specified, the menu item is displayed for all organization types.
`separator`	Special item in the format `<Object><Attribute name=’separator’ value=’separator’/></Object>`. Separators are displayed as horizontal bars in the Administrator Interface menus, and cannot be selected.

Attribute

Description

orgTypes

Comma-separated list of organization types for which to display the item in the organization menu. Possible values are normal, dynamic, and virtual for normal organizations, dynamic organizations, and virtual organizations, respectively.

If this attribute is not specified, the menu item is displayed for all organization types.

separator

Special item in the format <Object><Attribute name=’separator’ value=’separator’/></Object>. Separators are displayed as horizontal bars in the Administrator Interface menus, and cannot be selected.