instances de flux uip

uip flow instance inspecte et gouverne les instances de processus individuelles — une exécution d'un processus de flux publié. Le nom de la commande est au unique (instance), même si l'entrée de la barre latérale indique instances.

Toutes les sous-commandes nécessitent uip login et respectent les options globales. Les codes de sortie suivent le contrat standard.

Synthèse

uip flow instance list                <instance-id>             -f <folder-key> [-l <limit>] [--offset <n>] [--process-key <k>] [--package-id <id>] [--error-code <code>]
uip flow instance get                 <instance-id>             -f <folder-key>
uip flow instance pause               <instance-id>             -f <folder-key> [--comment <text>]
uip flow instance resume              <instance-id>             -f <folder-key> [--comment <text>]
uip flow instance cancel              <instance-id>             -f <folder-key> [--comment <text>]
uip flow instance retry               <instance-id>             -f <folder-key> [--comment <text>]
uip flow instance migrate             <instance-id> <new-version> -f <folder-key> [--comment <text>]
uip flow instance variables           <instance-id>             -f <folder-key> [--parent-element-id <id>]
uip flow instance incidents           <instance-id>             -f <folder-key>
uip flow instance asset               <instance-id>             -f <folder-key>
uip flow instance cursors             <instance-id>             -f <folder-key>
uip flow instance goto                <instance-id> <transitions> -f <folder-key>
uip flow instance element-executions  <instance-id>             -f <folder-key>

-f, --folder-key <key> est requis sur chaque sous-commande.

Options communes

• -f, --folder-key <key> (obligatoire) — clé de dossier.
• --comment <text> (commandes d'opération uniquement) — commentaire facultatif enregistré avec l'opération. Envoyé comme une chaîne vide si omis.

Sous-commandes

liste des instances de flux UiP

Répertoriez les instances dans un dossier, limitées aux processus de flux (processType=Flow).

Options

Option	Default	Description
-l, --limit <n>	DEFAULT_PAGE_SIZE	Nombre d'éléments à renvoyer (1-10 000).
--offset <n>	0	Nombre d’éléments à ignorer (0-1000 000).
--process-key <k>	—	Filtrer par clé de processus.
--package-id <id>	—	Filtrez par ID de package.
--error-code <code>	—	Filtrez par code dʹerreur.

Format des données

Code: "InstanceList", Data is an array of process-instance objects.

Obtenir une instance de flux uip

Récupérez une seule instance par ID.

Format des données: Code: "InstanceGet", Data est l'objet d'instance de processus.

pause d’instance de flux uip

Suspendez une instance en cours d'exécution. Format des données: Code: "InstancePaused".

reprise de l’instance de flux uip

Reprenez une instance suspendue. Format des données: Code: "InstanceResumed".

annulation d’instance de flux uip

Annulez une instance en cours d'exécution. Format des données: Code: "InstanceCanceled".

Nouvelle tentative d’instance de flux UiP

Réessayez une instance défaillante. Format des données: Code: "InstanceRetried".

Migration d’instance de flux uip

Migrez une instance vers une version de package différente.

Arguments: <instance-id>, <new-version> (version du package cible).

Format des données: Code: "InstanceMigrated".

variables d’instance de flux uip

Obtenir les variables d'une instance.

Options: --parent-element-id <id> — filtrer les variables par élément parent.

Format des données: Code: "InstanceVariables", Data porte la charge utile des variables de l’instance.

incidents d’instance de flux uip

Obtenir des incidents pour une instance spécifique.

Format des données: Code: "InstanceIncidents", Data est un tableau d’objets d’incident.

Ressource d’instance de flux UIP

Récupérez la définition de Flow (la ressource .flow ) associée à la version de cette instance — utile lors du débogage pour voir le graphique exact par lequel l'instance a été exécutée.

Format des données: Code: "InstanceAsset", Data est le fichier JSON du flux.

curseurs d’instance de flux uip

Obtenir les positions actuelles du curseur d'exécution — à quel(s) élément(s) l'instance est suspendue.

Format des données: Code: "InstanceCursors", Data répertorie les positions actuelles du curseur.

Goto d’instance de flux UIP

Déplacez un curseur d'exécution d'un élément à un autre. Utile pour récupérer une instance défaillante en ignorant ou en réessayant des nœuds spécifiques.

Arguments

• <instance-id> (requis)
• <transitions> (obligatoire) — Tableau JSON de transitions, chacune avec sourceElementId et targetElementId.

uip flow instance goto c3d4e5f6-… \
  '[{"sourceElementId":"Node_1","targetElementId":"Node_3"}]' \
  --folder-key c3d4e5f6-…

La CLI valide les analyses JSON et chaque entrée a les deux ID avant d'appeler l'API.

Format des données

Code: "InstanceGoto".

Instance d’exécution de flux UIP

Obtenez l'historique d'exécution par élément pour une instance (ce qui a été exécuté, quand et avec quel résultat).

Format des données

Code: "InstanceElementExecutions", Data is the per-element execution history.

Exemples

# Paginate through instances for a specific process
uip flow instance list --folder-key <k> --process-key "InvoiceFlow.flow.Flow:1.0.0" --limit 50

# Pause, fix, resume
uip flow instance pause   <id> --folder-key <k> --comment "Investigating"
uip flow instance resume  <id> --folder-key <k>

# Skip a faulted node by moving the cursor forward, then retry
uip flow instance cursors <id> --folder-key <k>
uip flow instance goto    <id> '[{"sourceElementId":"A","targetElementId":"C"}]' --folder-key <k>
uip flow instance retry   <id> --folder-key <k>

# Upgrade a long-running instance to a new package version
uip flow instance migrate <id> "1.2.0" --folder-key <k> --comment "Patch release"

Voir également

• uip flow incidents — incidents de lecture détachés d'une instance spécifique
• uip flow job — la vue de la tâche d'une exécution d'instance
• uip flow process — de nouvelles instances de démarrage
• Tâches Orchestrator
• Vue d’ensemble du flux