Opérations Data Fabric dans Maestro

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

Préfixes de requête

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

Préfixe	Nom complet	Type de retour	Comportement sans correspondance	Comportement multi-correspondance
qes:	Développement de requête unique	Enregistrement unique	Renvoie un résultat vide	Renvoie une erreur
qem:	Développement de requête multiple	Tableau de 1 000 enregistrements maximum	Renvoie un tableau vide	Renvoie tous les enregistrements correspondants

Syntaxe des expressions

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

qem: est adapté aux requêtes qui peuvent renvoyer plus d’un enregistrement. Maestro renvoie un tableau de 1 000 enregistrements correspondants. Un processus peut parcourir le tableau à l'aide d'un marqueur multi-instance ou d'une boucle, ce qui permet d'étaler des modèles sur plusieurs enregistrements Data Fabric en une seule étape.

Remarque :

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

Sorties

Les sorties de tâches BPMN qui ciblent une entité Data Fabric prennent en charge trois actions. L’action détermine si la sortie insère un nouvel enregistrement, modifie un enregistrement existant ou fait les deux selon qu’il existe 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 associés

• 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