Critérios compartilhados no Jitterbit App Builder

Visão geral

Critérios Compartilhados permitem que você aproveite variáveis passadas por páginas vinculadas. Essas variáveis normalmente são passadas ao usar critérios de vinculação, que permitem que um link de página do App Builder carregue chaves que filtram dados na página de destino (por exemplo, um link de uma página de Categorias para uma página de Produtos filtraria para mostrar produtos relevantes para a categoria escolhida), mas os critérios compartilhados estendem o uso das variáveis para além das cláusulas WHERE.

URLs de critérios compartilhados

Uma URL criada com critérios compartilhados será semelhante a este exemplo:

https://example.dev.zudy.host/app/App%20Name/Page%20Name?FieldName~Shared=2032

Como usar valores de critérios compartilhados

Selecione cláusulas

A função Critérios Compartilhados acessa os valores no contexto atual. Eles podem ser usados como qualquer função SQL. Se você incluir uma Coluna em qualquer objeto de dados, o valor será inserido como uma string. Ao selecionar um valor de Critérios Compartilhados, ele também poderá ser usado em Painéis subsequentes. Ele se torna um dado real no 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 de Critérios Compartilhados. Se você executar a regra fora do contexto da sua Página (visualizando resultados, por exemplo), espere que a função Compartilhado retorne o valor padrão "não encontrado" para o tipo de dado 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 executados pelo usuário 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 Critérios Compartilhados, o objeto de dados ainda será executado se a Página ou URL não contiver um critério correspondente. No entanto, você precisará garantir que sua cláusula WHERE ou SELECT ainda funcione se a função retornar uma string vazia.

Valor padrão ao inserir

Ao vincular uma Página com Critérios Compartilhados, todas as linhas inseridas terão o valor compartilhado automaticamente definido como padrão para colunas com o mesmo nome.

Valor padrão ao editar

Ao vincular uma Página com Critérios Compartilhados e alternar para o estado de edição, os Critérios Compartilhados serão "definidos" como padrão para 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 consultado
• Tipo de dado: se o critério compartilhado não for encontrado, o tipo de retorno pode ser especificado como UUID ou numérico. Se definido, o App Builder 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.

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 apenas em links de páginas. São links que alteram a URL e abrem uma nova Página. A Página de destino 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 de destino não serão filtrados automaticamente.