1,438
edits
Changes
no edit summary
<languages/>
<translate>
<!--T:39--><div style="float: right;">__TOC__</div> <!--== '''Data Import update automation on TaticView''' == <!--T:1-->-->
<!--T:2-->
<!--T:3-->
<!--T:4-->
=== Installing TVcli TVCli === <!--T:5-->
<!--T:65-->
For now, we have only a user friendly installer for Windows. If you need install TVCli in other platforms, please contact us at <u>[https://support.taticview.com Support]</u>. We are glad to to help you to install it in you environment.
<!--T:6-->
<!--T:7-->
<!--T:59-->TVCli works through command line. The best way to automate the execution is creating a script, after that, you can schedule it to run on the system task scheduler.<br/>To install and execute TVCli on you computer we need Java JRE version 1.8.0_200 or newer installed.<br/>On [[Java JRE install and troubleshooting]] we can help you in case of doubts. === ACCESS Generating the Access TOKEN generation === <!--T:8-->
<!--T:9-->
<!--T:10-->
<!--T:61-->
The main difference between them, besides the way they are generated, is that [[#Using_TVCli_command_line|command line]] selves, while the created by [[#Using_TaticView's_graphical_interface|TaticView interface]] don't refresh them selves (expire), and need to be recreated.
<!--T:13-->
-cmd - get_token_by_password - Requests The command responsible for requesting and stores storing the ACCESS Access TOKEN through command lineon the TVCli settings. (TVcli) -user - Your TaticView user(access email). -password - Your TaticView access password. -token_name (optional) - The name that you want to give set to the access tokenyour Access TOKEN. Default The default name "'''TaticView CLI''' will be set if you do not specify a name. <!--T:14-->Example: '''tvcli -cmd get_token_by_password -user myemail@email.com -password 123466 -token_name "TVCli Server 1" ''' ====Using TaticView's graphical interface==== <!--T:15-->
<!--T:17-->
-cmd - store_token - stores token The command responsible for storing the TOKENS generated through the interfaceon TaticView. -user - Your TaticView user (access email). -token - The token generated through the interfaceon TaticView.
=== Updating your data automatically === <!--T:19-->
<!--T:2041-->You can only automate the import of data files After that have been already created on TaticView, so you are going it will be necessary to need at least one manual import to create the necessary structure.Then you must grant enable the automatic import update to the desired data file..To do For this click on you must access the imported file (On properties of the TaticView interface), select desired ''Datasource'Properties''', and check . Access is available in the checkbox '''Automatic Importation''', which displays context menu of the identifier code of your data file, as you can see Datasource card in the example below[[Main Page Overview|TaticView main page]]: <!--T:45-->{| class="images-table"| On desktop|-|[[File:Datasources properties en-US.png|link=]]|-| In mobile devices|-|[[File:Datasources options mobile en-US.png|link=]] [[File:Datasources properties mobile en-US.png|link=]]|}
<!--T:46-->
Then, the ''Automatic importation'' option should be enabled. When you do this, you will see the data file code, as in the example below:
<!--T:22-->
[[File:automatic-importation+en-US.pngPNG]]
<!--T:23-->
<!--T:25-->
-cmd - import_file - Command that uploads the data file your files and places it in add them to the import update queue. -user - Your TaticView user (access email). -datamart - identifier The identification code of the data file obtained in through the Data file properties at option on the interfaceTaticView main page. -file - Text data file The address of the text (CSV) or spreadsheet (XLSX,XLS, XLSM) to data file that will be importedupdated. You can use mapped drives (Ex.: C:\, D:\) or UNC address (Ex.: \\server\folder\file). -type (opcional) - clear_and_add - Deletes all every data from the TaticView 's Data File and imports the new data. (This is TVCli's default)behavior. append - Adds the It adds new data at to your TaticView's data files file/spreadsheet while still keeping the end of the TaticView Data Filepreviously imported data. It is necessary 's important to make sure to be careful not to duplicate any data. -wait (opcional) - waits for Command that makes TVCli wait the end of the importyour data updates along with TaticView. It is needed 's necessary in case you want to test '''Output Status'''commands responses (ERROR_LEVEL). -noerror nonotifyerror (opcional) - does Command used to not notify the user if in case of an error occurs occurring during the update process. -notifyshare (opcinalopcional) - sends data update Command used to send a notification to the users who have these own shared dashboards informing that the data file dashboards shared update finished successfully. This command only works when used with the importing process ends without errors<i>-wait</i> command. <!--T:26-->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'''
<!--T:53-->
You can create BAT files to schedule a bunch of TVCli commands. Doing so the entire process can be automated. As you can schedule using Windows scheduler or other similar tool.
<!--T:54-->'''''Attention'''''<br>To execute TVCli from a BAT file, you have to use the Windows [https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/call CALL] command. Ie.: '''CALL''' C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\Users\jonathan\Documents\TaticView\Import Files\rh.xlsx" -datamart 673 -wait === Command return test = Evaluating if command execution was successful ==== <!--T:27-->
<!--T:28-->
<!--T:29-->
'''0 - Success''' '''8 - Error'''
<!--T:30-->
<!--T:3156-->An example of Windows running script:if %errorlevel% == 0 ( echo SALES updated successfully! ) else ( echo Problems updating SALES! )
<!--T:32-->
'''@ECHO OFF'''
'''call C:\TaticView\tvcli -cmd import_file -user my@email.com -file "C:\TaticView\Import Files\sales.xlsx" -datamart 674 -wait
'''if %errorlevel% == 0 (
'''echo SALES updated successfully!
''') else (
'''echo Problems updating SALES!
''')
'''call C:\TaticView\tvcli -cmd import_file -user my@email.com -file "C:\TaticView\Import Files\hr.xlsx" -datamart 673 -wait
'''if %errorlevel% == 0 (
'''echo HR updated successfully!
''') else (
'''echo Problems updating HR!
''')'''
=== More questions on how generate the automation commands? === <!--T:3342--><span style="color: red;">'''Important'''</span>
<!--T:3444-->The free version grants TaticView has a wizard the help you on this, on the Data Files properties screen, when clicking the link <i>help to generate automation import from only one data sourcecommands?</i>, it will display the [[TVCli Commands]] screen, where you can obtain preset TVCli commands. You need All you have to configure the feature '''automatic data update''' in your subscription to automate the imports of more do is inform some required data sources.
<!--T:43-->
You can also open a [https://support.taticview.com/open.php/?&lang=en_US support ticket]. In case you are having problems during the TVCli configuration process. It will be a pleasure to help you.
</translate>