== '''Automação de importações de dados no TaticView''' ==<languages/>
Você pode através dess processo automatizar importações dos seus Arquivos de Dados.<div style="float: right;">__TOC__</div>
Para automatizar as importações <!--== '''Automação de atualizações de dados no TaticView são necessário alguns procedimentos de configuração e uso do programa de linha de comando TVcli. ''' ==-->
Caso tenha dificuldades abra um ticket Com o TaticView é possível automatizar as atualizações das informações dos seus [[Data Sources/pt-br|Arquivos de suporte em https://support.taticview.com/open.php/?&lang=pt_br. Teremos prazer em lhe ajudarDados]].
=== Instalando o TVcli ===Para isso, são necessários alguns procedimentos de configuração e também a utilização do programa de linha de comando [[TVCli/pt-br|TVCli]].
Veja abaixo os passos necessários para automatizar a atualização dos seus dados.
Primeiramente baixe o instalador:
* Windows
* Linux
* Mac-OS
Depois execute <span style="color: red;">'''Importante:'''</span> * Para utilizar o TVCli, a instalação na mesma máquina onde estarão o mesmo será configurado deverá possuir o java a partir da versão <i>8</i> instalado. Se for executada uma versão de Java inferior a 8 será exibida uma mensagem de erro "Unsupported major.minor version 52.0", veja [[Java JRE install and troubleshooting/pt-br|Instalando o Java e resolvendo problemas]] para mais ajuda.* Uma notificação será enviada para o usuário caso ocorra erro na atualização. * Uma log com os arquivos que serão importados automaticamentedetalhes das execuções será gerada no diretório de configurações do usuário (exemplo: <i>C:\Usuários\<usuário>\AppData\Local\TVCli\Logs</i>).
=== Geração do TOKEN DE ACESSO Instalando o TVCli ===
You must have an '''ACCESS TOKEN''' registered on TaticView and TVcli before you can run an automation importPor enquanto, temos apenas um instalador amigável para Windows. An ACCESS TOKEN is always related with a TaticView userSe você precisar instalar o TVCli em outras plataformas, entre em contato conosco do <u>[https://support.taticview.com Suporte]</u>. The ACCESS TOKEN is like Teremos prazer em ajudá-lo a password generated by TaticView which allows access to your account through TVCli. It can be revoked by you at any time, allowing you to decide who and when can access your account on TaticViewinstalar em seu ambiente.
You can generate the ACCESS TOKEN in two ways:* Baixe a [[TVCli Download/pt-br|versão atual]]
O navegador pode tentar bloquear o download do instalador. Se você não conseguir fazer o download, entre em contato com o nosso suporte.
O Windows também pode bloquear a execução do instalador para proteger o computador. Nesse caso, continue a instalação através da opção "Mais informações".
'''Through TVcli'''# Run the command through command line requesting the generation of a new ACCESS TOKENNas duas situações, se você precisar, entre em contato conosco para ajudá-lo.
'''Syntax: tvcli -cmd get_token_by_password -user <user name> -password <user password> [-token_name "<token name>"]'''
-cmd - get_token_by_password - Requests and stores the ACCESS TOKEN through command line* '''Execute a instalação''' no computador onde vai ser agendado o TVCli para sua execução. (TVcli) -user - TaticView user -password - TaticView password -token_name (optional) - The name that you want to give to the access token. Default name "TaticView CLI"
'''Example: tvcli -cmd get_token_by_password -user myemail@email.com -password 123466 -token_name "TVcli Server 1"'''
TVCli é executado via linha decomando. A melhorar forma de automatizar a execução é criar um script, e em seguida você pode agendá-lo para executar no agendador do sistema operacional.<br/>'''Through TacticView interface'''Para instalar e executar o TVCli no seu computador é necessário que a JRE do Java 1.8.0_200 ou superior esteja instalada.<br/># Identify yourself on TaticView Em [[Java JRE install and access the '''My account''' button '''ACCESS TOKENS''';# On !identificacaotroubleshooting/pt-novobr|Instalando e resolvendo problemas do JRE Java]] nós vamos ajudá-token.png! enter a name to identify the ACCESS TOKEN on the list and then click on '''Generate new TOKEN'''.# An ACCESS TOKEN will be generated !generatedlo se tiver dúvidas de como fazê-tokenlo.png!# Run TVcli informing the generated ACCESS TOKEN
'''Syntax: tvcli -cmd store_token -user <user name> -token <generated token>'''=== Geração do TOKEN de Acesso ===
-cmd - store_token - stores token generated through the interface -user Para automatizar as atualizações de dados através do TVCli, é necessário possuir um [[Manage_Access/pt- br#Tokens|TOKEN de Acesso]] criado no TaticView user -token - The token generated through the interfacee, posteriormente, cadastrado no TVCli.
'''Example: tvcli -cmd store_token -user meuemail@emailUm TOKEN de Acesso está sempre associado a um usuário TaticView e é como uma senha gerada pelo TaticView que permite acesso a sua conta pelo TVCli. Ele pode ser revogado por você a qualquer momento, permitindo assim que você decida quem pode acessar sua conta no TaticView e quando. Lembrando que este acesso permite apenas a atualização dos Arquivos de Dados que estão configurados para serem atualizados automaticamente. O Acesso a seus painéis é liberado exclusivamente utilizando o seu usuário e senha.com -token 9bdr845gh5r4r1vd5d5'''
=== Importing in an automated way ===Aqui nós vamos lhe mostrar como gerar um token via interface do taticView
You can only automate the import of data files that have been already created on TaticView, so you are going to need at least one manual import to create the necessary structure.Then you must grant the automatic import to the desired data file..To do this click on the imported file (On the TaticView interface), select '''Properties''', and check the checkbox '''Automatic Importation''', which displays the identifier code of your data file, as you can see in the example belowÉ possível gerar o TOKEN de Acesso de duas maneiras:
!datamartA principal diferença entre eles além da forma que são gerados, é que [[#Using_TVCli_command_line/pt-dropdownbr|linha de comando]] renova-se automaticamente, enquanto que os tokens criados pela [[#Using_TaticView's_graphical_interface|interface do TaticView]] não renova-se automaticamente, ou seja expira e precisa ser renovada periodicamente pelo usuário.png!
!automatic====Usando TVCli (linha de comando)====Executar o comando via linha de comando do Windows o pedindo de geração de um novo [[Manage_Access/pt-importation.png!br#Tokens|TOKEN de Acesso]].
Once the data file is imported, granted for automatic import and you have your identification code, you can run the import through the command line.Para ajudá-lo aqui temos um [[TVCli Commands/pt-br|Wizard]]
'''Syntax: tvcli -cmd import_file -user <user name> -datamart <identifier> -file "<file/spreadsheet>" [-type <type>] [-wait] [-noerror] -[notifyshare]'''
Sintaxe do Comando: '''tvcli -cmd - import_file - uploads the data file and places it in the import queue get_token_by_password -user - <seu usuário TaticView user -datamart - identifier of the data file obtained in the Data file properties at the interface. -file - Text data file (CSV) or spreadsheet (XLSX,XLS) to be imported. > -type (opcional) - clear_and_add - Deletes all data from password <sua senha TaticView Data File and imports the new data. (default) append > [- Adds the new data at the end of the TaticView Data File. It is necessary to be careful not to duplicate any data.token_name "<nome para o token>"] -wait (opcional) - waits for the end of the import. It is needed to test '''Output Status''' -noerror (opcional) - does not notify the user if an error occurs during the process -notifyshare (opcinal) - sends data update notification to users who have these data file dashboards shared when the importing process ends without errors.
'''Example:''' '''tvcli -cmd import_file -user myemail@email.com -datamart 246 get_token_by_password -file "c:\taticview\imp\spreadsheetComando responsável em solicitar ao TaticView e armazenar o TOKEN de Acesso nas configurações do TVCli.xlsx"''' '''tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "c:\taticview\imp\file.csv" -notifyshare''' '''tvcli -cmd import_file -user myemail@Seu usuário do TaticView (emailde acesso).com -datamart 246 -file "c:\taticview\imp\spreadsheet.xlsx" -wait''' '''tvcli -cmd import_file password -user myemail@email.com -datamart 246 -file "c:\taticview\imp\spreadsheetSua senha de acesso ao TaticView.xlsx" -type clear_and_add''' '''tvcli -cmd import_file token_name (opcional) -user myemail@emailNome que você deseja atribuir ao TOKEN de Acesso.com -datamart 246 -file Caso você não informe nenhum nome será atribuído o nome padrão "c:\taticview\imp\spreadsheet.xlsxTaticView CLI" -type append''' '''tvcli -cmd import_file -user myemail@email.com -datamart 246 -file "c:\taticview\imp\spreadsheet.xlsx" -type append -noerror'''
Exemplo:
'''tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli Servidor 1"'''
=== Command return test =Usando a interface gráfica do TaticView====
The TVCI executable returns different codes to report the success or failure during the execution processAqui mostraremos como gerar um token pela interface do TaticView.
# Na [[Main Page Overview/pt-br|tela principal]] do TaticView, acesse a opção [[User profile/pt-br|Minha Conta]] e clique no botão [[Tokens/pt-br|TOKENS de Acesso]];# Em [[File:identificacao-novo-token+pr-BR.png]] informe um nome para identificar o TOKEN de Acesso na lista e clique em '''0 - SuccessGERAR NOVO TOKEN'''. '''8 # Um TOKEN de Acesso será gerado [[File:generated-token+pr- Error'''BR.png]]# Execute o comando de armazenamento de TOKENS do TVCli (<i>store_token</i>), informando o TOKEN recém gerado.
A notification is sent to the user if an error occurs during the import process.
A log with the imports details is generated in the logs directory, below the directory where TVcli was installed.
An example of Windows running scriptSintaxe do Comando: '''tvcli -cmd store_token -user <seu usuário TaticView> -token <token gerado no TaticView>'''
'''tvcli -cmd import_file -user meuemail@email.com store_token -datamart 246 -file "c:\taticview\imp\planilhaComando responsável por armazenar os tokens gerados diretamente no TaticView.xlsx" -notifyshare''' '''if errorlevel <> 0''' '''Error notification by -user - Seu usuário do TaticView (email'''de acesso). '''fi'''-token - Token gerado no TaticView.
Exemplo:
'''tvcli -cmd store_token -user meuemail@email.com -token ce699ce43dcbd2caeff1573eeb1d4e44'''
<span style="color: red;">'''Important'''</span>== Atualizando seus dados de forma automática ===
The free version grants you automation import from only one data sourceSomente é possível automatizar a atualização de arquivos de dados já criados no TaticView. You need to configure the feature Portanto é necessário realizar pelo menos uma importação manual do seu arquivo/planilha para que a estrutura necessária seja criada no TaticView. Após, é necessário liberar a atualização automática para o Arquivo de Dados desejado. Para isso você deverá acessar as propriedades do ''arquivo de dados'' desejado. O acesso está disponível no menu de contexto do cartão do arquivo de dados, na [[Main Page Overview/pt-br|página principal do TaticView]]: {| class="images-table"*| No desktop|-|[[File:Datasources properties pt-BR.png|link=]]|-| Nos dispositivos móveis|-|[[File:Datasources options mobile pt-BR.png|link=]] [[File:Datasources properties mobile pt-BR.png|link=]]|} Em seguida, a opção ''Atualização automática'' deverá ser habilitada. Ao fazer isso, será exibido o código do arquivo de dados, como no exemplo abaixo: [[File:automatic data update*-importation+pr-BR.PNG|link=]] Estando o arquivo de dados liberado para atualização automática, será possível executar a atualização dos dados automaticamente por linha de comando, utilizando o seu código identificador. Sintaxe do Comando: '''tvcli -cmd import_file -user <seu usuário TaticView> -datamart <código identificador do arquivo de dados> -file "<caminho para o arquivo/planilha>" [-type "<tipo>"] [-wait [-notifyshare]] [-nonotifyerror] ''' -cmd - import_file - Comando que faz o upload do seu arquivo/planilha e coloca na fila de atualização. -user - Seu usuário TaticView (email de acesso). -datamart - Código identificador do arquivo de dados obtido na opção Propriedades do Arquivo de Dados, na tela principal do TaticView. -file - Caminho onde encontra-se o seu arquivo de dados Texto (CSV) ou planilha (XLSX, XLS, XLSM) que será importado. Você pode utilizar unidades mapeadas (Ex.: C:\, D:\) ou então caminhos UNC (Ex.: \\servidor\pasta\arquivo). -type (opcional) - clear_and_add - Exclui todos os dados do Arquivo de Dados do TaticView e importa os novos dados. Este é o comportamento padrão do TVCli. append - Adiciona dados do seu arquivo/planilha no Arquivo de Dados do TaticView, mantendo os dados importados anteriormente. É necessário ter cuidado para não duplicar dados. -wait (opcional) - Comando que faz o TVCli aguardar o final da atualização dos seus dados junto ao TaticView. Necessário caso você queira efetuar testes de retorno dos comandos. -nonotifyerror (opcional) - Comando utilizado para NÃO notificar o usuário caso ocorra um erro durante o processo de atualização. -notifyshare (opcional) - Comando utilizado para enviar uma notificação de atualização dos dados para os usuários que possuem painéis compartilhados desse arquivo de dados quando a importação termina sem erros. Funciona somente em conjunto com o comando <i>-wait</i>. Exemplos: '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "\\server\taticview\imp\myspreadsheet.xls"''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.xlsx"''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.csv" -wait -notifyshare''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\sales.xlsx" -wait''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.xlsx" -type clear_and_add''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.xlsx" -type append''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.xlsx" -type append -nonotifyerror''' '''Call "C:\Program Files\TvCli\tvcli" -cmd import_file -user meuemail@email.com -datamart 246 -file "D:\taticview\imp\file.xlsx" -wait''' === Executando TVCli em um arquivo BAT (Script) === Você pode criar arquivos BAT para agendar vários comandos ao TVCli. Fazendo isso, o processo inteiro de atualização de dados pode ser automatizado. Já que você pode agendar a execução destes arquivos BAT no agendador do Windows, ou em uma ferramenta similar. '''''Atenção'''''<br>Para executar o TVCli em um arquivo BAT, é necessário usar o comando [https://docs.microsoft.com/pt-br/windows-server/administration/windows-commands/call CALL] do Windows. Por exemplo: '''CALL''' C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file " in your subscription to automate the imports of more data sourcesC:\Users\jonathan\Documents\TaticView\Import Files\rh.xlsx" -datamart 673 -wait ==== Avaliando se o comando do TVCli foi executado com sucesso==== Ao final da execução do comando o TVCli retorna códigos distintos para informar o sucesso ou falha na execução de seus comandos. Isto permite que os arquivos BAT verifiquem se a execução prévia do comando pelo TVCli teve sucesso ou não. Existem dois códigos de retorno possíveis: '''0 - Sucesso''' '''8 - Erro''' Você pode tratar os códigos de retorno no seu arquivo BAT.Para isso você pode usar a variável de ambiente [https://docs.microsoft.com/pt-br/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/cc754335(v=ws.11) ERROLEVEL] do Windows. Por exemplo: if %errorlevel% == 0 ( echo Vendas atualizado com sucesso! ) else ( echo Problemas na atualização do Vendas! ) ==== Exemplo de BAT (Script) ====Abaixo nós lhe mostramos um exemplo de um BAT que importa dois arquivos para dois arquivo de dados diferentes (ids 674 e 673)e testamos a variável ERRORLEVEL para determinar se a execução do comando de atualização de dados foi executado com sucesso. '''@ECHO OFF''' '''call C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\TaticView\Arquivos Importacao\Vendas.xlsx" -datamart 674 -wait '''if %errorlevel% == 0 ( '''echo VENDAS atualizado com sucesso! ''') else ( '''echo Problemas na atualizacao do VENDAS! ''') '''call C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\TaticView\Arquivos Importacao\rh.xlsx" -datamart 673 -wait '''if %errorlevel% == 0 ( '''echo RH atualizado com sucesso! ''') else ( '''echo Problemas na atualização do RH! ''')''' === Mais dúvidas sobre como gerar os comandos de automação? === O TaticView tem um wizard para ajudá-lo neste processo, na tela de propriedades dos Arquivos de Dados ao clicar no link <i>Ajuda para gerar os comandos de automação?</i> será exibida a tela [[TVCli Commands/pt-br|Comandos TVCli]] onde você poderá obter os comandos do TVCli já configurados, basta informar alguns dados necessários. Caso tenha dificuldades durante o processo de configuração do [[TVCli/pt-br|TVCli]], abra um [https://support.taticview.com/open.php/?&lang=pt_br ticket de suporte]. Teremos prazer em lhe ajudar.