Critérios Compartilhados¶

Visão Geral¶

Os critérios de vinculação são usados para permitir an App Builder link de página para carregar com ele chaves que filtram os dados na página de destino. Por exemplo, um link de uma página de categorias para uma página de produtos mostraria ao usuário produtos onde ProductCategoryId= ProductId. Critérios Compartilhados introduz a capacidade de alavancar essas variáveis passadas de maneiras adicionais além da cláusula WHERE.

Como Usar Valores de Critérios Compartilhados¶

Selecionar Cláusulas¶

A função Shared Criteria acessa os valores no contexto atual. Eles podem ser usados como qualquer função SQL. Se você incluir uma Column em qualquer objeto de dados, o valor será colocado lá como uma string. Ao selecionar um valor Shared Criteria, ele também pode ser usado em Painéis subsequentes. Ele se torna dados reais em seu objeto de dados e pode ser unido, usado por Controles, etc.

Por exemplo: shared('EmployeeID')

Cláusulas WHERE¶

As cláusulas WHERE podem conter esta função Shared Criteria. Se você executar a regra fora do contexto da sua Página (exibindo resultados, por exemplo), espere que a função Shared retorne o valor padrão 'não encontrado' para o tipo de dados especificado.

Por exemplo: Where E.EmployeeID = shared('EmployeeID')

CRUD¶

Regras CRUD podem ser executadas usando Critérios Compartilhados. Inserindo ou atualizando usando este valor nas cláusulas WHERE ou SELECT.

Eventos de Fundo¶

Os eventos de execução do usuário que são executados em segundo plano podem incluir Critérios Compartilhados.

Formatação Condicional¶

A formatação condicional pode tirar proveito dos Critérios Compartilhados passados ao Painel.

Substituição Dinâmica¶

Dados de células e rótulos de controle podem acessar Critérios compartilhados. Por exemplo, inclua "Bem-vindo ao {{NomedaEmpresa}}" em uma célula de objeto de dados, ou o mesmo em um rótulo de controle.

Correndo Sem Critérios Compartilhados¶

Se você estiver usando a função Shared Criteria, o objeto de dados ainda será executado se a página ou url não contiver um critério correspondente. No entanto, você precisará certificar-se de que sua cláusula WHERE ou cláusula SELECT ainda funcione se a função retornar uma string vazia.

Valor Padrão ao Inserir¶

Quando você vincula a uma Página com Critérios Compartilhados, todas as linhas que você inserir terão o valor compartilhado automaticamente padronizado para colunas que têm o mesmo nome.

Valor Padrão ao Editar¶

Quando você vincula a uma Página com Critérios Compartilhados e alterna para um estado de edição, os Critérios Compartilhados serão "padrão" em quaisquer colunas nulas com o mesmo nome.

Função de Tempo de Execução SQL: Compartilhada¶

Em SQL você acessa critérios compartilhados por meio da função Shared. Por exemplo:

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

A função retorna o valor compartilhado como uma string. A função tem dois parâmetros:

• Nome: o nome do critério a ser pesquisado
• Tipo de dados: se o critério compartilhado não for encontrado, o tipo de retorno pode ser especificado como UUID ou numérico. Se definido, App Builder retornará '00000000-0000-0000-0000-0000-000000000000' para um UUID ou '0' para um número. Caso contrário, o SQL resultante falhará ao comparar um UUID a uma string vazia.

Como Especificar Quais Valores Devem Ser Compartilhados em um Link de Página¶

Critérios compartilhados podem ser especificados no nível do painel ou do campo.

Critérios Compartilhados estão disponíveis somente em links de página. Esses são links que alteram a URL e abrem uma nova Página. A Página segmentada fornecerá esses valores Compartilhados a todos os Painéis 'raiz' (Painéis não vinculados a outros Painéis). A menos que você use a função Compartilhado, os Painéis segmentados não filtrarão automaticamente.