UIP-Auswertungszeitplan

Syntax und Optionen für „uip eval Schedule“, der wiederkehrende Zeitpläne für Auswertungsausführungen für einen Orchestrator-Prozess erstellt, auflistet, aktualisiert, anhält, fortgesetzt und löscht.

uip eval schedule verwaltet wiederkehrende Auswertungsausführungen für einen Orchestrator-Prozess: Erstellen Sie einen von Cron ausgelösten Zeitplan, der einen bestimmten Auswertungssatz mit einem Timer für den Prozess ausführt, und listen Sie ihn dann auf, überprüfen, aktualisieren, anhalten, fortsetzen oder löschen. Dies ist das geplante Gegenstück zu einer einmaligen Ausführung – unter uip eval finden Sie eine Übersicht über das gesamte eval -Subsystem, einschließlich execute-and-evaluate (einmalig, synchron ausgeführt) und run (Überprüfung früherer Ausführungen). Was ein Auswertungssatz tatsächlich enthält, erfahren Sie unter uip eval eval-set.

Jeder Zeitplan gehört zu einem Prozess (--process-key) und führt einen Auswertungssatz (--eval-set-id) für einen UTC-CRON-Ausdruck mit fünf Feldern aus.

Zusammenfassung

uip eval schedule create  --process-key <guid> --eval-set-id <guid> --cron <expr> [--workload-id <guid>] [--folder-key <guid>] [--tenant <tenant>]
uip eval schedule list    --process-key <guid> [--tenant <tenant>]
uip eval schedule get     <schedule-id> --process-key <guid> [--tenant <tenant>]
uip eval schedule update  <schedule-id> --process-key <guid> [--eval-set-id <guid>] [--cron <expr>] [--tenant <tenant>]
uip eval schedule pause   <schedule-id> --process-key <guid> [--tenant <tenant>]
uip eval schedule resume  <schedule-id> --process-key <guid> [--tenant <tenant>]
uip eval schedule delete  <schedule-id> --process-key <guid> [--tenant <tenant>]

Verben

Verb	Zweck
create	Erstellen Sie einen neuen wiederkehrenden Zeitplan für einen Prozess.
list	Listen Sie jeden Zeitplan für einen Prozess auf.
get	Rufen Sie einen Zeitplan nach ID ab.
update	Auswertungssatz und/oder CRON-Ausdruck eines Zeitplans ändern.
pause	Einen aktiven Zeitplan anhalten.
resume	Setzen Sie einen angehaltenen Zeitplan fort.
delete	Löschen eines Zeitplans.

UIP-Auswertungszeitplan erstellen

Erstellen Sie einen Zeitplan, der einen Auswertungssatz für einen Prozess mit einem wiederkehrenden UTC-CRON-Trigger ausführt.

Wenn --workload-id oder --folder-key weggelassen werden, sucht der Befehl zuerst den Auswertungssatz (GET .../evalSets/<eval-set-id>) und füllt beide damit aus – Sie müssen sie nur explizit übergeben, um diese Auflösung zu überschreiben.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel (Bereitstellungs-GUID) – identifiziert die Orchestrator-Version.
–	--workload-id	GUID	aus Auswertungssatz gelöst	Workload-ID.
–	--eval-set-id	GUID	–	Erforderlich. Auswertung, die für jeden Trigger ausgeführt werden soll.
–	--cron	CRON-Ausdruck	–	Erforderlich. CRON-Ausdruck mit fünf Feldern, ausgewertet in UTC (z. B. "0 9 * * *" für täglich um 9 Uhr UTC).
–	--folder-key	GUID	aus Auswertungssatz gelöst	Orchestrator-Ordnerschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten. Einfache Option, nicht veraltet.

Beispiele

# Daily at 9 AM UTC
uip eval schedule create --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 \
  --eval-set-id f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04 --cron "0 9 * * *"

Datenform (--output json)

{
  "Code": "EvalScheduleCreated",
  "Data": {
    "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
    "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
    "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "CronExpression": "0 9 * * *",
    "Status": "active",
    "CreatedAt": "2025-04-15T10:29:55Z"
  }
}

UpdatedAt ist nur vorhanden, wenn ein Zeitplan mindestens einmal geändert wurde (abwesend für eine neue create -Antwort).

Zeitplanliste für die UIP-Auswertung

Listen Sie jeden für einen Prozess registrierten Zeitplan auf.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule list --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalScheduleList",
  "Data": [
    {
      "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
      "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
      "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
      "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
      "CronExpression": "0 9 * * *",
      "Status": "active",
      "CreatedAt": "2025-04-15T10:29:55Z"
    }
  ]
}

