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 verwaltet die Automatisierungspakete (.nupkg Artefakte), die in einen Orchestrator-Feed hochgeladen werden. list, get und entry-points haben einen Mandanten-Scope und benötigen keinen Ordnerkontext; versions, upload und download akzeptieren zusätzlich --folder-path/--folder-key, um einen Ordner-Scope-Feed anstelle des Mandanten-Feeds anzuvisieren. Verwenden Sie uip or processes , um ein Paket als ausführbaren Prozess an einen Ordner zu binden. Pakete gepackt mit --output-type Library gehören stattdessen zu uip or libraries .

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	Eine Paketversion aus dem Feed löschen.
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	Zielen Sie auf einen ordnerbezogenen Feed nach Pfad anstelle des Mandantenfeeds.
–	--folder-key	GUID	Mandanten-Feed	Zielen Sie auf einen ordnerbezogenen Feed nach Schlüssel anstelle des Mandantenfeeds.
–	--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

Laden Sie ein .nupkg -Prozesspaket in den Feed hoch. Binden Sie es nach dem Hochladen mit uip or processes create an einen Ordner. Ein Paket mit --output-type Library wird vor dem Upload abgelehnt – verwenden Sie uip or libraries upload oder --force , um es trotzdem in den Prozessfeed zu stellen.

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	Laden Sie in einen ordnerbezogenen Feed nach Pfad anstelle des Mandantenfeeds hoch.
–	--folder-key	GUID	Mandanten-Feed	Hochladen in einen ordnerbezogenen Feed nach Schlüssel anstelle des Mandantenfeeds.
–	--force	Markieren	false	Laden Sie trotzdem ein Bibliothekspaket in den Prozessfeed hoch.

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 oder Pakete löschen

Eine Paketversion aus dem Orchestrator-Prozessfeed löschen. Das Löschen eines Pakets, an das ein Prozess gebunden ist, lässt diesen Prozess ohne eine auszuführende Version zurück.

Argumente

Name	Erforderlich	Zweck
<key>	ja	Paketversionsschlüssel (Format PackageId:Version, z. B. MyProcess:1.0.0). Verwenden Sie packages list oder packages versions für die Suche.

Optionen

Short	Long	Wert	Standard	Beschreibung
–	--feed-id	GUID	Mandanten-Feed	Aus einem bestimmten Feed löschen.
–	--folder-path	Pfad	Mandanten-Feed	Löschen Sie aus einem ordnerbezogenen Feed nach Pfad anstelle des Mandantenfeeds.
–	--folder-key	GUID	Mandanten-Feed	Löschen Sie aus einem ordnerbezogenen Feed anhand des Schlüssels anstelle des Mandantenfeeds.
-y	--yes	Markieren	–	Erforderlich. Bestätigen Sie diesen nicht rückgängig zu machenden Vorgang – die CLI fordert Sie nie auf.

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 ist immer vorhanden – eine leere Zeichenfolge bedeutet den Mandantenfeed. Bei einer Löschung im Ordnerbereich werden FolderKey und FolderPath zu Data hinzugefügt.

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	Zielen Sie auf einen ordnerbezogenen Feed nach Pfad anstelle des Mandantenfeeds.
–	--folder-key	GUID	Mandanten-Feed	Zielen Sie auf einen ordnerbezogenen Feed nach Schlüssel anstelle des Mandantenfeeds.
-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.