Managing a Virtual Attribute

Select a function: Select a function. The corresponding JavaScript is displayed in Script. Expand the script to view. You can further customize these scripts and use them in Advanced JavaScript.

The following table lists the pre-defined JavaScript functions with examples:

Advanced JavaScript:

Sample JavaScript:

function main(P1, P2)
     {
          //some logic
          //you can call yourFunction(name) and use its return value
          return some value;
     }
     function yourFunction(name)
     {
          //some code
         //return some value;
     }

For advanced JavaScript, the input parameter name in the main function of the JavaScript must match the input parameter name specified in Step 1: Provide input parameters. The return value can be a single value or an array.

When the input is multi-valued, it is sent as an array to the main function.

When Identity Server computes the value of a virtual attribute, it calls a function named main that is available in the script provided for it. The value (single value or array) returned by main is the value of the virtual attribute.

For example: Consider a scenario where P1 contains bmw and nissan, you can use the JavaScript instanceof function to check if the input is single-valued or multi-valued. If it is multi-valued, then JavaScript iterates over the values P1=['bmw', 'nissan']

function main (P1){
  if( P1 instanceof Array) {
    var a =P1[0]    //will assign 'bmw' value to variable a
    //do something
  }
else{
 // if the P1 is single value not a array
//do something
}
}

The following code checks if an input parameter is empty, contains a value, or undefined:

function main(P1){
  if(hasNoValue(P1))
    // do something
       return something;        
}
function hasNoValue(P1){
   if(P1 == null || (typeof P1 == 'undefined') || P1.trim().length == 0)
        return true;
   else 
        return false;
}

Base64 Encode: (Conditional) Select this if you want to encode the modified attribute with Base64.

Test: Click this to test the input values based on the modification function. To test multi-valued inputs, click the + icon.

For example, if an attribute mail has two values: abc@example.com and def@example.com, click the + icon twice. In each field, add the values separately.

The test result displays the status with the test results. You can view the error logs at the following location:

/opt/novell/nam/adminconsole/logs/catalina.out