Opérations Data Fabric dans Maestro

Les processus Maestro peuvent interroger et mettre à jour les enregistrements Data Fabric directement à partir des expressions de tâches BPMN et des mappages de sortie. Cette page répertorie les préfixes de requête pris en charge et les actions de sortie.

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: est adapté aux recherches où l'on s'attend à trouver exactement un enregistrement. Lorsque la requête correspond à plusieurs enregistrements, Maestro renvoie une erreur et le workflow s'arrête. Si aucun enregistrement n'est trouvé, Maestro renvoie un résultat vide et poursuit l'exécution.

qem: est adapté aux requêtes susceptibles de renvoyer plusieurs enregistrements. Maestro renvoie un array contenant jusqu'à 1 000 enregistrements correspondants. Un processus peut parcourir l'array à l'aide d'un marqueur multi-instance ou d'une boucle, ce qui permet de créer des schémas de répartition sur plusieurs enregistrements Data Fabric en une seule étape.

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
• Éditeur de variables et d'expressions
• Configuration des propriétés et des données