Operações do Data Fabric

Supported query prefixes and output actions for querying and updating Data Fabric records directly from BPMN task expressions in Maestro Orchestrate.

Maestro Orchestrate processes can query and update Data Fabric records directly from BPMN task expressions and output mappings. This page documents the supported query prefixes and output actions.

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: is suited for lookups where exactly one record is expected. When the query matches more than one record, Maestro Orchestrate returns an error and the workflow stops. When no record is found, Maestro Orchestrate returns an empty result and continues execution.

qem: is suited for queries that may return more than one record. Maestro Orchestrate returns an array of up to 1,000 matching records. A process can iterate over the array using a multi-instance marker or a loop, enabling fan-out patterns across multiple Data Fabric records in a single step.

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 Orchestrate
• Variáveis e Editor de expressão
• Configuração de propriedades e dados