Commandes tabcmd

Vous pouvez utiliser les commandes suivantes avec l'outil de ligne de commande tabcmd dans Tableau Online :

addusers nom-groupe

Ajoute des utilisateurs au groupe spécifié.

Exemple

tabcmd addusers "Development" --users "users.csv"

Options

--users

Ajoutez les utilisateurs du fichier .csv donné au groupe spécifié. Le fichier doit se composer d'une liste simple avec un nom d'utilisateur par ligne. Les noms d'utilisateur ne sont pas sensibles à la casse. Les utilisateurs devraient déjà avoir été créés sur Tableau Online.

Si vous utilisez cette commande avec des fichiers .csv volumineux, dans Tableau Server, un administrateur de serveur peut activer les paramètres susceptibles d’améliorer les performances.

Pour plus d'informations, consultez Recommandations relatives au fichier d'importation CSV.

--[no-]complete

Lorsqu'elle est définie sur complete, cette option requiert que toutes les lignes soient valides pour que les modifications prennent effet. Sinon, --complete est utilisé.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

creategroup nom_groupe

Crée un groupe. Utilisez addusers pour ajouter des utilisateurs une fois le groupe créé.

Exemple

tabcmd creategroup "Development"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createproject nom_projet

Crée un projet.

Exemple

tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."

Options

-n, --name

Spécifie le nom du projet que vous souhaitez créer.

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel que spécifié avec l'option -n. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -n "Nested".

-d, --description

Spécifie une description pour le projet.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

createsiteusers nomfichier.csv

Ajoute des utilisateurs à un site, en fonction des informations fournies dans un champ avec des valeurs séparées pa une virgule (CSV). Si l'utilisateur n'est pas déjà créé sur le serveur, la commande crée l'utilisateur avant de l'ajouter au site.

Le fichier CSV doit comporter un ou plusieurs noms d'utilisateur et peut également inclure (pour chaque utilisateur) un mot de passe, un nom complet, un type de licence, un niveau Administrateur, un publicateur (oui/non) et une adresse e-mail. Pour plus d'informations sur le format du fichier CSV, voir Recommandations relatives au fichier d'importation CSV.

Comme alternative à l'inclusion du niveau Administrateur et des autorisations de publicateur dans le fichier CSV, vous pouvez transmettre les informations de niveau d'accès en incluant l'option --role et en spécifiant le rôle sur le site que vous souhaitez affecter aux utilisateurs répertoriés dans le fichier CSV.

Par défaut, les utilisateurs sont ajoutés au site auquel vous êtes connecté. Pour ajouter des utilisateurs à un site différent, incluez l'option --site gloable et spécifiez ce site. (Vous devez avoir les autorisations pour créer des utilisateurs sur le site que vous spécifiez.)

Exemple

tabcmd createsiteusers "users.csv" --role "Explorer"

Options

--admin-type

Obsolète. À la place, utilisez l'option --role.

--auth-type

Définit le type d'authentification (TableauID ou SAML) pour tous les utilisateurs dans le fichier .csv . En l'absence de spécification, le paramètre par défaut est TableauID.

Remarque : Pour utiliser l'authentification SAML, le site proprement dit doit également être compatible SAML. Pour plus d'informations, voir Activer l'authentification SAML sur un site.

--complete

Requiert que toutes les lignes soient valides pour que les modifications prennent effet. Il s'agit du paramètre par défaut.

--no-complete

Indique que la commande doit apporter des modifications au serveur même si toutes les lignes ne comportent pas d'informations valides. Les lignes qui comportent des informations non valides sont ignorées.

--no-publisher

Obsolète. À la place, utilisez l'option --role.

--nowait

Permet de ne pas attendre que les tâches asynchrones soient terminées.

--publisher

Obsolète. À la place, utilisez l'option --role.

--role

Spécifie un rôle sur le site pour tous les utilisateurs du fichier .csv. Lorsque vous souhaitez attribuer des rôles sur le site à l'aide de l'option --role, créez un fichier CSV séparé pour chaque rôle sur le site.

Les valeurs valides sont ServerAdministrator, SiteAdministratorCreator, SiteAdministratorExplorer, Creator, ExplorerCanPublish, Explorer, Viewer, ReadOnly et Unlicensed.

Pour les nouveaux utilisateurs, la valeur par défaut est Unlicensed et pour les utilisateurs existants, elle reste inchangée. Les utilisateurs sont ajoutés en tant qu'utilisateurs sans licence également si votre installation de serveur est basée sur les utilisateurs et que la commande createsiteusers crée un nouvel utilisateur mais que vous avez déjà atteint la limite de nombre de licences pour vos utilisateurs.

Remarque : sur Tableau Server multisite, si vous souhaitez attribuer le rôle sur le site ServerAdministrator à l'aide de l'option --role, utilisez plutôt la commande createusers au lieu de createsiteusers.

--silent-progress

Permet de ne pas afficher les messages de progression pour les tâches asynchrones.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

delete workbook-name ou datasource-name

Supprime le classeur ou la source de données spécifié(e) du serveur.

Cette commande utilise le nom du classeur ou de la source de données tel qu'il est spécifié sur le serveur, et non le nom du fichier lors de sa publication.

Exemple

tabcmd delete "Sales_Analysis"

Options

-r, --project

Nom du projet contenant le classeur ou la source de données que vous souhaitez supprimer. Si aucun nom n'est spécifié, le projet "Par défaut" est utilisé.

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel que spécifié avec l'option -r. Par exemple, pour spécifier un projet appelé « Nested » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -r "Nested".

--workbook

Nom du classeur que vous souhaitez supprimer.

--datasource

Nom de la source de données que vous souhaitez supprimer.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletegroup group-name

Supprime le groupe spécifié du serveur.

Exemple

tabcmd deletegroup "Development"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deleteproject project-name

Supprime le projet spécifié du serveur.

La commande tabcmd vous permet de spécifier un projet de niveau supérieur seulement dans une hiérarchie de projet. Pour automatiser les tâches que vous souhaitez effectuer sur un projet dans un projet parent, utilisez l'appel Tableau REST API équivalent.

Exemple

tabcmd deleteproject "Designs"

Option

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel que spécifié avec la commande. Par exemple, pour spécifier un projet appelé « Designs » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" "Designs".

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

deletesiteusers filename.csv

Supprime les utilisateurs du site auquel vous êtes connecté. Les utilisateurs à supprimer sont spécifiés dans un fichier qui contient une liste simple avec un nom d'utilisateur par ligne. (Aucune information supplémentaire n'est requise au-delà du nom d'utilisateur.)

Par défaut, si le serveur n'a qu'un seul site ou si l'utilisateur appartient à un seul site, l'utilisateur est également supprimé du serveur. Sur une installation Tableau Server Enterprise, si le serveur contient plusieurs sites, les utilisateurs ayant le rôle sur le site Administrateur de serveur sont supprimés du site mais pas du serveur.

Si l'utilisateur est propriétaire de contenu, sonrôle passe à Sans licence, mais l'utilisateur n'est pas supprimé du serveur ou du site. Le contenu est toujours détenu par cet utilisateur. Pou supprimer complètement l'utilisateur, vous devez modifier le propriétaire du contenu, puis essayez de supprimer à nouveau l'utilisateur.

Exemple

tabcmd deletesiteusers "users.csv"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

export

Exporte une vue ou un classeur à partir de Tableau Online et l'enregistre dans un fichier. Cette commande peut aussi exporter uniquement les données utilisées pour une vue.

