Função de Tempo de Execução mvSQL - SHARED()¶

Resumo¶

Ao vincular a uma página, os critérios podem ser disponibilizados para os objetos de dados da página de destino. Esta função irá então acessar esses valores em vários locais.

Sintaxe¶

SHARED(<name>, <datatype>)

Parâmetros¶

Nome¶

Uma string representando o nome do critério solicitado.

Tipo de Dados¶

O tipo de dados é usado apenas para retornar valores nulos/vazios. O tipo de retorno Shared é sempre uma string e essencialmente sempre terá o comportamento padrão de retornar uma string vazia. Se os critérios compartilhados não estiverem disponíveis, o tipo de retorno poderá ser especificado como UUID ou numérico (se desejado). Se definido, o Vinyl retornará '00000000-0000-0000-0000-000000000000' para um UUID ou '0' para um número. Caso contrário, o SQL resultante falhará ao comparar um UUID com uma string vazia.

Devoluções¶

Retorna uma string entre aspas com o valor passado para a página.

Observações¶

Mais informações estão disponíveis sobre os Critérios Compartilhados, incluindo como definir os critérios compartilhados e onde esta função pode ser usada.

A partir da versão 2.3, a função SHARED() sempre retorna uma string entre aspas.

Exemplos¶

Dado:

• A página recebe critérios compartilhados ActiveEmployeeId=5
• A página não recebe critérios compartilhados com o nome LastRegion

Esta regra poderia ser criada:

SELECT CustomerId, shared('ActiveEmployeeId') as ActiveEmployeeId FROM Customer WHERE CustomerRegionId <> shared('LastRegion', 'UUID')

O que seria avaliado em tempo de execução para:

SELECT CustomerId, '5' as ActiveEmployeeId FROM Customer WHERE CustomerRegionId <> '00000000-0000-0000-0000-000000000000'