Téléchargement de la solution UIP

Syntaxe et options pour `uip solution upload`, qui regroupe une solution locale et l'envoie à Studio Web pour une modification basée sur le navigateur.

uip solution upload charge une solution locale dans UiPath Studio Web pour la modification basée sur le navigateur. Elle regroupe la solution dans une archive .uis interne, l'envoie à Studio Web et imprime une URL que vous pouvez ouvrir directement dans le concepteur.

Contrairement à uip solution pack + uip solution publish, qui produisent un .zip déployable pour Orchestrator, upload cible l'interface de création interactive de Studio Web . Utilisez cette option lorsque vous souhaitez continuer à modifier une solution de manière collaborative dans le navigateur.

Si la solution existe déjà sur Studio Web (correspondant au SolutionId à l’intérieur de son .uipx), téléchargement écrase la copie existante; dans le cas contraire, il est importé en tant que nouvelle solution et l'ID renvoyé est réécrit dans le fichier .uipx local, de façon à ce que les téléchargements ultérieurs soient mis à jour en place.

Synthèse

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

La commande respecte les options globales et renvoie les codes de sortie standard.

Arguments

• <solutionPath> (requis) : l’un des suivants:
  • Un répertoire de solution contenant un manifeste .uipx (le plus courant).
  • Un fichier.uipx (la commande résout le répertoire qui le contient).
  • Un fichier.uis (une archive de solution pré-groupée; téléchargé tel quel à des fins de rétrocompatibilité).

Options

• --force — Ignorez la vérification de l'existence et écrasez directement la solution Studio Web nommée par le bundle SolutionId. Pas normalement nécessaire - un téléchargement écrase une solution cloud existante par elle-même. Échoue si cette solution n’existe pas. Aucun effet lorsqu'aucune SolutionId n'est groupée (une archive .uis sans une): le téléchargement est importé en tant que nouveau.
• --no-snapshot — N'enregistrez pas une version pré-écrasement restaurable de la solution cloud avant de remplacer son contenu. Les modifications apportées dans Studio Web depuis le dernier chargement sont perdues; les fichiers locaux ne sont pas affectés. Aucun effet lorsque le téléchargement importe une nouvelle solution.
• --login-validity <minutes> — Nombre minimum de minutes avant l'expiration du jeton pour déclencher une actualisation. La valeur par défaut est 10.

Exemples

Minimum

uip solution upload ./my-solution

Charger un fichier.uipx spécifique

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

Écraser sans instantané récupérable

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

Scripting — ouvre l'URL du concepteur renvoyée

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

Format des données (--sortie json)

Studio Web n’a pas de solution avec le SolutionId groupé, il est donc importé en tant que nouveau et le .uipx local est mis à jour avec l’ID attribué:

{
  "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": { }
  }
}

La solution existe déjà sur Studio Web. Elle est donc écrasée en place, le contenu remplacé étant d’abord enregistré en tant que version restaurable:

{
  "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" lors d'un premier téléchargement, "Overwritten" lorsqu'une solution avec ce SolutionId existait déjà sur Studio Web.
• SolutionId — l'identité attribuée par Studio Web (lors du premier téléchargement) ou correspondante (lors de l'écrasement). Également réécrit dans le fichier .uipx local afin que le upload suivant met à jour la même solution.
• DesignerUrl — URL prête à ouvrir pour le premier projet de la solution, pré-étendue à la solution. null/absent lorsque Studio Web ne renvoie pas d'ID de projet.
• LocalSolutionIdUpdated — présent uniquement lorsqu'un nouveau SolutionId a été réécrit dans le .uipx local (Path, From, To). Absent lorsque l’écrasement est en place ou lorsque la source du téléchargement n’avait pas d’ID antérieur à réécrire.
• SnapshotCreated — présent et true uniquement sur un écrasement qui a enregistré une version pré-écrasement réparable (c'est-à-dire --no-snapshot non dépassé). Absent lors d'une nouvelle importation, car il n'y a rien à instantané.
• Response — charge utile de réponse Studio Web brute. Utile pour le débogage; faisant partie d'un contrat stable.

Conséquences

• Synchronisation des liaisons. Avant le téléchargement, upload analyse à nouveau le fichier bindings_v2.json de chaque projet et réconcilier les déclarations de ressources de la solution, ce qui équivaut à exécuter uip solution resources refresh
• Écrasements de connexion. Après le téléchargement, tous les écrasements de connexion détectés dans le répertoire resources/solution_folder/connection/ de la solution sont corrigés dans Studio Web dans le dossier Espace de travail personnel de l'utilisateur authentifié. Les échecs sont ici consignés comme des avertissements et n’échouent pas pour la commande.
• Réécriture de l’ID de solution. Lors d'un nouveau téléchargement, l'ID de solution renvoyé remplace (ou remplit) le champ SolutionId dans le fichier .uipx local.

Commandes associées

• uip solution pack + uip solution publish — alternative au pipeline de déploiement à upload.
• uip solution delete — supprime une solution Studio Web par son SolutionId.
• uip solution init — élaborent une solution avant de la télécharger.

Voir également

• Authentification — upload nécessite une session active.
• Vue d’ensemble du typeuip solution .