1,438
edits
Changes
no edit summary
<languages/>
<div style="float: right;">__TOC__</div>
<!--
== '''Automação de atualizações de dados no TaticView''' ==
-->
Para automatizar as atualizações de dados no TaticView isso, são necessários alguns procedimentos de configuração e uso 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. <span style="color: red;">'''Importante:'''</span> * Para utilizar o TVCli, a máquina onde 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 detalhes 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>).
=== Instalando o TVCli ===
Por enquanto, temos apenas um instalador amigável para Windows. Se você precisar instalar o TVCli em outras plataformas, entre em contato conosco do <u>[https://support.taticview.com Suporte]</u>. Teremos prazer em ajudá-lo a instalar em seu ambiente.
* 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".
Nas duas situações, se você precisar, entre em contato conosco para ajudá-lo.
* '''Execute a instalação''' no computador onde vai ser agendado o TVCli para sua execução.
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/>
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/>
Em [[Java JRE install and troubleshooting/pt-br|Instalando e resolvendo problemas do JRE Java]] nós vamos ajudá-lo se tiver dúvidas de como fazê-lo.
=== Geração do TOKEN de Acesso ===
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 e, posteriormente, cadastrado no TVCli.
Um 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.
Aqui nós vamos lhe mostrar como gerar um token via interface do taticView
É possível gerar o TOKEN de Acesso de duas maneiras:
A principal diferença entre eles além da forma que são gerados, é que [[#Using_TVCli_command_line/pt-br|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.
Para ajudá-lo aqui temos um [[TVCli Commands/pt-br|Wizard]]
Sintaxe do Comando:
'''tvcli -cmd get_token_by_password -user <seu usuário TaticView> -password <sua senha TaticView> [-token_name "<nome para o token>"]
'''
Aqui 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 '''Pelo TVCliGERAR NOVO TOKEN'''.# Um TOKEN de Acesso será gerado [[File:generated-token+pr-BR.png]]# Executar Execute o comando via linha de comando pedindo geração armazenamento de um novo TOKENS do TVCli (<i>store_token</i>), informando o TOKEN DE ACESSOrecém gerado.
Sintaxe do Comando: '''tvcli -cmd - get_token_by_password - Solicita e armazena o TOKEN DE ACESSO via linha de comando (TVCli) store_token -user - <seu usuário TaticView -password - senha TaticView -token_name (opcional) > - Nome que você quer dar ao TOKEN DE ACESSO. Nome default "token <token gerado no TaticView CLI" >'''
Exemplo: '''Via interface do TaticView'''# Identificartvcli -se no TaticView e acessar o '''Minha Conta''' botão '''TOKENS DE ACESSO''';# Em [[File:identificacaocmd store_token -novouser meuemail@email.com -token+pr-BR.png]] informe um nome para identificar o TOKEN DE ACESSO na lista e clique em ''ce699ce43dcbd2caeff1573eeb1d4e44'Gerar novo TOKEN'''.# Um TOKEN DE ACESSO será gerado [[File:generated-token+pr-BR.png]]# Executar o TVCli informando o TOKEN DE ACESSO gerado
{| 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=]]
|}
[[File:datamartautomatic-dropdownimportation+enpr-USBR.pngPNG|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.
Exemplos: '''tvcli -cmd import_file - import_file user meuemail@email.com -datamart 246 - faz upload do arquivo de dados e coloca na fila de atualizaçãofile "\\server\taticview\imp\myspreadsheet.xls"''' '''tvcli -cmd import_file -user meuemail@email.com - usuário TaticView datamart 246 -file "c:\taticview\imp\file.xlsx"''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 - identificador do arquivo de dados obtido na opção propriedades do Arquivo de Dados na Interfacefile "c:\taticview\imp\file.csv" -wait -notifyshare''' '''tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\sales.xlsx" - arquivo de dados Texto (CSV) ou planilha (XLSX,XLS) que será importado.wait''' '''tvcli -type (opcional) cmd import_file - clear_and_add user meuemail@email.com - Exclui todos os dados do Arquivo de Dados do TaticView e importa os novos dados (default) append datamart 246 - Adiciona os novos dados ao final do Arquivo de Dados do TaticView. É necessário ter cuidado para não duplicar dadosfile "c:\taticview\imp\file.xlsx" -type clear_and_add''' '''tvcli -wait (opcional) cmd import_file - aguarda o final da importaçãouser meuemail@email. Necessário para testar com -datamart 246 -file "c:\taticview\imp\file.xlsx" -type append'''Status de Saída ''' tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\file.xlsx" -type append -nonotifyerror (opcional) - não notifica o usuário caso ocorra um erro durante o processo''' '''Call "C:\Program Files\TvCli\tvcli" -notifyshare (opcional) cmd import_file - envia notificação de atualização de dados para os usuários que tem painéis compartilhados desse arquivo de dados quando a importação termina sem errosuser meuemail@email. Funciona somente em conjunto com -datamart 246 -file "D:\taticview\imp\file.xlsx"-wait".'''
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.
==== Avaliando se o comando do TVCli foi executado com sucesso====
'''8 - Erro'''
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:\Users\jonathan.SADIG\Documents\TaticView\Arquivos Importacao\vendasVendas.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:\Users\jonathan.Sadig\Documents\TaticView\Arquivos Importacao\rh.xlsx" -datamart 673 -wait
'''if %errorlevel% == 0 (
'''echo "RH atualizado com sucesso!"
''') else (
'''echo "Problemas na atualizacao 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 <span style="color: red;"i>'''Importante'''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.