UIP oder Pakete

Syntax und Optionen für „uip oder package“, die Automatisierungsartefakte „.nupkg“ verwalten, die in einen Orchestrator-Feed hochgeladen werden.

uip or packages manages the automation packages (.nupkg artifacts) uploaded to an Orchestrator feed. list, get, and entry-points are tenant-scoped and need no folder context; versions, upload, and download additionally accept --folder-path/--folder-key to target a folder-scoped feed instead of the tenant feed. Use uip or processes to bind a package to a folder as a runnable process. Packages packed with --output-type Library belong to uip or libraries instead.

Zusammenfassung

uip or packages <verb> [options]

Verben

Verb	Zweck
list	Listen Sie Pakete im Feed auf.
get	Eine Paketversion nach Schlüssel abrufen.
versions	Alle Versionen eines Pakets auflisten.
entry-points	Listen Sie Workflow-Einstiegspunkte (mit Eingabe-/Ausgabeschemata) für eine Paketversion auf.
upload	Laden Sie .nupkg in den Feed hoch.
delete	Delete a package version from the feed.
download	Laden Sie .nupkg aus dem Feed herunter.

UIP oder Paketliste

Listen Sie Pakete im Feed auf. Gibt den Paketversionsschlüssel (Format PackageId:Version), Titel, Version und Metadaten zurück.

Optionen

Short	Long	Wert	Standard	Beschreibung
-s	--search	text	–	Suchen Sie Pakete anhand des Namens.
–	--feed-id	GUID	Mandanten-Feed	Zielen Sie auf einen bestimmten Feed. Verwenden Sie feeds list um IDs zu erkennen.
–	--all-fields	Markieren	aus	Gibt die vollständige API-Nutzlast zurück.
-l	--limit	Nummer	50	Seitengröße.
–	--offset	Nummer	0	Anzahl der Überspringungen.
–	--sort-by	Feld	Id desc	OData-Sortierung.

Beispiele

uip or packages list
uip or packages list --search Invoice --limit 20
uip or packages list --output-filter 'Data[].{id:Id, v:Version}'

Datenform (--output json)

