Rechercher les enregistrements

UiPath.MicrosoftDynamics.Activities.SearchRecords

À l'aide de vos paramètres de recherche (QueryOptions et Object), l'activité Search Records utilise l'opération GET de l'API Web pour récupérer les enregistrements.

Après avoir récupéré les enregistrements, l'activité génère les résultats dans un objet DataTable (Résultat) et le statut de la requête (informations de réussite/d'échec) dans un objet ResponseStatus (StatutMicrosoftDynamics), que vous pouvez utiliser dans des activités ultérieures (par exemple, logique conditionnelle, Mettre à jour l'enregistrement ( Update Record), Télécharger la pièce jointe de l'activité (Download Activity Attachment), etc.).

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l'activité Étendue de l'application Microsoft Dynamics ( Microsoft Dynamics Application Scope ) à votre projet.
3. Ajoutez l’activité Rechercher dans les enregistrements ( Search Records) à l’intérieur de l’activité Étendue de l’application Microsoft Dynamics .
4. Sélectionnez l' objet que vous souhaitez récupérer et entrez vos paramètres de recherche dans la propriété Options .
5. Créez et entrez une variable DataTable et une ResponseStatus pour les propriétés de sortie .
   • Vos valeurs de propriété d'entrée sont envoyées dans la demande d'opération GET .
   • L'opération renvoie les valeurs DataTable et ResponseStatus à vos variables de propriété de sortie.
     
     

     

     
     

Dans le corps de l’activité

• Objet ( Object ) : sélectionnez un objet à l'aide de l' assistant d'objet.

Propriétés

Commun

• DisplayName : le nom complet de l'activité. Ce champ ne prend en charge que les chaînes ou les variables String .

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• OptionsRequête : les paramètres de recherche que vous souhaitez utiliser pour récupérer vos enregistrements. Saisissez une variable Dictionary<String, String> ou Dictionary<String, String> . Pour plus d'informations sur les valeurs de requête, consultez les pages de métadonnées de requête et/ou de données de requête dans la documentation Microsoft. Consultez les étapes ci-dessous pour savoir comment créer et remplir une variable Dictionary<String, String> .
  Remarque :

  Voici une façon de remplir une variable Dictionary<String, String> :

  • Installez le package Microsoft.Activities.Extensions .
  • Créez une nouvelle variable Dictionary<String, String> (par exemple, optionrequête).
  • Ajoutez une activité Ajouter au dictionnaire .
  • Entrez votre variable de dictionnaire (par exemple, queryOption)
  • Saisissez une seule méthode de requête dans la propriété Clé (par exemple, "$filter", "$select", etc.)

  • Saisissez la valeur à appliquer à la méthode de requête (par exemple, "name eq 'Quickstart_Account'")

    • Répétez l'étape 3 pour appliquer des OptionsRequêtesupplémentaires.

Sortie

• ResponseStatus (ResponseStatus) - Statut de la demande (informations de réussite/échec). Saisissez une variable ResponseStatus (UiPath.BAF.Models.ResponseStatus). L'objet ResponseStatus comprend trois propriétés que vous pouvez utiliser dans d'autres activités.
  • Success - Boolean - Spécifie si la requête API a réussi.
  • Code d'erreur - String - L'erreur de réponse si la requête API échoue (Success=False).
  • Message - String - Le message d'erreur.
• Résultat (Result ) : les enregistrements qui correspondent à vos paramètres de recherche. Saisissez une variable DataTable .

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez le guide de démarrage rapide .