UIP Maestro-Fallaufgaben

Syntax und Optionen für „uip Maestro Case Tasks“, das Aufgaben innerhalb einer Phase in einer JSON-Datei mit Fallverwaltungsdefinition liest und bereichert, sowie die JSON-Feldreferenz für die manuelle Erstellung einer.

Eine Aufgabe ist eine Arbeitseinheit innerhalb einer Phase einer Fallverwaltungsdefinition – eine Prozessausführung, ein Agent-Aufruf, ein API-Workflow, ein RPA-Auftrag, ein menschliches Aktionselement, eine Timer-Wartezeit, eine Connector-Aktivität oder ein Warten auf eine Eingehendes Connector-Ereignis. Aufgabeneinträge live in den Lanes einer Phase in der JSON-Datei mit Falldefinition (dieselbe Dateistruktur, auf stages und task-entry-conditions arbeiten); uip maestro case tasks liest und bereichert sie.

Für Eintrittsregeln, die festgelegt werden, wenn eine Aufgabe ausführbar wird, siehe uip maestro case task-entry-conditions. Das Gesamtmodell des Fallverwaltungskonzepts finden Sie unter uip maestro case.

Konzepte

• Lane – Aufgaben innerhalb einer Phase werden in parallele Lanes gruppiert (Index 0, 1, 2, …); Aufgaben in derselben Lane werden sequenziell ausgeführt, Aufgaben in verschiedenen Lanes werden parallel ausgeführt. lane wird standardmäßig auf 0 festgelegt, wenn eine Aufgabe manuell erstellt wird.
• Aufgabentyp – einer von process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, wait-for-connector, execute-connector-activity, case-management. Von Connectors unterstützte Typen (execute-connector-activity, wait-for-connector) verwenden eine andere Feldform als die anderen (siehe unten).
• Anreicherung – Mehrere Aufgabentypen benötigen ein Eingabe-/Ausgabeschema und Bindungsmetadaten, die von der Plattform abgerufen wurden (der eigentliche Eingabe-/Ausgabevertrag eines Prozesses und das Feldschema einer Connector-Aktivität), bevor Studio Web sie aussagekräftig darstellen kann. tasks enrich und tasks describe sind Suchbefehle für diese Metadaten, die nützlich sind, um zu entdecken, was in das JSON einer Aufgabe geschrieben werden soll, bevor sie manuell erstellt wird.

Zusammenfassung

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>]

JSON-Felder der Aufgabe

Aufgaben werden manuell in den Phasen Lane-Arrays von caseplan.json hinzugefügt, bearbeitet und entfernt und dann mit uip maestro case validate validiert. Feldreferenz:

Eine Nicht-Connector-Aufgabe – Aufgabentypen: process, action, agent, api-workflow, rpa, external-agent, wait-for-timer, case-management (die folgenden von Connector-gestützten Typen sind separat). Felder: displayName, name (Prozess-/Workflowname), folderPath, lane (Parallel-Lane-Index, Standard 0), shouldRunOnlyOnce, description, isRequired; Nur action-Typ: taskTitle, priority (Low|Medium|High|Critical, Standard Medium), recipient (E-Mail; legt auch assignmentCriteria auf { fest user). Eine angereicherte Aufgabe (Bindungen/Eingaben/Ausgaben, die über die Plattform gesucht werden) hat zusätzlich ein stabiles elementId und enriched: true – verwenden Sie tasks enrich , um diese Nutzlast abzurufen, bevor Sie sie von Hand einschreiben.

Eine Connector-gestützte Aufgabe – Aufgabentyp execute-connector-activity (Aktivität) oder wait-for-connector (Trigger), die durch einen TypeCache uiPathActivityTypeId und eine Verbindungs-ID identifiziert wird. Führt ein serviceType von Intsvc.ActivityExecution (Aktivität) oder Intsvc.WaitForEvent (Trigger) aus. Eingabewerte: Für eine Aktivität, verschlüsselt durch den Eingabenamen (body, pathParameters, queryParameters); Für einen Trigger werden Werte unter body zu Ereignisfilterparametern (ein filters.expression wird daraus generiert, z. B. (project == 'PROJ' && issuetype == 'Bug')) und füllen Sie auch queryParams/parameters aus. Verwenden Sie tasks describe , um echte Eingabenamen und die vollständige Anreicherungsnutzlast zu erkennen, bevor Sie eine Aufgabe von Hand schreiben.

Aktualisieren einer Aufgabe – führen Sie dieselben Felder displayName/name/folderPath/shouldRunOnlyOnce/description/isRequired ) mit dem vorhandenen Aufgabenobjekt zusammen (nicht aufgeführte Felder behalten ihren aktuellen Wert bei). name/folderPath haben keine Auswirkungen auf eine wait-for-timer -Aufgabe, die keinen data -Block hat.