{
  "Code": "PackageList",
  "Data": [
    {
      "Key": "InvoiceProcessing:1.0.2",
      "Title": "InvoiceProcessing",
      "Version": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "IsActive": true,
      "PackageType": "Process",
      "TargetFramework": "Windows",
      "Authors": "Finance Team",
      "Published": "2025-04-10T08:00:00Z",
      "Id": "InvoiceProcessing"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}

UIP oder Pakete abrufen

Eine bestimmte Paketversion abrufen. Das Schlüsselformat ist PackageId:Version.

Argumente

Name	Erforderlich	Zweck
<key>	ja	Paketversionsschlüssel (z. B. MyProcess:1.0.0).

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Zielen Sie auf einen bestimmten Feed.
–	--all-fields	Markieren	aus	Gibt die vollständige API-Nutzlast zurück.

Beispiele

uip or packages get InvoiceProcessing:1.0.2
uip or packages get InvoiceProcessing:1.0.2 --all-fields
uip or packages get InvoiceProcessing:1.0.2 --output-filter 'Data.ReleaseNotes'

Datenform (--output json)

{
  "Code": "PackageGet",
  "Data": {
    "Key": "InvoiceProcessing:1.0.2",
    "Title": "InvoiceProcessing",
    "Version": "1.0.2",
    "Description": "Processes vendor invoices",
    "IsLatestVersion": true,
    "IsActive": true,
    "PackageType": "Process",
    "TargetFramework": "Windows",
    "Authors": "Finance Team",
    "Published": "2025-04-10T08:00:00Z",
    "ReleaseNotes": "Fix amount rounding bug",
    "Id": "InvoiceProcessing"
  }
}

UIP oder Paketversionen

Alle Versionen eines Pakets auflisten. Verwenden Sie dies, bevor Sie processes create --package-version aufrufen.

Argumente

Name	Erforderlich	Zweck
<package-id>	ja	Paket-ID (z. B. MyProcess).

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Zielen Sie auf einen bestimmten Feed.
–	--folder-path	Pfad	Mandanten-Feed	Target a folder-scoped feed by path instead of the tenant feed.
–	--folder-key	GUID	Mandanten-Feed	Target a folder-scoped feed by key instead of the tenant feed.
–	--all-fields	Markieren	aus	Geben Sie die vollständige API-Nutzlast anstelle der kuratierten Zusammenfassung zurück.
-l	--limit	Nummer	50	Seitengröße.
–	--offset	Nummer	0	Anzahl der Überspringungen.
–	--sort-by	Feld	Id desc	OData-Sortierung.

Beispiele

uip or packages versions InvoiceProcessing
uip or packages versions InvoiceProcessing --limit 5
uip or packages versions InvoiceProcessing \
    --output-filter 'Data[?IsLatestVersion].Version | [0]'

# From a folder-scoped feed instead of the tenant feed
uip or packages versions InvoiceProcessing --folder-path "Shared"

Datenform (--output json)

{
  "Code": "PackageVersionList",
  "Data": [
    {
      "Key": "InvoiceProcessing:1.0.2",
      "Title": "InvoiceProcessing",
      "Version": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "IsActive": true,
      "PackageType": "Process",
      "TargetFramework": "Windows",
      "Authors": "Finance Team",
      "Published": "2025-04-10T08:00:00Z",
      "Id": "InvoiceProcessing"
    }
  ]
}

UIP oder Paketeinstiegspunkte

Listen Sie Workflow-Einstiegspunkte für eine Paketversion auf, einschließlich Schemas für Eingabe-/Ausgabeargumente. Verwenden Sie den Einstiegspunktpfad mit processes create --entry-point für Pakete mit mehreren Einstiegspunkten.

Argumente

Name	Erforderlich	Zweck
<key>	ja	Paketversionsschlüssel (z. B. MyProcess:1.0.0).

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Zielen Sie auf einen bestimmten Feed.

Beispiele

uip or packages entry-points InvoiceProcessing:1.0.2
uip or packages entry-points InvoiceProcessing:1.0.2 \
    --output-filter 'Data[].Path'
uip or packages entry-points InvoiceProcessing:1.0.2 --output table

Datenform (--output json)

{
  "Code": "PackageEntryPoints",
  "Data": [
    {
      "UniqueId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Path": "Main.xaml",
      "DisplayName": "Main",
      "InputArguments": "{\"invoicePath\":\"String\"}",
      "OutputArguments": "{\"result\":\"String\"}"
    }
  ]
}

UIP oder Pakete werden hochgeladen

Upload a process .nupkg package to the feed. After upload, bind it to a folder with uip or processes create. A package packed with --output-type Library is rejected before upload — use uip or libraries upload, or --force to put it in the processes feed anyway.

Argumente

Name	Erforderlich	Zweck
<file>	ja	Der Pfad zur .nupkg-Datei.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	In einen bestimmten Feed hochladen.
–	--folder-path	Pfad	Mandanten-Feed	Upload to a folder-scoped feed by path instead of the tenant feed.
–	--folder-key	GUID	Mandanten-Feed	Upload to a folder-scoped feed by key instead of the tenant feed.
–	--force	Markieren	false	Upload a library package to the processes feed anyway.

Beispiele

uip or packages upload ./InvoiceProcessing.1.0.3.nupkg
uip or packages upload ./dist/MyProcess.2.0.0.nupkg --feed-id a1b2c3d4-0000-0000-0000-000000000001
uip or packages upload ./InvoiceProcessing.1.0.3.nupkg --output-filter 'Data[0].body'

# Upload to a folder-scoped feed instead of the tenant feed
uip or packages upload ./InvoiceProcessing.1.0.3.nupkg --folder-path "Shared"

Datenform (--output json)

{
  "Code": "PackageUploaded",
  "Data": [
    {
      "key": "InvoiceProcessing.1.0.3.nupkg",
      "status": "Created",
      "body": "InvoiceProcessing:1.0.3"
    }
  ]
}

uip or packages delete

Delete a package version from the Orchestrator processes feed. Deleting a package a process is bound to leaves that process without a version to run.

Argumente

Name	Erforderlich	Zweck
<key>	ja	Package version key (format PackageId:Version, for example MyProcess:1.0.0). Use packages list or packages versions to find it.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Delete from a specific feed.
–	--folder-path	Pfad	Mandanten-Feed	Delete from a folder-scoped feed by path instead of the tenant feed.
–	--folder-key	GUID	Mandanten-Feed	Delete from a folder-scoped feed by key instead of the tenant feed.
-y	--yes	Markieren	–	Required. Confirm this irreversible operation — the CLI never prompts.

Beispiele

uip or packages delete InvoiceProcessing:1.0.3 --yes

Datenform (--output json)

{
  "Code": "PackageDeleted",
  "Data": {
    "Key": "InvoiceProcessing:1.0.3",
    "FeedId": "",
    "Status": "Package deleted"
  }
}

FeedId is always present — an empty string means the tenant feed. A folder-scoped delete adds FolderKey and FolderPath to Data.

UIP oder Pakete herunterladen

Laden Sie .nupkg aus dem Feed herunter. Erfordert --destination.

Argumente

Name	Erforderlich	Zweck
<key>	ja	Paketversionsschlüssel (z. B. MyProcess:1.0.0).

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Zielen Sie auf einen bestimmten Feed.
–	--folder-path	Pfad	Mandanten-Feed	Target a folder-scoped feed by path instead of the tenant feed.
–	--folder-key	GUID	Mandanten-Feed	Target a folder-scoped feed by key instead of the tenant feed.
-d	--destination	Pfad	erforderlich	Wo die heruntergeladene .nupkg gespeichert werden soll.

Beispiele

uip or packages download InvoiceProcessing:1.0.2 \
    --destination ./InvoiceProcessing.1.0.2.nupkg

uip or packages download InvoiceProcessing:1.0.2 -d /tmp/ip.nupkg \
    --feed-id a1b2c3d4-0000-0000-0000-000000000001

uip or packages download InvoiceProcessing:1.0.2 -d ./ip.nupkg \
    --output-filter 'Data.SavedTo'

Datenform (--output json)

{
  "Code": "PackageDownloaded",
  "Data": {
    "Key": "InvoiceProcessing:1.0.2",
    "SavedTo": "./InvoiceProcessing.1.0.2.nupkg",
    "Size": "512000 bytes"
  }
}

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip or processes – Binden Sie ein Paket als Prozess an einen Ordner.
• uip or feeds – Verfügbare Feed-IDs erkennen.
• uip or jobs – insbesondere jobs start, das den Prozessschlüssel (nicht den Paketschlüssel) von processes list verwendet.

Siehe auch

• Globale Optionen.