Goverlan
GUIDE MENU

UNDERSTANDING DYNAMIC VALUE DEFINITIONS

Dynamic Values allow you to set a parameter to a value based on other object attributes and calculated during the execution of the Scope Action. A dynamic value is a string that defines how the final value should be compiled. You can configure a dynamic value definition for every type of value: String, Number, Date & Time and Boolean.

To configure a dynamic value for an argument:

1. Select the argument from the list.

2. Click on the Set Dynamic Value Definition link in the task panel.

Note: The currently configured value for that argument will be removed.

 

3. Configure the dynamic value definition and click on OK.

The Argument Window displays arguments configured as dynamic with a pale blue background

To modify or remove a dynamic value definition

Once a dynamic value has been configured, click the Expand [...] button to open the Dynamic Value Definition window. From there you can either modify the definition or click the Remove Dynamic Value link to reset the argument as a static value.

Configuring String as Dynamic Values

A Dynamic String Definition may contain any combination of static text and value of other attributes.

  • To Insert Static Text:  Type it at the desired location.

  • To Insert the Value of Another Attribute:  Place the text caret at the point of insertion and click on the [Insert] key. Then, select the attribute from the menu. You can select any type of attribute (even numbers and dates) except for array attributes.

The attribute selection menu also includes special pre-defined items:

  • Current Date & Time  
    The current date and time value during execution.

  • Incrementor
    A numerical value that starts at 1 and is increased for each instance in your scope.

Example: You want to populate the active directory Description field of your computer objects with statistics about the password age of the account.

1. Under the Action Module configuration, select Add/Remove > Set Computer Property > Computer Account Information > Description

 

2. In the Argument Selection window, select the Description argument and click on the Set Dynamic Value Definition link

 

3. Configure the dynamic value definition to be the following combination of text and attributes:

Running this Scope Action would result in the description field of computer accounts to display something similar to: On December 20th, 2009, MACHINE_123 's password age was 124 day.

Configuring Numbers as Dynamic Values

A Dynamic Numerical Definition may contain any combination of numerical operators and number value of other attributes.

  • To Insert numerical operators: Type it at the desired location.  
    The following operators are allowed:   +   -   *   /   (   )   [   ]

  • To Insert the value of another attribute: Place the text caret at the point of insertion and click on the [Insert] key. Then, select the attribute from the menu.
    You can only select attributes of the following types:  Number

The attribute selection menu also includes special pre-defined items:

  • Current Date & Time  
    The current date and time value during execution.

  • Incrementor
    A numerical value that starts at 1 and is increased for each instance in your scope.

Example: You need to set a numerical value to the percentage of physical memory available

Configure the dynamic value definition to: ( {Memory Information:Available Physical RAM (KB)} / {Memory Information:Total Physical RAM (KB)} ) *100

Configuring Boolean as Dynamic Values

A Dynamic Boolean Definition may contain any combination of Boolean operators and Boolean or Integer values of other attributes.

  • To Insert the Boolean operator: Type it at the desired location.
    The following operators are allowed: AND , OR , NOT , < , <= , > , >= , = , <> , + , - , * , / , ( , ) , [ , ]

  • To Insert the value of another attribute: Place the text caret at the point of insertion and click on the [Insert] key. Then, select the attribute from the menu.  
    You can only select attributes of the following types:  Boolean, Number

The attribute selection menu also includes special pre-defined items:

  • Current Date & Time  
    The current date and time value during execution.

  • Incrementor
    A numerical value that starts at 1 and is increased for each instance in your scope.

Example:

{Account Statistics:Password Age} > 60 AND NOT({User Account Information:User Cannot Change Password} OR {User Account Information:Password Never Expires})

Results in TRUE if the user’s password age is greater than 60 days, and the user is allowed to change their password, and if the password expires.

Configuring Date & Time as Dynamic Values

A Dynamic Date & Time Definition may contain any combination of numerical operators and date & time value of other attributes.

  • To Insert numerical operator: Type it at the desired location.
    The following operators are allowed: + , - , * , / , ( , ) , [ , ]

  • To Insert the value of another attribute: Place the text caret at the point of insertion and click on the [Insert] key. Then select the attribute from the menu.
    You can only select attributes of the following types:  Date & Time

The attribute selection menu also includes special pre-defined items:

  • Current Date & Time  
    The current date and time value during execution.

  • Incrementor
    A numerical value that starts at 1 and is increased for each instance in your scope.

  • Time Span – 1 Min:
    A 1-minute timestamp that can be used in date operations.

  • Time Span – 1 Hour:
    A 1-hour timestamp that can be used in date operations.

  • Time Span – 1 Day:
    A 1-day timestamp that can be used in date operations.

Example:

{Current Date and Time} + 60 * {Time Span: 1 Day}

Would result in 60 days from the current date & time.