Difference between revisions of "TVCli Commands Reference"
| (11 intermediate revisions by the same user not shown) | |||
| Line 11: | Line 11: | ||
<!--T:30--> | <!--T:30--> | ||
| − | '''TVCli sending data to a | + | '''TVCli sending data to a Datasource''' |
<!--T:31--> | <!--T:31--> | ||
| − | Use '''import_file''' to send data to a | + | Use '''import_file''' to send data to a Datasource. |
You can see a [[Automate_Update_data#Updating_your_data_automatically|tutorial]] to help in this process, and we have a [[TVCli_Commands#Data_update_command|graphic wizard]] interface to help you on building a complete command | You can see a [[Automate_Update_data#Updating_your_data_automatically|tutorial]] to help in this process, and we have a [[TVCli_Commands#Data_update_command|graphic wizard]] interface to help you on building a complete command | ||
| − | |||
<!--T:32--> | <!--T:32--> | ||
| Line 25: | Line 24: | ||
<!--T:25--> | <!--T:25--> | ||
-cmd - import_file - Command that uploads your files and add them to the update queue. | -cmd - import_file - Command that uploads your files and add them to the update queue. | ||
| − | -user - Your TaticView user (access | + | -user - Your TaticView user (access email). |
-datamart - The identification code of the data file obtained through the properties option on the TaticView main page. | -datamart - The identification code of the data file obtained through the properties option on the TaticView main page. | ||
-file - The address of the text (CSV) or spreadsheet (XLSX, XLS, XLSM) data file that will be updated. You can use mapped drives (Ex.: C:\, D:\) or UNC address (Ex.: \\server\folder\file). | -file - The address of the text (CSV) or spreadsheet (XLSX, XLS, XLSM) data file that will be updated. You can use mapped drives (Ex.: C:\, D:\) or UNC address (Ex.: \\server\folder\file). | ||
| Line 48: | Line 47: | ||
<!--T:34--> | <!--T:34--> | ||
| − | '''TVCli generate | + | '''TVCli generate and store/save new token on local repository''' |
<!--T:35--> | <!--T:35--> | ||
| − | Use '''get_token_by_password''' command to request the generation of a new '''[[Manage_Access#Tokens| | + | Use '''get_token_by_password''' command to request the generation of a new '''[[Manage_Access#Tokens|access TOKEN]]'''. |
<!--T:36--> | <!--T:36--> | ||
| Line 63: | Line 62: | ||
<!--T:38--> | <!--T:38--> | ||
-cmd - get_token_by_password - The command responsible for requesting and storing the Access TOKEN on the TVCli settings. | -cmd - get_token_by_password - The command responsible for requesting and storing the Access TOKEN on the TVCli settings. | ||
| − | -user - Your TaticView user (access | + | -user - Your TaticView user (access email). |
-password - Your TaticView access password. | -password - Your TaticView access password. | ||
-token_name (optional) - The name you want to set to your Access TOKEN. The default name '''TaticView CLI''' will be set if you do not specify a name. | -token_name (optional) - The name you want to set to your Access TOKEN. The default name '''TaticView CLI''' will be set if you do not specify a name. | ||
| Line 69: | Line 68: | ||
<!--T:39--> | <!--T:39--> | ||
Example: | Example: | ||
| − | '''tvcli -cmd get_token_by_password -user myemail@email.com -password 123466 -token_name "TVCli | + | '''tvcli -cmd get_token_by_password -user myemail@email.com -password 123466 -token_name "TVCli sample token" ''' |
| − | === store_token === | + | === store_token === <!--T:49--> |
| − | '''TVCli store/save | + | <!--T:50--> |
| − | + | '''TVCli store/save token on local repository''' | |
| + | <!--T:51--> | ||
Use '''store_token''' command to store a previously generated '''[[Manage_Access#Tokens|access TOKEN]]''' in TVCli Token Store. | Use '''store_token''' command to store a previously generated '''[[Manage_Access#Tokens|access TOKEN]]''' in TVCli Token Store. | ||
| − | + | <!--T:52--> | |
You can see a [[Automate_Update_data#Updating_your_data_automatically|tutorial]] to help in this process, and we have a [[TVCli_Commands#Token_creation_command|graphic wizard]] interface to help you on building a complete command | You can see a [[Automate_Update_data#Updating_your_data_automatically|tutorial]] to help in this process, and we have a [[TVCli_Commands#Token_creation_command|graphic wizard]] interface to help you on building a complete command | ||
| + | <!--T:53--> | ||
Command Syntax: | Command Syntax: | ||
| − | '''tvcli -cmd store_token -user <your TaticView user> -token <the token generated on TaticView> | + | '''tvcli -cmd store_token -user <your TaticView user> -token <the token generated on TaticView>''' |
| − | -cmd - store_token - The command save the informed '''[[Manage_Access#Tokens|access TOKEN]]''' the TVCli Token Store for future use. | + | <!--T:54--> |
| − | -user - Your TaticView user (access | + | -cmd - store_token - The command save the informed '''[[Manage_Access#Tokens|access TOKEN]]''' the TVCli Token Store for future use. |
| + | -user - Your TaticView user (access email). | ||
-token - the '''[[Manage_Access#Tokens|access TOKEN]]'''. | -token - the '''[[Manage_Access#Tokens|access TOKEN]]'''. | ||
| − | |||
| + | <!--T:55--> | ||
Example: | Example: | ||
| − | '''tvcli -cmd store_token -user myemail@email.com -token 9bdr845gh5r4r1vd5d5 | + | '''tvcli -cmd store_token -user myemail@email.com -token 9bdr845gh5r4r1vd5d5''' |
===version=== <!--T:40--> | ===version=== <!--T:40--> | ||
Latest revision as of 13:32, 15 April 2023
TVCli Commands Reference
Here you can read about the commands and options available for TVCli.
import_file
TVCli sending data to a Datasource
Use import_file to send data to a Datasource. You can see a tutorial to help in this process, and we have a graphic wizard interface to help you on building a complete command
Command Syntax:
tvcli -cmd import_file -user <your TaticView user> -datamart < data file identification code> -file "<file/spreadsheet address>" [-type "<type>"] [-wait [-notifyshare]] [-nonotifyerror]
-cmd - import_file - Command that uploads your files and add them to the update queue.
-user - Your TaticView user (access email).
-datamart - The identification code of the data file obtained through the properties option on the TaticView main page.
-file - The address of the text (CSV) or spreadsheet (XLSX, XLS, XLSM) data file that will be updated. You can use mapped drives (Ex.: C:\, D:\) or UNC address (Ex.: \\server\folder\file).
-type (opcional) - clear_and_add - Deletes every data from the TaticView's Data File and imports new data. This is TVCli's default behavior.
append - It adds new data to your TaticView's data files file/spreadsheet while still keeping the previously imported data. It's important to make sure to not duplicate any data.
-wait (opcional) - Command that makes TVCli wait the end of your data updates along with TaticView. It's necessary in case you want to test commands responses (ERROR_LEVEL).
-nonotifyerror (opcional) - Command used to not notify the user in case of an error occurring during the update process.
-notifyshare (opcional) - Command used to send a notification to the users who own shared dashboards informing that the data update finished successfully. This command only works when used with the -wait command.
Example:
tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "\\servidor\taticview\imp\myspreadsheet.xls" tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\spreadsheet.xlsx" tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\file.csv" -wait -notifyshare tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\spreadsheet.xlsx" -wait tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\spreadsheet.xlsx" -type clear_and_add tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\spreadsheet.xlsx" -type append tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "C:\taticview\imp\spreadsheet.xlsx" -type append -nonotifyerror Call "C:\Program Files\TvCli\tvcli" -cmd import_file -user myemail@email.com -datamart 246 -file "D:\taticview\imp\spreadsheet.xlsx" -wait
get_token_by_password
TVCli generate and store/save new token on local repository
Use get_token_by_password command to request the generation of a new access TOKEN.
You can see a tutorial to help in this process, and we have a graphic wizard interface to help you on building a complete command
Command Syntax:
tvcli -cmd get_token_by_password -user <your TaticView user> -password <your TaticView password> [-token_name "<token name>"]
-cmd - get_token_by_password - The command responsible for requesting and storing the Access TOKEN on the TVCli settings. -user - Your TaticView user (access email). -password - Your TaticView access password. -token_name (optional) - The name you want to set to your Access TOKEN. The default name TaticView CLI will be set if you do not specify a name.
Example:
tvcli -cmd get_token_by_password -user myemail@email.com -password 123466 -token_name "TVCli sample token"
store_token
TVCli store/save token on local repository
Use store_token command to store a previously generated access TOKEN in TVCli Token Store.
You can see a tutorial to help in this process, and we have a graphic wizard interface to help you on building a complete command
Command Syntax:
tvcli -cmd store_token -user <your TaticView user> -token <the token generated on TaticView>
-cmd - store_token - The command save the informed access TOKEN the TVCli Token Store for future use. -user - Your TaticView user (access email). -token - the access TOKEN.
Example:
tvcli -cmd store_token -user myemail@email.com -token 9bdr845gh5r4r1vd5d5
version
TVCli show version
Use the version command to see which TVCli version is installed on your computer. This command displays the TVCli version on the console and registers it on the TVCli log.
Command Syntax:
tvcli -version
show_logs
TVCli show log
since TVCli version 1.1
Use the show_logs command to show the log file.
Command Syntax:
tvcli -cmd show_logs - Show the current day logs tvcli -cmd show_logs -all - Show all logs in the logs directory
