A janela de configuração de uma Consulta Hierarquia do Aplicativo, mostrada na figura a seguir, permite editar, verificar e visualizar o resultado de uma consulta.
Janela Editor de XQuery
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Editor de XQuery
Opção |
Descrição |
|---|---|
Objeto de contexto |
Objeto usado como o objeto raiz da consulta. Clique em |
Verificar |
Verifica se a sintaxe do script na opção Consulta XQuery está correta. O resultado desta verificação é mostrado na opção Resultado. Esta opção corresponde ao método VerifyXQuery do objeto Consulta Hierarquia do Aplicativo |
Executar |
Executa o script da opção Consulta XQuery e mostra o resultado desta execução na opção Resultado. Esta opção corresponde ao método RunXQuery do objeto Consulta Hierarquia do Aplicativo |
Consulta XQuery |
Script usado nesta Consulta. Esta opção corresponde à propriedade Script do objeto Consulta Hierarquia do Aplicativo |
Resultado |
Mostra o resultado da verificação ou execução de uma Consulta |
A linguagem XQuery utilizada na Consulta Hierarquia do Aplicativo tem as seguintes particularidades:
•Strings literais só são permitidas com aspas duplas (")
•Comentários devem utilizar o padrão do VBScript, com o caractere de aspas simples (')
•O caractere de sublinhado (_) permite continuar o código na próxima linha
•O objeto raiz, indicado na propriedade DefaultObjectPath, inicia como o objeto de contexto atual (@me) e o primeiro comando @foreach varre os objetos filhos deste objeto de contexto
•O comando @with permite executar comandos filhos em um novo objeto de contexto, permitindo acessar coleções internas destes objetos
•O argumento de um comando @with é uma expressão que deve obrigatoriamente retornar um objeto
•Utilize o comando @with com um caractere de interrogação (?) ao final da linha para indicar que a expressão avaliada é opcional e não deve gerar um erro, como por exemplo ao acessar uma coleção existente que pode estar vazia no momento da consulta
NOTAS |
•Para mais informações sobre a especificação da linguagem XQuery, consulte a Referência de linguagem XQuery. •Uma Consulta Hierarquia do Aplicativo também pode ser executada usando o método XQuery do módulo E3Globals. |
Exemplos de Uso da Consulta Hierarquia do Aplicativo
Para consultar os objetos filhos da pasta Dados do servidor da aplicação de demonstração do Elipse E3, utilize o código a seguir.
<{Name}>
@foreach
<{TypeName(Me)} Name>
@recurse
O resultado desta consulta é semelhante ao código a seguir.
<Dados>
<DemoTag Name='DataHora' />
<InternalTag Name='EnableAlarmingMode' />
</Dados>
Para acessar todas as Associações da Tela Menu da aplicação de demonstração do Elipse E3, utilize o código a seguir.
<root>
@foreach
@var Object = {Me.PathName}
@with Me.Links
@foreach
<Link Object Property Source>
@recurse
O resultado desta consulta é semelhante ao código a seguir.
<root>
<Link Object='AppScreens.Root.Menu.hpLyraMenu1.Monitor' Property='Visible' Source='False' />
<Link Object='AppScreens.Root.Menu.hpLyraMenu1.StartRunning' Property='Visible' Source='False' />
</root>