Concepteur d’activités

Utilisez le concepteur d'activités pour prévisualiser et configurer la mise en page des activités Integration Service 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. Le concepteur d'activités récupère tous les paramètres et champs des onglets Paramètres ou Demande 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 :

Figure 1. Paramètres avec un champ obligatoire

Image 2. Champs de demande avec un champ obligatoire

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

L'image suivante montre l'onglet Concepteur d'activités de la ressource. Les champs de paramètre et de requête requis s'affichent dans la fenêtre Aperçu :

Modification des paramètres

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

Configurez le placement des paramètres et des champs de demande en choisissant une option de position : Principal, Secondaire ou Aucun. Lorsque vous définissez un champ sur Obligatoire, sa Position est automatiquement définie sur Principal et le champ s'affiche dans la section principale de la zone de dessin d'activité.

Modifiez la façon dont le paramètre est affiché dans la fenêtre Aperçu (son nom d’affichage et sa Description) en sélectionnant 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 spécifier la position d'un paramètre ou d'un champ sur le canevas d'activité en tant que Principal, Secondaire ou Aucun. Chaque option dicte le comportement du paramètre et son emplacement d'affichage sur le canevas de l'activité. Vous pouvez également marquer un champ comme Obligatoire pour définir automatiquement sa position comme Principal.

• Obligatoire: le paramètre ou le champ nécessite une valeur pour exécuter correctement l'activité. Le paramètre est marqué comme obligatoire à l'aide du symbole astérisque (*). Cela signifie qu’il est toujours visible sur le canevas et que vous devez fournir une valeur pour celle-ci.

  

• 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.

  

• Secondaire: le paramètre est masqué dans le canevas principal. Il s'affiche dans la section Afficher les options supplémentaires . Ces champs sont facultatifs et peuvent être laissés vides.

  

• None: le paramètre est masqué dans l'activité. Vous devez utiliser l'assistant Gérer les propriétés pour l'ajouter au canevas.

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. Sélectionnez le bouton Envoyer la demande d'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, 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 de l'envoi de la requête est activé :

Option 2 : ajout manuel de 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 effectuant un appel à la ressource avec succès.

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 Statut, le champ sélectionné, est directement affiché dans la section Sortie de l'activité :