Automação da Atualização dos dados

From TaticView
Revision as of 17:35, 7 March 2018 by Jonathan (talk | contribs)
Jump to: navigation, search
Other languages:
English • ‎português do Brasil


Com o TaticView é possível automatizar as atualizações das informações dos seus Arquivos de Dados.

Para isso, são necessários alguns procedimentos de configuração e também a utilização do programa de linha de comando TVCli.

Veja abaixo os passos necessários para automatizar a atualização dos seus dados.


Importante:

  • O TVCli funciona com o java a partir da versão 7.0_80. Porém, recomendamos que seja utilizado o Java 8, pois o Java 7 está descontinuado pela Oracle.
  • 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: C:\Usuários\<usuário>\AppData\Local\TVCli\Logs).
  • A assinatura grátis do TaticView permite que apenas um arquivo de dados tenha sua atualização automatizada. Para automatizar atualizações de mais arquivos de dados será necessário configurar o Recurso de Atualização automática de dados na sua Assinatura.


Instalando o TVCli

Primeiramente baixe o instalador:


Depois execute a instalação na máquina onde serão criados os agendamentos para a execução do TVCli. O TVCli funciona através de linha de comando. Após criar o executável contendo o comando desejado, você pode agendar a execução do mesmo, utilizando um agendador de tarefas de sua preferência.


Geração do TOKEN de Acesso

Para automatizar as atualizações de dados através do TVCli, é necessário possuir um 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.


É possível gerar o TOKEN de Acesso de duas maneiras:


Pelo TVCli

  1. Executar o comando via linha de comando pedindo geração de um novo TOKEN de Acesso


Síntaxe do Comando:

 tvcli -cmd get_token_by_password -user <seu usuário TaticView> -password <sua senha TaticView> [-token_name "<nome para o token>"]

 -cmd                   - get_token_by_password - Comando responsável em solicitar ao TaticView e armazenar o TOKEN de Acesso nas configurações do TVCli.
 -user                  - Seu usuário do TaticView (e-mail de acesso). 
 -password              - Sua senha de acesso ao TaticView.
 -token_name (opcional) - Nome que você deseja atribuir ao TOKEN de Acesso. Caso você não informe nenhum nome será atribuído o nome padrão "TaticView CLI" .         
 Exemplo: tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli Servidor 1"


Via interface do TaticView

  1. Na tela principal do TaticView, acesse a opção Minha Conta e clique no botão TOKENS de Acesso;
  2. Em Identificacao-novo-token+pr-BR.png informe um nome para identificar o TOKEN de Acesso na lista e clique em GERAR NOVO TOKEN.
  3. Um TOKEN de Acesso será gerado Generated-token+pr-BR.png
  4. Execute o comando de armazenamento de TOKENS do TVCli (store_token), 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 (e-mail de acesso). 
 -token - Token gerado no TaticView.
 Exemplo: tvcli -cmd store_token -user meuemail@email.com -token ce699ce43dcbd2caeff1573eeb1d4e44


Atualiando 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, na tela principal do TaticView, clique sobre o arquivo de dados, selecione Propriedades, e habilite a opção Atualização automática. Com isso, será exibido o código do arquivo de dados, como no exemplo abaixo:

Datamart-dropdown+pr-BR.png


Automatic-importation+pr-BR.PNG


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 (e-mail 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 -wait. 

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


Versão TVCli

Para visualizar em qual versão o TVCli instalado em sua máquina está, é possível executar o comando -version. Este comando mostra a versão do TVCli na console e também registra na log do TVCli.


 Sintaxe do Comando: tvcli -version


Teste de retorno do comando

O executável do TVCli retorna códigos distintos para informar o sucesso ou falha na execução de seus comandos. Os códigos atualmente disponíveis são:

 0 - Sucesso
 8 - Erro

Com base nesses códigos de retorno, é possível efetuar tratamentos no seu script de automação.


Dúvidas sobre como gerar os comandos de automação?

Caso tenha dificuldades durante o processo de configuração do TVCli, abra um ticket de suporte. Teremos prazer em lhe ajudar.

Além disso, na tela de propriedades dos Arquivos de Dados ao clicar no link Ajuda para gerar os comandos de automação? será exibida a tela Comandos TVCli onde você poderá obter os comandos do TVCli já configurados, basta informar alguns dados necessários.


Exemplo de Script

@ECHO OFF
call tvcli -cmd import_file -user jonathan@sadig.com -file "C:\Users\jonathan.SADIG\Documents\TaticView\Arquivos Importacao\vendas.xlsx" -datamart 674 -wait
if %errorlevel% == 0 (
	echo "VENDAS atualizado com sucesso!"
) else (
	echo "Problemas na atualizacao do VENDAS!"
)
call 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 do RH!"
)