UIP-Lösungsprojekte

Syntax und Optionen für „UIP-Lösungsprojekte“, das die in einem „.uipx“-Lösungsmanifest aufgeführten Projekte sowie die Veröffentlichung und Synchronisierung von Cloud-Projekten verwaltet.

uip solution projects verwaltet die in einem .uipx -Lösungsmanifest aufgeführten Projekte – RPA-Prozesse, Tests, Agents, Maestro-Flows, Fall- und BPMN-Projekte, codierte Apps, Funktionen, API-Workflows und andere buildbare Projekttypen. Eine Bibliothek ist kein Projekt – veröffentlichen Sie sie eigenständig und fügen Sie sie dann mit uip solution resources add --source remote --kind Library hinzu.

Hinweis:

Diese Gruppe wurde zuvor als project (Singular) dokumentiert. Die Singularform funktioniert weiterhin – sie wird als ausgeblendeter, veralteter Alias für die Rückkompatibilität registriert – aber projects ist in Zukunft kanonisch.

Unterbefehl	Zweck
add	Registrieren Sie einen Projektordner, der sich bereits im Lösungsverzeichnis befindet.
import	Kopieren Sie einen externen Projektordner in das Lösungsverzeichnis und registrieren Sie ihn dann.
remove	Die Registrierung eines Projekts bei .uipx aufheben (löscht keine Dateien auf der Festplatte).
list	Listen Sie die in der lokalen .uipx registrierten Projekte auf.
publish	Veröffentlichen Sie ein Cloud- Lösungsprojekt als Lösungspaket.
resync	Synchronisieren oder Zurücksetzen eines Cloud -Lösungsprojekts.

add, import, remove und list arbeiten nur mit lokalen Dateien – keine Authentifizierung erforderlich. publish und resync arbeiten mit einem Cloud-Lösungsprojekt und erfordern eine aktive Sitzung.

Zusammenfassung

uip solution projects add <project-path> [solutionFile]
uip solution projects import <source> [--solutionFile <path>]
uip solution projects remove <project-path> [solutionFile]
uip solution projects list [--solution-folder <path>]
uip solution projects publish --project-name <name> --package-name <name> --package-version <version> [--folder-name <name>] [--description <text>] [--release-notes <text>] [-t <tenant-name>]
uip solution projects resync [project-name] [--project-name <name>] [--sync-option <Sync|Reset>] [-t <tenant-name>]

Jeder Unterbefehl berücksichtigt die globalen Optionen und gibt die Standardaustrittscodes zurück.

Allgemeines Verhalten (hinzufügen/importieren/entfernen)

• Der Zielprojektordner muss einen project.uiproj, Legacy- project.json oder uipath.json -Deskriptor enthalten. Der Befehl erkennt automatisch, welcher.
• Wenn [solutionFile] weggelassen wird, sucht der Befehl vom Projektpfad (oder dem aktuellen Verzeichnis nach import) nach oben für das nächste .uipx. Wenn keine gefunden wird oder wenn sich mehrere .uipx -Dateien im selben Ordner befinden, schlägt der Befehl fehl und wird mit 1 beendet.
• Für jeden Projekteintrag, der dem Manifest hinzugefügt wird, wird eine eindeutige Id (UUID) generiert.

---

Hinzufügen

Registrieren Sie einen Projektordner, der sich bereits im Lösungsverzeichnis befindet . Der relative Pfad des Projektordners wird in .uipx aufgezeichnet, und ein übereinstimmender Eintrag wird im internen Ressourcengenerator der Lösung bereitgestellt.

Argumente

• <project-path> (erforderlich) – Der Pfad zum Projektordner. Muss project.uiproj, project.json oder uipath.json enthalten.
• [solutionFile] (optional) – Der Pfad zum .uipx -Lösungsmanifest. Wenn keine Angabe erfolgt, müssen Sie den nächsten .uipx zu Beginn von <project-path> nach oben finden.

Beispiele

uip solution projects add ./my-solution/my-project ./my-solution/my-solution.uipx

# Auto-detect the .uipx
uip solution projects add ./my-solution/my-project