Entfernen einer Aufgabe – Löschen Sie ihren Eintrag direkt aus dem Lane-Array der Phase; Lassen Sie die Lane vollständig ab, wenn sie leer wird.

Führen Sie nach einer manuellen Bearbeitung uip maestro case validate aus.

Abrufen von UIP Maestro-Fallaufgaben

Drucken Sie eine einzelne Aufgabe aus einer Phase.

Argumente

Name	Erforderlich	Zweck
<file>	ja	Pfad zur JSON-Datei zur Fallverwaltung.
<stage-id>	ja	ID der Phase, die die Aufgabe enthält.
<task-id>	ja	ID der abzurufenden Aufgabe.

Beispiel

uip maestro case tasks get case.json Stage_1 ta1b2c3d

Datenform (--output json)

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

UIP Maestro Fallaufgaben bereichern

Suchen Sie nach dem tatsächlichen Eingabe-/Ausgabeschema und den Bindungen eines Aufgabentyps auf der Plattform, ohne in eine Datei zu schreiben. Sichtbar in --help.

Hinweis:

Verwenden Sie diese Option, um eine Vorschau zu sehen, was tasks add --task-type-id erzeugt, bevor Sie es in eine Datei committen. Verwenden Sie speziell für Connector-Aktivitäten/Trigger tasks describe stattdessen – enrich deckt die anderen anreicherbaren Typen ab (process, agent, rpa, action, api-workflow, case-management, flow-process) .

Optionen

Long	Wert	Erforderlich	Beschreibung
--type <type>	einer der anreicherbaren Typen	ja	Aufgabentyp.
--id <id>	string	ja	Eindeutige ID der Aufgabe (entityKey oder Action App-ID, je nach Typ).
--element-id <id>	string	nein	Element-ID, an die die Variablenbindung gebunden sein soll.

Beispiel

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

Datenform (--output json)

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

Die genaue Data -Form hängt von --type ab – einer unformatierten Anreicherungsnutzlast von der Plattform, die nicht in ein festes Schema normalisiert wurde.

UIP Maestro-Fallaufgaben beschreiben

Beschreiben Sie die Eingabe-/Ausgabemetadaten eines Aufgabentyps für die Bindungserkennung – die umfangreichste Typabdeckung eines Suchbefehls hier (fügt connector-activity, connector-trigger, external-workflow und external-agent zusätzlich zu allem hinzu, was enrich unterstützt). Sichtbar in --help.

Optionen

Long	Wert	Erforderlich	Beschreibung
--type <type>	einer der beschreibbaren Typen	ja	Aufgabentyp – siehe Liste oben.
--id <id>	string	ja	Eindeutige ID der Aufgabe (Entitätsschlüssel oder Aktions-App-ID).
--connection-id <id>	UUID	bedingt	Erforderlich für connector-activity, connector-trigger, external-workflow und external-agent – der Befehl schlägt schnell mit einem expliziten Fehler fehl, wenn er für diese Typen weggelassen wird. Wird für andere Typen nicht verwendet.

external-workflow und external-agent werden identisch mit connector-activity beschrieben (dieselbe Integration Service-Anreicherungspipeline, gleiche --connection-id -Anforderung), lösen aber ihre Typ-ID mit einem anderen TypeCache-Index auf, da Studio Web sie aus einem separaten Katalog bereitstellt.

Beispiel

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

Datenform (--output json)

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

Ein enrichment -Feld ist nur enthalten, wenn die zugrunde liegende Suche eines zurückgibt.

Zugehörig

• uip Maestro-Fall – Konzepte und das vollständige Subsystemverzeichnis.
• uip Maestro Case Task-Entry-Conditions – Regeln, die festgelegt werden, wenn eine Aufgabe ausführbar wird.
• uip Maestro Fallfälle und Phasen – die Phase, in der sich eine Aufgabe befindet.

Siehe auch

• Übersicht über das Maestro-Tool
• Globale Optionen
• Exitcodes