Concepteur d’activités

Utilisez le concepteur d'activités dans Integration Service pour Automation Suite pour prévisualiser et configurer la mise en page des activités de connecteur personnalisées telles qu'elles apparaissent dans UiPath Studio.

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 allez utiliser l'onglet Paramètres afin d'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 .

L'image suivante montre l'onglet Paramètres de la ressource. Seul un champ est marqué comme obligatoire :

L'image suivante montre l'onglet Concepteur d'activités de la ressource. Les mêmes paramètres sont répertoriés sur la gauche, mais seul le champ marqué comme Obligatoire s'affiche dans la fenêtre Aperçu :

Modification des paramètres

Modifier ou supprimer des paramètres de l'onglet Concepteur d'activités en cliquant sur Plus d'options menu.

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

Valeurs des paramètres d'entrée

Dans l'onglet Concepteur d'activités , vous pouvez marquer chaque champ d'entrée comme Requis, Principal, ou Supplémentaire. Chaque option dicte le comportement du paramètre et son emplacement d'affichage sur le canevas de l'activité.

• Obligatoire: le paramètre est marqué comme obligatoire à l’aide du symbole astérisque (*). Cela signifie qu’il est toujours visible sur le canevas et qu’une valeur doit lui être fournie.

  

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

  

• Supplémentaire: le paramètre est masqué dans la zone de dessin principale. Il s'affiche dans la section Afficher les options supplémentaires . 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 détermine l'emplacement des paramètres dans la fenêtre Aperçu de l'activité. Vous pouvez modifier l’ordre en utilisant le fait glisser située à côté de chaque paramètre.

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

Dans la fenêtre Aperçu de l'activité, les champs sont affichés dans l'ordre indiqué dans l'onglet Entrée en fonction du groupe auquel ils sont affectés.

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. Sélectionnez Envoyer une requête pour une ressource.
2. Ajoutez le JSON.
3. Assurez-vous que l'option Remplacer les champs lors de la demande d'envoi est activée.
4. Sélectionnez Exécuter.

Si la réponse réussit, les champs Entrée sont renseignés avec les propriétés JSON utilisées pour la requête et les champs Sortie sont renseignés 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 de l'envoi de la requête est activé :

Option 2

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

1. Accédez à l'onglet Designer d'activité .

2. Dans l’onglet Entrée , sélectionnez Plus d’options menu.

3. Sélectionnez Ajouter un champ de demande.

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 et sélectionnez l'option Ajouter un champ de réponse .

   

Champs de sortie

Les champs Sortie dans le concepteur d'activités sont extraits des champs Réponse. Les valeurs peuvent être renseignées en faisant correctement une requête auprès de la ressource.

Champs sélectionnés

Vous pouvez marquer des champs de sortie comme Sélectionnés. La valeur du champ est spécifiquement extraite de l'objet de réponse et peut être affectée à une variable, ce qui facilite l'accès et l'utilisation dans d'autres activités lorsqu'elle est utilisée dans une automatisation.

L'image suivante montre comment Url, le champ sélectionné, est directement affiché dans la section Sortie de l'activité: