Opérations de 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.

Préfixes de requête

Un préfixe de requête dans une expression Data Fabric récupère les enregistrements en fonction de la valeur d'un champ plutôt qu'en fonction de l'ID interne de l'enregistrement. Deux préfixes sont pris en charge :

Préfixe	Nom complet	Type de retour	Comportement sans correspondance	Comportement des correspondances multiples
qes:	Expansion de requête unique	Enregistrement unique	Renvoie un résultat vide	Renvoie une erreur
qem:	Expansion de requête multiple	Array allant jusqu'à 1 000 enregistrements	Renvoie un array vide	Renvoie tous les enregistrements correspondants

Syntaxe de l'expression

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

Exemple - recherche d'enregistrement unique

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

Exemple - recherche de plusieurs enregistrements

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

Quand utiliser chaque préfixe

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.

Remarque :

Lors de la migration d'expressions de qes: vers qem:, mettez à jour les références aux variables en aval. qes: renvoie un seul objet d'enregistrement ; qem: renvoie un array.

Sorties

Les sorties de tâches BPMN qui ciblent une entité Data Fabric prennent en charge trois actions. Cette action détermine si la sortie insère un nouvel enregistrement, modifie un enregistrement existant ou effectue les deux opérations, selon qu'il existe ou non un enregistrement correspondant.

Action	Comportement	L'enregistrement doit exister
create	Insère un nouvel enregistrement	Non (No)
update	Modifie un enregistrement existant identifié par l'ID d'enregistrement	Oui (Yes)
upsert	Insère un nouvel enregistrement si aucune correspondance n'est trouvée ; met à jour l'enregistrement existant si une correspondance est trouvée	Non (No)

L'action de sortie est configurée dans la section Sortie du panneau Propriétés de la tâche. Pour plus d'informations sur le panneau Propriétés, consultez Configuration des propriétés et des données.

Pages liées

• Intégration des systèmes et des données
• Utilisation des fichiers dans les Processes Maestro Orchestrate
• Éditeur de variables et d'expressions
• Configuration des propriétés et des données