Lisez les points suivants avant d'utiliser cette commande :

  • Autorisations : Pour pouvoir exporter, vous devez bénéficier de l'autorisation d'Exportation d'une image. Par défaut, la valeur de cette autorisation est définie sur Autorisée ou Héritée pour tous les rôles, mais elle peut être définie par classeur ou par vue.

  • Exportation de données : Pour exporter uniquement les données d'une vue, utilisez l'option --csv. Cette opération exporte les données de résumé utilisées dans la vue dans un fichier .csv.

  • Spécification de la vue, du classeur ou des données à exporter :

    • Utilisez la partie de l’URL pour identifier les éléments à exporter, plus spécifiquement la chaîne "workbook/view" telle qu’elle apparaît dans l’URL du classeur ou de la vue. N'utilisez pas le nom convivial, et excluez l’ID de session :iid=<n> à la fin de l’URL.

      Par exemple, l’exemple de vue Tableau Global Temperatures dans le classeur Regional a une URL du type suivant : <server_name>/#/views/Regional/GlobalTemperatures?:iid=3

      Pour exporter la vue Global Temperatures, utilisez la chaîne Regional/GlobalTemperatures.

      N'utilisez pas Regional/Global Temperatures ni Regional/GlobalTemperatures?:iid=3.

    • Si le serveur fait fonctionner plusieurs sites et que la vue ou le classeur se trouve sur un site autre que celui par défaut, utilisez -t <site_id>.

    • Pour exporter un classeur, obtenez la chaîne d’URL en ouvrant une vue dans le classeur, et incluez la vue dans la chaîne que vous utilisez.

      Dans l’exemple ci-dessus, pour exporter le classeur Regional, vous devez utiliser la chaîne Regional/GlobalTemperatures.

    • Pour exporter un classeur, l'option Afficher les feuilles sous forme d'onglets doit être sélectionnée dans la boîte de dialogue Publier de Tableau Desktop au moment de sa publication.

  • Format du fichier sauvegardé : Les formats proposés dépendent du contenu exporté. Un classeur ne peut être exporté qu'en PDF, en utilisant l'argument --fullpdf. La vue peut être exportée au format PDF (--pdf) ou PNG (--png).

  • Nom et emplacement du fichier sauvegardé (facultatif) : Si vous ne définissez pas de nom, celui-ci sera nommé automatiquement à partir du nom de la vue ou du classeur. Si vous ne définissez pas d'emplacement, le fichier sera sauvegardé dans le répertoire de travail courant. Vous pouvez également spécifier un chemin absolu ou relatif au répertoire de travail courant.

    Remarque : Vous devez inclure une extension de nom de champ telle que .csv ou .pdf. La commande n'ajoute pas automatiquement une extension au nom de champ que vous fournissez.

  • Objets de page Web du tableau de bord non inclus dans les exports PDF : Un tableau de bord peut inclure, au choix, un objet de page Web. Si vous réalisez l'export en PDF d'un tableau de bord qui contient un objet de page Web, celui-ci ne sera pas inclus dans le fichier PDF.

  • Caractères non-ASCII/caractères ASCII non standard et exportations PDF : si vous exportez une vue ou un classeur dont le nom inclut un caractère non-ASCII ou un caractère ASCII non standard, vous devez encoder le caractère avec une URL (encodage avec pourcentage).

    Par exemple, si votre commande inclut la ville de Zürich, vous devez l'encoder avec une URL sous la forme Z%C3%BCrich :

    tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf

Effacement du cache pour utiliser des données en temps réel

Vous pouvez éventuellement ajouter le paramètre URL ?:refresh=yes pour forcer une requête de rafraîchissement des données au lieu de demander les résultats du cache. Si vous utilisez tabcmd avec votre propre script et que le paramètre URL refresh est très utilisé, cela peut avoir un impact négatif sur les performances. Il est recommandé d'utiliser la commande refresh uniquement lorsque vous avez besoin des données en temps réel—par exemple, sur un tableau de bord unique au lieu d'un classeur entier.

Exemples

Vues

tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"

tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

tabcmd export "Finance/InvestmentGrowth" --png

tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png

Classeurs

tabcmd export "Q1Sales/Sales_Report" --fullpdf

tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"

Options

-f, --filename

Enregistre le fichier avec le nom et l'extension donnés.

--csv

Disponible pour les vues uniquement. Exportez les données de la vue (données résumées) au format .csv.

--pdf

Disponible pour les vues uniquement. Permet d'exporter au format PDF.

--png

Disponible pour les vues uniquement. Exportez en tant qu'image au format .png.

--fullpdf

Disponible pour les classeurs uniquement. Permet d'exporter au format PDF. L'option Afficher les feuilles sous forme d'onglets doit être activée au moment de la publication du classeur.

--pagelayout

Définit l'orientation de la page (landscape ou portrait) du PDF exporté. Si cette option n'est pas définie, les paramètres Tableau Desktop seront utilisés.

--pagesize

Définit la taille de page du fichier PDF exporté sous l'un des formats suivants : unspecified, letter, legal, note folio, tabloid, ledger, statement, executive, a3, a4, a5, b4, b5 ou quarto. La valeur par défaut est letter.

--width

Définit la largeur en pixels. La valeur par défaut est 800 px.

--height

Définit la hauteur en pixels. La valeur par défaut est 600 px.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

get url

Obtient la ressource de Tableau Online, qui est représentée par l'URL (partielle) spécifiée. Le résultat est renvoyé comme un fichier.

