- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
uip-Maestro-Fall
Erstellen, Packen, Debuggen, Validieren und Erstellen von Fallverwaltungsprojekten mithilfe von „uip Maestro Case“, der dritten Oberfläche für Maestro-Orchestrierung neben BPMN und Flow.
uip maestro case erstellt, verpackt, debuggt und erstellt Fallverwaltungsprojekte – eine dritte Maestro-Orchestrierungsoberfläche neben BPMN und Flow. Ein Fallprojekt modelliert eine langlaufende, von Menschen gesteuerte Arbeitseinheit als Fallplan: ein JSON-Dokument (caseplan.json), das Phasen, Aufgaben, SLAs, Trigger und die Eintritts-/Austrittsbedingungen beschreibt, die einen Fall zwischen Phasen verschieben – näher an einem strukturierten Workflow mit einem Lebenszyklus als ein linearer Prozess ist.
Das Tool wird als separates @uipath/case-tool -Paket ausgeliefert, das dynamisch von @uipath/maestro-tool unter der case -Verzweigung geladen wird – jeder Befehl wird hier als uip maestro case <verb> aufgerufen, niemals als eigenständiges uip case.
Diese Ressource umfasst neun Seiten
-
Diese Seite – Konzepte und die Projektlebenszyklus-Befehle:
init,pack,debug,validate,format,bindings sync,sdd,task-types,spec,splice. -
Maestro-Erstellungsbefehle –
compile,check,decompileundmergezwischen autorisiertem TypeScript (.case.ts) undcaseplan.jsonüber das Builder SDK. -
registry– Durchsuchen/Durchsuchen des Automatisierungsressourcenkatalogs, zu dem Aufgaben verarbeitet werden, und durchsuchen, wie eine Aufgabeneingabe an eine Variable gebunden wird. -
casesundstages– lesen Sie die Metadaten und die Phasenliste des Fallplans auf oberster Ebene. -
tasks– Lesen, anreichern und beschreiben von Aufgabendefinitionen innerhalb einer Phase. -
task-entry-conditions– Liest die Regeln, die festgelegt werden, wenn eine Aufgabe ausführbar wird. -
sla– SLA-/Eskalationsregeln lesen. -
triggers,sticky-notes,edges– Lesen Sie Falltrigger, Anmerkungen auf der Arbeitsfläche und Übergänge von Phase zu Phase. -
case-exit-conditions,stage-entry-conditions,stage-exit-conditions– Lesen Sie die Bedingungsregeln auf Fall- und Phasenebene. -
process,processes,job,instances,incidents– Bereitstellen und Ausführen von Fallinstanzen im Orchestrator.
Konzepte
- Das Autorenmodell: Bearbeiten Sie
caseplan.jsondirekt und dannvalidate. Verfassen oder bearbeiten Siecaseplan.jsonmanuell (oder lassen Sie dies von einem Agent ausführen, der sich durch die JSON-Form-Referenzen deruipath-maestro-case-Fähigkeit geführt wird) und führen Sie dannuip maestro case validateaus, um es zu überprüfen. Dieread-Verben, die auf den gleichgeordneten Seiten oben dokumentiert sind (cases get,stages list,tasks getusw.) helfen Ihnen, den Plan zu überprüfen, während Sie ihn erstellen. Die Befehle, die in einen Fallplan schreiben, sindformat,sdd convertundsplice.bindings syncschreibt die aus dem Plan abgeleitetebindings_v2.json-Datei. - Fall vs. BPMN vs. Flow – alle drei sind Maestro-Orchestrierungsoberflächen, die auf
.nupkggepackt werden und Runtime /process/job/instances/registry), aber eine eigene für die Fallverwaltungincidentsteilen Das primäre Asset istcaseplan.json(plus ein generiertescaseplan.json.bpmn) und sein Projekttyp istCaseManagementinoperate.json/project.uiproj– unterscheidet sich von.bpmnvon BPMN und.flowvon Flow. - Validierungsprofile –
validateführt eines von vier Profilen aus, je nachdem, wie weit die Erstellung ist:skeleton(nur Struktur – Knoten, Edges, Identität, Typen),skeleton-v2(S Zeit dafür überprüft und überspringt immer noch Aufgabeninhalte),strict(jede Prüfung, einschließlich Phase ohne Aufgaben, ungelöste$xref-Marker und Connector-Kontextvollständigkeit – das Gateway für abgeschlossene Fälle) und das Standardprofilfull(Übergeordnet, für teilweise erstellte oder bereits gepackte Dateien).--sdd <path>prüft die Vollständigkeit anhand eines Spezifikationsdokuments und impliziert--strict. specist ein Planungstool und kein Fallplan-Mandator: Es ruft eine normalisierte Beschreibung einer Integration Service-Connector-Aktivität oder eines Triggers ab (Eingaben, Ausgaben, Pflichtfelder), damit Sie wissen, was in die Aufgabe voncaseplan.jsongesetzt werden soll. Triggerdefinitionen, bevor Sie sie schreiben. Finden Sie die benötigten Werte für--activity-type-id/--connection-idüberregistry get-connector/get-connection.
Zusammenfassung
uip maestro case init <name> [--force] [--skip-solution-registration]
uip maestro case pack <project-path> <output-path> [-n, --name <name>] [-v, --version <version>] [package-metadata options...]
uip maestro case debug <project-path> [--folder-id <id>] [--poll-interval <ms>] [--login-validity <minutes>]
uip maestro case validate <file> [--skeleton | --skeleton-v2 | --strict] [--sdd <path>]
uip maestro case format <file>
uip maestro case bindings sync <file>
uip maestro case sdd parse <file>
uip maestro case sdd resolve <file> [--out <file>]
uip maestro case sdd convert <file> [--out <file>] [--resolved <file>]
uip maestro case task-types list
uip maestro case splice <file> (--task-id <id> | --task-name <name>) (--spec <file> | --described <file>) [--connection-id <id>] [--folder-key <key>] [--out <file>]
uip maestro case spec --type <activity|trigger> --activity-type-id <uuid> --connection-id <id> [--object-name <name>] [--trigger-kind <start|wait-for>] [--skip-case-shape | --input-details <json> [--solution-folder <path>]]
uip maestro case init <name> [--force] [--skip-solution-registration]
uip maestro case pack <project-path> <output-path> [-n, --name <name>] [-v, --version <version>] [package-metadata options...]
uip maestro case debug <project-path> [--folder-id <id>] [--poll-interval <ms>] [--login-validity <minutes>]
uip maestro case validate <file> [--skeleton | --skeleton-v2 | --strict] [--sdd <path>]
uip maestro case format <file>
uip maestro case bindings sync <file>
uip maestro case sdd parse <file>
uip maestro case sdd resolve <file> [--out <file>]
uip maestro case sdd convert <file> [--out <file>] [--resolved <file>]
uip maestro case task-types list
uip maestro case splice <file> (--task-id <id> | --task-name <name>) (--spec <file> | --described <file>) [--connection-id <id>] [--folder-key <key>] [--out <file>]
uip maestro case spec --type <activity|trigger> --activity-type-id <uuid> --connection-id <id> [--object-name <name>] [--trigger-kind <start|wait-for>] [--skip-case-shape | --input-details <json> [--solution-folder <path>]]
UIP Maestro Fall Init
Erstellen Sie ein neues Fallprojekt mit Textbaustein-Dateien: project.uiproj, operate.json, entry-points.json, bindings_v2.json, package-descriptor.json und einem minimalen caseplan.json (nur geschrieben, wenn noch keins vorhanden ist – erneutes Ausführen von init überlappt nie einen erstellten Fallplan). Wenn die Ausführung außerhalb einer vorhandenen Lösung erfolgt, wird automatisch ein übergeordnetes <name>Solution -Framework erstellt und das Fallprojekt wird darin verschachtelt; Wenn es innerhalb einer ausgeführt wird, wird das Projekt stattdessen in dieser Lösung registriert.
Argumente
| Name | Erforderlich | Zweck |
|---|---|---|
<name> | ja | Der Name des Fallprojekts. Nur Buchstaben, Ziffern, Unterstriche und Bindestriche. |
Optionen
| Long | Wert | Beschreibung |
|---|---|---|
--force | Markieren | Initialisieren Sie auch dann, wenn das Zielverzeichnis nicht leer ist. Schreibt Dateien, ohne vorhandene Inhalte zu löschen. |
--skip-solution-registration | Markieren | Registrieren Sie dieses Projekt nicht automatisch in der Umgebungslösung. |
Beispiel
uip maestro case init my-case-project
uip maestro case init my-case-project
Datenform (--output json)
{
"Code": "CaseInit",
"Data": {
"Status": "Created successfully",
"Path": "/workspace/my-case-project",
"CasePlan": "/workspace/my-case-project/caseplan.json",
"CasePlanStatus": "Created",
"SolutionRegistration": { "Status": "Registered", "Solution": "...", "ProjectId": "..." },
"AutoCreatedSolution": { "...": "present only when a parent solution was scaffolded" },
"ProjectArtifacts": { "...": "present only when registered into a parent solution" },
"NextSteps": "present only when SolutionRegistration.Instructions is set"
}
}
{
"Code": "CaseInit",
"Data": {
"Status": "Created successfully",
"Path": "/workspace/my-case-project",
"CasePlan": "/workspace/my-case-project/caseplan.json",
"CasePlanStatus": "Created",
"SolutionRegistration": { "Status": "Registered", "Solution": "...", "ProjectId": "..." },
"AutoCreatedSolution": { "...": "present only when a parent solution was scaffolded" },
"ProjectArtifacts": { "...": "present only when registered into a parent solution" },
"NextSteps": "present only when SolutionRegistration.Instructions is set"
}
}
CasePlanStatus ist "Created" auf einem neuen Gerüst oder "Preserved", wenn ein vorhandenes caseplan.json unberührt wurde (erneutes Ausführen von init für ein Projekt, das Sie bereits erstellt haben). SolutionRegistration ist immer vorhanden – sein Status ist "NotInSolution" anstelle des Felds, das weggelassen wird, wenn keine übergeordnete Lösung vorhanden ist.
UIP Maestro Fallpack
Packen Sie ein Fallprojektverzeichnis in eine .nupkg -Datei und lesen Sie caseplan.json aus dem Projektstamm.
Argumente
| Name | Erforderlich | Zweck |
|---|---|---|
<project-path> | ja | Pfad zum Verzeichnis des Falls. |
<output-path> | ja | Ausgabeverzeichnis für .nupkg. |
Optionen
| Long | Wert | Beschreibung |
|---|---|---|
-n, --name <name> | string | Paketname. Standard: Name des Projektordners. |
-v, --version <version> | string | Paketversion Der Standardwert ist 1.0.0. |
Akzeptiert auch die freigegebenen Paketmetadatenoptionen dieses Repositorys (--repository-url/--repository-commit/--repository-branch/--repository-type, --release-notes, --project-url, --author, --description) – siehe alle anderen pack -Befehle Optionstabelle (z. B. uip maestro bpmn pack) für den vollständigen freigegebenen Satz, den dieser Befehl identisch registriert.
Beispiel
uip maestro case pack ./my-case-project ./dist --version 1.2.0
uip maestro case pack ./my-case-project ./dist --version 1.2.0
Datenform (--output json)
{
"Code": "CasePack",
"Data": {
"Package": "my-case-project.1.2.0.nupkg",
"Output": "./dist/my-case-project.1.2.0.nupkg"
}
}
{
"Code": "CasePack",
"Data": {
"Package": "my-case-project.1.2.0.nupkg",
"Output": "./dist/my-case-project.1.2.0.nupkg"
}
}
Ein Schemafehler beim Packen (eine falsch formatierte caseplan.json) wird mit fallspezifischen Anweisungen angereichert, bevor er als Fehler angezeigt wird – erwarten Sie eine umsetzbare Instructions, keinen unformatierten Parser-Fehler.
UIP Maestro-Falldebuggen
Debuggen Sie ein Fallprojekt, indem Sie es in Studio Web hochladen und dort eine Debugging-Sitzung ausführen – es gibt keinen lokalen Debugmodus für die Fallverwaltung (im Gegensatz zu einigen anderen Debugging-Befehlen von Maestro).
Argumente
| Name | Erforderlich | Zweck |
|---|---|---|
<project-path> | ja | Pfad zum Fallprojektverzeichnis. Muss project.uiproj enthalten. |
Optionen
| Long | Wert | Beschreibung |
|---|---|---|
--folder-id <id> | Integer | Orchestrator-Ordner-ID (OrganizationUnitId). Automatisch erkennen, wenn er weggelassen wird. |
--poll-interval <ms> | Integer | Abrufintervall in Millisekunden. Der Standardwert ist 2000. |
--login-validity <minutes> | Integer | Mindestens Minuten vor dem Tokenablauf, um eine Aktualisierung auszulösen. Der Standardwert ist 10. |
Erfordert eine aktive Anmeldung (uip login) mit einer auflösbaren Organisation, einem Mandanten und einem Zugriffstoken – schlägt schnell mit einer bestimmten Nachricht fehl, die benennt, welcher Teil des Anmeldestatus fehlt.
Beispiel
uip maestro case debug ./my-case-project
uip maestro case debug ./my-case-project
Datenform (--output json)
{
"Code": "CaseDebug",
"Data": {
"jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"runId": "d4e5f6a7-0000-0000-0000-000000000001",
"finalStatus": "Completed",
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
"elementExecutions": [
{ "elementId": "Stage_1", "status": "Completed" },
{ "elementId": "Stage_2", "status": "Completed" }
]
}
}
{
"Code": "CaseDebug",
"Data": {
"jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"runId": "d4e5f6a7-0000-0000-0000-000000000001",
"finalStatus": "Completed",
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
"elementExecutions": [
{ "elementId": "Stage_1", "status": "Completed" },
{ "elementId": "Stage_2", "status": "Completed" }
]
}
}
Die Schlüssel werden in ihrem nativen BinnenMajuskel (nicht in PascalCase) gehalten – diese Nutzlast ist so konzipiert, dass sie von Auswertungsprüfern und SDKs programmgesteuert gelesen wird, und entspricht dem gleichendatensatz, der von dem Debugging-Befehl von Flow und registry get verwendet wird. Der Befehl wird ungleich Null beendet, wenn finalStatus etwas anderes als "Completed"/"Successful" ist, obwohl der Umschlag selbst Result: "Success" meldet – überprüfen Sie den Exitcode, nicht nur das Vorhandensein von Data, in Skripts.
UIP Maestro Fallvalidierung
Validieren Sie eine JSON-Datei für die Fallverwaltung anhand der Struktur- und Geschäftsregeln von Case Management.
Argumente
| Name | Erforderlich | Zweck |
|---|---|---|
<file> | ja | Pfad zur JSON-Datei zur Fallverwaltung (normalerweise caseplan.json). |
Optionen
| Long | Beschreibung |
|---|---|
--skeleton | Nur strukturierte Prüfungen (Knoten, Edges, Identität, Typen). Überspringt Aufgabeninhalte, SLAs, Eskalationen und Eintritts-/Austrittsregeln – nützlich während der Skeleton-Phase der Erstellung. Konflikte mit --skeleton-v2/--strict. |
--skeleton-v2 | Skeleton-Prüfungen sowie SLA, Eskalation und Prüfungen für Eintritts-/Austrittsregeln. Überspringt immer noch Aufgabeninhalte. Konflikte mit --skeleton/--strict. |
--strict | Jede Prüfung sowie der strikte Satz: eine Phase ohne Aufgaben, ungelöste $xref -Marker, eine angehaltene conditionExpression, Formen der Formel-/Ausgabebindung und Vollständigkeit des Connector-Kontexts. Das Gateway für abgeschlossene Fälle. Konflikte mit --skeleton/--skeleton-v2. |
--sdd <path> | Prüfen Sie den Fallplan auf Vollständigkeit anhand des angegebenen SDD (Spezifikationsdokument) – jede Phase, Aufgabe, Aufgabentyp, Bedingungszeile, SLA, Trigger und Fallvariable müssen vorhanden sein. Impliziert --strict. |
Wenn Sie alle vier Ausführungen weglassen, wird das Standardprofil full ausgeführt: nacht, sodass teilweise erstellte oder bereits gepackte Dateien weiterhin validiert werden.
Beispiele
uip maestro case validate case.json
uip maestro case validate case.json --skeleton
uip maestro case validate case.json --strict
uip maestro case validate case.json --sdd ./spec.md
uip maestro case validate case.json
uip maestro case validate case.json --skeleton
uip maestro case validate case.json --strict
uip maestro case validate case.json --sdd ./spec.md
Datenform (--output json)
{
"Code": "CaseValidate",
"Data": {
"File": "case.json",
"Status": "Valid",
"Warnings": "2 warning(s):\n - [stages[0].tasks[1]] ...",
"Issues": [
{ "Code": "UNRESOLVED_REFERENCE", "Path": "stages[0].tasks[1]", "Message": "...", "Severity": "warning" }
]
}
}
{
"Code": "CaseValidate",
"Data": {
"File": "case.json",
"Status": "Valid",
"Warnings": "2 warning(s):\n - [stages[0].tasks[1]] ...",
"Issues": [
{ "Code": "UNRESOLVED_REFERENCE", "Path": "stages[0].tasks[1]", "Message": "...", "Severity": "warning" }
]
}
}
Profile: "strict" wird nur dann zu Data hinzugefügt, wenn --strict (oder --sdd) übergeben wurde. Wenn bei einer Ausführung mit keiner der Profiloptionen ein sdd.md neben dem Fallplan oder am Stammpfad der Lösung gefunden wird, zählt Data.Suppressed ({ Profile, Sdd, Errors, Warnings }) die strikten und SDD-Ergebnisse, die das Standardprofil nicht anzeigt und Instructions gibt den Befehl --strict --sdd an, der sie anzeigt. Warnings/Issues sind nur vorhanden, wenn die gültige Datei noch Warnungen erzeugte. Bei einem Fehler (Result: "Failure", Beenden 1) enthält Data.Issues jeden Fehler und jede Warnung mit einem stabilen Code, Path, Message und Severity – analysieren Sie dieses Array anstelle des von Menschen lesbaren Instructions Text, wenn Sie eine Reparaturschleife steuern.
UIP-Maestro-Fallformat
Schreiben Sie eine JSON-Datei für den Fallplan an Ort und Stelle neu, die mit einer 2-Leerzeichen-Einrückung und einem Schlüssel pro Zeile versehen ist, damit ein Dateibearbeitungstool sie Patchen kann.
uip maestro case format case.json
uip maestro case format case.json
Datenform: Code: "CaseFormat", Data: { Changed, Lines, LongestLine }.
Synchronisierung von UIP Maestro-Fallbindungen
Leiten Sie bindings_v2.json von einem Fallplan ab und schreiben Sie ihn in dasselbe Verzeichnis wie der Plan, wobei eine vorhandene Datei überschrieben wird. Die Datei wird von uip solution resources refresh für Lösungen benötigt, die ohne Studio Web erstellt wurden. Der Befehl liest nur den Fallplan und die Datei entry-points.json daneben.
uip maestro case bindings sync case.json
uip maestro case bindings sync case.json
Datenform: Code: "CaseBindingsSync", Data: { BindingsPath, ResourceCount, ConnectionCount }.
UIP Maestro Fall SDD
Lesen Sie ein Lösungsdesigndokument (sdd.md), das Dokument, gegen das validate --sdd einen Fallplan prüft.
| Unterbefehl | Optionen | Beschreibung |
|---|---|---|
parse <file> | – | Geben Sie das strukturierte Modell, das von sdd.md geparst wurde, als JSON aus. Liest nur das Dokument. Code: "SddParse". |
resolve <file> | --out <file>: Schreibe das Ergebnis in eine Datei, anstatt es zu drucken. | Lösen Sie die Aufgabenressourcen des Dokuments anhand der von registry pull geschriebenen Caches auf. Ein Name, der mit mehreren Ressourcen übereinstimmt, oder mit keiner, wird gemeldet, damit Sie auswählen können. Liest nur Caches. Code: "SddResolve". |
convert <file> | --out <file>: Schreiben Sie den Fallplan in eine Datei, anstatt ihn auszudrucken.--resolved <file>: Lesen Sie ein sdd resolve -Ergebnis, um Ressourcennamen oder Ordner auszufüllen, die das Dokument auslässt. | Schreiben Sie einen Fallplan aus dem Dokument. Meldet, was das Dokument nicht bestimmt, z. B. Ressourcen, die für einen Mandanten aufgelöst werden müssen, oder die Verbindung eines Connectors. Überprüfen Sie das Ergebnis mit validate. Code: "SddConvert". |
uip maestro case sdd parse sdd.md
uip maestro case sdd convert sdd.md --out caseplan.json
uip maestro case sdd parse sdd.md
uip maestro case sdd convert sdd.md --out caseplan.json
Fallaufgabentypen von UIP Maestro
Listen Sie die Fallaufgabentypen zum manuellen Schreiben eines sdd.md oder eines Fallplans auf. Die Liste stammt aus dem installierten Falltool und liest nichts vom Mandanten, sodass der Befehl keine Anmeldung benötigt.
uip maestro case task-types list --output json
uip maestro case task-types list --output json
| Feld | Beschreibung |
|---|---|
WriteSchemaVersion | Fallplanschemaversion, die sdd convert auf die von ihm geschriebenen Pläne stempelt. |
ReadSchemaVersion | Neueste Version des Fallplanschemas, die ein Plan deklarieren kann und dennoch validate übergeben kann. Kann neuer als WriteSchemaVersion sein. |
Authorable | Aufgabentypen, die ein SDD deklarieren kann, die sdd convert schreibt. |
StudioWebOnly | Aufgabentypen, die ein Fallplan enthalten kann, aber ein SDD nicht deklarieren kann. Sie werden in Studio Web erstellt. |
NotTaskTypes | Schreibweisen, die an anderer Stelle das richtige Konzept benennen, aber keine Aufgabentypen sind. Jeder Eintrag gibt den Spelling, den Layer wo die Rechtschreibung korrekt ist, und den PlanType an, der stattdessen in den Plan geschrieben werden soll. |
Die Aufgabentypen in Authorable und StudioWebOnly:
| Aufgabentyp | Aufgelistet in |
|---|---|
action | Authorable |
agent | Authorable |
api-workflow | Authorable |
business-rule | Authorable |
case-management | Authorable |
execute-connector-activity | Authorable |
flow-process | Authorable |
function | Authorable |
http-request | Authorable |
process | Authorable |
rpa | Authorable |
wait-for-connector | Authorable |
wait-for-timer | Authorable |
document-extraction | StudioWebOnly |
external-agent | StudioWebOnly |
external-workflow | StudioWebOnly |
script | StudioWebOnly |
Die NotTaskTypes Einträge:
Spelling | Wo es korrekt ist | Zu schreibender Aufgabentyp |
|---|---|---|
connector-activity | uip maestro case tasks describe --type | execute-connector-activity |
connector-trigger | uip maestro case tasks describe --type | wait-for-connector |
wait-for-event | Eine Connector-Aufgabe data.serviceType | wait-for-connector |
Datenform: Code: "TaskTypeList", Data: { WriteSchemaVersion, ReadSchemaVersion, Authorable, StudioWebOnly, NotTaskTypes }. Die Einträge Authorable und StudioWebOnly sind { Type } -Objekte.
Wenn das installierte Falltool seine Schemaversionen nicht lesen kann, schlägt der Befehl mit Exitcode 1 und Instructions fehl und uip tools update maestro wird ausgeführt.
UIP Maestro Case Splice
Schreiben Sie die Eingaben, Ausgaben und den Kontext einer Aufgabe aus einem gespeicherten Ergebnis in einen Fallplan, ohne einen Mandanten aufzurufen.
| Option | Beschreibung |
|---|---|
--task-id <id> | ID der Aufgabe, in die geschrieben werden soll (nodes[].data.tasks[][].id). Übergeben Sie dies oder --task-name. |
--task-name <name> | Anzeigename der Aufgabe, genau wie im Plan geschrieben. Übergeben Sie dies oder --task-id. |
--spec <file> | Ein als JSON-Objekt gespeichertes case spec -Ergebnis für eine Connector-Aufgabe. Das Ergebnis muss die Fallform enthalten: spec ohne --skip-case-shape ausführen. Schreibt data.context, data.inputs, data.outputs, den Diensttyp und die Stammbindungen der Verbindung. |
--described <file> | Ein case tasks describe -Ergebnis, das als JSON-Objekt für einen Prozess, eine RPA, eine Geschäftsregel, einen API-Workflow, eine Agent-Aktion, eine Funktion oder eine untergeordnete Fallaufgabe gespeichert wird. Schreibt die Eingaben und Ausgaben der Aufgabe und behält die IDs bei, die der Plan bereits hat. Verwenden Sie sie anstelle von --spec. |
--connection-id <id> | Verbindung, für die die Connectoraufgabe ausgeführt wird. Standard: die Verbindung in der Spezifikation. Ein Wert, der von den Spezifikationen abweicht, wird abgelehnt. |
--folder-key <key> | Ordnerschlüssel für die Verbindung. Standard: der Ordner in der Spezifikation. Ein Wert, der von den Spezifikationen abweicht, wird abgelehnt. |
--out <file> | Schreiben Sie das Ergebnis in diese Datei, anstatt den vorhandenen Plan zu aktualisieren. |
uip maestro case splice caseplan.json --task-id tP6mWC2aG --spec slack-send.json
uip maestro case splice caseplan.json --task-id tP6mWC2aG --spec slack-send.json
Datenform: Code: "ConnectorShapeSpliced" mit --spec oder Code: "DescribedIoApplied" mit --described. Mit --spec ist Data { Path, Summary }, wobei Summary TaskId, TaskType, ServiceType, ContextEntries, Inputs, Outputs, ConnectionBindingId, FolderBindingId, enthält. und BindingsReused.
UIP Maestro Fallspezifikation
Generieren Sie ein normalisiertes ConnectorTaskSpec – alles, was zum Erstellen einer ausführbaren Integration Service-Aktivität oder Triggeraufgabe innerhalb eines Fallplans erforderlich ist. Sucht den Typ im lokalen TypeCache, listet Integration Service-Verbindungen für den Connector auf und ruft Integration Service-Metadaten ab.
Optionen
| Long | Wert | Erforderlich | Beschreibung |
|---|---|---|---|
--type <type> | activity | trigger | ja | Welcher TypeCache gesucht werden soll. |
--activity-type-id <uuid> | UUID | ja | Studio Web uiPathActivityTypeId. Zu finden über registry pull + Lesen der typecache-{activities,triggers}-index.json Cache-Datei oder registry get-connector. |
--connection-id <id> | UUID | ja | Verbindungs-ID. Kandidaten mit registry get-connection --type typecache-{activities,triggers} --activity-type-id <uuid> auflisten. |
--object-name <name> | string | nein | Überschreiben Sie den TypeCache objectName. Erforderlich für kuratierte Trigger vom Typ Entität, deren TypeCache einen Platzhalter speichert (z. B Data Service {tenantEntityName|folderEntityName}) – Wählen Sie einen echten Entitätsnamen aus. |
--skip-case-shape | Markieren | nein | Lassen Sie caseShape (inputs[]/outputs[]/context[]) aus der Antwort weg – verwenden Sie sie während der Planung, wenn Sie nur den Connector-Vertrag benötigen. Sich gegenseitig mit --input-details ausschließen. |
--trigger-kind <kind> | start | wait-for | nein | Mit --type trigger: start für einen Fallstarttrigger oder wait-for für eine „Wait-auf-Connector“-Aufgabe oder Bedingungsregel. Standardmäßig auf wait-for. Ignoriert mit --type activity. |
--input-details <json> | JSON | nein | Füllen Sie Werte, die in das generierte caseShape eingeklappt werden, vorab aus. Form unterscheidet sich um --type: Aktivität akzeptiert {bodyParameters, queryParameters, pathParameters, filter}; Trigger akzeptiert {eventParameters, queryParameters, pathParameters, filter}. Sich gegenseitig mit --skip-case-shape ausschließen. |
--solution-folder <path> | Pfad | nein | Lösungsstamm, in den auf Ressourcenauswahlwerte in --input-details, z. B. eine Data Fabric-Entität, verwiesen wird. Standardmäßig die Lösung, die den aktuellen Ordner enthält. Wenn ein Auswahlwert festgelegt wird und keine Lösung gefunden wird, schlägt der Befehl fehl und fragt nach dieser Option. |
Beispiele
# Curated connector activity (Send Email)
uip maestro case spec --type activity \
--activity-type-id c7ce0a96-2091-3d94-b16f-706ebb1eb351 \
--connection-id fc82e610-c454-4bc7-a1a5-b5aa529d1ba6
# Curated connector activity (Send Email)
uip maestro case spec --type activity \
--activity-type-id c7ce0a96-2091-3d94-b16f-706ebb1eb351 \
--connection-id fc82e610-c454-4bc7-a1a5-b5aa529d1ba6
# Curated connector trigger (Email Received)
uip maestro case spec --type trigger \
--activity-type-id 7dc57f24-894c-5ae2-a902-66056fa40609 \
--connection-id fc82e610-c454-4bc7-a1a5-b5aa529d1ba6
# Curated connector trigger (Email Received)
uip maestro case spec --type trigger \
--activity-type-id 7dc57f24-894c-5ae2-a902-66056fa40609 \
--connection-id fc82e610-c454-4bc7-a1a5-b5aa529d1ba6
Datenform (--output json)
{
"Code": "ConnectorTaskSpec",
"Data": {
"specVersion": 1,
"identity": {
"target": "activity",
"uiPathActivityTypeId": "c7ce0a96-2091-3d94-b16f-706ebb1eb351",
"connectorKey": "uipath-microsoft-outlook365",
"objectName": "send-mail-v2",
"typecacheEntry": { "displayName": "Send Email" }
},
"operation": { "name": "POST", "verb": "create", "httpMethod": "POST", "path": "/hubs/productivity/send-mail-v2" },
"inputs": { "bodyFields": [{ "name": "message.toRecipients", "required": true }] }
}
}
{
"Code": "ConnectorTaskSpec",
"Data": {
"specVersion": 1,
"identity": {
"target": "activity",
"uiPathActivityTypeId": "c7ce0a96-2091-3d94-b16f-706ebb1eb351",
"connectorKey": "uipath-microsoft-outlook365",
"objectName": "send-mail-v2",
"typecacheEntry": { "displayName": "Send Email" }
},
"operation": { "name": "POST", "verb": "create", "httpMethod": "POST", "path": "/hubs/productivity/send-mail-v2" },
"inputs": { "bodyFields": [{ "name": "message.toRecipients", "required": true }] }
}
}
Die operation -Form einer Triggerspezifikation unterscheidet sich (eventMode/Ereignisname anstelle eines HTTP-Verb/Pfads) – siehe zweites Beispiel oben.
Zugehörig
registry– Entdecken Sie Ressourcen, auf die in einem Fallplan verwiesen werden kann, und wie eine Aufgabeneingabe an eine Variable gebunden wird.casesundstages– überprüfen Sie die Metadaten und Phasen des Fallplans.tasks– Überprüfung, Anreicherung und Beschreibung von Aufgabendefinitionen.task-entry-conditions– Überprüfung der Eintrittsregeln auf Aufgabenebene.sla– Überprüfen Sie die SLA-/Eskalationsregeln.triggers,sticky-notes,edges– Überprüfen Sie Trigger, Canvas-Notizen und Übergänge.- Bedingungen – Überprüfen Sie die Eintritts-/Austrittsbedingungen auf Fallebene und Phasenebene.
process,processes,job,instances,incidents– Bereitstellen und Ausführen von Fallinstanzen.uip maestro– BPMN-Orchestrierung, die gleichgeordnete Oberfläche.uip maestro flow– Flow-Orchestrierung, die andere gleichgeordnete Oberfläche.
Siehe auch
- Diese Ressource umfasst neun Seiten
- Konzepte
- Zusammenfassung
- UIP Maestro Fall Init
- Argumente
- Optionen
- Beispiel
- Datenform (--output json)
- UIP Maestro Fallpack
- Argumente
- Optionen
- Beispiel
- Datenform (--output json)
- UIP Maestro-Falldebuggen
- Argumente
- Optionen
- Beispiel
- Datenform (--output json)
- UIP Maestro Fallvalidierung
- Argumente
- Optionen
- Beispiele
- Datenform (--output json)
- UIP-Maestro-Fallformat
- Synchronisierung von UIP Maestro-Fallbindungen
- UIP Maestro Fall SDD
- Fallaufgabentypen von UIP Maestro
- UIP Maestro Case Splice
- UIP Maestro Fallspezifikation
- Optionen
- Beispiele
- Datenform (--output json)
- Zugehörig
- Siehe auch