UIP Maestro-Fallregistrierung

Durchsuchen und durchsuchen Sie die Maestro Case Management-Registrierung von Aktivitäten, Triggern, Connectors und anderen Automatisierungsressourcen mithilfe von „uip Maestro Case Registry“.

uip maestro case registry durchsucht und durchsucht die Fallverwaltungsregistrierung – einen lokalen, zwischengespeicherten Katalog der Automatisierungsressourcen (Prozesse, Agents, APIs, Flows, Connector-Aktivitäten/Trigger, Aktions-Apps und optional die eigenen Ressourcen einer in Bearbeitung befindlichen Lösung) und eine Falldefinition Kann Aufgaben mit verknüpfen. Rufen Sie die Registrierung einmal pro Sitzung ab und suchen oder rufen Sie dann beim Erstellen eines Falls Ressourcen anhand des Bezeichners ab.

Das gesamte Subsystem uip maestro case und wie Registrierungsressourcen in die Aufgabenerstellung einfließen, finden Sie in der Übersicht.

Zusammenfassung

uip maestro case registry pull [-f, --force] [-s, --solution-id <solutionId>]
uip maestro case registry search [keyword] [-t, --type <type>] [-f, --filter <filter>] [--local]
uip maestro case registry list [--local]
uip maestro case registry get <identifier> [-t, --type <type>] [--connection-id <id>] [--local]
uip maestro case registry get-connector -t, --type <type> --activity-type-id <id>
uip maestro case registry get-connection -t, --type <type> --activity-type-id <id>

Typischer Workflow:

1. uip maestro case registry pull – Die vollständige Ressourcenregistrierung abrufen und zwischenspeichern (einmal pro Sitzung ausgeführt).
2. uip maestro case registry search <keyword> – Suche nach einer Ressource.
3. uip maestro case registry get <identifier> – Überprüfen Sie das vollständige Schema.
4. uip maestro case registry get <identifier> --output-filter "Node.inputDefinition.fields" – extrahieren Sie nur die Eingabefelder.

Konzepte

• Ressourcentypen – Die Registrierung indiziert 17 Ressourcentypen: agent, process, api, processOrchestration, caseManagement, flow, action-apps, solution, plus 9 typecache-* Connector-Indexdateien Aufteilung nach Katalogquelle (typecache-activities, typecache-triggers, typecache-packages und jeweils die Varianten -external-automation-*/-external-agent-* ). Sie werden als separate Cache-Dateien aufbewahrt, da die zugrunde liegenden Kataloge uneinheitlich sind – eine Zusammenführung würde dazu führen, dass jeder Pull die Einträge des vorherigen Typs überschreibt.
• --local -Modus – search, list und get akzeptieren --local , um nur gleichgeordnete Projektressourcen in Lösung anstelle des mandantenweiten Caches zu durchsuchen. Erfordert eine .uipx -Datei im aktuellen Verzeichnis oder in einem der beiden übergeordneten Verzeichnisse; Der Bezeichner für get --local ist der Ressourcenschlüssel des gleichgeordneten Elements oder seine .uipx -Projekt-ID.
• solution Ressourcen – Der solution -Ressourcentyp wird nur zwischengespeichert, wenn pull --solution-id <id> angegeben wird; Das Suchen/Abrufen von --type solution , ohne es zuerst abgerufen zu haben, gibt einen expliziten Hinweis dazu zurück, dass pull --solution-id zuerst ausgeführt wird.
• Connector-Anreicherung – get bereichert typecache-activities/typecache-triggers automatisch mit Live-Connector-Metadaten (siehe uiPathActivityTypeId des Eintrags), wenn möglich; Übergeben Sie --connection-id , um verbindungsspezifische Metadaten für benutzerdefinierte Felder abzurufen. Diese Anreicherung wird im Hintergrund übersprungen (kein Fehler), wenn die Suche fehlschlägt.
• get-connector / get-connection – Suche auf niedrigerer Ebene nur für den lokalen TypeCache-Index (nicht den allgemeinen Ressourcencache): get-connector löst einen Connector-Aktivitäts-/Trigger-Eintrag sowie dessen Connector-Konfiguration durch --activity-type-id auf; get-connection führt die gleiche Suche durch und ruft dann die verfügbaren Verbindungen des Connectors von Integration Service ab.

UIP Maestro Case Registry Pull

Abrufen und Zwischenspeichern aller Ressourcentypen. Führt alle Typen parallel aus und meldet eine Aufschlüsselung pro Typ, einschließlich aller fehlgeschlagenen.

Optionen

Short	Long	Wert	Beschreibung
-f	--force	Markieren	Ignorieren Sie den Cache und rufen Sie jeden Ressourcentyp erneut ab.
-s	--solution-id <solutionId>	string	Rufen Sie auch die eigenen Ressourcen der angegebenen Lösung (den Ressourcentyp solution) ab und zwischenspeichern Sie sie.