Lisez les points suivants avant d'utiliser cette commande :

  • Autorisations : Pour récupérer un fichier, vous devez disposer de l'autorisation Télécharger/Enregistrer sur le Web sous. Par défaut, la valeur de cette autorisation est définie sur autorisée ou héritée pour tous les rôles, mais elle peut être définie par classeur ou par vue.

  • Définition d'une vue ou d'un classeur à obtenir : vous spécifiez une vue à obtenir avec la chaîne "/views/<workbookname>/<viewname>.<extension>" et un classeur à obtenir avec la chaîne "/workbooks/<workbookname>.<extension>". Remplacez <workbookname>  et <viewname> par les noms du classeur et affichez-les comme ils apparaissent dans l'URL lorsque vous ouvrez la vue dans un navigateur et remplacez <extension> par le type de fichier que vous souhaitez enregistrer. N'utilisez ni l'ID de session à la fin de l'URL (?:iid=<n>) ni le nom "friendly"du classeur ou de la vue.

    Par exemple, si vous ouvrez une vue Regional Totals dans un classeur nommé Metrics Summary, l'URL ressemble à ce qui suit :

    /views/MetricsSummary_1/RegionalTotals?:iid=1

    Servez-vous de la chaîne /views/MetricsSummary_1/RegionalTotals.<extension> pour obtenir la vue.

    Servez-vous de la chaîne /workbooks/MetricsSummary_1.<extension> pour obtenir le classeur.

  • Extension du fichier : l'URL doit contenir une extension de fichier. L'extension détermine le type de fichier généré. Pour une vue, vous pouvez utiliser les formats PDF, PNG ou CSV (données résumées uniquement). Un classeur Tableau est enregistré au format TWB s'il se connecte à une source de données publiées ou s'il utilise une connexion en direct. Il est enregistré au format TWBX s'il se connecte à un extrait de données.

    Remarque : Si vous téléchargez une vue sur un fichier PDF ou PNG, et si vous incluez un paramètre --filename portant l'extension .pdf ou .png, vous n'avez pas besoin d'inclure une extension .pdf ou .png dans l'URL.

  • Nom et emplacement du fichier sauvegardé (facultatif) : Le nom spécifié pour l'option --filename doit inclure une extension. Si vous ne fournissez pas de nom ni d'extension de fichier, ceux-ci seront obtenus à partir de la chaîne URL. Si vous ne définissez pas d'emplacement, le fichier est sauvegardé dans le répertoire de travail courant. Vous pouvez également spécifier un chemin absolu ou relatif au répertoire de travail courant.

  • taille PNG (facultatif) : Si le fichier enregistré est au format PNG, vous pouvez en spécifier la taille, en pixels, dans l'URL.

Effacement du cache pour utiliser des données en temps réel

Vous pouvez éventuellement ajouter le paramètre URL ?:refresh=yes pour forcer une requête de rafraîchissement des données au lieu de demander les résultats du cache. Si vous utilisez tabcmd avec votre propre script, l'utilisation intensive de la commande refreshpeut avoir un impact négatif sur les performances. Il est recommandé d'utiliser la commande refresh uniquement lorsque vous avez besoin des données en temps réel—par exemple, sur un tableau de bord unique au lieu d'un classeur entier.

Exemples

Vues

tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"

tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"

tabcmd get "/views/Finance/InvestmentGrowth.csv"

tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png

tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png

Classeurs

tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

login

Connecte un utilisateur Tableau Online.

Utilisez les options générales --server, --site, --username et --password pour créer une session.

Remarque : lorsque vous utilisez la commande tabcmd login, vous ne pouvez pas utiliser l'authentification unique SAML (SSO), même si votre site est configuré pour utiliser SAML. Pour vous connecter, vous devez fournir le nom d'utilisateur et le mot de passe d'un utilisateur qui a été créé sur votre site. Vous disposerez des autorisations de l'utilisateur Tableau Server sous lequel vous êtes connecté.

Si vous souhaitez vous connecter à l'aide des mêmes informations que celles utilisées pour créer une session, spécifiez simplement l'option --password. Le serveur et le nom d'utilisateur stockés dans le cookie seront utilisés.

Si le serveur utilise un port autre qu'un port 80 (par défaut), il faudra indiquer le port.

Vous n'avez besoin de l'option --site (-t) que si le serveur exécute plusieurs sites et que vous êtes connecté à un site autre que le site Par défaut. Si vous n'en fournissez pas, un mot de passe vous sera demandé. Si l'option --no-prompt est spécifiée et qu'aucun mot de passe n'est fourni, la commande échoue.

