Operações do Data Fabric no Maestro

Os processos do Maestro podem consultar e atualizar registros do Data Fabric diretamente a partir de expressões de tarefas 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.Há suporte para dois prefixos:

Prefix	Nome completo	Tipo de retorno	Comportamento sem correspondência	Comportamento de correspondência múltipla
qes:	Expansão de consulta única	Registro único	Retorna um resultado vazio	Retorna um erro
qem:	Expansão de consulta múltipla	Array de até 1.000 registros	Retorna um array vazio	Retorna todos os registros correspondentes

Sintaxe de 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 se espera exatamente um registro.Quando a consulta corresponde a mais de um registro, o Maestro retorna um erro e o fluxo de trabalho para.Quando nenhum registro é encontrado, o Maestro retorna um resultado vazio e continua a execução.

qem: é adequado para consultas que podem retornar mais de um registro. O Maestro retorna um array 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 referências de variável subsequentes.qes: retorna um objeto de registro único; qem: retorna um array.

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 ambos, dependendo da existência de um registro correspondente.

Ação	Comportamento	O registro deve existir
create	Insere um novo registro	Não
update	Modifica um registro existente identificado pela 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