Funções SQL definidas pelo usuário no Jitterbit App Builder
A sintaxe da função SQL do usuário pode ser colocada em linha com a sintaxe suportada App Builder para substituição de parâmetros.
Exemplo de função SQL definida pelo usuário
Para fins de ilustração, descreveremos um caso de uso para ter uma Função SQL Definida pelo Usuário:
- Você tem duas tabelas: Employees (tabela original) e EmployeesPanel (tabela nova)
- Ambas as tabelas têm as mesmas chaves
- Uma tabela contém valores carregados da fonte de dados, a outra foi usada como uma fonte de painel
Se com o cenário acima você deseja exibir o valor Original ou o valor Original !! '-------' !! Novo valor para um campo específico, você pode fazer isso com uma Função SQL Definida pelo Usuário. Neste exemplo, usaremos uma Função SQL Definida pelo Usuário para comparar o valor FirstName da nossa tabela Original (Employees, alias como E) e a tabela New (EmployeesPanel, alias como EP).
Aqui está a definição para nossa Função SQL Definida pelo Usuário de exemplo:
IIF({0} = {1}, {0}, {0} || '------>' || {1})
Aqui está uma captura de tela ilustrando como este cenário de exemplo usando uma função SQL definida pelo usuário pode parecer na visualização do aplicativo App Builder:
Para criar uma função SQL definida pelo usuário
Funções SQL definidas pelo usuário são criadas na área Configurações do App Builder IDE, na tela Funções.
- Vá para a gaveta de ações e selecione App Builder IDE no menu
- Selecione Configurar seu site no menu Configurar
- Clique em Funções
- Clique no botão Criar para adicionar uma nova função SQL definida pelo usuário.
-
Forneça informações sobre a função SQL definida pelo usuário:
- Proprietário - Valor padrão
- Tipo - MVSQL ou SQL
- Nome - Nome definido pelo usuário para a função, deve começar com um caractere sublinhado. Por exemplo, _DiffFirstName
- Número de argumentos - Número de argumentos na função
- Definição - A sintaxe SQL real para a função
- Descrição - Descrição textual do que a função SQL faz
- Exemplo - Um exemplo usando a função SQL
- Resultados de exemplo - Resultados da função SQL
-
Clique em Salvar
Para usar uma função SQL definida pelo usuário em uma regra
Depois de criar uma Função SQL Definida pelo Usuário, você estará pronto para usá-la em uma Regra de Objeto de Negócios.
- Vá para a gaveta de ações e selecione App Builder IDE no menu
- Clique em Criar seu aplicativo no menu Criar
- Clique no botão de menu Camada de lógica de negócios
- Clique no ícone BOBJ para a fonte de dados do seu aplicativo
- Clique em Criar em Regras
- Atribua um Nome para a Função SQL Definida pelo Usuário e selecione Objeto Comercial como Finalidade
- Clique em Salvar
-
Clique no ícone SQL para definir a lógica SQL para a Função SQL Definida pelo Usuário. As etapas para configurar essa função são semelhantes a como você trabalha com a definição de outras funções SQL no App Builder. Quando chegar ao painel Colunas, você fará referência ao Nome da Função SQL Definida pelo Usuário junto com a sintaxe:
-
Se você quiser usar o valor da coluna da função SQL definida pelo usuário em outro lugar no aplicativo, clique em Criar em Colunas e adicione um ID exclusivo que vinculará as tabelas.
- Neste exemplo, queremos ver os resultados da função SQL definida pelo usuário no painel Funcionários que usa EmployeesPanel (Origem). Vá para a lógica de negócios EmployeesPanel (Origem) e clique no ícone SQL para o objeto de negócios EmployeesPanel (Origem).
- Clique em Criar em Tabelas e traga a regra do objeto de negócios da função SQL definida pelo usuário. Neste exemplo, é Employees (UDF _DiffFirstName).
- Crie uma junção interna na tabela e na regra
- Una as colunas no ID exclusivo
- Clique em Criar em Colunas para adicionar uma coluna com o valor resultante da sua função SQL definida pelo usuário que você deseja ver. Atribua um Alias e clique na marca de seleção para salvar.
Nota
Este recurso pressupõe que a pessoa que cria uma Função SQL Definida pelo Usuário esteja ciente da sintaxe suportada App Builder para substituição de parâmetros com Funções SQL.