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]].

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 ===

É necessário possuir Por enquanto, temos apenas um '''TOKEN DE ACESSO''' cadastrado no TaticView e no TVcli antes de poder executar uma automação de importaçãoinstalador amigável para Windows. Um TOKEN DE ACESSO está sempre associado a um usuário TaticView. O TOKEN DE ACESSO é como uma senha gerada pelo TaticView que permite acesso a sua conta pelo Se você precisar instalar o TVCliem outras plataformas, ele pode ser revogado por você entre em contato conosco do <u>[https://support.taticview.com Suporte]</u>. Teremos prazer em ajudá-lo a qualquer momento, permitindo assim que você decida quem pode acessar sua conta no TaticView e quandoinstalar em seu ambiente.

-cmd - get_token_by_password - Solicita e armazena * '''Execute a instalação''' no computador onde vai ser agendado o TOKEN DE ACESSO via linha de comando (TVcli) -user - usuário TaticView -password - senha TaticView -token_name (opcional) - Nome que você quer dar ao TOKEN DE ACESSOTVCli para sua execução. Nome default "TaticView CLI"

'''Via interface 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 TaticView'''sistema operacional.<br/># Identificar-se no TaticView Para instalar e acessar executar o '''Minha Conta''' botão '''TOKENS DE ACESSO''';TVCli no seu computador é necessário que a JRE do Java 1.8.0_200 ou superior esteja instalada.<br/># Em !identificacao[[Java JRE install and troubleshooting/pt-novobr|Instalando e resolvendo problemas do JRE Java]] nós vamos ajudá-token.png! informe um nome para identificar o TOKEN DE ACESSO na lista e clique em '''Gerar novo TOKEN'''.# Um TOKEN DE ACESSO será gerado !generatedlo se tiver dúvidas de como fazê-tokenlo.png!# Executar o TVcli informando o TOKEN DE ACESSO gerado

Para automatizar as atualizações de dados através do TVCli, é necessário possuir um [[Manage_Access/pt-cmd - store_token - armazena token gerado pela interface -user - usuário br#Tokens|TOKEN de Acesso]] criado no TaticView -token - token gerado pela interfacee, posteriormente, cadastrado no TVCli.

'''Exemplo: 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'''

Somente é É possível automatizar importações gerar o TOKEN de arquivos Acesso de dados já criados no TaticView, portanto é necessário pelo menos uma importação manual para criar a estrutura necessária.duas maneiras:

Depois A principal diferença entre eles além da forma que são gerados, é necessário liberar a importação automática para o arquivo que [[#Using_TVCli_command_line/pt-br|linha de dados desejado.Para isso clique sobre o arquivo importado (na comando]] renova-se automaticamente, enquanto que os tokens criados pela [[#Using_TaticView's_graphical_interface|interface do TaticView), selecionar '''Propriedades''']] não renova-se automaticamente, ou seja expira e marcar o checkbox '''Importação automática''', o que exibirá o código identificador de seu arquivo de dados, como no exemplo abaixo:precisa ser renovada periodicamente pelo usuário.

!automaticPara ajudá-importation.png!.lo aqui temos um [[TVCli Commands/pt-br|Wizard]]

Sintaxe do Comando: '''Sintaxe: tvcli -cmd import_file get_token_by_password -user <seu usuárioTaticView> -datamart password <identificadorsua senha TaticView> [-file token_name "<arquivo/planilhanome para o token>" [-type <tipo>] [-wait] [-noerror] -[notifyshare]'''

-cmd - import_file get_token_by_password - faz upload do arquivo de dados Comando responsável em solicitar ao TaticView e coloca na fila armazenar o TOKEN de importaçãoAcesso nas configurações do TVCli. -user - Seu usuário do TaticView -datamart - identificador do arquivo de dados obtido na opção propriedades do Arquivo de Dados na Interface. -file - arquivo (email de dados Texto (CSVacesso) ou planilha (XLSX,XLS) que será importado. -type (opcional) - clear_and_add password - Exclui todos os dados do Arquivo Sua senha de Dados do TaticView e importa os novos dados (default) append - Adiciona os novos dados acesso ao final do Arquivo de Dados do TaticView. É necessário ter cuidado para não duplicar dados. -wait token_name (opcional) - aguarda o final da importaçãoNome que você deseja atribuir ao TOKEN de Acesso. Necessário para testar '''Status de Sáida''' -noerror (opcional) - Caso você não notifica informe nenhum nome será atribuído o usuário caso ocorra um erro durante o processo -notifyshare (opcinal) - envia notificação de atualização de dados para os usuários que tem dashboards compartilhados desse arquivo de dados quando a importação termina sem errosnome padrão "TaticView CLI".

'''Exemplo:''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx"''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\arquivo.csv" -notifyshare''' '''tvcli -cmd import_file get_token_by_password -user meuemail@email.com -datamart 246 password 123466 -file token_name "c:\taticview\imp\planilha.xlsxTVCli Servidor 1" -wait''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx" -type clear_and_add''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx" -type append''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx" -type append -noerror'''

=== Teste de retorno Aqui mostraremos como gerar um token pela interface do comando ===TaticView.

O executável # Na [[Main Page Overview/pt-br|tela principal]] do TVcli retorna códigos distintos 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 informar identificar o sucesso ou falha TOKEN de Acesso na execuçãolista e clique em '''GERAR NOVO TOKEN'''.# Um TOKEN de Acesso será gerado [[File:generated-token+pr-BR.png]]# Execute o comando de armazenamento de TOKENS do TVCli (<i>store_token</i>), informando o TOKEN recém gerado.

Sintaxe do Comando: '''tvcli -cmd store_token -user <seu usuário TaticView> -token <token gerado no TaticView>'''  -cmd - store_token - Comando responsável por armazenar os tokens gerados diretamente no TaticView. -user - Seu usuário do TaticView (email de acesso). -token - Token gerado no TaticView. Exemplo: '''tvcli -cmd store_token -user meuemail@email.com -token ce699ce43dcbd2caeff1573eeb1d4e44''' === Atualizando seus dados de forma automática === Somente é possível automatizar a atualização de arquivos de dados já criados no TaticView. 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-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 "C:\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'''

A notification is sent to the user if an error occurs during the import processVocê pode tratar os códigos de retorno no seu arquivo BAT.A log with the imports details is generated in the logs directory, below the directory where TVcli was installedPara 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! )

'''@ECHO OFF''' '''call C:\TaticView\tvcli -cmd import_file -user meuemailjonathan@emailsadig.com -datamart 246 -file "cC:\taticviewTaticView\impArquivos Importacao\planilhaVendas.xlsx" -notifysharedatamart 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! '''Error notification by email) else ( '''echo Problemas na atualização do RH! '''fi)'''

O TaticView tem um wizard para ajudá-lo neste processo, na tela de propriedades dos Arquivos de Dados ao clicar no link <span style="color: red;"i>'''Important'''Ajuda para gerar os comandos de automação?</spani>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.

The free version grants you automation import from only one data sourceCaso tenha dificuldades durante o processo de configuração do [[TVCli/pt-br|TVCli]], abra um [https://support. You need to configure the feature "*automatic data update*" in your subscription to automate the imports of more data sourcestaticview.com/open.php/?&lang=pt_br ticket de suporte]. Teremos prazer em lhe ajudar.