Use esta função para executar a SQLPathExpression que você criou chamando as funções de utilitário cniSqlCreateReadOnlyPathExpression ou cniSqlCreateModifiablePathExpression, conforme definido pelo argumento sqlPathExpression.
CciElement* cniSqlNavigatePath(
int* returnCode,
CciSqlPathExpression* sqlPathExpression,
CciMessage* inputMessageRoot,
CciMessage* inputLocalEnvironment,
CciMessage* inputExceptionList,
CciMessage* outputMessageRoot
CciMessage* outputLocalEnvironment,
CciMessage* outputExceptionList);
A tabela a seguir mostra o mapeamento entre os nomes de correlação aceitos na expressão de caminho ESQL e os dados acessados.
| Nome de correlação | Dados Acessados |
|---|---|
| Ambiente | A única árvore Ambiente para o fluxo. Esse elemento é determinado pelo intermediário e não é necessário especificá-lo através dessa API. |
| Ambiente Local da Entrada | Parâmetro inputLocalEnvironment para cniSqlNavigatePath |
| Ambiente Local da Saída | Parâmetro outputLocalEnvironment para cniSqlNavigatePath |
| Raiz da Entrada | Parâmetro inputMessageRoot para cniSqlNavigatePath |
| Corpo da Entrada | Último filho de InputRoot |
| Propriedades da Entrada | InputRoot.Properties (InputRoot.Properties é o primeiro filho de InputRoot, chamado "Properties") |
| Raiz da Saída | Parâmetro outputMessageRoot para cniSqlNavigatePath |
| Lista de Exceções de Entrada | Parâmetro inputExceptionList para cniSqlNavigatePath |
| Lista de Exceções da Saída | Parâmetro outputExceptionList para cniSqlNavigatePath |
| Database | Origem de dados ODBC identificada pelo parâmetro dataSourceName para cniCreateReadOnlyPathExpression ou cniCreateModifyablePathExpression |
| Lista de Destino da Entrada | Sinônimo de InputLocalEnvironment que é compatível com versões anteriores |
| Lista de Destino da Saída | Sinônimo de OutputLocalEnvironment que é compatível com versões anteriores |
Todas as outras regras sobre a navegabilidade e validade de caminhos reais estão definidas em Nomes de Correlação.
Supondo que você tenha criado anteriormente uma SQLPathExpression (consulte o exemplo para cniSqlCreateReadOnlyPathExpression ou cniSqlCreateModifiablePathExpression), seria possível utilizar o seguinte código para navegar no elemento de destino.
CciElement* targetElement = cniSqlNavigatePath(
NULL,
((NODE_CONTEXT_ST *)context)->pathExpression,
message,
localEnvironment,
exceptionList,
NULL, /* não referenciar nenhuma árvore de saída*/
NULL,
NULL);