Une fois connecté, la session reste ouverte jusqu'à son expiration sur le serveur ou jusqu'à l'exécution de la commande logout.

Exemple

Se connecter au site Tableau Online à l'aide de l'ID de site spécifié :

tabcmd login -s https://online.tableau.com -t siteID -u user@email.com -p password

Options

-s, --server

Si vous exécutez la commande depuis un ordinateur Tableau Server qui se trouve sur votre réseau, vous pouvez utiliser http://localhost. Sinon, spécifiez l'URL de l'ordinateur, telle que http://bigbox.myco.com ou http://bigbox.

Pour Tableau Online, spécifiez l'URL https://online.tableau.com.

-t, --site

Utilisez cette option si le serveur dispose de plusieurs sites et que vous êtes connecté à un site autre que le site par défaut.

L'ID de site est utilisé dans l'URL pour identifier le site de manière unique. Par exemple, un site nommé West Coast Sales peut disposer d'un ID de site west-coast-sales.

-u, --username

Nom d'utilisateur de l'utilisateur qui se connecte. Pour Tableau Online, le nom d'utilisateur est l'adresse de messagerie de l'utilisateur.

-p, --password

Mot de passe de l'utilisateur spécifié pour --username. Si vous n'en fournissez pas, un mot de passe vous sera demandé.

--password-file

Permet d'enregistrer le mot de passe dans le fichier filename.txt indiqué au lieu de le saisir sur la ligne de commande, pour plus de sécurité.

--no-prompt

Pas de demande de mot de passe. Si aucun mot de passe n'est spécifié, la commande login échoue.

--cookie

Enregistre l'ID de session lors de la connexion. Les commandes suivantes ne requièrent pas de connexion. Cette valeur est la valeur par défaut de la commande.

--no-cookie

N'enregistrez pas les informations d'ID de session après une connexion réussie. Les commandes suivantes requièrent une connexion.

--timeout SECONDS

Le nombre de secondes d'attente du serveur avant le traitement de la commande login. Par défaut : 30 secondes.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

logout

Permet de se déconnecter du serveur.

Exemple

tabcmd logout

publish filename.twb(x), filename.tds(x) ou filename.hyper

Publie le classeur spécifié (.twb(x)), la source de données (.tds(x)) ou l'extrait de données (.hyper) sur Tableau Online.

Si vous publiez un classeur, par défaut, toutes les feuilles du classeur sont publiées sans nom d'utilisateur ni mot de passe de base de données.

Les autorisations initialement attribuées au classeur ou à la source de données sont copiées du projet dans lequel le fichier est publié. Les autorisations pour la ressource publiée peuvent être modifiées une fois le fichier publié. 

Si le classeur contient des filtres utilisateur, l'une des options de miniatures doit être spécifiée.

Exemple

tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"
--oauth-username "user-name" --save-oauth

Si le fichier ne se trouve pas dans le même répertoire que tabcmd, indiquez le chemin complet du fichier.

Exemple

tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth

Options

-n, --name

Nom du classeur ou de la source de données sur le serveur. Par défaut, le classeur, la source de données ou l'extrait de données portera le même nom que le fichier dont il est tiré.

-o, --overwrite

Ecrase le classeur, la source de données ou l'extrait de données si ceux-ci existent déjà sur le serveur.

-r, --project

Publie le classeur, la source de données ou l'extrait de données dans le projet spécifié. Si aucun projet n'est spécifié, le classeur est publié dans le projet "Par défaut".

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel qu'il est spécifié avec l'option -r. Par exemple, pour spécifier un projet appelé « imbriqué » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" -r "Nested".

--db-username

Utilisez cette option pour publier un nom d'utilisateur de base de données avec le classeur, la source de données ou l'extrait de données.

Si vous vous connectez aux données via une connexion ou un jeton d'accès OAuth protégé, utilisez plutôt l'option --oauth-username.

--db-password

Utilisez cette option pour publier un mot de passe de base de données avec le classeur, la source de données ou l'extrait.

--save-db-password

Enregistre le mot de passe de base de données fourni sur le serveur.

--oauth-username

Adresse e-mail du compte utilisateur. Connecte l'utilisateur via une connexion OAuth préconfigurée, si l'utilisateur a enregistré un jeton d'accès pour la source de données Cloud spécifiée dans --name. Les jetons d'accès sont gérés dans les préférences de l'utilisateur.

