- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- encodeur UIP
- uip ancrage dans le contexte
- UiPath Docsai
- Fonction UiP
- garde-fous UiP
- configuration llm uip
- uip llm-passerelle
- Création uip maestro
- Registre Maestro uip
- uip model-hub
- Tâches (Jobs)
- Dossiers
- Processus
- ROI du processus
- Paquets
- Machines
- Utilisateurs
- Rôles
- Licences
- Flux
- Pièces jointes (Attachments)
- Sessions
- Calendriers
- magasins d'informations d’identification
- journaux-audit
- paramètres
- Actifs
- Compartiments
- Compartiment-fichiers
- Bibliothèques
- Files d'attente (Queues)
- ROI de la file d'attente
- éléments de la file d'attente
- Déclencheurs (Triggers)
- Webhooks
- Activités - Rechercher
- activités get-Default-xaml
- Analyser
- liste règles-analyseurs
- Construire
- Nettoyage
- Installation de entités data-fabrics
- liste des entités data-fabrics
- Diff de fichiers
- Get-Library-Object-Repository
- Récupérer le référentiel d'objets
- Init
- liste des instances
- Créer un package
- Vérification des paquets
- Installation des paquets
- Versions de paquets
- Publier
- Distant
- restore
- exécuter, déboguer et amp; Exécution
- paramètres
- Début de Studio
- Recherche de modèles
- entité ajoutée aux données de test
- Ajouter une file d'attente de données de test
- variation d'ajout de données de test
- TM
- UIA
- Valider
- exemples de workflow - Obtenir
- liste d'exemples de workflow
- tâches UIP
- pièce jointe
- Champ personnalisé
- Défauts (Defects)
- Exécutions
- exporter-tâches
- Migration
- Libellé Objet
- Créer un package
- scénarios-perf
- groupes-de-charge-scénarios-perf
- données d’exécution de perf-scenario
- rapport de scénarios de performances
- Projet
- autorisations-projet
- Invites
- Rapport
- Prérequis
- Résultat
- Exécuter
- Planifications (Schedules)
- Journaux de cas de test
- Cas de test
- Ensembles de tests
- Journal des étapes de test
- Utilisateur (User)
- Attendre
- Traçages UIP
- Commentaires sur les traces UIP
- Migration
- Référence et assistance
Libellé d'objet uip tm
Syntaxe et options de `uip tm objectname`, qui gère les libellés associés aux objets Test Manager tels que les cas et les exigences de test.
uip tm objectlabel gère les libellés attachés aux objets Test Manager (exigences, cas de test, ensembles de test, exécutions de test et journaux des cas de test). Les libellés sont des chaînes de forme libre utilisées pour étiqueter et regrouper des objets à des fins de filtrage et de recherche.
Chaque verbe de ce groupe nécessite un projet (--project-id ou --project-key) et --object-type, y compris get. list, add et remove prennent le --object-ids, séparé par des espaces; get prend un seul --object-id. --labels est au multiple; il n'y a pas d'indicateur --label .
Synthèse
uip tm objectlabel list (--project-id <id> | --project-key <key>) --object-type <type> [--object-ids <uuid...>] [--label-types <types...>] [--filter <text>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm objectlabel get (--project-id <id> | --project-key <key>) --object-type <type> --object-id <uuid>
uip tm objectlabel add (--project-id <id> | --project-key <key>) --object-type <type> --object-ids <uuid...> --labels <name...> [--label-type <type>] [--remove-other-labels]
uip tm objectlabel remove (--project-id <id> | --project-key <key>) --object-type <type> --object-ids <uuid...> (--labels <name...> | --remove-all-labels) --yes
uip tm objectlabel list (--project-id <id> | --project-key <key>) --object-type <type> [--object-ids <uuid...>] [--label-types <types...>] [--filter <text>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm objectlabel get (--project-id <id> | --project-key <key>) --object-type <type> --object-id <uuid>
uip tm objectlabel add (--project-id <id> | --project-key <key>) --object-type <type> --object-ids <uuid...> --labels <name...> [--label-type <type>] [--remove-other-labels]
uip tm objectlabel remove (--project-id <id> | --project-key <key>) --object-type <type> --object-ids <uuid...> (--labels <name...> | --remove-all-labels) --yes
Tous les verbes respectent les options globales et les codes de sortie standard. Chaque verbe accepte --log-level <level> (par défaut Information). Chaque verbe accepte également -t, --tenant <name> pour s’exécuter contre un locataire autre que celui sélectionné par votre session uip login . Il s'agit par défaut du locataire de la session.
Lorsque vous transmettez à la fois --project-id et --project-key, --project-id l'emporte. Si vous ne transmettez ni l’un ni l’autre, la commande échoue avec ErrorCode: invalid_argument.
--object-type accepts Requirement, TestCase, TestSet, TestExecution, or TestCaseLog. --label-types on list accepts the wire-form values userLabel, systemLabel, internalLabel, and generatedLabel; --label-type on add accepts only userLabel. Both take the wire form, not the PascalCase forms used elsewhere in this CLI.
liste des libellés d'objets uip tm
List distinct label names in use for one object type (paginated). This does not return label assignment rows — use get for the labels on one object.
Arguments
Aucun
Options
--project-id <id>— ID du projet Test Manager. Gagne si--project-keyest également donné.--project-key <key>— Clé de projet Test Manager (par exemple,DEMO). Ignoré si--project-idest également fourni.--object-type <type>(obligatoire) : type d'objet pour lequel lister les libellés.--object-ids <uuid...>— restreindre aux libellés attribués à ces objets (séparés par des espaces). Omettez à rechercher sur l'ensemble du type d'objet.--label-types <type...>— label types to include (userLabel,systemLabel,internalLabel,generatedLabel, space-separated). The server always returnssystemLabel,userLabel, andgeneratedLabelnames and adds the types passed here, so this flag widens the result rather than narrowing it.--filter <text>— préfixe permettant de faire correspondre les noms de libellés (StartsWithcôté serveur, il ne s'agit pas d'une recherche générale de sous-chaînes).--sort-by <expr>— expression de tri, par exemplename asc.--limit <n>— taille de la page. La valeur par défaut est50.--offset <n>— résultats à ignorer. La valeur par défaut est0.
Exemple
uip tm objectlabel list \
--project-key DEMO \
--object-type TestCase \
--filter smo \
--limit 50
uip tm objectlabel list \
--project-key DEMO \
--object-type TestCase \
--filter smo \
--limit 50
Format des données
{
"Code": "ObjectLabelsList",
"Data": [
{ "Name": "smoke" },
{ "Name": "smoke-test" }
]
}
{
"Code": "ObjectLabelsList",
"Data": [
{ "Name": "smoke" },
{ "Name": "smoke-test" }
]
}
Chaque ligne est uniquement { "Name": "<label>" } — list ne renvoie pas Id, ObjectId ou LabelType. Pour voir les libellés sur un objet avec leurs ID et leurs types de libellé, utilisez objectlabel get.
Obtenir le libellé d'objet uip tm
Get the visible labels on one object — user, system, and generated labels — including label ids and label types. Internal labels are not returned. list returns distinct label names for an object type; get returns the full assignment rows for a single object.
Arguments
Aucun
Options
--project-id <id>— ID du projet Test Manager. Gagne si--project-keyest également donné.--project-key <key>— Clé de projet Test Manager (par exemple,DEMO). Ignoré si--project-idest également fourni.--object-type <type>(obligatoire) : type d'objet auquel le libellé appartient.--object-id <uuid>(requis) : UUID de l'objet, par exemple leIddeuip tm testcases list(ou le verbe de liste correspondant--object-type).
Exemple
uip tm objectlabel get \
--project-key DEMO \
--object-type TestCase \
--object-id f9e8d7c6-0000-0000-0000-000000000001
uip tm objectlabel get \
--project-key DEMO \
--object-type TestCase \
--object-id f9e8d7c6-0000-0000-0000-000000000001
Format des données
{
"Code": "ObjectLabelGet",
"Data": [
{
"Id": "a1b2c3d4-0000-0000-0000-000000000001",
"ProjectId": "a1b2c3d4-0000-0000-0000-000000000009",
"ObjectId": "f9e8d7c6-0000-0000-0000-000000000001",
"ObjectType": "TestCase",
"Name": "smoke",
"Description": "",
"LabelType": "UserLabel"
}
]
}
{
"Code": "ObjectLabelGet",
"Data": [
{
"Id": "a1b2c3d4-0000-0000-0000-000000000001",
"ProjectId": "a1b2c3d4-0000-0000-0000-000000000009",
"ObjectId": "f9e8d7c6-0000-0000-0000-000000000001",
"ObjectType": "TestCase",
"Name": "smoke",
"Description": "",
"LabelType": "UserLabel"
}
]
}
Data is an array with one row per label on the object, and an empty array when the object has no visible labels. LabelType is PascalCase (UserLabel, SystemLabel, GeneratedLabel) even though the --label-type/--label-types input flags take the camelCase wire form.
ajout de libellé d'objet uip tm
Ajoutez des libellés à un ou plusieurs objets. Deux comportements distincts selon que l'élément --label-type est défini ou non:
- Without
--label-type(default): a single bulk-add call across all objects and labels. Pass--remove-other-labelsto make this an authoritative set — after adding, any non-system labels on these objects that are not in--labelsare deleted. - With
--label-type userLabel: each label is assigned individually (one call per object × label pair).--remove-other-labelsis ignored in this mode.
Arguments
Aucun
Options
--project-id <id>— ID du projet Test Manager. Gagne si--project-keyest également donné.--project-key <key>— Clé de projet Test Manager (par exemple,DEMO). Ignoré si--project-idest également fourni.--object-type <type>(obligatoire) : type d'objet.--object-ids <uuid...>(obligatoire) : UUID d'objets séparés par des espaces auxquels appliquer les libellés.--labels <name...>(obligatoire) : noms de libellés séparés par des espaces à ajouter.--label-type <type>— label type. OnlyuserLabelis accepted:objectlabel removecannot detach a system label, so the CLI writes user labels only. When set, switches to the per-pair assign path described above.--remove-other-labels— après l'ajout, supprimez tous les libellés non système liés à ces objets non présents dans--labels. Ignoré lorsque--label-typeest défini.
Exemples
# Bulk add — multiple labels to multiple objects in one call
uip tm objectlabel add \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels smoke regression
# With an explicit label type — assigns each label individually
uip tm objectlabel add \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels smoke \
--label-type userLabel
# Bulk add — multiple labels to multiple objects in one call
uip tm objectlabel add \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels smoke regression
# With an explicit label type — assigns each label individually
uip tm objectlabel add \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels smoke \
--label-type userLabel
Format des données
{
"Code": "ObjectLabelsAdd",
"Data": {
"ObjectCount": 2,
"LabelCount": 2,
"Result": "Added"
}
}
{
"Code": "ObjectLabelsAdd",
"Data": {
"ObjectCount": 2,
"LabelCount": 2,
"Result": "Added"
}
}
LabelCount compte les noms de libellé distincts, insensible à la casse. Lorsque --label-type est transmis, la réponse inclut:
{
"Code": "ObjectLabelsAdd",
"Data": {
"ObjectCount": 2,
"LabelCount": 1,
"LabelType": "userLabel",
"Result": "Added"
}
}
{
"Code": "ObjectLabelsAdd",
"Data": {
"ObjectCount": 2,
"LabelCount": 1,
"LabelType": "userLabel",
"Result": "Added"
}
}
Suppression du libellé d'objet uip tm
Remove user and generated labels from up to 100 objects. Pass --labels to remove specific labels, or --remove-all-labels to remove every user and generated label on the listed objects; the two are mutually exclusive, and one is required. Names match case-insensitively. The removal is irreversible and requires -y, --yes.
- Les étiquettes système ne sont jamais supprimées. Les noms de libellé système correspondants sont indiqués dans
SkippedSystemLabels. - Internal label names, and names of label types the CLI doesn't recognize, are never sent. With
--labels, requested internal names are reported inSkippedInternalLabels; with--remove-all-labels, user or generated labels that share a name with an internal label are kept and reported there. removereads the objects' labels before writing — at least two read requests per object, five objects at a time — so it needs read access to the listed objects. If the labels can't be read, or an object carries 500 or more label names, nothing is removed.- Si une demande de suppression échoue à mi-parcours, le message d'erreur répertorie les libellés déjà supprimés.
Arguments
Aucun
Options
--project-id <id>— ID du projet Test Manager. Gagne si--project-keyest également donné.--project-key <key>— Clé de projet Test Manager (par exemple,DEMO). Ignoré si--project-idest également fourni.--object-type <type>(obligatoire) : type d'objet.--object-ids <uuid...>(requis) : UUID d'objets séparés par des espaces. Au moins 100 identifiants distincts par appel; les doublons sont ignorés.--labels <name...>— noms de libellés séparés par des espaces à supprimer. Obligatoire si--remove-all-labelsn'est pas défini.--remove-all-labels— supprimer les libellés utilisateur et générés sur les objets répertoriés, à l'exception de tous ceux qui partagent un nom avec un libellé interne. Les libellés système et internes sont conservés, contrairement à l'effacement de tous dans l'interface utilisateur de Test Manager. Capture mutuellement exclusive avec--labels-y, --yes(required) — confirms the irreversible operation. The CLI never prompts; without--yesthe command returnsResult: "Failure"and exits1.
Exemples
# remove specific labels
uip tm objectlabel remove \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels regression \
--yes
# remove every user and generated label
uip tm objectlabel remove \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--remove-all-labels \
--yes
# remove specific labels
uip tm objectlabel remove \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--labels regression \
--yes
# remove every user and generated label
uip tm objectlabel remove \
--project-key DEMO \
--object-type TestCase \
--object-ids a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
--remove-all-labels \
--yes
Format des données
{
"Code": "ObjectLabelsRemove",
"Data": {
"ObjectCount": 2,
"LabelCount": 1,
"RemovedLabels": ["regression"],
"Result": "Removed"
}
}
{
"Code": "ObjectLabelsRemove",
"Data": {
"ObjectCount": 2,
"LabelCount": 1,
"RemovedLabels": ["regression"],
"Result": "Removed"
}
}
Avec --remove-all-labels:
{
"Code": "ObjectLabelsRemove",
"Data": {
"ObjectCount": 2,
"RemoveAllLabels": true,
"RemovedLabels": ["regression", "smoke"],
"SkippedSystemLabels": ["automated"],
"Result": "AllRemoved"
}
}
{
"Code": "ObjectLabelsRemove",
"Data": {
"ObjectCount": 2,
"RemoveAllLabels": true,
"RemovedLabels": ["regression", "smoke"],
"SkippedSystemLabels": ["automated"],
"Result": "AllRemoved"
}
}
| Champ | Description |
|---|---|
ObjectCount | Nombre d'ID d'objets distincts traités. |
LabelCount | With --labels, the number of distinct requested names (case-insensitive). Replaced by RemoveAllLabels: true with --remove-all-labels. |
RemovedLabels | Label names removed, sorted. |
SkippedSystemLabels | Les noms de libellés système qui correspondaient et ont été conservés. Omis lorsqu'il est vide. |
SkippedInternalLabels | Les noms sont conservés, car ils sont, ou partagent un nom avec, un libellé interne. Omis lorsqu'il est vide. |
Result | Removed, AllRemoved (avec --remove-all-labels) ou Skipped lorsque rien n'a été supprimé. |
Associé
- exigences — les exigences peuvent comporter des libellés d'objet.
- champ personnalisé — un mécanisme de libellé distinct (
customfield label) pour les valeurs de champ personnalisé de type Libellé; distinct des balises de forme libre deobjectlabel.
Voir également
- Synthèse
- liste des libellés d'objets uip tm
- Arguments
- Options
- Exemple
- Format des données
- Obtenir le libellé d'objet uip tm
- Arguments
- Options
- Exemple
- Format des données
- ajout de libellé d'objet uip tm
- Arguments
- Options
- Exemples
- Format des données
- Suppression du libellé d'objet uip tm
- Arguments
- Options
- Exemples
- Format des données
- Associé
- Voir également