Função de tempo de execução Caller() mvSQL no Jitterbit App Builder

Resumo

As colunas da linha atual podem ser disponibilizadas para os objetos de dados a jusante. Essa função pode acessar esses valores em vários locais.

Caller() pode ser usado em expressões em Regras CRUD dentro de Eventos, Manipuladores de Sucesso ou Manipuladores de Erro. Quando a função Caller() é usada em um Manipulador de Sucesso ou Erro, a Ação procurará um campo específico da Regra de Ação da qual está sendo executada. Quando a função Caller() é usada em uma Regra de Ação, ela analisa os valores dos campos do registro no Objeto de Negócio em que o Evento está sendo executado (veja Exemplos).

As funções de tempo de execução podem retornar mais do que uma string se um parâmetro de tipo for especificado.

Nota

Esta função mvSQL funcionará apenas em Regras CRUD, e não com outros objetos de dados.

Sintaxe

CALLER(<name> [, <datatype> ])

Parâmetros

Nome

Uma string representando o nome dos critérios solicitados.

Tipo de dados

Tipo de dado, string é o padrão, opcional. Tipos de dados suportados:

String (padrão)
Numérico
UUID
Booleano
DataHora

Nota

O parâmetro datatype é opcional por padrão. Se a opção Requerer Parâmetro de Tipo de Função estiver habilitada nas Configurações Avançadas da fonte de dados, o parâmetro se torna obrigatório. Isso é útil ao implantar aplicativos em diferentes tipos de banco de dados.

Retornos

Um valor do tipo de dado datatype, ou NULL se name referenciar uma coluna indisponível.

Exemplos

Exemplo direcionando para outra tabela

Uma linha da tabela Customer tem um evento Uppercase que direciona para outra tabela.

Essa regra poderia ser criada:

SELECT UPPER(CALLER('CustomerName')) as UppercasedName FROM CustomerArchive

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

SELECT UPPER('John Doe') as UppercasedName FROM CustomerArchive

Exemplo de uso com manipulador de sucesso

O Objeto de Negócio 123 tem um Evento chamado event.
event tem uma Ação do tipo Regra com a Regra abc.
abc tem um Evento de Manipulador de Sucesso, onde a Ação do tipo Regra tem a Regra def.
def tem uma Expressão Caller('uuid').
Caller('uuid') direciona para a PK da Tabela de Destino para def com bind como o tipo de Destino.
uuid de Caller('uuid') existe apenas pelo nome em abc, não no Objeto de Negócio 123.
No cenário apropriado, o Manipulador de Sucesso é acionado e atualiza com sucesso o registro apropriado na Tabela de Destino de def de acordo com a Regra.