Concepteur d’activités

Vue d'ensemble (Overview)

Le concepteur d’activités vous permet de prévisualiser la mise en page de vos activités Integration Service personnalisées telles qu’elles apparaîtront dans UiPath® Studio.

Ses principales fonctionnalités sont les suivantes :

• Aperçu de la mise en page (Preview layout) : prévisualisez la conception de vos activités personnalisées et voyez comment elles apparaîtront dans Studio. Vous pouvez visualiser la configuration et effectuer les ajustements nécessaires avant de déployer votre connecteur.
• Paramètres (Parameter settings) : créez et gérez des champs de paramètres, pour plus de flexibilité dans la personnalisation de votre activité. Cela inclut les arguments d'entrée, de sortie, d'entrée/de sortie et les propriétés utilisées dans votre workflow.
• Champs Demande (Request) et Réponse (Response) : ajoutez des champs de demande et de réponse. Cela vous aide à définir les informations requises par l'activité (demande) et les informations qui seront renvoyées par l'activité (réponse).

Champs d'entrée

Pour configurer les ressources d'un connecteur personnalisé, vous utilisez l'onglet Paramètres (Parameters) pour ajouter des champs spécifiques à votre type de demande. Le concepteur d'activités récupère tous les paramètres et champs des onglets Paramètres ( Parameters) ou Champs de demande ( Request fields ) et les affiche sous la section Entrée (Input).

L'image suivante montre l'onglet Paramètres (Parameters) de la ressource. Un seul champ est marqué comme obligatoire :

Figure 1. Paramètres avec un champ obligatoire

Figure 2. Champs de demande avec un champ obligatoire

L'image suivante montre l'onglet Champs de demande ( Request fields ) de la ressource. Un seul champ est marqué comme obligatoire :

L'image suivante montre l'onglet Concepteur d'activités ( Activity concepteur ) de la ressource. Le paramètre requis et les champs de requête sont affichés dans la fenêtre Aperçu (Preview) :

Modification des paramètres

Modifiez ou supprimez des paramètres de l'onglet Concepteur d'activités (Activity Designer ) en cliquant sur Plus d'options (More options) menu.

Configurez l'emplacement des paramètres et des champs de demande en choisissant une option de Position : Principal, Seconde ou Aucune. Lorsque vous définissez un champ comme Requis(Required), sa Position (Position) est automatiquement définie sur Principal (Main) et le champ s'affiche dans la section principale de la zone de dessin de l'activité.

Modifiez la façon dont le paramètre est affiché dans la fenêtre Aperçu (Preview) (son nom d'affichage et sa description) en cliquant sur le bouton Modifier (Edit) à côté du nom du paramètre.

Valeurs des paramètres d'entrée

Dans l'onglet du concepteur d'activités , vous pouvez spécifier un paramètre ou la position du champ sur la zone de dessin de l'activité comme Principal, Seconde ou Aucun. Chaque option détermine le comportement du paramètre et l'emplacement de son affichage sur la zone de dessin de l'activité. Vous pouvez également marquer un champ comme Obligatoire (Required) pour définir automatiquement sa position comme Principal (Main).

• Requis: le paramètre ou le champ nécessite une valeur pour exécuter correctement l'activité. Le paramètre est marqué comme requis à l'aide du symbole astérisque (*). Cela signifie qu'il est toujours visible sur la zone de dessin et que vous devez lui fournir une valeur.

  
  

  

  
  
• Principal: le paramètre est affiché dans la section principale de l'activité. Il peut être laissé vide lorsque l'activité est utilisée dans une automatisation.
  
  

  

  
  
• Secondaire(Secondary) : le paramètre est masqué dans la zone de dessin principale. Elle est affichée sous la section Afficher les options supplémentaires . Ces champs sont facultatifs et peuvent être laissés vides.
  
  

  

  
  
• Aucun: le paramètre est masqué dans l'activité. Vous devez utiliser l'assistant Gérer les propriétés ( Manage Properties ) pour l'ajouter à la zone de dessin.

Paramètres d'entrée de commande

L'ordre des paramètres d'entrée dicte leur emplacement dans la fenêtre Aperçu (Preview) de l'activité. Vous pouvez modifier l'ordre d'affichage en utilisant l'icône située tout à gauche de chaque paramètre pour faire glisser l'élément de la liste vers le haut ou vers le bas.

Champs de demande

Les champs de demande vous permettent de remplir le corps d'une requête HTTP.

Les champs de demande sont le plus souvent associés aux requêtes POST, PUT ou PATCH (activités d'insertion, d'upsert ou de mise à jour d'enregistrement).

Remplir les champs Demande (Request) et Réponse (Response)

Il existe deux manières de remplir les champs de demande et de réponse.

Option 1 (recommandée) : utiliser un JSON correctement formaté.

1. Cliquez sur le bouton Envoyer la demande ( Send Request ) d'une ressource.
2. Ajoutez le JSON.
3. Assurez-vous que l'option Remplacer les champs lors de l'envoi d'une demande ( Overwrite fields on send request ) est activée.
4. Sélectionnez Exécuter.

Si la réponse est réussie, les champs Entrée (Input) sont remplis avec les propriétés JSON utilisées pour la requête et les champs Sortie (Output) sont remplis en fonction de la réponse.

Remarque : Si vous utilisez cette méthode, effectuez une requête exhaustive de tous les champs que vous souhaitez utiliser dans votre activité.

L'image suivante montre un exemple de charge utile pour une requête POST . Notez que le champ Remplacer les champs lors la demande d'envoi d'e -mails est activé :

Option 2 : ajout manuel de chaque champ de demande et de réponse à partir de l'onglet du concepteur d'activités .

1. Accédez à l'onglet Concepteur d'activités (Activity Designer ).
2. Dans l'onglet Entrée (Input), cliquez sur Plus d'options (More options) menu.
3. Sélectionnez Ajouter un champ de demande (Add request field).
4. Ajoutez les détails du champ de requête, comme pour l'ajout d'un paramètre.
   
   

   

   
   
5. Pour ajouter des champs de réponse, accédez à l'onglet Sortie (Output) et sélectionnez l'option Ajouter un champ de réponse ( Add response field) .
   
   

   

   
   

Champs de sortie

Les champs de sortie (Output) du concepteur d'activités sont extraits des champs de réponse (Response). Les valeurs peuvent être renseignées en effectuant un appel à la ressource.

Champs sélectionnés

Vous pouvez marquer les champs de sortie comme Sélectionnés ( Curated). La valeur du champ est spécifiquement extraite de l'objet de la réponse et peut être affectée à une variable, ce qui facilite son accès et son utilisation dans d'autres activités en cas d'utilisation dans une automatisation.

L'image suivante montre comment le Statut ( Status), le champ sélectionné, est directement affiché dans la section Sortie (Output) de l'activité :