Datenform (--output json)

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi

• Das Projekt befindet sich außerhalb des Lösungsordners. Der Befehl verweigert das Hinzufügen mit einem Verweis auf projects import, wodurch externe Projekte in kopiert werden.
• Projekt ist bereits registriert. Wird mit 1 und einer Meldung beendet, die den vorhandenen Projektpfad benennt.

---

import

Kopieren Sie einen externen Projektordner in das Lösungsverzeichnis (unter Beibehaltung des Ordnernamens) und registrieren Sie ihn dann im .uipx. Verwenden Sie dies, wenn sich das Projekt, das Sie einschließen möchten, noch nicht unter dem Lösungsstamm befindet.

Argumente

• <source> (erforderlich) – Der Pfad zum externen Projektordner, der importiert werden soll. Muss ein Verzeichnis sein, das project.uiproj, project.json oder uipath.json enthält. Dies ist ein Positionsargument, kein Flag – frühere Dokumente auf dieser Seite zeigten es als --source <path> an, was falsch ist.

Optionen

Long	Wert	Standard	Beschreibung
--solutionFile	Pfad	nächste .uipx über dem aktuellen Verzeichnis	Pfad zum .uipx -Lösungsmanifest.

Beispiele

uip solution projects import ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

# From inside the solution directory (auto-detect .uipx)
cd ./my-solution
uip solution projects import ../shared-library

Datenform (--output json)

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi und Rollback

• Zielordner ist bereits vorhanden. Der Befehl kann nicht überschrieben werden; Benennen Sie den Quellordner um oder entfernen Sie zuerst das vorhandene Ziel.
• Projekt bereits im .uipx -Manifest. Abgelehnt, bevor Dateien kopiert werden.
• Kopier-, Schreib- oder Erstellungsschritt schlägt fehl. Der Befehl läuft zurück – das kopierte Verzeichnis wird entfernt und der .uipx wird in seinem ursprünglichen Inhalt wiederhergestellt.

---

remove

Heben Sie die Registrierung eines Projekts beim .uipx -Lösungsmanifest auf und entfernen Sie seinen Eintrag aus dem internen Ressourcengenerator. Dateien auf der Festplatte werden nicht gelöscht. Verweigert das Entfernen des letzten Projekts in einer Lösung (ein leeres Projects[] ist erst sofort nach init gültig) – Die einzige Ausnahme ist ein Projekt eines nicht unterstützten Typs, das jederzeit entfernt werden kann, um die Blockierung pack aufzuheben.

Argumente

• <project-path> (erforderlich) – Der Pfad zum zu entfernenden Projektordner. Muss derzeit in .uipx registriert sein.
• [solutionFile] (optional) – Der Pfad zum .uipx -Lösungsmanifest. Standardmäßig wird der nächste .uipx verwendet, der gefunden wird, wenn Sie von <project-path> nach oben gehen.

Beispiele

uip solution projects remove ./my-solution/my-project ./my-solution/my-solution.uipx

Datenform (--output json)

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Fehlermodi

• Das Projekt befindet sich außerhalb des Lösungsordners. Der relative Pfad darf nicht mit .. beginnen.
• Das Projekt befindet sich nicht im Manifest. Beendet mit 1 und dem relativen Pfad, der für die Suche verwendet wird.
• Das Projekt ist das einzige, das in der Lösung noch übrig ist. Abgelehnt, es sei denn, es handelt sich um einen nicht unterstützten Projekttyp.

---

Liste

Listen Sie die Projekte auf, die im Manifest der lokalen Lösung .uipx registriert sind. Liest nur Metadaten auf der Festplatte – kein Backend-Aufruf.

Optionen

Long	Wert	Standard	Beschreibung
--solution-folder	Pfad	aktuelles Verzeichnis	Pfad zum Lösungsstammordner.

Beispiele

uip solution projects list

Datenform (--output json)

{
  "Code": "SolutionProjectsList",
  "Data": [
    {
      "Name": "MyProject",
      "Type": "Process",
      "Id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "ProjectRelativePath": "MyProject/project.uiproj",
      "ProjectFilePath": "/workspace/my-solution/MyProject/project.uiproj"
    }
  ]
}

