DirXMLScript DTD: token-dest-dn element

token-dest-dn

<token-dest-dn> expands to the destination DN specified in the current operation or a portion thereof. If start and length are not specified or are set to the default values {0,-1}, then the entire DN is used, otherwise only the portion of the DN specified by start and length is used. The format of the DN is automatically to the format of the source datastore if convert attribute is set to true.

Example

<token-dest-dn/>

1. Allowed Content

EMPTY

2. Attributes

Attribute Value(s) Default Value

convert true | false

convert to DN format of source datastore
false

length CDATA

number of DN segments to include
negative numbers are interpreted as (total # of segments + length) + 1 (e.g for a DN with 5 segments a length of -1 = (5 + (-1)) + 1 = 5, -2 = (5 + (-2)) + 1 = 4, etc.)
-1

notrace true | false

trueif this element should not be traced during execution of policy
false

start CDATA

segment index to start with
0 is the rootmost segment >0 is an offset from the rootmost segment -1 is the leafmost segment <-1 is an offset from the leafmost segment towards the rootmost segment
0

Attribute	Value(s)	Default Value
convert	true \| false convert to DN format of source datastore	false
length	CDATA number of DN segments to include negative numbers are interpreted as (total # of segments + length) + 1 (e.g for a DN with 5 segments a length of -1 = (5 + (-1)) + 1 = 5, -2 = (5 + (-2)) + 1 = 4, etc.)	-1
notrace	true \| false trueif this element should not be traced during execution of policy	false
start	CDATA segment index to start with 0 is the rootmost segment >0 is an offset from the rootmost segment -1 is the leafmost segment <-1 is an offset from the leafmost segment towards the rootmost segment	0

3. Content Declaration

Empty

4. Parent Elements

arg-association: association argument
arg-component: component argument
arg-dn: DN argument
arg-node-set: node set argument
arg-password: password argument
arg-string: string argument
arg-value: value argument
token-base64-decode: decode base64 data into a string
token-base64-encode: encode a string into base64 data
token-convert-time: convert a date/time from one format to another
token-escape-for-dest-dn: convert a string for use in a destination DN
token-escape-for-src-dn: convert a string for use in a source DN
token-join: join a node-set into a string
token-lower-case: convert a string to lower case
token-map: map a string through a mapping table
token-map-source-col: used in token-map to have multiple source columns
token-parse-dn: parse and/or convert a DN
token-replace-all: replace all instances of a substring within a string
token-replace-first: replace a single instance of a substring within a string
token-split: split a string into a node-set
token-substring: substring of a string
token-upper-case: convert a string to upper case
token-xml-parse: parse XML
token-xml-serialize: serialize XML