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,substringIdentifierdeve estar em branco.
- phaseNumberList:(Opcional) Define o número da fase que produz o valor deattributeName. SephaseNumber: for omitido, o DSA fornecerá o valor deattributeNamea partir do filtro fornecido no comando de pesquisa LDAP que invocou a exibição.O valor dephaseNumberdeve 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.
- attributeNameEspecifica 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 desubstringIdentifieré ú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.
- delimiterStringDefine 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.
- substringNumberEspecifica 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.
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.
- numberOfDNsOrCharactersEspecifica 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" ...