ah uip

Gérez les idées d'automatisation, le pipeline, la taxonomie, le marketplace et les utilisateurs d'Automation Hub à l'aide de l'outil `uip ah`.

uip ah est l'outil Automation Hub (préfixe de commande ah, package @uipath/automation-hub-tool): il gère le pipeline des idées d'automatisation — les idées soumises via une évaluation, déplacées à travers des phases configurables, notées et suivies jusqu'à la livraison — plus la taxonomie , la collaboration et le marketplace qui l’accompagnent. Installez-le avec uip tools install ah, ou invoquez uip ah … et laissez l'installation automatique s'exécuter. Voir Outils pour le modèle d'installation.

Concepts

• Chaque écriture correspond à un remplacement complet de l'enregistrement, et non à un correctif. automations update, categories update, users update et tags set envoient tous la forme d'enregistrement complète d'Automation Hub - les champs que vous ne transmettez pas sont reportés à partir de ce qui est déjà stocké (ou, pour categories update/tags set, le la collection entière est remplacée immédiatement). Vérifiez les propres notes de chaque verbe pour connaître exactement ce qui est conservé par rapport à l'écrasement.
• --all-fields sur chaque commande de lecture. Un enregistrement Automation Hub brut transporte environ 300 clés, y compris une paire __display pré-formatée pour la plupart d’entre elles. Chaque commande list/get se projette dans un champ gérable défini par défaut; transmettez --all-fields pour la charge utile inchangée.
• Points de terminaison paginés vs non paginés. La plupart des commandes list atteignent un point de terminaison Automation Hub paginé et acceptent --limit/--offset normalement. Quelques points de terminaison (roles, idea-flows, questionnaires list, audit-logs list, collaborators list) renvoient l'intégralité de leur collection en un seul appel sans pagination côté serveur — --limit/--offset sont appliqués côté client sur ces derniers, après que l'ensemble complet a été récupéré.
• Les ID proviennent d'autres commandes list , et non de l'interface utilisateur. L'interface utilisateur Web d'Automation Hub n'expose pas la plupart des ID numériques que cette CLI prend (ID de catégorie, ID de statut de phase, ID de rôle) — recherchez-les avec la commande list --all-fields correspondante, comme l'indiquent les propres messages d'erreur de chaque verbe.
• Erreurs spécifiques à cet outil: une erreur 403 signifie « non visible par votre rôle Automation Hub», jamais « introuvable» — Automation Hub n'utilise pas 404 pour les enregistrements hors du cadre. Une exception « Automation Hub » de classe 500 n’est pas enregistrée sur ce locataire; ou « aucun enregistrement de locataire pour le moment»; la réponse se présente sous la forme Result: "ConfigError" avec des instructions d'intégration du locataire, distinctes d'un échec d'authentification.

Ressources

Chaque ressource a sa propre page de référence. Le verbe défini sur chaque page correspond aux commandes enregistrées par uip ah — exécutez uip ah --help pour confirmer la surface complète de votre installation.

Ressource	Objectif
automatisations, flux d'idées, cas métier, phases, questionnaires, pipelines	Le cycle de vie de l’idée à la livraison: soumettez et lisez les idées d'automatisation, découvrez les transitions de phase/de statut, lisez les analyses coûts-avantages, déplacez les idées à travers les phases, lisez le catalogue de questions d'évaluation et lisez la vue du pipeline classée par avantages.
applications, composants, documents, médias, listes du magasin, avis sur le magasin	Les automatisations de l’inventaire des applications sont balisées, les composants réutilisables, les documents et supports joints, et l'Automation Store (listes publiées et leurs avis).
catégories, balises, collaborateurs, rôles, utilisateurs	La taxonomie de la catégorie, les balises en texte libre, les collaborateurs par automatisation et leurs rôles, le catalogue de rôles attribuable et les comptes d'utilisateurs Automation Hub.
audit-logs, auth-info	Couverture ci-dessous sur cette page — petites ressources utilitaires croisées.

journaux d'audit uip ah

Lire la piste d'audit d'Automation Hub. Automation Hub regroupe la piste en bundles CSV hebdomadaires plutôt qu’un journal plate.

liste des journaux d'audit uip ah

Répertoriez des bundles de journaux d'audit pour une plage de dates.

Options

Long	Valeur (Value)	Description
--start-date <date>	YYYY-MM-DD	Début de la plage.
--end-date <date>	YYYY-MM-DD	Fin de la plage.
--limit <n>	Integer	Le nombre maximal de bundles à renvoyer. Par défaut 20.
--offset <n>	Integer	Nombre de bundles à ignorer. Par défaut 0.
--all-fields	Drapeau	Renvoyez la charge utile brute au lieu des champs Name/EntryCount prévus.

Point de terminaison non paginé — l'ensemble de la collection pour la plage de dates est extrait, puis fenêtreré côté client. Une piste vide (une note 404 « Aucun journal d’audit n’a pas été trouvé») est repliée dans un tableau Data vide plutôt que réaffichée comme une erreur.

Exemple

uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04

Format des données (--sortie json)

{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}

Un bundle soutenu par un blob de référence d'objet au lieu d'entrées intégrées renvoie Uri (la valeur download --uri prise) à la place de EntryCount.

téléchargement des journaux d’audit uip ah

Enregistrez un bundle de journaux d'audit sous forme de fichier CSV local.

Options

Long	Valeur (Value)	Requis	Description
--uri <name>	string	oui	Nom du bundle, exactement comme le champ Name de audit-logs list.
--destination <path>	Chemin d'accès	oui	Chemin d’accès local dans lequel écrire le fichier CSV.

Exemple

uip ah audit-logs download --uri <name> --destination ./audit.csv

Format des données (--sortie json)

{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }

uip ah-infos

Ressource de nom de masse singulaire — il y a exactement une identité par session, il n'y a donc rien à répertorier.

uip ah-infos authentification

Affichez le locataire Automation Hub et votre identité à l'intérieur - la vérification la plus rapide qu'Automation Hub est activé et intégré pour le locataire actif.

Options

Long	Description
--all-fields	Renvoyez la charge utile brute au lieu des champs Type/Tenant/User résumés.

Exemple

uip ah auth-info get

Format des données (--sortie json)

{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "[e-mail]", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}

Synthèse

uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]

Voir les automatisations, les flux d'idées, les cas métier, les phases, les questionnaires, les pipelines, les applications, les composants, les documents, les médias, les listes de magasins, les avis de magasins et les catégories, balises, collaborateurs, rôles, utilisateurs pour le reste de l'interface de commande .

Voir également

• Outils (extensions)
• Outils UIP
• Options globales
• Codes de sortie