policy

A policy consists of an ordered set of <rule>s. A <rule> consists of a set of <conditions> to be tested and an ordered set of <actions> to be performed when the conditions are met.

Remarks

A <policy> operates on an XDS document and its primary purpose is to examine and modify that document. A <policy> can also get additional context from outside of the document and cause side effects that are not reflected in the result document.

The following outline describes the basic operation of a <policy>:

  • The XDS document is divided into its constituent operations. An operation is any element that is a child of <input> or <output>. An operation usually represents an event, a command, or a status.

  • The <policy> is applied to separately to each operation. As the <policy> is applied to each operation in turn, that operation becomes the current operation. The object that is described by the current operation src-dn, src-entry-id, dest-dn, dest-entry-id, and/or association from the becomes the current object.

  • Each <rule> is applied in order to the current operation. All of the <rule>s are applied to the current operation unless an action is performed by a prior <rule> that causes subsequent <rule>s to no longer be applied.

  • The <conditions> for the <rule> are tested and if the <conditions> for the <rule> are met then the <actions> are applied.

Variables

DirXML Script supports two kinds of variables: global and local. A global variable is a variable that gets there values from a Global Configuration Value that is defined for the driver or the driver set. Global variables are by definition read-only. A local variable is a variable that is set by a policy. A local variable can exist in one of two different scopes: policy or driver. A policy scoped variable is only visible during the processing of the current operation by the policy that sets the variable. A driver scoped variable is visible from all DirXML Script policies running within the same driver until the driver is stopped. A variable name must be a legal XML Name.

There are a number of global and local variables that are automatically defined:

Name

Type

Description

dirxml.auto.driverdn

global/string

Slash format DN of the current driver

dirxml.auto.driverguid

global/string

GUID of the current driver.

dirxml.auto.treename

global/string

Tree name of the local eDirectory instance.

fromNDS

policy local/boolean

True if the source data store is eDirectory.

False if the source data store is the connected application.

destQueryProcessor

policy local/java object

Instance of XdsQueryProcessor used to query the destination data store.

srcQueryProcessor

policy local/java object

Instance of XdsQueryProcessor used to query the destination data store.

destCommandProcessor

policy local/java object

Instance of XdsCommandProcessor used to query the destination data store.

srcCommandProcessor

policy local/java object

Instance of XdsCommandProcessor used to query the destination data store.

dnConverter

policy local/java object

Instance of DNConverter

current-node

policy local/node-set

The loop variable for each iteration of <do-for-each>.

current-value

policy local/node-set

The loop variable for each iteration of <do-reformat-op-attr>.

current-op

policy local/node-set

The current operation.

Setting this variable using <do-set-local-variable> causes the first operation specified by <arg-node-set> to become the current operation for the remainder of the current policy execution or until it is set to another value. The new current operation must be an element sibling of the original current operation and must have been added by the current policy.

Variable Expansion

Many conditions, actions, and tokens support dynamic variable expansion in their attributes or content. Where supported, an embedded reference of the form $<variable-name>$ is replaced with the value of the local or global variable with the given name. $<variable-name>$ must be a legal variable name. If the given variable does not exist the reference is replaced with the empty string. Where it is desirable to use a single '$' and not have it interpreted as a variable reference, it should be escaped with and additional '$' (e.g. You owe me $$100.00). Content and attributes that support variable expansion are annotated with the phrase supports variable expansion.

Date/Time Parameters

Tokens that deal with dates and times have arguments that deal with the format, language, and time zone of the date and time representation. Date formats arguments may be specified in one of two ways. If the format begins with a '!' character, then the format is a named format. Legal names are defined in the following table:

Name

Description

!CTIME

Number of seconds since Midnight, January 1, 1970. (Compatible with eDirectory time syntaxes.)

!JTIME

Number of milliseconds since Midnight, January 1, 1970. (Compatible with Java time.)

!FILETIME

Number of 100-nanosecond intervals since January 1, 1601. (Compatible with Win32 FILETIME.)

!FULL.TIME

Language-specific FULL time format.

!LONG.TIME

Language-specific LONG time format.

!MEDIUM.TIME

Language-specific MEDIUM time format.

!SHORT.TIME

Language-specific SHORT time format.

!FULL.DATE

Language-specific FULL date format.

!LONG.DATE

Language-specific LONG date format.

!MEDIUM.DATE

Language-specific MEDIUM date format.

!SHORT.DATE

Language-specific SHORT date format.

!FULL.DATETIME

Language-specific FULL date/time format.

!LONG.DATETIME

Language-specific LONG date/time format.

!MEDIUM.DATETIME

Language-specific MEDIUM date/time format.

!SHORT.DATETIME

Language-specific SHORT date/time format.

If the format does not begin with '!', then the format is interpreted as a custom date/time format conforming to the patterns recognized by java.text.SimpleDateFormat.

Language arguments can be specified by an identifier that conforms to IETF RFC 3066. The list of identifiers understood by the system can be obtained by calling java.util.Locale.getAvailableLocales() and substituting all underscores in the result with a hyphens. If a language argument is omitted or blank, then the default system language is used.

Time zone arguments can be specified in any identifier recognizable by java.util.TimeZone.getTimeZone(). A list of identifies understood by the system can be obtained by calling java.util.TimeZone.getAvailableIDs(). If a time zone argument is omitted or blank, then the default system time zone is used.

XPath Evaluation

Arguments to some conditions and actions take an XPath 1.0 expression. This XPath is evaluated with the following context:

  • The context node is the current operation unless otherwise specified in the description of the expression.

  • The context position and size are 1.

  • Available variables

    • Those available as parameters to style sheets within the Identity Manager Metadirectory engine (currently fromNDS, srcQueryProcessor, destQueryProcessor, srcCommandProcessor, destCommandProcessor, and dnConverter.)

    • Global configuration variables.

    • Local policy variables.

    • If there is a name conflict between the different variable sources then the order of precedence is local (policy scope), local (driver scope), global.

    • Because of the XPath syntax, any variable that has a colon character in its name is not accessible from XPath.

  • Namespaces that are declared on <policy>.

  • Available functions

    • All built-in XPath 1.0 functions

    • Java extension functions as provided by NXSL.

      • Namespaces declarations to associate a prefix with a Java class must be declared on <policy>.

Example

<policy>  <description>My policy</description>  <include name="..\..\Library\My shared policy"/> <rule>   <description>Rule to disallow moving a user</description>   <comment>This rule was added because under no circumsances do we ever want to perform a move.</comment>   <conditions>    <and>     <if-class-name op="equal" mode="nocase">User</if-class-name>     <if-operation op="equal">move</if-operation>    </and>   </conditions>   <actions>    <veto/>   </actions>  </rule>  <rule>   <description>Rule to disallow operations on a disabled user or group</description>   <conditions>    <or>     <if-class-name op="equal" mode="nocase">User</if-class-name>     <if-class-name op="equal" mode="nocase">Group</if-class-name>    </or>    <or>     <if-attr op="equal" mode="nocase" name="Login Disabled">true</if-attr>   </or>   </conditions>   <actions>    <veto/>   </actions>  </rule> </policy> 

Allowed Content

Element

Description

description

Description of a <policy> or a <rule>.

rule

Rule within a policy.

include

Include rules from another policy.

Attributes

None

Content Rule

( description ? , ( rule | include ) * )

Parent Elements

None