Critérios compartilhados no Jitterbit App Builder

Critérios compartilhados permitem que desenvolvedores usem variáveis passadas através de páginas vinculadas ou painéis vinculados. Essas variáveis são tipicamente geradas através de critérios de vinculação, que permitem que um link de página do App Builder ou uma relação de painel carregue chaves que filtram dados em um objeto alvo. Por exemplo, um link de uma página de Categorias para uma página de Produtos pode filtrar resultados para mostrar apenas aqueles produtos relevantes à categoria escolhida. Além de cláusulas WHERE simples, critérios compartilhados ampliam como essas variáveis podem ser usadas em toda a aplicação.

Uma URL gerada com critérios compartilhados geralmente segue este formato:

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

Como usar valores de critérios compartilhados

Critérios compartilhados são usados para acessar valores no contexto de execução atual, comportando-se muito como qualquer função SQL padrão. Quando um valor de critério compartilhado é incluído em uma coluna de objeto de dados, ele é tratado como uma string e se torna dados reais que podem ser unidos, usados por controles de UI ou referenciados por painéis subsequentes. Por exemplo, usar shared('EmployeeID') permite que você trate essa variável como uma coluna padrão dentro da sua lógica.

Esses valores são altamente versáteis e podem ser aplicados em cláusulas WHERE para filtrar resultados ou dentro de regras CRUD para impulsionar inserções e atualizações. Se uma regra for executada fora do contexto de uma página (como ao visualizar resultados brutos), a função retornará o valor padrão 'não encontrado' para o tipo de dado especificado. Critérios compartilhados também são suportados em eventos em segundo plano iniciados por usuários, bem como na lógica de formatação condicional. Além disso, a substituição dinâmica permite que valores compartilhados apareçam em dados de células e rótulos de controle usando sintaxe como {{ CompanyName }}, desde que "Suporte à substituição" esteja habilitado no controle.

O sistema também lida com cenários onde critérios podem estar ausentes ou quando os dados estão sendo modificados. Se uma página ou URL não contiver um critério correspondente, o objeto de dados ainda será executado, desde que o SQL possa lidar com um retorno de string vazia. Ao vincular a uma página com critérios compartilhados, quaisquer novas linhas inseridas automaticamente definirão colunas do mesmo nome para o valor compartilhado. Da mesma forma, ao mudar para um estado de edição, critérios compartilhados se definirão automaticamente em quaisquer colunas nulas que compartilhem o mesmo nome.

Função de tempo de execução SQL: Compartilhado

No SQL, você acessa essas variáveis por meio da função shared(). Esta função aceita dois parâmetros: o Nome do critério a ser pesquisado e o Tipo de Dados. Especificar um tipo de dado é importante; por exemplo, se um critério não for encontrado e o tipo estiver definido como UUID ou numérico, o App Builder retornará um GUID em branco ou um '0', respectivamente, para garantir que o SQL resultante não falhe ao comparar diferentes tipos de dados. Um exemplo de uso é:

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

Especificar valores compartilhados

Os critérios compartilhados podem ser definidos tanto no nível do painel quanto no nível do campo. Embora sejam frequentemente usados em links de página, onde a URL muda e abre uma nova página, eles também são igualmente suportados por meio da vinculação de painéis. Páginas direcionadas fornecem esses valores a todos os painéis 'raiz' (aqueles que não estão explicitamente vinculados a outros).