Lancer l'exécution

UiPath.Activities.System.Jobs.RunJob

Description

Utilisez l'activité Exécuter la tâche (Run Job) pour démarrer facilement d'autres automatisations telles que les workflows RPA ou les processus d'agent. Cette activité unique consolide les activités existantes qui démarrent les automatisations à partir de votre workflow. Vous pouvez sélectionner le type de projet que vous souhaitez démarrer, et l’activité adapte son comportement en fonction de votre sélection.

Important :

• L’automatisation sélectionnée doit exister dans votre dossier Orchestrator avant de configurer cette activité.

• Après avoir mis à jour une automatisation, assurez-vous de la republier et de redéployer le processus correspondant dans le dossier Orchestrator.

Compatibilité du projet

Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Propriétés du corps de l’activité :
  • Chemin du dossier Orchestrator : sélectionnez le dossier Orchestrator dans lequel l'automatisation que vous souhaitez démarrer au sein de votre workflow est déployée. Seuls les dossiers auxquels vous pouvez accéder s'affichent dans le menu déroulant. Si vous ne sélectionnez aucune option, votre espace de travail personnel sera utilisé.
  • Nom du processus : sélectionnez le processus associé à l’automatisation que vous souhaitez exécuter. Tous les types de processus sont affichés : RPA, Agents, Orchestration agentique. Si le processus dont vous avez besoin n'est pas répertorié, sélectionnez Gérer les processus pour être redirigé vers votre dossier Orchestrator, où vous pourrez ajouter le processus manquant.

  • Arguments d’entrée : si le processus sélectionné nécessite des arguments d’entrée, vous pouvez les configurer à l’aide de ce champ.

    Pour récupérer la dernière liste des arguments de processus lorsque vous utilisez l'option Mappeur de données (Data Mapper) , sélectionnez Actualiser les arguments (Refresh arguments) sur le côté droit du champ.

    Important :

    Pour une expérience optimale, assurez-vous que vous utilisez la dernière version de Studio (2025.0.161). Les versions de Studio antérieures à 2025.0.161 utilisent la fenêtre de l’éditeur d’expressions .

    L'extrait de code suivant vous montre comment fournir des valeurs aux arguments d'entrée de l'agent à l'aide de VB.NET et C# :

    'VB.NET
    New Email_Rewriter_Input() With {
        .feedback = "sample feedback", 
        .originalEmail = "sample email content"
    }

    //C#
    new Email_Rewriter_Input {
        feedback = "sample feedback",
        originalEmail = "sample email content"
    }

• Panneau Propriétés :
  • Mode d'exécution :sélectionnez comment l'activité attend que la tâche se termine. Les options suivantes sont disponibles :
    • Ne pas attendre :l'activité va démarrer la tâche et permettre au workflow de poursuivre sans attendre la fin de la tâche.
    • Attendre l’achèvement de la tâche :option par défaut. L'activité suspend le workflow jusqu'à ce que la tâche démarrée soit terminée ou que le délai d'expiration soit atteint. Si l’achèvement de la tâche est réussi, l’activité renvoie les sorties et le workflow reprend.
      Remarque : ce mode d'exécution utilise la fonctionnalité Orchestrator SignalR pour reconnaître l'achèvement de la tâche en temps réel. Il peut être activé dans les Paramètres d'Orchestrator au niveau du locataire. Si SignalR est désactivé, ce mode d’exécution utilisera par défaut une interrogation de 30 secondes.
    • Suspendre l'exécution jusqu'à l'achèvement de la tâche :l'activité suspend le workflow et attend la sortie avec persistance.
  • Timeout : définit le délai maximal d’attente pour la finalisation de la tâche. La valeur par défaut est 600 000 millisecondes (10 minutes).
  • Continuer en cas d’erreur : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai, Faux). La valeur par défaut est Faux. Par conséquent, si le champ n’est pas configuré et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire Vrai, l’exécution du projet se poursuit même en cas d’erreur.

  • Échec d’échec de tâche :cette propriété devient disponible uniquement lorsque le mode d’exécution est Attendre l’achèvement de la tâche ou Suspendre l’exécution jusqu’à l’achèvement de la tâche.

    Spécifie si l’activité doit générer une exception lorsque la tâche Orchestrator exécutée se termine par un statut Défaillant (Faulted) . La valeur par défaut est Désactivé (Off). Définissez sur On pour générer une exception afin que l’exécution du workflow s’arrête lorsque la tâche Orchestrator échoue.

  • Données de la tâche : affiche l’objet de la tâche démarrée. Généré automatiquement.

  • Output arguments :affiche la liste des arguments de sortie du processus, tels qu'ils ont été définis lors de la création du processus.

    Si vous sélectionnez le processus dans une liste de processus, l'objet de sortie contiendra toutes les propriétés de sortie du processus sélectionné.

    Si vous avez fourni le processus à l'aide d'une expression, ou si votre mode d'exécution renvoie des valeurs, vous devez configurer les arguments d'entrée et de sortie à l'aide de l'option Utiliser des noms statiques (Use statique noms) .

Limites connues

Lorsqu'un processus agentique lève une exception, Maestro conserve la tâche Orchestrator dans l'état En cours d'exécution , en s'appuyant sur le fait que l'exception soit gérée dans Maestro.

En conséquence :

• L'activité Run Job ne détecte pas l'échec.
• Lorsqu'il est configuré sur Attendre l'achèvement de la tâche, il soit :
  • Expire, ou
  • Reste indéfiniment en mode persistance, car la tâche n’atteint jamais Réussi.

Pour éviter ce comportement, utilisez les recommandations suivantes basées sur le mode d’exécution de l’activité Run Job :

• Pour Attendre l'achèvement de la tâche, appliquez un Délai d'attente qui correspond à la durée prévue du processus agentique. Sans cela, le workflow reste bloqué en attendant un changement d’état de la tâche qui ne se produit jamais.
• Utilisez Suspendre l'exécution jusqu'à l'achèvement de la tâche, car ce mode fonctionne mieux lorsque votre workflow doit recevoir des sorties. Le processus reprend automatiquement lorsque le processus d’agent est terminé.