fichier d’exécution rpa uip

Syntaxe et options pour `uip rpa run-file`, qui exécute ou débogue un workflow ou un fichier codé, avec prise en charge des options de démarrage, de pause, de séquence et de point d'arrêt.

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.

Remarque :

run-file is now a hidden legacy alias — it still works, but current source (tool-names.ts, CLI_DERIVED_COMMANDS) splits this same underlying operation into a discoverable family of top-level verbs: uip rpa run (start execution), uip rpa debug start / start-from-here / test-activity / break / continue / resume / continue-retry / continue-ignore / step-into / step-over / step-out / state / set-breakpoints / apply-file-changes / toggle-breakpoint / restart-from-top, and uip rpa execution cancel (replaces stop-execution). Each derived verb takes only the flags relevant to it, rather than one --command enum with the full 19-value list. This page's own examples still work today via the hidden alias — see uip rpa run, debug & execution for the current primary surface.

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.
GetDebugState	Report the current debug session state with no side effects (None when no session is active). Always an instant probe on the Studio backend; on the Helm backend it can long-poll for the next stable state.
SetBreakpoints	Replace the active debug session's whole breakpoint set with --breakpoints. Helm backend only — on the Studio backend, set breakpoints via ToggleBreakpoint or by passing them to StartDebugging instead.
ApplyFileChanges	While paused/suspended in a debug session, reconcile on-disk activity-property edits into the running session via hot-reload, so it picks them up without a restart. Edit the file first, then call this naming what changed. Returns { applied, rejected, debugState } instead of a run result — structural (non-hot-reloadable) edits are rejected and need a session restart.

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