Parâmetros de exibições

Você pode usar o parâmetro de exibição dentro do comando set view para especificar um espaço reservado para uma sequência de caracteres. O DSA irá determinar o valor do parâmetro de exibição quando a exibição for invocada ou depois que o DSA tiver executado uma fase anterior dentro da exibição.
cad140br
Você pode usar o parâmetro de exibição dentro do comando 
set view
 para especificar um espaço reservado para uma sequência de caracteres. O DSA irá determinar o valor do parâmetro de exibição quando a exibição for invocada ou depois que o DSA tiver executado uma fase anterior dentro da exibição.
A sintaxe de um parâmetro de exibição é a seguinte:
[$][phaseNumberList:]attributeName[substringIdentifier]
  • $
    (Opcional) Especifica que o DSA deve tratar isso como um parâmetro de exibição.
    Se $ estiver faltando, a sequência de caracteres será tratada como um nome de atributo literal e nenhuma substituição ocorrerá. Nesse caso,
    substringIdentifier
    deve estar em branco.
  • phaseNumberList
    :
    (Opcional) Define o número da fase que produz o valor de 
    attributeName
    . Se
    phaseNumber
    : for omitido, o DSA fornecerá o valor de
    attributeName
    a partir do filtro fornecido no comando de pesquisa LDAP que invocou a exibição.
    O valor de 
    phaseNumber
    deve ser um número menor que o número da fase em que o parâmetro é usado. Ou seja, uma fase pode mecionar somente fases anteriores da exibição.
    Você pode especificar uma lista de números de fase ao usar exibições condicionais.
  • attributeName
    Especifica o atributo cujo valor é usado para substituir o parâmetro.
  • substringIdentifier
    (Opcional) Especifica uma seção em uma sequência de caracteres de valor do atributo.
    Existem dois formatos possíveis para o identificador da subsequência de caracteres.
    A primeira forma de 
    substringIdentifier
    é útil quando você deseja extrair uma subsequência de caracteres com base em caracteres delimitadores, e é a seguinte:
    • [
      delimiterString
      :
      substringNumber
      ]
      Os colchetes e os dois-pontos fazem parte da sintaxe e serão necessários se essa opção for usada.
    • delimiterString
      Define o delimitador dentro da sequência de caracteres de valor do atributo. É uma sequência de caracteres literal, então, por exemplo, ela pode incluir espaços em branco, aspas e caracteres não alfanuméricos. A sequência de caracteres do delimitador particiona o valor do atributo em subsequências de caracteres.
    • substringNumber
      Especifica quais subsequências de caracteres extrair da sequência de caracteres de valor do atributo. As subsequências de caracteres do valor do atributo são numeradas da esquerda para a direita, começando em um.
    A segunda forma de
    substringIdentifier
    é útil quando você deseja extrair os DNs à esquerda de uma sequência de caracteres de DNs ou quando deseja extrair os caracteres à esquerda da sequência de caracteres. Essa forma é a seguinte:
    • [
      numberOfDNsOrCharacters
      ]
      Os colchetes fazem parte da sintaxe e serão necessários se essa opção for usada.
    • numberOfDNsOrCharacters
      Especifica quantos RDNs ou caracteres extrair da sequência de caracteres de valor do atributo, começando com o caractere totalmente à esquerda.
      Se esse parâmetro for usado como parte da especificação de de subárvore de uma fase ("subtree=..."), ele retornará o número de RDNs. Caso contrário, ele especificará o número de caracteres.
Exemplo: parâmetro de exibição $cn
Quando a exibição é invocada, o DSA substitui a sequência de caracteres de exemplo pelo valor do atributo
cn
fornecido no filtro do comando de pesquisa que foi usado para invocar a exibição.
Neste exemplo, a pesquisa é invocada com o seguinte comando:
ldapsearch... (cn="Smith, John")
$cn
é substituído pelo seguinte valor:
Smith, John
Exemplo: parâmetro de exibição $cn[,:1]
Quando a exibição é invocada, o DSA substitui a sequência de caracteres de exemplo pelos caracteres que precedem a primeira vírgula do valor do atributo cn.
Neste exemplo, a pesquisa é invocada com o seguinte comando:
ldapsearch... (cn="Smith,John")
$cn[,:1]
 é substituído pelo seguinte valor:
Smith
Exemplo: $cn[7]
Quando a exibição é invocada, o DSA substitui a sequência de caracteres de exemplo pelos primeiros sete caracteres do valor do atributo cn.
Neste exemplo, a pesquisa é invocada com o seguinte comando:
ldapsearch... (cn="Smith,John")
$cn[7]
 é substituído pelo seguinte valor:
Smith,J
Exemplo: $3:cn
Imediatamente após a execução da fase três da exibição, o DSA substitui a sequência de caracteres de exemplo pelo valor do atributo
cn
retornado pela fase três. A sequência de caracteres de exemplo só é válida nas fases quatro e posterior.
Exemplo: $2,3:cn
Usando $2,3:cn no exemplo a seguir, use $2:cn ou $3:cn dependendo de qual fase tenha sido invocada.
if ( condition ) { (phase = 2) } else { (phase = 3) }
Exemplo: subtree= $1:dn
... (phase=2 subtree = $1:dn ...
Esse é um fragmento de um comando set view. Imediatamente após a execução da fase um, o DSA substitui a sequência de caracteres $1:dn pelo valor de DN de cada resultado de pesquisa retornado na fase um. Se a fase um retornar vários DNs, a fase dois será executada diversas vezes — uma vez para cada resultado de DN retornado da fase um.
Exemplo: subtree= $1:dn[3]
... (phase=2 subtree = $1:dn[3] ...
Esse é um fragmento de um comando set view. Imediatamente após a execução da fase um, o DSA substitui a sequência de caracteres $1:dn[3] pelo valor dos três primeiros RDNs dos DNs de cada resultado de pesquisa retornado na fase um. Se a fase um retornar vários DNs, a fase dois será executada diversas vezes — uma vez para cada resultado de DN retornado da fase um.
Exemplo: subtree="uid=$1:uids,o=Democorp,c=AU"
... (phase=2 subtree="uid=$1:uids,o=Democorp,c=AU" ...
Esse é um fragmento de um comando set view. Imediatamente após a execução da fase um, o DSA substitui a sequência de caracteres $1:uid pelo valor de uids retornado pela pesquisa da fase um. Se a fase um retornar vários DNs, a fase dois será executada diversas vezes, uma vez para cada resultado de DN retornado da fase um.
Por exemplo, se a fase retornae 12345 para o valor de uid, esse fragmento será exatamente equivalente ao seguinte:
... (phase=2 subtree="uid=12345,o=Democorp,c=AU" ...