Pour les connexions OAuth existantes à la source de données, utilisez cette option plutôt que --db-username et --db-password.

--save-oauth

Enregistre les informations d'identification spécifiées par --oauth-username comme données d'identification intégrées à la source de données ou au classeur publié.

Par conséquent, lorsque le publicateur ou l'administrateur du serveur se connecte au serveur et modifie la connexion pour ce classeur ou cette source de données, les paramètres de connexion présentent ces informations d'identification OAuth comme intégrées au contenu.

Si vous souhaitez programmer des actualisations d'extraits après la publication, vous devez inclure cette option avec --oauth-username. Cela revient à utiliser la commande --save-db-password avec une connexion de base de données traditionnelle.

--thumbnail-username

Si le classeur contient des filtres utilisateur, les miniatures seront générées en fonction de ce que peut voir l'utilisateur spécifié. Ne peut être spécifié lorsque l'option --thumbnail-group est définie.

--thumbnail-group

Si le classeur contient des filtres utilisateur, les miniatures seront générées en fonction de ce que peut voir le groupe spécifié. Ne peut être spécifié lorsque l'option --thumbnail-usernameest définie.

--tabbed

Lorsqu'un classeur avec des vues présentant des onglets est publié, chaque feuille devient un onglet dont les observateurs peuvent se servir pour naviguer dans le classeur. Notez que ce paramètre remplace la sécurité au niveau des feuilles.

--append

Ajoutez le fichier de l'extrait à la source de données existante.

--replace

Utilisez le fichier de l'extrait pour remplacer la source de données existante.

--disable-uploader

Désactivez l'outil de téléchargement de fichier incrémentiel.

--restart

Redémarrez le téléchargement du fichier.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

refreshextracts workbook-name ou datasource-name

Effectue une actualisation complète ou incrémentielle d'extraits appartenant au classeur ou à la source de données spécifié.

Cette commande utilise le nom du classeur ou de la source de données tel qu'il apparaît sur le serveur, et non le nom de champ lors de sa publication. Seul un administrateur ou le propriétaire du classeur ou de la source de données est autorisé à effectuer cette opération.

Remarque : Dans Tableau Online, vous pouvez utiliser la commande tabcmd pour actualiser les sources de données prises en charge qui sont hébergées sur le cloud. Par exemple, SQL Server, MySQL, PostgreSQL sur une plate-forme de cloud ; Google Analytics ; etc. Pour actualiser les données locales, ou les données Oracle qui sont soit locales, soit hébergées, vous pouvez utiliser Tableau Bridge ou l'utilitaire d'extrait de données à la ligne de commande. Pour en savoir plus, consultez Utiliser Tableau Bridge pour conserver les données Tableau Online à jour et Automatiser les tâches d'actualisation des extraits à la ligne de commande

Exemples

tabcmd refreshextracts --datasource sales_ds

tabcmd refreshextracts --project "Sales External" --datasource sales_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales_ds --removecalculations

Options

--incremental

Exécute l'opération d'actualisation incrémentielle.

--synchronous

Ajoute l'opération d'actualisation complète à la file d'attente utilisée par le processus backgrounder afin qu'elle soit exécutée aussitôt que le backgrounder sera disponible. Si le processus backgrounder est disponible, l'opération s'exécute immédiatement. L'opération d'actualisation apparaît dans le rapport des tâches d'arrière-plan.

Pendant une actualisation synchrone, tabcmd maintient une connexion en direct avec le serveur pendant que l'opération d'actualisation est en cours, avec interrogation à chaque seconde jusqu'à ce que le travail en arrière-plan soit terminé.

--workbook

Nom du classeur contenant les extraits à actualiser. Si le nom du classeur comporte des espaces, placez-le entre guillemets.

--datasource

Nom de la source de données contenant les extraits à actualiser.

--project

Utilisez cette option avec --workbook ou --datasource afin d'identifier un classeur ou une source de données dans un projet autre que Par défaut. Si aucun nom n'est spécifié, le projet Par défaut est utilisé.

--parent-project-path

Spécifie le nom du projet parent pour le projet imbriqué tel qu'il est spécifié avec l'option --project. Par exemple, pour spécifier un projet appelé « imbriqué » existant dans un projet « Main », utilisez la syntaxe suivante : --parent-project-path "Main" --project "Nested".

--url

Nom du classeur tel qu'il apparaît dans l'URL. Le nom URL d'un classeur publié en tant que « Sales Analysis » est « SalesAnalysis ».

