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

Uma notificação será enviada para o usuário caso ocorra erro na importaçãoVocê pode tratar os códigos de retorno no seu arquivo BAT.Uma log Para isso você pode usar a variável de ambiente [https://docs.microsoft.com os detalhes das importações é gerada no diretório logs abaixo /pt-br/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/cc754335(v=ws.11) ERROLEVEL] do diretório que o TVcli foi instaladoWindows.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.