Operações do Data Fabric no Maestro

Os processos do Maestro podem consultar e atualizar registros do Data Fabric diretamente de expressões de tarefa BPMN e mapeamentos de saída. Esta página documenta os prefixos de consulta e ações de saída compatíveis.

Prefixos de consulta

Um prefixo de consulta em uma expressão do Data Fabric recupera registros por valor de campo em vez de por ID de registro interno. Dois prefixos são compatíveis:

Prefix	Nome completo	Retornar tipo	Comportamento sem correspondência	Comportamento de várias correspondências
qes:	Expansão de consulta única	Registro único	Retorna um resultado vazio	Retorna um erro
qem:	Expansão de consulta múltipla	Matriz de até 1.000 registros	Retorna uma matriz vazia	Retorna todos os registros correspondentes

Sintaxe da expressão

datafabric.EntityName["qes:FieldName=Value"].FieldToRead
datafabric.EntityName["qem:FieldName=Value"]

Exemplo — pesquisa de registro único:

datafabric.LoanApplicationCase["qes:CaseId=HL-999"].LoanAmount

Exemplo — pesquisa de vários registros:

datafabric.LoanApplicationCase["qem:Status=Pending"]

Quando usar cada prefixo

qes: adequado para pesquisas em que é esperado exatamente um registro. Quando a consulta corresponde a mais de um registro, o Maestro retorna um erro e o fluxo de trabalho é interrompido. Quando nenhum registro é encontrado, o Maestro retorna um resultado vazio e continua a execução.

qem: adequada para consultas que podem retornar mais de um registro. O Maestro retorna uma matriz de até 1.000 registros correspondentes. Um processo pode iterar no array usando um marcador de várias instâncias ou um loop, permitindo padrões de distribuição em vários registros do Data Fabric em uma única etapa.

Observação:

Ao migrar expressões de qes: para qem:, atualize as referências de variáveis downstream. qes: retorna um único objeto de registro; qem: retorna uma matriz.

Ações de Saída

As saídas de tarefas BPMN que têm como destino uma entidade do Data Fabric são compatíveis com três ações. A ação determina se a saída insere um novo registro, modifica um existente ou faz as duas coisas, dependendo de se existir um registro correspondente.

Ação	Comportamento	O registro deve existir
create	Insere um novo registro	Não
update	Modifica um registro existente identificado pelo ID do registro	Sim
upsert	Insere um novo registro se nenhuma correspondência for encontrada; atualiza o registro existente se uma correspondência for encontrada	Não

A ação de saída é configurada na seção Saída do painel de propriedades da tarefa. Para obter mais informações sobre o painel de propriedades, consulte Configuração de propriedades e dados.

Páginas relacionadas

• Integração de sistemas e dados
• Trabalho com arquivos em processos do Maestro
• Variáveis e Editor de expressão
• Configuração de propriedades e dados