test

Oracle Waveset 8.1.1 Deployment Reference

Additional Options

The following options are used by a subset of the FormUtil methods:

scopingOrg

Use this option when two or more AdminRoles are assigned to a user. The value of this option should be the name of an organization. This value specifies that the returned names should consist only of names that are available to organizations that are controlled by an AdminRole. The AdminRole must control the scopingOrg organization and is assigned to the logged-in user.

This option is typically used to ensure that when a user is creating or editing another user, the member organization of the user being edited determines which names (for example, Resourcenames) are available for assignment.

Using the scopingOrg Parameter

Set this attribute under these conditions:

For example, under these circumstances:

the resources available for assigning to that user should be limited to the resources available to the organization(s) controlled by the Engineering AdminRole.

Implementing the scopingOrg Attribute

To implement the behavior described above, add the scopingOrg attribute to the waveset.resources field in the User form.

Reference the value of the current organization as follows:


<Field name=’waveset.resources’>
   <Display class=’MultiSelect’>
      <Property name=’title’ value=’_FM_PRIVATE_RESOURCES’/>
      <Property name=’availableTitle’
          value=’_FM_AVAILABLE_RESOURCES’/>
      <Property name=’selectedTitle’ value=’_FM_SELECTED_RESOURCES’/>
      <Property name=’allowedValues’>
         <invoke class=’com.waveset.ui.FormUtil’
           name=’getUnassignedResources’>
             <ref>:display.session</ref>
               <map>
                  <s>currentRoles</s>
                  <ref>waveset.roles</ref>
                  <s>currentResourceGroups</s>
                  <ref>waveset.applications</ref>
                  <s>current</s>
                  <ref>waveset.original.resources</ref>
                  <s>scopingOrg</s>
                  <ref>waveset.organization</ref>
               </map>
         </invoke>
      </Property>
   </Display>
</Field>

current

Specifies a list of names to be merged with those returned. For example, this is typically the list of selected names in a MultiSelect field to ensure that all selected names are in the MultiSelect’s list of available names.

conditions

This value contains a set of AttributeConditions that specify particular attributes, their expected values, and a comparison operator. AttribueConditions can be specified in three ways:

Table 2–23 Values of conditions Attribute

Value Format  

Description  

Map 

As a map containing <MapEntry> elements, each <MapEntry> element contains the attribute name to be matched as the key and the value to be matched as the value. (The operator is assumed to be “equals”.) If more than one attrname/value pair is specified, they will be logically and’ed together.

Example 

<Map>
<MapEntry key=’memberObjectGroups’ value=’Top’/>
</Map>

map 

As a map with no <MapEntry> elements, the first entry is the name of a queryable attribute supported by this type of object. The second entry is the value an object of this type must have for the associated queryable attribute to be returned. (The operator is assumed to be “equals”.)

If more than one attrname/value pairs is specified, they will be logically and’ed together. 

Example 

<map><s>memberObjectGroups</s>

<ref>waveset.organizations</ref>

</map>

list 

As a list of AttributeCondition objects. If more than one AttributeCondition is specified, they will be logically and’ed together. You must use this form if you must specify an operator other than ”equals’.

Example 

<list>

<newclass= ’com.waveset.object.AttributeCondition’>

<s>MemberObjectGroups</s>

<s>equals</s>

<ref>waveset.organization</ref>

</new>

</list>

Using the conditions Attribute

You can specify a list of one or more object type-specific query attribute conditions to filter the list of names returned by certain FormUtil methods. (These methods include methods that take an options map as an argument.) You can specify these query attribute conditions as a query option whose key is conditions and whose value can be specified as either a map or list of AttributeConditions.

Examples: Using the condition Attribute to Filter Names

The following examples illustrate the use of the conditions attribute to apply additional filters to the list of names returned by a FormUtil method that takes an options map as an argument. This example uses conditions to specify that only resources that support container object groups of type LDAP should be returned.

Example 2–12 First Example of Using the conditions Attribute


<Field name=’waveset.resources’>
   <Display class=’MultiSelect’ action=’true’>
...
      <Property name=’allowedValues’>
         <invoke class=’com.waveset.ui.FormUtil’ name=’getUnassignedResources’>
            <ref>:display.session</ref>
            <map>
               <s>currentRoles</s>
               <ref>waveset.roles</ref>
               <s>currentResourceGroups</s>
               <ref>waveset.applications</ref>
               <s>current</s>
               <ref>waveset.original.resources</ref>
               <s>conditions</s>
               <map>
                  <s>supportsContainerObjectTypes</s>
                  <s>true</s>
                  <s>type</s>
                  <s>LDAP</s>
               </map>
            </map>
         </invoke>
      </Property>
   </Display>
</Field>

This second example requests resources that support container objects where the resource has a name that starts with ldap. Note that the value for the queryable attributes are compared case-sensitive.

Example 2–13 Second Example of Using the conditions Attribute


<Field name=’orgResource’>
   <Display class=’Select’ action=’true’>
...
      <Property name=’allowedValues’>
         <invoke class=’com.waveset.ui.FormUtil’ 
                  name=’getResourcesSupportingContainerObjectTypes’>
            <ref>:display.session</ref>
            <map>
               <s>conditions</s>
               <list>
                  <new class=’com.waveset.object.AttributeCondition’>
                     <s>name</s>
                     <s>starts with</s>
                     <s>ldap</s>
                  </new>
               </list>
            </map>
         </invoke>
      </Property>
   </Display>
</Field>

Third Example of Using the conditions Attribute


<Field name=’accounts[Lighthouse].capabilities’>
   <Display class=’MultiSelect’>
         ...
     <Property name=’allowedValues’>
        <invoke class=’com.waveset.ui.FormUtil’
           name=’getUnassignedCapabilities’>
           <ref>:display.session</ref>
           <ref>waveset.original.capabilities</ref>
             <map>
             <s>conditions</s>
               <list>
                  <new class=’com.waveset.object.AttributeCondition’>
                    <s>name</s>
                    <s>starts with</s>
                    <s>bulk</s>
                  </new>
               </list>
             </map>
        </invoke>
     </Property>
   </Display>
</Field>

Supported Queryable Attribute Names

The list of supported queryable attribute names per object type are categorized as follows:

Other queryable attribute names are defined in the Waveset Schema Configuration configuration object (for example, firstname and lastname).

Supported Operators

Waveset performs all comparisons of queryable attributes with case-sensitive semantics. Furthermore, Waveset carries out comparisons using String comparison semantics., so 1000<999 (because String comparisons compare character by character, and 9 is greater than 1.