---

Veröffentlichen

Veröffentlichen Sie ein Cloud -Lösungsprojekt (eines bereits in der Automation Cloud, kein lokales .uipx -Projekt) als Lösungspaket und warten Sie, bis der Veröffentlichungsvorgang abgeschlossen ist.

Optionen

Long	Wert	Standard	Beschreibung
--project-name	text	–	Erforderlich. Name des Cloud-Lösungsprojekts, das veröffentlicht werden soll.
--package-name	text	–	Erforderlich. Name des zu erstellenden Lösungspakets.
--package-version	text	–	Erforderlich. Version des zu erstellenden Lösungspakets.
--folder-name	text	–	Name des Stammordners, der im Lösungspaket gespeichert werden soll.
--description	text	–	Beschreibung des Lösungspakets.
--release-notes	text	–	Versionshinweise zum Lösungspaket.
-t, --tenant	name	Sitzungsstandard	hinzugefügt.
--timeout	Sekunden	360	Timeout bei Veröffentlichung und Abfrage.
--poll-interval	ms	5000	Millisekunden zwischen Abfragen zum Veröffentlichungsstatus.
--login-validity	Minuten	10	Mindestens Minuten vor dem Tokenablauf, um eine Aktualisierung auszulösen.

Beispiele

uip solution projects publish --project-name MyProject \
  --package-name my-package --package-version 1.0.0 \
  --folder-name MySolution

Datenform (--output json)

{
  "Code": "SolutionProjectPublish",
  "Data": {
    "ProjectName": "MyProject",
    "PackageName": "my-package",
    "PackageVersion": "1.0.0",
    "Status": "Completed"
  }
}

---

erneut synchronisieren

Synchronisieren oder setzen Sie ein Cloud -Lösungsprojekt zurück und warten Sie, bis der Vorgang abgeschlossen ist. Sync gleicht das Projekt mit seiner Quelle ab; Reset verwirft lokale Cloud-Änderungen.

Argumente

• [project-name] (optional) – Name des zu synchronisierenden Cloud-Lösungsprojekts. Kann auch mit --project-name bereitgestellt werden; Es ist ein Fehler, wenn beide mit unterschiedlichen Werten angegeben werden.

Optionen

Long	Wert	Standard	Beschreibung
--project-name	text	–	Name des zu synchronisierenden Cloud-Lösungsprojekts (Alternative zum Positionsargument).
--sync-option	Sync | Reset	Sync	Welcher Synchronisierungsvorgang ausgeführt werden soll.
-t, --tenant	name	Sitzungsstandard	hinzugefügt.
--timeout	Sekunden	360	Timeout bei der Synchronisierung von Abrufen.
--poll-interval	ms	5000	Millisekunden zwischen Abfragen des Synchronisierungsstatus.
--login-validity	Minuten	10	Mindestens Minuten vor dem Tokenablauf, um eine Aktualisierung auszulösen.

Beispiele

uip solution projects resync --project-name MyProject --sync-option Sync

# Positional form, reset instead of sync
uip solution projects resync MyProject --sync-option Reset

Datenform (--output json)

{
  "Code": "SolutionProjectResync",
  "Data": {
    "ProjectName": "MyProject",
    "Status": "Successful",
    "SyncOption": "Sync",
    "SyncErrors": []
  }
}

Bei einem Fehler listet Instructions jeden Synchronisierungsfehler nach Dienstname und den betroffenen Ressourcenschlüsseln auf.

---

Zugehörige Befehle

• uip solution init – Erstellen Sie ein Gerüst für die Lösung, bevor Sie Projekte hinzufügen.
• uip solution resources refresh – Synchronisierung von Ressourcen nach der Bearbeitung von Projektbindungen erneut.
• uip solution pack – Verpacken der Lösung, sobald ihre Projektliste finalisiert ist.

Siehe auch

• Ihre erste Pipeline – End-to-End-Beispiel.
• uip solution Übersicht.