--addcalculations

Utilisez avec --workbook pour matérialiser les calculs dans l'extrait intégré du classeur, ou --datasource pour matérialiser les calculs dans la source de données d'un extrait. Ajoute l'opération à la file d'attente utilisée par le processus Backgrounder. Si un processus Backgrounder est disponible, l'opération s'exécute immédiatement. Cette opération apparaît dans la vue administrative Tâches d'arrière-plan pour les extraits .

--removecalculations

Utilisez avec --workbook ou --datasource pour supprimer les calculs qui étaient précédemment matérialisés. Ajoute l'opération à la file d'attente utilisée par le processus Backgrounder. Si un processus Backgrounder est disponible, l'opération s'exécute immédiatement. Cette opération apparaît dans la vue administrative Tâches d'arrière-plan pour les extraits .

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

removeusers group-name

Supprime les utilisateurs du groupe spécifié.

Exemple

tabcmd removeusers "Development" --users "users.csv"

Options

--users

Supprimez du groupe spécifié les utilisateurs qui se trouvent dans le fichier .csv donné. Le fichier doit se composer d'une liste simple avec un nom d'utilisateur par ligne.

Si vous utilisez cette commande avec des fichiers .csv volumineux dans Tableau Server, un administrateur de serveur peut activer les paramètres susceptibles d’améliorer les performances. Pour plus d'informations, consultez Recommandations relatives au fichier d'importation CSV

--[no-]complete

Requiert que toutes les lignes soient valides pour que les modifications prennent effet. Sinon, --complete est utilisé.

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

runschedule schedule-name

Exécute la programmation spécifiée.

Cette commande utilise le nom de la programmation tel qu'il est spécifié sur le serveur.

Pour Tableau Online, la commande peut être exécutée dans le cadre d'un site unique, en utilisant des autorisations d'administrateur du site.

Exemple

tabcmd runschedule "5AM Sales Refresh"

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

version

Affiche les informations de version pour l'installation actuelle de l'utilitaire tabcmd.

Exemple

tabcmd version

Options globales

Les options suivantes sont utilisées par les commandes tabcmd. Les options --server, --user et --password sont requises au moins une fois pour démarrer une session. Un jeton d'authentification est enregistré de sorte que les commandes suivantes puissent être exécutées sans inclure ces options. Ce jeton reste valide pendant cinq minutes après la dernière commande l'ayant utilisé.

-h, --help

Affiche l'aide de la commande.

-s, --server

L'URL Tableau Online, qui est requise au moins une fois pour démarrer la session.

-u, --user

Le nom d'utilisateur Tableau Online, qui est requis au moins une fois pour démarrer une session.

-p, --password

Le mot de passe Tableau Online, qui est requis au moins une fois pour démarrer une session.

--password-file

Permet d'enregistrer le mot de passe dans le fichier .txt indiqué au lieu de le saisir sur la ligne de commande pour plus de sécurité.

-t, --site

Indique que la commande s'applique au site spécifié par l'ID du site Tableau Online. Utilisez cette option si l'utilisateur spécifié est associé à plusieurs sites.

--no-prompt

Lorsque cette option est spécifiée, la commande ne demande pas de mot de passe. Si aucun mot de passe valide n'est fourni, la commande échoue.

--[no-]cookie

Lorsque cette option est spécifiée, l'ID de session est enregistré lors de la connexion afin que les commandes suivantes n'aient pas à se connecter. Utilisez le préfixe no- pour ne pas enregistrer l'ID de session. Par défaut, la session est enregistrée.

--timeout

Permet d'attendre le nombre spécifié de secondes afin que le serveur termine le traitement de la commande. Par défaut, le processus s'interrompt au bout de 30 secondes.

--

Spécifie la fin des options à la ligne de commande. Vous pouvez utiliser -- pour indiquer à tabcmd que tout élément suivant --ne doit pas être interprété comme un réglage d'option et peut au lieu de cela être interprété comme une valeur pour la commande. Cette fonction est utile si vous avez besoin de spécifier une valeur dans la commande qui inclut un tiret. L'exemple suivant vous montre comment vous pouvez utiliser -- dans une commande tabcmd, où -430105/Sheet1 est une valeur requise pour la commande export.

tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1

Merci pour vos commentaires ! Il y a eu une erreur lors de l’envoi de vos commentaires. Essayez à nouveau ou envoyez-nous un message.