UIP-Lösung hochladen

Syntax und Optionen für „uip solution Upload“, der eine lokale Lösung bündelt und zur browserbasierten Bearbeitung an Studio Web sendet.

uip solution upload lädt eine lokale Lösung für die browserbasierte Bearbeitung in UiPath Studio Web hoch. Es bündelt die Lösung in einem internen .uis -Archiv, sendet sie an Studio Web und gibt (bei Erfolg) eine URL aus, die Sie direkt im Designer öffnen können.

Im Gegensatz zu uip solution pack + uip solution publish, die ein einsetzbares .zip für Orchestrator erzeugen, ist upload auf die interaktive Erstellungsoberfläche von Studio Web ausgerichtet. Verwenden Sie diese Option, wenn Sie die Bearbeitung einer Lösung gemeinsam im Browser fortsetzen möchten.

Overwrite or import

Before uploading, the command checks whether Studio Web holds a solution with the SolutionId from the .uipx (or from the .uis archive):

• The solution exists. It is overwritten in place. The replaced contents are first recorded as a restorable version, unless you pass --no-snapshot. Data.Action is Overwritten.
• The solution does not exist. The upload is imported as a new solution, and the ID that Studio Web assigns is written back into the local .uipx so the next upload overwrites the same solution. Data.Action is Imported.

--force skips the existence check and overwrites directly. If Studio Web has no solution with that SolutionId, the command fails with not_found and uploads nothing; re-run without --force to import as new.

Zusammenfassung

uip solution upload <solutionPath> [--force] [--no-snapshot] [--login-validity <minutes>]

Der Befehl berücksichtigt die globalen Optionen und gibt die Standardaustrittscodes zurück.

Argumente

• <solutionPath> (erforderlich) – Einer von:
  • Ein Lösungsverzeichnis, das ein .uipx -Manifest enthält (am häufigsten).
  • Eine .uipx -Datei (der Befehl löst das Verzeichnis auf, das sie enthält).
  • Eine .uis -Datei (ein vorgefertigtes Lösungsarchiv; aus Gründen der Abwärtskompatibilität hochgeladen).

Optionen

• --force — Skip the existence check and overwrite the Studio Web solution named by the bundled SolutionId directly. An upload overwrites an existing cloud solution without it. Fails if that solution does not exist. No effect when no SolutionId is bundled (a .uis archive without one): the upload imports as new.
• --no-snapshot – Zeichnen Sie keine wiederherstellbare Version der Cloud-Lösung vor dem Überschreiben auf, bevor Sie deren Inhalt ersetzen. Änderungen, die seit dem letzten Hochladen in Studio Web vorgenommen wurden, gehen verloren; lokale Dateien sind nicht betroffen. Keine Auswirkungen, wenn der Upload eine neue Lösung importiert.
• --login-validity <minutes> – Mindestens Minuten vor dem Ablauf des Tokens, um eine Aktualisierung auszulösen. Die Standardeinstellung ist 10.

Beispiele

Minimal

uip solution upload ./my-solution

Laden Sie eine bestimmte.uipx-Datei hoch

uip solution upload ./workspace/my-solution/my-solution.uipx

Überschreiben ohne wiederherstellbaren Snapshot

uip solution upload ./my-solution --no-snapshot

Skripting – Öffnen Sie die zurückgegebene Designer-URL

URL=$(uip solution upload ./my-solution --output-filter "DesignerUrl" --output plain)
open "$URL"   # macOS

Datenform (--output json)

Studio Web hat keine Lösung mit dem gebündelten SolutionId, daher wird es als neu importiert und das lokale .uipx wird mit der zugewiesenen ID aktualisiert:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Imported",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "LocalSolutionIdUpdated": {
      "Path": "/workspace/my-solution/my-solution.uipx",
      "From": "00000000-0000-0000-0000-0000000000ff",
      "To": "a1b2c3d4-0000-0000-0000-000000000001"
    },
    "Response": { }
  }
}

Die Lösung ist bereits in Studio Web vorhanden, wird also überschrieben, wobei der ersetzte Inhalt zuerst als wiederherstellbare Version aufgezeichnet wurde:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Overwritten",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "SnapshotCreated": true,
    "Response": { }
  }
}

• Action – "Imported" bei einem ersten Upload, "Overwritten" wenn eine Lösung mit diesem SolutionId bereits in Studio Web vorhanden war.
• SolutionId – die Identität, die Studio Web zugewiesen (beim ersten Upload) oder abgeglichen (beim Überschreiben) wurde. Wird auch in den lokalen .uipx zurückgeschrieben, sodass das nächste upload dieselbe Lösung aktualisiert.
• DesignerUrl – Öffnen Sie die URL für das erste Projekt in der Lösung, vorab auf die Lösung festgelegt. null/absent, wenn Studio Web keine Projekt-ID zurückgibt.
• LocalSolutionIdUpdated – Nur vorhanden, wenn ein neues SolutionId in den lokalen .uipx (Path, From, To) zurückgeschrieben wurde. Abwesend, wenn die Überschreibung vorhanden war oder wenn die Uploadquelle keine vorherige ID zum Neuschreiben hatte.
• SnapshotCreated — present and true only on an overwrite that recorded a restorable pre-overwrite version (that is, without --no-snapshot). Absent on a fresh import and with --no-snapshot.
• Response – Roh-Antwortnutzlast in Studio Web. Nützlich für das Debuggen; nicht Teil eines stabilen Vertrags.

Nebenwirkungen

• Resource preparation. For a solution directory or .uipx file, upload prepares the solution's resources the same way as uip solution pack: it syncs each project's bindings_v2.json into the solution's resource declarations, as uip solution resources refresh does, and writes what each project contributes onto its resources. An error that a project's tool reports fails the upload. A .uis file is uploaded as-is, without this step.
• SolutionId write-back. On an import, the returned solution ID replaces (or populates) the SolutionId field in the local .uipx.

Files left out of the bundle

When bundling a solution directory, upload always leaves out .venv, node_modules, __pycache__, .git, .local, and .flow-sdk folders, and dotenv files (.env, .env.local, .env.production, and similar).

To leave out more files, add a .uipignore file at the solution root, in a project folder, or both. The syntax is gitignore: one pattern per line, # for comments, globs such as *.log, anchored paths such as /dist, a trailing / for directories only, and ! to re-include. Patterns in a project's .uipignore match relative to that project folder and apply only to it. An unreadable .uipignore is skipped with a warning.

A pattern that would leave out the manifest of a project listed in the .uipx (for example *.uiproj, or the project's folder name) is refused: the command fails with invalid_argument and names the project. Remove or narrow the pattern, or remove the project from the solution with uip solution projects remove, then upload again.

Fehlermodi

• A project uses a project.json manifest that Studio Web does not accept. Refused with invalid_argument. Convert the listed project to a project.uiproj manifest before uploading. uip solution pack and uip solution publish accept project.json.
• A .uipignore pattern drops a listed project. Refused with invalid_argument, as described in Files left out of the bundle.
• --force with a SolutionId that Studio Web does not hold. Refused with not_found; nothing is uploaded.

Zugehörige Befehle

• uip solution pack + uip solution publish – Bereitstellungspipeline alternative zu upload.
• uip solution delete – Entfernen Sie eine Studio Web-Lösung durch ihre SolutionId.
• uip solution init – Erstellen Sie vor dem Hochladen ein Gerüst für eine Lösung.

Siehe auch

• Authentifizierung – upload erfordert eine aktive Sitzung.
• uip solution Übersicht.