uip rpa start-studio

uip rpa start-studio affiche une instance UiPath Studio et attend jusqu'à ce qu'elle soit prête. La plupart des uip rpa verbes qui pilotent Studio génèrent une instance à la demande, donc l'appel explicite start-studio est rarement nécessaire. Utilisez-le lorsque vous souhaitez préparer Studio au début d'un script (afin que le premier verbe en aval ne paye pas le les coûts de démarrage) ou pour vérifier qu'une installation de Studio est accessible.

La commande est sécurisée en raccourcis: si une instance de Studio correspond déjà au répertoire de projet résolu, elle est réutilisée. Sinon, l'outil en démarre une nouvelle.

Remarque :

Studio est uniquement compatible Windows

Studio s'exécute uniquement sous Windows. uip rpa start-studio ne fonctionne donc que sur les runtimes Windows. Les verbes du package (pack, build, analyze, restore) n'ont pas besoin de Studio et s'exécutent sur tout système d'exploitation qui répond aux exigences d'exécution.NET.

Synthèse

uip rpa start-studio [options]

Ce verbe ne prend aucun argument et aucune option par commande. Le comportement de résolution est contrôlé par les options au niveau parent partagées par chaque uip rpa verbe:

Option parent	Description
--project-dir <path>	Répertoire de projet utilisé pour la correspondance avec les instances de Studio en cours d'exécution. La valeur par défaut est le répertoire de travail actuel.
--studio-dir <path>	Chemin d’accès à une installation de Studio, lorsque la découverte ne peut pas en trouver une automatiquement.
--timeout <seconds>	Durée d’attente maximale pour qu’une instance de Studio soit prête. Par défaut: 300.
--verbose	Activez la journalisation détaillée à partir du réviseur IPC.

Pour obtenir la liste complète des options de votre version d'outil installée, exécutez:

uip rpa start-studio --help
uip rpa --help

Comportement

La cascade de résolution:

1. Correspondance par répertoire de projet — si une instance de Studio en cours d'exécution a le --project-dir demandé, cette instance est réutilisée.
2. Instance inactive — si une instance de Studio est en cours d'exécution mais n'a aucun projet ouvert, le projet est ouvert à l'intérieur.
3. Démarrer un nouveau Studio - sinon, un nouveau processus Studio est démarré et interrogé jusqu'à ce qu'il soit prêt.

Si cela réussit, la commande imprime l’ID de processus de l’instance résolue. L'instance reste en cours d'exécution après la sortie de la commande — uip rpa start-studio ne possède pas le cycle de vie du processus Studio; la fermeture de Studio est laissée à l'utilisateur.

Exemples

# Bring up Studio for the current directory
uip rpa start-studio

# Bring up Studio for a specific project
uip rpa start-studio --project-dir ./MyProject

# Verbose, so you can see where the resolver is looking
uip rpa start-studio --verbose

Modèle de réentraînement

D'autres verbes résolvent automatiquement Studio à la demande, mais le premier d'une session paye les coûts de démarrage. Pour transférer ce coût vers une étape de configuration:

uip rpa start-studio --project-dir ./MyProject

# downstream verbs reuse the warmed-up instance
uip rpa get-errors
uip rpa find-activities --query "Click"

Associé

• uip rpa list-instances — répertorie les instances Studio en cours d'exécution visibles au résolveur (masqué dans --help; appelable directement).

Voir également

• Présentation de l’outil RPA
• Options globales
• Codes de sortie