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.
cad126es
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,
    substringIdentifier
    debe estar en blanco.
  • phaseNumberList
    :
    (Opcional) Define el número de fase que genera el valor de 
    attributeName
    . Si
    phaseNumber:
    se omite, el agente de sistema de directorio proporciona el valor de
    attributeName
    del filtro especificado en el comando de búsqueda LDAP que ha invocado la vista.
    phaseNumber
    debe 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.
  • attributeName
    Especifica 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 para
    substringIdentifier
    es ú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.
    • delimiterString
      Define 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.
    • substringNumber
      Especifica 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.
    El segundo formato de
    substringIdentifier
    es ú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.
    • numberOfDNsOrCharacters
      Especifica 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" ...