Beispiel

uip maestro case registry pull

Datenform (--output json)

{
  "Result": "Success",
  "Code": "PullResourcesSuccess",
  "Data": {
    "TotalNodesCount": 128,
    "FromCache": false,
    "ResourceTypes": [
      {
        "Type": "typecache-activities",
        "NodesCount": 80,
        "FromCache": false,
        "AgeMinutes": null,
        "CacheWritten": true,
        "Info": null
      }
    ],
    "Errors": null
  }
}

Result ist "PartialSuccess, N failed" (nicht "Success"), wenn ein oder mehrere Ressourcentypen nicht ausgeführt werden können – Errors listet dann jeden fehlgeschlagenen Typ mit seiner Fehlermeldung auf; Die erfolgreich abgerufenen Typen werden weiterhin zwischengespeichert und in ResourceTypes widergespiegelt.

Suche in der UIP Maestro-Fallregistrierung

Durchsuchen Sie zwischengespeicherte Ressourcen anhand von Schlüsselwörtern und/oder Feldfiltern. Von den Optionen [keyword] und --filter ist mindestens eine erforderlich.

Argumente

Name	Erforderlich	Zweck
[keyword]	Nein*	Freitext-Schlüsselwort, nach dem gesucht werden soll.

* Entweder [keyword], --filter oder beide müssen angegeben werden – das Lassen von beiden schlägt vor der Suche fehl.

Optionen

Short	Long	Wert	Beschreibung
-t	--type <type>	ENUM	Beschränken Sie die Suche auf einen Ressourcentyp. Einer der durchsuchbaren Typen – die vollständige Liste mit 17 Typen finden Sie unter Konzepte (alle RESOURCE_TYPES -Werte sind hier gültig).
-f	--filter <filter>	string	Feldfilter: field=value oder field:operator=value, durch Komma getrennt für mehrere (z. B. name:contains=Apple,category=Pipelines). Felder: name, title, description, category, connectorKey. Operatoren: equals, contains, in, startsWith, endsWith.
–	--local	Markieren	Suchen Sie nur gleichgeordnete Ressourcen in der Lösung. Siehe Konzepte.

Beispiele

uip maestro case registry search invoice

uip maestro case registry search --filter "name:contains=Apple,category=Pipelines"

Datenform (--output json)

{
  "Result": "Success",
  "Code": "ResourceSearchSuccess",
  "Data": {
    "Keyword": "invoice",
    "Filters": null,
    "Type": null,
    "Local": false,
    "ResultCount": 1,
    "Resources": [
      {
        "resourceType": "typecache-activities",
        "resource": {
          "name": "InvoiceParser",
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001"
        }
      }
    ],
    "FailedTypes": null,
    "Hint": null
  }
}

Hint wird ausgefüllt (anstatt weggelassen), genau wenn --type solution null Ergebnisse zurückgibt und --local nicht übergeben wurde – es verweist Sie auf registry pull --solution-id <id>. FailedTypes listet alle Ressourcentypen auf, die während der Suche fehlgeschlagen sind (Teilergebnisse werden weiterhin für die erfolgreichen Typen zurückgegeben).

UIP Maestro-Fallregistrierungsliste

Listen Sie jede zwischengespeicherte Ressource auf, gruppiert nach Typ. Tätet das Netzwerk nicht – spiegelt das wider, was pull zuletzt zwischengespeichert wurde; Führen Sie zuerst pull (oder erneut) aus, um zu aktualisieren.

Optionen

Long	Wert	Beschreibung
--local	Markieren	Listen Sie nur gleichgeordnete Ressourcen in der Lösung anstelle des mandantenweiten Caches auf. Siehe Konzepte.

Beispiel

uip maestro case registry list

Datenform (--output json)

{
  "Result": "Success",
  "Code": "ResourceListSuccess",
  "Data": {
    "ResourcesCount": 128,
    "Local": false,
    "ResourceTypes": [
      { "Type": "typecache-activities", "Count": 80 },
      { "Type": "typecache-triggers", "Count": 48 }
    ],
    "resources": []
  }
}

--local löst die Lösung auf und scannt ihre Ressourcenstruktur direkt (ohne Cache); wird eine fehlende Lösung (keine .uipx gefunden) als sauberer Fehler und nicht als leere Liste gemeldet.

Abrufen der UIP Maestro-Fallregistrierung

Rufen Sie einen oder mehrere vollständige Ressourcendatensätze nach Bezeichner ab.

Argumente

Name	Erforderlich	Zweck
<identifier>	ja	Das entityKey (prozessähnliche Typen) oder id (Aktions-Apps) der Ressource – siehe ID-Feld jedes Typs über Konzepte. Mit --local, dem Ressourcenschlüssel des gleichgeordneten Projekts oder der Projekt-ID .uipx.

