Omni Content Explorer

Trouvez, parcourez et organisez le contenu Omni — tableaux de bord, classeurs et dossiers — via la CLI Omni.

Prérequis

# Vérifiez que la CLI Omni est installée — sinon, demandez à l'utilisateur de l'installer
# Voir: https://github.com/exploreomni/cli#readme
command -v omni >/dev/null || echo "ERROR: Omni CLI is not installed."

# Affichez les profils disponibles et sélectionnez le bon
omni config show
# S'il y a plusieurs profils, demandez à l'utilisateur lequel utiliser, puis basculez:
omni config use <profile-name>

Découvrir les commandes

omni content --help     # Content operations
omni documents --help   # Document operations
omni folders --help     # Folder operations

Astuce : Utilisez -o json pour forcer une sortie structurée exploitable par programme, ou -o human pour des tableaux lisibles. La valeur par défaut est auto (human dans un TTY, JSON quand le contenu est piped).

Parcourir le contenu

Lister tout le contenu

omni content list

Avec comptages et libellés

omni content list --include '_count,labels'

Filtrer et trier

# Par libellé
omni content list --labels finance,marketing

# Par portée
omni content list --scope organization

# Trier par popularité ou récence
omni content list --sortfield favorites

omni content list --sortfield updatedAt

Pagination

Les réponses incluent pageInfo avec pagination basée sur curseur. Récupérez la page suivante :

omni content list --cursor <nextCursor>

Travailler avec les documents

Lister les documents

omni documents list

# Filtrer par créateur
omni documents list --creatorid <userId>

Chaque document inclut : identifier, name, type, scope, owner, folder, labels, updatedAt, hasDashboard.

Important : Utilisez toujours le champ identifier pour les appels API, pas id. Le champ id est null pour les documents de type classeur et causera des défaillances silencieuses.

Obtenir les requêtes d'un document

Récupérez les définitions de requête alimentant les tuiles d'un tableau de bord :

omni documents get-queries <identifier>

Utile pour comprendre ce qu'un tableau de bord calcule et relancer les requêtes via omni-query.

Dossiers

# Lister
omni folders list

# Créer
omni folders create "Q1 Reports" --scope organization

Libellés

# Lister les libellés
omni labels list

# Ajouter un libellé à un document
omni documents add-label <identifier> <labelName>

# Supprimer un libellé
omni documents remove-label <identifier> <labelName>

Favoris

# Ajouter aux favoris
omni documents add-favorite <identifier>

# Retirer des favoris
omni documents remove-favorite <identifier>

Téléchargements de tableaux de bord

# Démarrer le téléchargement (async)
omni dashboards download <dashboardId> --body '{ "format": "pdf" }'

# Interroger l'état du job
omni dashboards download-status <dashboardId> <jobId>

Formats : pdf, png

Modèles d'URL

Construisez des liens directs vers le contenu :

Dashboard: {OMNI_BASE_URL}/dashboards/{identifier}
Workbook:  {OMNI_BASE_URL}/w/{identifier}

L'identifier provient du champ identifier du document dans les réponses API. Fournissez toujours un lien cliquable à l'utilisateur après la découverte du contenu.

Modèles de recherche

Lors du scan de tous les documents pour les références de champ (par exemple, pour une analyse d'impact), paginéz avec le curseur et appelez omni documents get-queries <identifier> pour chaque document. Lancez plusieurs appels de récupération de requêtes en parallèle pour gagner en efficacité. Pour une analyse d'impact de champ, privilégiez l'approche content-validator dans omni-model-explorer.

Référence docs

Content API · Documents API · Folders API · Labels API · Dashboard Downloads

Skills associées

omni-query — exécutez les requêtes derrière les tableaux de bord trouvés
omni-content-builder — créez ou mettez à jour des tableaux de bord
omni-embed — intégrez les tableaux de bord trouvés dans des applications externes
omni-admin — gérez les permissions sur les documents et dossiers

omni-content-explorer