Exécuter actions
Dans OData, les actions permettent d'ajouter des opérations côté serveur sur des entités. Une action peut cibler une entité unique ou une collection d'entités. Les actions renvoient des données et sont utilisables aux fins suivantes :
• manipulation de plusieurs entités en même temps ;
• autorisation des mises à jour pour certaines propriétés d'une entité uniquement ;
• envoi de données non définies dans une entité au serveur ;
• implémentation de transactions complexes.
Utilisez l'action Exécuter actions pour exécuter des actions définies dans les métadonnées OData.
Procédez comme suit pour utiliser l'action Exécuter actions dans votre processus :
1. Faites glisser l'action Exécuter actions sous OData jusqu'au canevas, placez le pointeur sur l'action, puis cliquez sur 
ou double-cliquez sur l'action. La fenêtre Exécuter actions s'ouvre.
ou double-cliquez sur l'action. La fenêtre Exécuter actions s'ouvre.2. Modifiez le champ Etiquette, si nécessaire. Par défaut, le nom de l'étiquette est identique à celui de l'action.
3. Pour ajouter un type de connecteur OData, consultez la rubrique Types de connecteur OData pris en charge.
Si vous avez déjà précédemment ajouté un type de connecteur approprié, sélectionnez-le dans Type de connecteur, puis sous Nom du connecteur, sélectionnez le connecteur voulu.
4. Cliquez sur TESTER pour valider le connecteur.
5. Cliquez sur MAPPER CONNECTEUR pour exécuter l'action à l'aide d'un connecteur différent de celui que vous utilisez pour renseigner les champs d'entrée. Dans le champ Connecteur d'exécution, spécifiez un nom de connecteur OData valide. Pour plus d'informations sur la commande MAPPER CONNECTEUR, consultez la section détaillant l'utilisation d'un mappage de connecteur.
6. Cochez la case Inclure domaines de référence pour afficher toutes les actions décrites par ActionImport dans les domaines référencés.
7. Dans la liste Action, sélectionnez l'action OData à exécuter.
Les champs du formulaire d'entrée changent dynamiquement en fonction de l'action sélectionnée.
8. Sélectionnez Formulaire pour renseigner vos entrées au moyen des propriétés du formulaire, ou sélectionnez Affecter JSON pour spécifier un JSON unique comportant toutes les propriétés requises.
9. Utilisez les options de la liste Type de requête pour filtrer la sortie en fonction des propriétés d'objet que vous souhaitez inclure dans la sortie. Si l'action ne renvoie pas d'objet, l'option Type de requête n'est pas disponible.
Selon le type de renvoi de l'action, une requête possède les paramètres suivants :
◦ Objet unique : Sélectionner propriétés, Ajouter éléments connexes
◦ Collection d'objets : Filtres, Sélectionner propriétés, Ajouter éléments connexes, Limiter, Ignorer
Dans la liste Type de requête, sélectionnez Requête à base de formulaire, Requête discrète ou Requête brute pour fournir des paramètres de requête.
Requête à base de formulaire a. (Disponible uniquement pour une collection d'objets) Dans le groupe Filtrer, effectuez les opérations suivantes : a. Dans la liste Combiner avec, sélectionnez un opérateur logique de combinaison des clauses de filtrage. La valeur par défaut est and. b. Sous Clauses de filtrage, cliquez sur Ajouter pour ajouter un filtre : ▪ Propriété : sélectionnez une propriété. ▪ Condition correspondance : sélectionnez une condition. La condition dépend du type de la propriété sélectionné (par exemple String, Boolean, etc.). ▪ Valeur : spécifiez une valeur de propriété. Pour ajouter d'autres filtres, cliquez sur Ajouter. Pour supprimer les filtres que vous avez ajoutés, cliquez sur  .Si vous ajoutez les mêmes propriétés, puis que vous sélectionnez ET dans la liste Combiner avec, les attributs sont joints par l'opérateur OU. b. Sous Sélectionner propriétés, cliquez sur Ajouter, puis, dans la liste Propriété, sélectionnez la propriété dont vous souhaitez récupérer les valeurs. Pour ajouter d'autres propriétés, cliquez sur Ajouter. Pour supprimer les propriétés que vous avez ajoutées, cliquez sur .Par défaut, si vous sélectionnez une propriété, les valeurs des propriétés sélectionnées et des propriétés "clé" sont récupérées dans la sortie. Si vous ne sélectionnez aucune propriété, toutes les propriétés d'entité sont incluses par défaut dans la sortie. c. Sous Ajouter éléments connexes, cliquez sur Ajouter, puis dans la liste Elément connexe, sélectionnez l'élément connexe dont vous souhaitez récupérer les valeurs. Pour spécifier d'autres éléments connexes, cliquez sur Ajouter. Pour supprimer les éléments connexes que vous avez ajoutés, cliquez sur .Toute propriété marquée NavigationProperty est catégorisée comme Elément connexe. d. (Disponible uniquement pour une collection d'objets) Dans le champ Limiter, spécifiez une valeur pour limiter la sortie à un nombre donné d'entités. e. (Disponible uniquement pour une collection d'objets) Dans le champ Ignorer, spécifiez le nombre de ressources que vous souhaitez ignorer. |
Requête discrète a. (Disponible uniquement pour une collection d'objets) Dans le champ Filtres, spécifiez les critères de filtrage OData au format propertyName operator 'value' [and | or | not].... Par exemple, number eq '0000222341' ou name eq 'PTC' ou startswith(name, 'PTC') b. Dans le champ Sélectionner propriétés, spécifiez une expression de sélection OData pour fournir une liste de noms de propriété séparés par une virgule. Par défaut, si vous spécifiez une propriété dans la requête, les valeurs des propriétés sélectionnées sont récupérées dans la sortie. Si vous ne spécifiez aucune propriété, toutes les propriétés d'entité sont incluses par défaut dans la sortie. c. Dans le champ Ajouter éléments connexes, spécifiez une expression de sélection OData pour fournir une liste d'éléments connexes séparés par une virgule. Toute propriété marquée NavigationProperty est catégorisée comme Elément connexe. d. (Disponible uniquement pour une collection d'objets) Dans le champ Limiter, spécifiez le nombre de résultats de recherche que vous souhaitez récupérer. e. (Disponible uniquement pour une collection d'objets) Dans le champ Ignorer, spécifiez le nombre de résultats principaux de recherche que vous ne souhaitez pas inclure dans le résultat. |
Requête brute Dans le champ de Requête, spécifiez une expression de requête OData. Par exemple : $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' Par défaut, si vous spécifiez une propriété dans la requête, les valeurs des propriétés sélectionnées sont récupérées dans la sortie. Si vous ne spécifiez aucune propriété, toutes les propriétés d'entité sont incluses par défaut dans la sortie. Toute propriété marquée NavigationProperty est catégorisée comme Elément connexe. Selon le type de renvoi de l'action, vous pouvez spécifier des paramètres Filtres, Limiter et Ignorer dans l'expression de requête. |
10. Cliquez sur Afficher champs supplémentaires.
11. Dans le groupe En-têtes, cliquez sur Ajouter pour ajouter un en-tête personnalisé à la requête. Spécifiez une paire Clé/Valeur.
Pour ajouter d'autres paires clé/valeur, cliquez sur Ajouter. Pour supprimer les en-têtes personnalisés que vous avez ajoutés, cliquez sur .
.12. Cliquez sur Terminé.
 | Lors de la modification de ce formulaire d'action, si vous modifiez l'Action sélectionnée et que vous spécifiez des valeurs pour tous les champs obligatoires, une notification d'erreur peut s'afficher dans l'éditeur de processus. Dans ce cas, ouvrez de nouveau le formulaire d'action et cliquez sur Terminé. L'erreur ne s'affiche plus. |
Schéma de sortie
Selon l'action OData que vous sélectionnez, l'action Exécuter actions renvoie un schéma de sortie dynamique. Si l'action n'a pas de type de renvoi, elle retourne une chaîne de message.
Si vous avez sélectionné Requête à base de formulaire pour spécifier les paramètres de requête, le schéma de sortie fournit uniquement les détails des propriétés sélectionnées.
Si vous avez sélectionné Requête discrète ou Requête brute, le schéma de sortie contient toutes les propriétés de l'objet renvoyé, mais il ne fournit que les valeurs des propriétés sélectionnées.