tâches de cas uip maestro

Syntaxe et options pour `uip maestro case tasks`, qui lit et enrichit les tâches au sein d'une étape dans un fichier JSON de définition de gestion des cas, plus la référence du champ JSON pour la création manuelle.

Une tâche est une unité de travail au sein d'une étape d'une définition de gestion des cas — une exécution de processus, une invocation d'agent, un workflow d'API, une tâche RPA, un élément d'action humaine, une attente de minuterie, une activité de connecteur ou une attente d’un Événement du connecteur entrant. Les entrées de tâche se trouvent dans les couloirs d'une étape dans le fichier JSON de définition de cas (la même structure de fichier stages et task-entry-conditions fonctionne); uip maestro case tasks les lit et les enrichit.

Pour les règles d'entrée qui s'appliquent lorsqu'une tâche devient exécutable, voir uip maestro case task-entry-conditions. Pour le modèle global du concept de gestion des cas, voir uip maestro case.

Concepts

• Couloir - les tâches d'une étape sont regroupées en couloirs parallèles (index 0, 1, 2, …); les tâches dans le même couloir s'exécutent de manière séquentielle, les tâches dans des couloirs différents s'exécutent en parallèle. La valeur lane est définie par défaut sur 0 lors de la création manuelle d'une tâche.
• Type de tâche — l'un des process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, wait-for-connector, execute-connector-activity, case-management. Les types basés sur des connecteurs (execute-connector-activity, wait-for-connector) utilisent une forme de champ différente de celle des autres (voir ci-dessous).
• Enrichissement : plusieurs types de tâches nécessitent un schéma d’entrée/sortie et des métadonnées de liaison extraits de la plate-forme (le contrat d’entrée/sortie réel d’un processus, le schéma de champ d’une activité de connecteur) avant que Studio Web puisse les restituer de manière significative. tasks enrich et tasks describe sont des commandes de recherche pour ces métadonnées, utiles pour découvrir ce qu'il faut écrire dans le fichier JSON d'une tâche avant de la créer manuellement.

Synthèse

uip maestro case tasks get <file> <stage-id> <task-id>
uip maestro case tasks enrich --type <type> --id <id> [--element-id <id>]
uip maestro case tasks describe --type <type> --id <id> [--connection-id <id>]

Champs JSON de la tâche

Les tâches sont ajoutées, modifiées et supprimées manuellement dans les tableaux de couloirs de caseplan.json, puis validées avec uip maestro case validate. Référence du champ:

Une tâche sans connecteur — types de tâches: process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, case-management (les types basés sur un connecteur ci-dessous sont distincts). Champs: displayName, name (nom du processus/workflow), folderPath, lane (index à couloirs parallèles, 0 par défaut), shouldRunOnlyOnce, description, isRequired; Type actionuniquement: taskTitle, priority (Low|Medium|High|Critical, par défaut Medium), recipient (e-mail; définit également assignmentCriteria sur user). Une tâche enrichie (liaisons/entrées/sorties recherchées à partir de la plate-forme) entraîne en outre un elementId et enriched: true stables — utilisez tasks enrich pour récupérer cette charge utile avant de l’écrire manuellement.

Une tâche intégrée au connecteur , de type execute-connector-activity (activité) ou wait-for-connector (déclencheur), identifiée par une activité TypeCache uiPathActivityTypeId et un ID de connexion. Affiche une serviceType de Intsvc.ActivityExecution (activité) ou Intsvc.WaitForEvent (déclencheur). Valeurs d'entrée: pour une activité, saisies par nom d'entrée (body, pathParameters, queryParameters); pour un déclencheur, les valeurs sous body deviennent les paramètres du filtre d'événements (un filters.expression est généré à partir d'eux, par exemple (project == 'PROJ' && issuetype == 'Bug')) et remplissent également queryParams/parameters. Utilisez tasks describe pour découvrir les noms d'entrée réels et la charge utile complète de l'enrichissement avant d'écrire une tâche manuellement.

Mise à jour d'une tâche - fusionnez les mêmes champs displayName/name/folderPath/shouldRunOnlyOnce/description/isRequired avec l'objet de tâche existant (les champs non répertoriés conservent leur valeur actuelle). name/folderPath n'ont aucun effet sur une tâche wait-for-timer, qui n'a pas de bloc data.

Suppression d’une tâche : supprimez directement son entrée du tableau de couloirs de l’étape; supprimer entièrement le couloir si elle devient vide.

Après une modification manuelle, exécutez uip maestro case validate.

tâches de cas uip maestro obtenir

imprimez une seule tâche à partir d'une étape.

Arguments

Nom	Requis	Objectif
<file>	oui	Chemin d’accès au fichier JSON de gestion des cas.
<stage-id>	oui	ID de l’étape contenant la tâche.
<task-id>	oui	ID de la tâche à récupérer.

Exemple

uip maestro case tasks get case.json Stage_1 ta1b2c3d

Format des données (--sortie json)

{
  "Code": "TaskFound",
  "Data": {
    "StageId": "Stage_1",
    "Lane": 0,
    "Index": 0,
    "Task": { "id": "ta1b2c3d", "type": "process", "displayName": "Process invoice" }
  }
}

tâches d’enrichissement de cas uip maestro

Recherchez le schéma d'entrée/sortie réel d'un type de tâche sur la plate-forme sans écrire dans aucun fichier. Visible dans --help.

Remarque :

Utilisez-le pour prévisualiser ce que tasks add --task-type-id produira avant de le valider dans un fichier. Pour les activités/déclencheurs du connecteur spécifiquement, utilisez tasks describe à la place - enrich couvre les autres types enrichis (process, agent, rpa, action, api-workflow, case-management, flow-process) .

Options

Long	Valeur (Value)	Requis	Description
--type <type>	l'un des types enrichis	oui	Type de tâche.
--id <id>	string	oui	ID unique de la tâche (identityKey ou ID d'application d'action, selon le type).
--element-id <id>	string	non	ID d'élément auquel étendre la liaison de variable.

Exemple

uip maestro case tasks enrich --type process --id a1b2c3d4-0000-0000-0000-000000000001

Format des données (--sortie json)

{
  "Code": "TaskEnriched",
  "Data": {
    "name": "InvoiceProcess",
    "folderPath": "Shared",
    "inputs": [],
    "outputs": []
  }
}

La forme exacte de Data dépend de --type — une charge utile d'enrichissement brute de la plate-forme, non normalisée à un schéma fixe.

Description des tâches de cas uip maestro

Décrivez les métadonnées d'entrée/sortie d'un type de tâche pour la découverte de liaison - la couverture de type la plus large de toute commande de recherche ici (ajoute connector-activity, connector-trigger, external-workflow et external-agent au-dessus de tout ce que enrich prend en charge). Visible dans --help.

Options

Long	Valeur (Value)	Requis	Description
--type <type>	un des types descriptifs	oui	Type de tâche — voir la liste ci-dessus.
--id <id>	string	oui	ID unique de la tâche (identityKey ou ID d'application d'action).
--connection-id <id>	UUID	Conditionnel	Requis pour connector-activity, connector-trigger, external-workflow et external-agent — la commande échoue rapidement avec une Error explicite si elle est omise pour ces types. Non utilisé pour les autres types.

external-workflow et external-agent décrivent de manière identique à connector-activity (même pipeline d'enrichissement Integration Service, même exigence --connection-id), mais résolvent leur ID de type par rapport à un index TypeCache différent, car Studio Web les gère à partir d'un catalogue distinct.

Exemple

uip maestro case tasks describe --type connector-activity \
  --id a1b2c3d4-0000-0000-0000-000000000001 \
  --connection-id b2c3d4e5-0000-0000-0000-000000000001

Format des données (--sortie json)

{
  "Code": "TaskDescribed",
  "Data": {
    "inputs": [{ "name": "body", "body": {} }],
    "outputs": [{ "name": "response" }]
  }
}

Un champ enrichment est inclus uniquement lorsque la recherche sous-jacente en renvoie un.

Associé

• cas uip maestro — concepts et répertoire complet du sous-système.
• uip maestro case task-entry-conditions — règles qui s'appliquent lorsqu'une tâche devient exécutable.
• cas et étapes du cas uip maestro — l'étape à laquelle se trouve une tâche.

Voir également

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