Optionen

Short	Long	Wert	Beschreibung
-t	--type <type>	ENUM	Beschränken Sie die Suche auf einen Ressourcentyp (derselbe wie search --type).
–	--connection-id <id>	string	Verbindungs-ID für steckverbinder-spezifische Integration Service-Feldmetadaten (benutzerdefinierte Felder). Gilt nur für typecache-* Aktivitäts-/Trigger-Übereinstimmungen.
–	--local	Markieren	Lösen Sie anhand von gleichgeordneten Ressourcen in der Lösung anstelle des Mandantencaches auf. Siehe Konzepte.

Beispiel

uip maestro case registry get a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Result": "Success",
  "Code": "ResourceGetSuccess",
  "Data": {
    "MatchCount": 1,
    "Local": false,
    "Resources": [
      {
        "ResourceType": "typecache-activities",
        "Resource": {
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
          "name": "InvoiceParser"
        }
      }
    ]
  }
}

Null Übereinstimmungen sind ein Fehler (Code-weniger-Fehlerantwort), kein leerer Erfolg – die Instructions des Fehlers unterscheiden sich je nach Modus: Ein --local -Fehlschlag schlägt vor, dass der Ressourcenschlüssel oder die Projekt-ID des gleichgeordneten Elements über registry list --local erneut überprüft wird; Ein --type solution -Fehlschlag schlägt vor, zuerst pull --solution-id auszuführen; alles andere meldet nur „keine Ressource gefunden.“

Get-Connector für UIP Maestro-Fallregistrierung

Suchen Sie nach einer einzelnen Connector-Aktivität/Trigger-Eintrag (und deren Connector-Konfiguration) direkt aus dem lokalen TypeCache-Index und umgehen Sie die allgemeine Ressourcensuche.

Optionen

Short	Long	Wert	Erforderlich	Beschreibung
-t	--type <type>	ENUM	ja	Geben Sie Cache-Index ein, in dem gesucht werden soll: typecache-activities, typecache-triggers, typecache-external-automation-activities, typecache-external-automation-triggers, typecache-external-agent-activities oder typecache-external-agent-triggers.
–	--activity-type-id <id>	string	ja	Der nachzuschlagende uiPathActivityTypeId.

Beispiel

uip maestro case registry get-connector --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Result": "Success",
  "Code": "ConnectorGetSuccess",
  "Data": {
    "Entry": {
      "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "InvoiceParser"
    },
    "Config": { "connectorKey": "uipath-connector-a" }
  }
}

Get-Connection für UIP Maestro-Fallregistrierung

Suchen Sie eine Connector-Aktivität/einen Trigger (dieselbe Suche wie get-connector) und rufen Sie dann die verfügbaren Integration Service-Verbindungen ab.

Optionen

Short	Long	Wert	Erforderlich	Beschreibung
-t	--type <type>	ENUM	ja	Die gleichen TypeCache-Indexauswahlen wie get-connector.
–	--activity-type-id <id>	string	ja	Der nachzuschlagende uiPathActivityTypeId.

Beispiel

uip maestro case registry get-connection --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Result": "Success",
  "Code": "ConnectionGetSuccess",
  "Data": {
    "Entry": { "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001" },
    "Config": { "connectorKey": "uipath-connector-a" },
    "Connections": [
      { "id": "b2c3d4e5-0000-0000-0000-000000000001", "name": "Default" }
    ]
  }
}

Binden einer Aufgabeneingabe an eine Variable

Die Eingabe einer Aufgabe wird mit einem Literalwert/Ausdruck oder der Ausgabe einer anderen Aufgabe verbunden, indem die JSON-Schemadatei für die Fallverwaltung direkt bearbeitet wird. Feldreferenz: Die Eingabe einer Aufgabe an einem durch Punkt getrennten <field-path> (<input-name>[.<key1>[.<key2>...]] – keine Punkte legt input.value direkt fest; jedes Punktsegment durchläuft eine Eigenschaftsebene, z. B. body.body.body für den geschachtelten Anforderungstext einer Connector-Aktivität) verwendet entweder eine Literalzeichenfolge, einen Ausdruck mit einem zulässigen Präfix (=vars., =bindings., =js:, =metadata., =datafabric., =orchestrator.JobAttachments, =response). }, =result, =Error, =jsonString:) oder einen generierten =vars.<id> -Ausdruck bei der Quelle auf die Ausgabe einer anderen Aufgabe. Bearbeiten Sie die Aufgabeneingabe von caseplan.json direkt, um eines davon festzulegen, und führen Sie dann uip maestro case validate <file> aus.

Zugehörig

• uip Maestro Case – Übersicht und der Rest des Subsystems für die Fallverwaltung.

Siehe auch

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