Parámetros de vistas
Utilice un parámetro de vista en el comando set view para especificar un marcador de posición para una cadena. El agente de sistema de directorio determinará el valor del parámetro de vista cuando se invoque la vista o después de que el agente de sistema de directorio haya ejecutado una fase más temprana dentro de la vista.
cad140es
Utilice un parámetro de vista en el comando
set view
para especificar un marcador de posición para una cadena. El agente de sistema de directorio determinará el valor del parámetro de vista cuando se invoque la vista o después de que el agente de sistema de directorio haya ejecutado una fase más temprana dentro de la vista.La sintaxis de un parámetro de vista es la siguiente:
[$][phaseNumberList:]attributeName[substringIdentifier]
- $(Opcional) Especifica que el agente de sistema de directorio debe considerar este elemento como un parámetro de vista.Si falta $, la cadena se considera como un nombre de atributo literal y no se lleva a cabo ninguna sustitución. En ese caso,substringIdentifierdebe estar en blanco.
- phaseNumberList:(Opcional) Define el número de fase que genera el valor deattributeName. SiphaseNumber:se omite, el agente de sistema de directorio proporciona el valor deattributeNamedel filtro especificado en el comando de búsqueda LDAP que ha invocado la vista.phaseNumberdebe ser un número menor que el número de la fase en la que se utiliza el parámetro. Es decir, una fase puede hacer referencia únicamente a las fases anteriores de la vista.Se puede especificar una lista de números de fase al utilizar vistas condicionales.
- attributeNameEspecifica el atributo cuyo valor se utiliza para reemplazar el parámetro.
- substringIdentifier(Opcional) Especifica una sección dentro de una cadena del valor del atributo.Hay dos formatos posibles para el identificador de subcadena.El primer formato parasubstringIdentifieres útil si se desea extraer una subcadena basada en los caracteres delimitadores; es el siguiente:
- [delimiterString:substringNumber]Los corchetes y los dos puntos forman parte de la sintaxis y son obligatorios si se utiliza esta opción.
- delimiterStringDefine el delimitador dentro de la cadena del valor del atributo. Puesto que se trata de una cadena literal, puede incluir, por ejemplo, espacios en blanco, comillas y caracteres no alfanuméricos. La cadena de delimitador divide el valor del atributo en subcadenas.
- substringNumberEspecifica qué subcadenas se debe extraer de la cadena del valor del atributo. Las subcadenas del valor del atributo se enumeran de izquierda a derecha empezando en uno.
substringIdentifieres útil si desea extraer los nombres distintivos iniciales de una cadena de nombres distintivos, o si desea extraer los primeros caracteres de la cadena. El formato es el siguiente:- [numberOfDNsOrCharacters]Los corchetes forman parte de la sintaxis y son obligatorios si se utiliza esta opción.
- numberOfDNsOrCharactersEspecifica cuántos caracteres o nombres distintivos relativos se deben extraer de la cadena de valores de atributos, comenzando por el carácter más a la izquierda.Si este parámetro se utiliza como parte de la especificación de una fase del subárbol ("subtree=..."), devuelve el número de nombres distintivos relativos; de lo contrario, especifica el número de caracteres.
Ejemplo: Parámetro de vista $cn
Cuando se invoca la vista, el agente de sistema de directorio reemplaza la cadena de ejemplo con el valor del atributo
cn
proporcionado en el filtro del comando de búsqueda que se ha utilizado para invocar la vista.En este ejemplo, la búsqueda se invoca mediante el comando siguiente:
ldapsearch... (cn="Smith, John")
$cn
se reemplaza con el valor siguiente:Smith, John
Ejemplo: Parámetro de vista $cn[,:1]
Cuando se invoca la vista, el agente de sistema de directorio reemplaza la cadena de ejemplo con los caracteres anteriores a la primera coma del valor del atributo "cn".
En este ejemplo, la búsqueda se invoca mediante el comando siguiente:
ldapsearch... (cn="Smith,John")
$cn[,:1]
se reemplaza por el valor siguiente:Smith
Ejemplo: $cn[7]
Cuando se invoca la vista, el agente de sistema de directorio reemplaza la cadena de ejemplo por los primeros siete caracteres del valor del atributo "cn".
En este ejemplo, la búsqueda se invoca mediante el comando siguiente:
ldapsearch... (cn="Smith,John")
$cn[7]
se reemplaza por el valor siguiente:Smith,J
Ejemplo: $3:cn
Inmediatamente después de la ejecución de la fase tres de la vista, el agente de sistema de directorio reemplaza la cadena de ejemplo por el valor del atributo
cn
devuelto por la fase tres. La cadena de ejemplo solamente es válida a partir de la fase cuatro.Ejemplo: $2,3:cn
Mediante $2,3:cn, en el ejemplo siguiente se utiliza $2:cn o $3:cn en función de la fase que se ha invocado.
if ( condition ) { (phase = 2) } else { (phase = 3) }
Ejemplo: subtree= $1:dn
... (phase=2 subtree = $1:dn ...
Se trata de un fragmento del comando "set view". Inmediatamente después de la ejecución de la fase uno, el agente de sistema de directorio reemplaza la cadena $1:dn por el valor del nombre distintivo de cada resultado de búsqueda devuelto por la fase uno. Si la fase uno devuelve varios nombres distintivos, se ejecuta varias veces la fase dos: una vez por cada resultado de nombre distintivo devuelto por la fase uno.
Ejemplo: subtree= $1:dn[3]
... (phase=2 subtree = $1:dn[3] ...
Se trata de un fragmento del comando "set view". Inmediatamente después de la ejecución de la fase uno, el agente de sistema de directorio reemplaza la cadena $1:dn[3] por el valor de los tres primeros nombres distintivos relativos de los nombres distintivos de cada resultado de búsqueda devuelto por la fase uno. Si la fase uno devuelve varios nombres distintivos, se ejecuta varias veces la fase dos: una vez por cada resultado de nombre distintivo devuelto por la fase uno.
Ejemplo: subtree="uid=$1:uids,o=Democorp,c=AU"
... (phase=2 subtree="uid=$1:uids,o=Democorp,c=AU" ...
Se trata de un fragmento del comando "set view". Inmediatamente después de la ejecución de la fase uno, el agente de sistema de directorio reemplaza la cadena $1:uid por el valor de los uid devueltos por búsqueda de la fase uno. Si la fase uno devuelve varios nombres distintivos, se ejecuta varias veces la fase dos: una vez por cada resultado de nombre distintivo devuelto por la fase uno.
Por ejemplo, si la fase devuelve 12345 para el valor de uid, este fragmento equivale exactamente a lo siguiente:
... (phase=2 subtree="uid=12345,o=Democorp,c=AU" ...