UiPath-Lösungspaket

Die UiPath Solution Pack-Aufgabe verpackt eine vorhandene archivierte UiPath-Lösungsdatei in ein bereitzustellendes Paket, das in die Lösungsverwaltung im Orchestrator hochgeladen werden kann.

Hinweis:

Lösungen werden derzeit nur in der Automation Cloud unterstützt. Die Unterstützung der Automation Suite ist für eine zukünftige Version geplant. Der lokale Orchestrator (MSI) unterstützt keine Lösungen.

Hinweis:

Diese Aufgabe ist nur mit UiPath.CLI.Windows oder UiPath.CLI.Linux von mindestens Version 25.10 oder höher kompatibel.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben des UiPath Solution Pack zu konfigurieren.

Parameter	Beschreibung
Lösungspfad (Erforderlich)	Der lokale Pfad der Lösung. Dies kann ein direkter Pfad zu einer solution.uipx-Datei oder einem Lösungsverzeichnis sein.
Version (erforderlich)	Das Festlegen der Lösungspaketversion bietet die Möglichkeit, die erstellten Pakete und deren Quellversion effizienter nachzuverfolgen. Beispielsweise kann das Microsoft-Assemblymuster verwendet werden, um die NuGet-Paketversion zu erstellen: [Hauptversion].[Nebenversion].[Buildnummer].[Revisionsnummer]
Ausgabepfad (Erforderlich)	Pfad zu einem Ordner, in dem das erstellte Paket platziert werden soll.Standard: $(Build.ArtifactStagingDirectory)\Output
Deaktivieren Sie integrierte NuGet-Feeds	Integrierte NuGet-Feeds deaktivieren Standard: false
Versionsinformationen des Quellcodes und URL der Automation Hub-Idee	Aktivieren Sie Paketmetadaten, einschließlich Versionsinformationen zum Quellcode und der URL der Automation Hub-Idee. Standard: false
Der vollständige Pfad zu project.json im Remote-Repository	Der vollständige Pfad zu project.json im Remote-Repository. Nur sichtbar, wenn Paketmetadaten aktiviert sind.
Die Commit-ID	Die Commit-ID für die Nachverfolgung des Quellcodes. Nur sichtbar, wenn Paketmetadaten aktiviert sind.
Die Repository-Verzweigung	Die Repository-Verzweigung für die Nachverfolgung des Quellcodes. Nur sichtbar, wenn Paketmetadaten aktiviert sind.
Der Typ des Repositorys (z. B.: GIT)	Der Typ des Repositorys (z. B.: git). Nur sichtbar, wenn Paketmetadaten aktiviert sind.
URL der Automation Hub-Idee	Automation Hub-Ideen-URL zur Verknüpfung zur ursprünglichen Automatisierungsidee. Nur sichtbar, wenn Paketmetadaten aktiviert sind.
Versionshinweise	Versionshinweise für die Paketversion. Nur sichtbar, wenn Paketmetadaten aktiviert sind.
Orchestrator-Verbindung	Eine Dienstverbindung mit einer Orchestrator-Instanz, die über Feedabhängigkeiten von den zu packenden Projekten verfügt. Wird in der Regel zum Packen von Bibliotheken verwendet. Die Orchestrator-Version muss mindestens 20.4 sein.
Workflow-Analyse ausführen	Die Workflow-Analyse wird vor dem Packen ausgeführt und schlägt fehl, wenn Fehler vorhanden sind. Standard: false
Pfad der Governance-Datei	Übergeben Sie Governance-Richtlinien, die die Workflow-Analyse-Regeln enthalten. Richtlinien können von Automation Ops heruntergeladen oder aus der exportierten komprimierten ZIP-Datei von Studio extrahiert werden. Weitere Informationen finden Sie in der Dokumentation. Nur sichtbar, wenn die Workflow-Analyse aktiviert ist.
Ablaufverfolgungsstufe	Die Protokollierungsstufe der Ablaufverfolgung. Standard: Error. Optionen: None, Critical, Error, Warning, Information, Verbose

Hinweise

• Lösungsverpackung: Diese Aufgabe erstellt bereitstellbare Pakete aus UiPath-Lösungen, die in die Lösungsverwaltung im Orchestrator hochgeladen werden können.
• Versionsanforderung: Im Gegensatz zu eigenständigen Projekten erfordern Lösungen eine explizite Versionsspezifikation mittels semantischer Versionierung.
• Orchestrator-Abhängigkeiten: Konfigurieren Sie beim Packen von Bibliotheken oder Projekten mit Abhängigkeiten aus Orchestrator-Feeds den Orchestrator-Verbindungsparameter.
• Workflow-Analyse: Aktivieren Sie die Workflow-Analyse, um Ihre Lösung vor dem Packen anhand von Governance-Richtlinien zu validieren.
• Metadatennachverfolgung: Aktivieren Sie Paketmetadaten, um Quellcodeinformationen und Links zu Automation Hub-Ideen für eine bessere Rückverfolgbarkeit zu enthalten.
• Ausgabeformat: Die Aufgabe erstellt eine verpackte Lösungsdatei im angegebenen Ausgabeverzeichnis mit dem Namensmuster: {SolutionName}.{Version}.zip.
• CLI-Kompatibilität: Diese Aufgabe verwendet intern die UiPath-CLI und erfordert eine ordnungsgemäße CLI-Installation auf dem Build-Agenten.
• Mindest-CLI-Version: Erfordert die UiPath-CLI-Version 25.10 oder höher für vollständige Kompatibilität.

Pipelinebeispiele

Verpackung der Standardlösung

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MySolution'
    version: '1.0.$(Build.BuildId)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Output'
    traceLevel: 'Information'

Mit Orchestrator-Verbindung

- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Orchestrator Dependencies'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyLibrarySolution'
    version: '2.1.$(Build.BuildNumber)'
    outputPath: '$(Build.ArtifactStagingDirectory)/Packages'
    orchestratorConnection: 'UiPath-Orchestrator-Connection'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/policies.json'
    traceLevel: 'Verbose'

Vollständige Pipeline mit Metadaten und Governance

variables:
  solutionVersion: '1.$(Date:yyyy).$(DayOfYear)$(Rev:.r)'

steps:
- task: UiPathSolutionPack@6
  displayName: 'Pack Solution with Full Metadata'
  inputs:
    solutionPath: '$(Build.SourcesDirectory)/MyBusinessSolution'
    version: '$(solutionVersion)'
    outputPath: '$(Build.ArtifactStagingDirectory)'
    disableBuiltInNugetFeeds: false
    enablePackageMetadata: true
    repositoryUrl: '$(Build.Repository.Uri)/$(Build.SourcesDirectory)/MyBusinessSolution/project.json'
    repositoryCommit: '$(Build.SourceVersion)'
    repositoryBranch: '$(Build.SourceBranchName)'
    repositoryType: 'git'
    projectUrl: 'https://cloud.uipath.com/automationhub/idea/12345'
    releaseNotes: 'Automated build $(Build.BuildNumber) - Added new features and bug fixes'
    orchestratorConnection: 'Production-Orchestrator'
    runWorkflowAnalysis: true
    governanceFilePath: '$(Build.SourcesDirectory)/governance/workflow-analyzer-rules.json'
    traceLevel: 'Information'

- task: PublishBuildArtifacts@1
  displayName: 'Publish Solution Package'
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: 'SolutionPackage'