Concepteur d’activités

Vue d'ensemble (Overview)

Le concepteur d'activités est une nouvelle fonctionnalité du générateur de connecteurs. 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 requête. Désormais, le concepteur d’activités récupère tous les champs de paramètres 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 :

L'image suivante montre l'onglet Concepteur d'activités ( Activity Designer ) de la ressource. Les mêmes paramètres sont répertoriés sur la gauche, mais seul le champ marqué comme Obligatoire ( Required ) s'affiche 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.

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 marquer chaque champ d'entrée comme Obligatoire ( Required), Principal(Main) ou Supplémentaire ( Additional). Chaque option détermine le comportement du paramètre et son emplacement d'affichage sur la zone de dessin de l'activité.

• Obligatoire(Required) : 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 qu'une valeur doit être fournie pour celui-ci.

  
  

  

  
  
• Principal ( Main) : le paramètre est affiché dans la section principale de l'activité. Il peut être laissé vide lors de l'utilisation de l'activité dans une automatisation.
  
  

  

  
  
• Supplémentaire ( Additional) : le paramètre est masqué dans la zone de dessin principale. Il se trouve sous la section Afficher les options supplémentaires ( Show additional options) . Ces champs sont facultatifs et peuvent être laissés vides.
  
  

  

  
  

Paramètres d'entrée de commande

L'ordre des paramètres d'entrée dicte l'emplacement des paramètres dans la fenêtre Aperçu (Preview) de l'activité. Vous pouvez modifier l'ordre en utilisant le glisser-déposer icône située à côté de chaque paramètre.

Par exemple, pour déplacer le champ Quand (When) vers le haut de la section Entrée (Input), faites glisser le icône vers le haut.

Dans la fenêtre Aperçu (Preview) de l'activité, les champs sont affichés dans l'ordre indiqué dans l'onglet Entrée (Input) en fonction du groupe auquel ils sont affectés (Requis(Required), Principal(Main) et Supplémentaire ( Additional)).

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 demandes POST, PUT ou PATCH (activités d'insertion, d'upsert ou de mise à jour d'enregistrement). Si vous ajoutez un champ de demande à une demande GET ou DELETE (répertorier, obtenir ou supprimer des activités), un message d'erreur s'affiche et vous informe que le champ n'apparaîtra pas pour cette opération.

L'image suivante montre le message d'erreur qui s'affiche lorsque vous essayez d'ajouter un champ de requête à une ressource DELETE :

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)

Utilisez 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. Cliquez sur Exécuter (Execute).

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, veillez à effectuer 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

Vous pouvez ajouter manuellement chaque champ de demande et de réponse à partir de l'onglet Concepteur d'activités (Activity Designer ).

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 du concepteur d'activité sont extraits des champs de réponse. Les valeurs peuvent être renseignées en effectuant avec succès une requête à 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 champ URL ( Url) sélectionné est directement affiché dans la section Sortie (Output) de l'activité :