Abrufen des UIP-Auswertungszeitplans

Rufen Sie einen Zeitplan nach ID ab.

Argumente

Name	Erforderlich	Zweck
<schedule-id>	ja	Zeitplan-GUID von create oder list.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule get b2c3d4e5-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalScheduleDetails",
  "Data": {
    "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
    "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
    "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "CronExpression": "0 9 * * *",
    "Status": "active",
    "CreatedAt": "2025-04-15T10:29:55Z"
  }
}

Aktualisierung des UIP-Evaluierungszeitplans

Auswertungssatz und/oder CRON-Ausdruck eines Zeitplans ändern. Mindestens eines von --eval-set-id/--cron ist erforderlich – das Übergeben von beiden schlägt auf Clientseite vor einem Netzwerkaufruf fehl.

Argumente

Name	Erforderlich	Zweck
<schedule-id>	ja	Aktualisierung planen.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--eval-set-id	GUID	–	Neuer Auswertungssatz. Mindestens eines davon oder --cron ist erforderlich.
–	--cron	CRON-Ausdruck	–	Neuer CRON-Ausdruck mit fünf Feldern, UTC. Mindestens eines davon oder --eval-set-id ist erforderlich.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule update b2c3d4e5-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09 --cron "0 */6 * * *"

Datenform (--output json)

{
  "Code": "EvalScheduleUpdated",
  "Data": {
    "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
    "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
    "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "CronExpression": "0 */6 * * *",
    "Status": "active",
    "CreatedAt": "2025-04-15T10:29:55Z",
    "UpdatedAt": "2025-04-16T08:00:00Z"
  }
}

Das Auslassen von --eval-set-id sowie --cron schlägt mit Folgendem fehl:

{
  "Result": "Failure",
  "Message": "At least one of --eval-set-id or --cron must be provided.",
  "Instructions": "Provide the field(s) you want to update."
}

Pause des UIP-Auswertungszeitplans

Einen aktiven Zeitplan anhalten – keine weiteren Ausführungen bis resume.

Argumente

Name	Erforderlich	Zweck
<schedule-id>	ja	Anhalten planen.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule pause b2c3d4e5-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalSchedulePaused",
  "Data": {
    "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
    "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
    "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "CronExpression": "0 9 * * *",
    "Status": "paused",
    "CreatedAt": "2025-04-15T10:29:55Z"
  }
}

Fortsetzen des UIP-Auswertungszeitplans

Setzen Sie einen angehaltenen Zeitplan fort.

Argumente

Name	Erforderlich	Zweck
<schedule-id>	ja	Fortsetzen planen.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule resume b2c3d4e5-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalScheduleResumed",
  "Data": {
    "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001",
    "WorkloadId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProcessKey": "9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09",
    "FolderKey": "a9f3b2c1-7d4e-4a8b-9c2f-5e1d3b6a8f7e",
    "EvalSetId": "f3a7d219-8b4c-4e62-a951-7d3f6e2c8b04",
    "CronExpression": "0 9 * * *",
    "Status": "active",
    "CreatedAt": "2025-04-15T10:29:55Z"
  }
}

Löschen des UIP-Auswertungszeitplans

Einen Zeitplan endgültig löschen.

Argumente

Name	Erforderlich	Zweck
<schedule-id>	ja	Zu löschender Zeitplan.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--process-key	GUID	–	Erforderlich. Prozessschlüssel.
–	--tenant	name	Sitzungsstandard	Name des UiPath-Mandanten.

Beispiele

uip eval schedule delete b2c3d4e5-0000-0000-0000-000000000001 \
  --process-key 9e4b2f17-7c3a-4d81-b592-3f6e8a1d5c09

Datenform (--output json)

{
  "Code": "EvalScheduleDeleted",
  "Data": { "ScheduleId": "b2c3d4e5-0000-0000-0000-000000000001" }
}

Zugehörige Befehle

• uip eval – Übersicht, execute-and-evaluate und run.
• uip eval evaluator – Definieren Sie die Auswerter, die der Auswertungssatz eines Zeitplans verwenden kann.
• uip eval eval-set / evaluation – Definieren, was für ein Zeitplan tatsächlich ausgeführt wird.

Siehe auch

• uip or Übersicht – gemeinsame Konventionen für jedes uip or -Verb.
• Globale Optionen
• Exitcodes