fichier d’exécution rpa uip

uip rpa run-file exécute ou débogue un workflow ou un fichier codé. Le même verbe couvre le cycle de vie complet de l'exécution — démarrer, suspendre, reprendre, étape, redémarrer, arrêter, activer/désactiver un point d'arrêt — sélectionné par l'indicateur --command . Il s'agit de la passerelle entre un script ou un agent d'IA et le débogueur de Studio.

L'exécution se produit via Studio, de sorte que la commande ne fonctionne que sur les exécuteurs Windows (Studio est uniquement compatible Windows). Si Studio n'est pas déjà en cours d'exécution, l'outil l'affiche automatiquement. Exécuter uip rpa start-studio est d'abord facultatif, mais utile lorsque vous souhaitez que le coût de démarrage soit payé dans une étape de configuration dédiée.

Synthèse

uip rpa run-file --file-path <path> [--command <verb>] [options]

Options

Drapeau	Description
--file-path <string>	Requis. Chemin d'accès au fichier à exécuter — workflow .xaml ou workflow codé .cs .
--command <verb>	Que faire. La valeur par défaut est StartExecution. Voir les verbes de commande ci-dessous.
--input-arguments <json>	Objet JSON avec des arguments d'entrée au niveau du projet. Utilisé par toutes les commandes. Pour StartExecution / StartDebugging, les valeurs sont en JSON brut ({"name":"John","age":30}). Pour TestActivity / StartDebuggingFromHere, les valeurs sont des expressions VB.NET ou C#.
--input-variables <json>	Objet JSON avec des valeurs de variables au niveau du workflow. S'applique uniquement à TestActivity et StartDebuggingFromHere. Les valeurs sont des expressions de langage, et non des littéraux JSON.
--log-level <level>	Niveau de journalisation minimum inclus dans le flux de sortie — Verbose, Trace, Information, Warning, Error, Critical La valeur par défaut est Trace.
--skip-build	Ignorer la validation et la création pour StartExecution / StartDebugging. Supposons que le projet a déjà été créé — à utiliser pour une réexécution rapide lorsque le projet n'a pas changé.

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

uip rpa run-file --help

Verbes de commande

L'indicateur --command couvre deux modes d'exécution: l'exécution non-debug et le contrôle de débogage. Les verbes sont sensibles à la casse et sont transmis à Studio.

Exécution

Verbe	Effet
StartExecution (par défaut)	Exécutez le workflow sur --file-path. Aucun débogueur joint.
StartDebugging	Démarrez une session de débogage du workflow.
Stop	Arrêtez la session d’exécution ou de débogage en cours.
ForceSessionEnded	Forcez la fin de la session en cours si l'arrêt normal est bloqué.

Contrôle du débogueur

Verbe	Effet
Break	Mettre en pause l'exécution.
Continue	Reprenez à partir d'un état suspendu.
Resume	Reprenez à partir d'un état suspendu.
ContinueRetry	Reprendre; si elle est suspendue sur une exception, réessayez l'activité actuelle.
ContinueIgnore	Reprendre; s'il est suspendu sur une exception, avaler l'exception.
StepInto / StepOver / StepOut	Étape dans le sens standard du débogueur.
RestartFromTop	Redémarrez le débogage depuis le début.
ToggleBreakpoint	Activez un point d'arrêt au niveau de l'activité (.xaml) ou de la ligne (.cs) ciblée. Cycles XAML activés → désactivés → aucun; du cycle de workflows codés activé/désactivé.
TestActivity	Isolez et exécutez l'activité ciblée, avec --input-variables / --input-arguments fournissant des expressions dans l'étendue.
StartDebuggingFromHere	Commencez le débogage à partir de l’activité ciblée, en ignorant tout ce qui le précède.

Exemples

# Run a workflow with input arguments
uip rpa run-file \
  --file-path ./Main.xaml \
  --input-arguments '{"customerId": "ACME-1234"}'

# Start a debug session
uip rpa run-file \
  --file-path ./Main.xaml \
  --command StartDebugging

# Toggle a breakpoint at the focused activity, then start debugging
uip rpa run-file --file-path ./Main.xaml --command ToggleBreakpoint
uip rpa run-file --file-path ./Main.xaml --command StartDebugging

# Test a single activity with a custom variable expression (VB.NET project)
uip rpa run-file \
  --file-path ./Main.xaml \
  --command TestActivity \
  --input-variables '{"greeting": "\"Hello World\""}'

# Stop a runaway session
uip rpa run-file --file-path ./Main.xaml --command Stop

Associé

• uip rpa start-studio — payez le coût de démarrage de Studio dans une étape de configuration dédiée.
• uip rpa stop-execution — équivalent de --command Stop en tant que verbe autonome.
• uip rpa get-errors — inspecter les diagnostics après une exécution.

Voir également

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