Difference between revisions of "Automate Update data/pt-br"

From TaticView
Jump to: navigation, search
(Created page with "<div style="float: right;">__TOC__</div>")
Line 9: Line 9:
 
Você pode através desse processo automatizar as atualizações das informações dos seus Arquivos de Dados.
 
Você pode através desse processo automatizar as atualizações das informações dos seus Arquivos de Dados.
  
Para automatizar as atualizações de dados no TaticView são necessários alguns procedimentos de configuração e uso do programa de linha de comando [[TVCli/pt-br|TVCli]].  
+
Para automatizar as atualizações de dados no TaticView são necessários alguns procedimentos de configuração e uso do programa de linha de comando [[TVCli/pt-br|TVCli]].
  
 
Caso tenha dificuldades abra um ticket de suporte em https://support.taticview.com/open.php/?&lang=pt_br. Teremos prazer em lhe ajudar.
 
Caso tenha dificuldades abra um ticket de suporte em https://support.taticview.com/open.php/?&lang=pt_br. Teremos prazer em lhe ajudar.
Line 18: Line 18:
 
Primeiramente baixe o instalador:
 
Primeiramente baixe o instalador:
 
* <u>[http://wiki.taticview.com/taticfiles/tvcli-windows-installer.exe Windows]</u>  
 
* <u>[http://wiki.taticview.com/taticfiles/tvcli-windows-installer.exe Windows]</u>  
 +
  
 
Depois execute a instalação na mesma máquina onde estarão os arquivos que serão usados para as atualizações automáticas.
 
Depois execute a instalação na mesma máquina onde estarão os arquivos que serão usados para as atualizações automáticas.
Line 28: Line 29:
  
 
É necessário possuir um '''[[Tokens/pt-br|TOKEN DE ACESSO]]''' cadastrado no TaticView e no TVCli antes de poder executar uma automação de atualização. Um TOKEN DE ACESSO está sempre associado a um usuário TaticView.  
 
É necessário possuir um '''[[Tokens/pt-br|TOKEN DE ACESSO]]''' cadastrado no TaticView e no TVCli antes de poder executar uma automação de atualização. 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 TVCli, ele pode ser revogado por você a qualquer momento, permitindo assim que você decida quem pode acessar sua conta no TaticView e quando.  
+
O TOKEN DE ACESSO é 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.
 +
 
 +
An Access TOKEN is always linked to a TaticViwe user. The TOKEN works like a TaticView generated password that allows access to TVCli. The TOKEN can be revoked at any moment, allowing you to decide who can access your TaticView account and when. It is important to remember that this access only allows the update of data files that are set to be automatically updated.
 +
 
  
 
É possível gerar o TOKEN DE ACESSO de duas maneiras:
 
É possível gerar o TOKEN DE ACESSO de duas maneiras:
Line 41: Line 45:
 
   -user                  - usuário TaticView  
 
   -user                  - usuário TaticView  
 
   -password              - senha TaticView
 
   -password              - senha TaticView
   -token_name (opcional) - Nome que você quer dar ao TOKEN DE ACESSO. Nome default "TaticView CLI"        
+
   -token_name (opcional) - Nome que você quer dar ao TOKEN DE ACESSO. Nome default "TaticView CLI"        
  
 
     '''Exemplo: tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli Servidor 1"'''
 
     '''Exemplo: tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli Servidor 1"'''
Line 67: Line 71:
 
Depois é necessário liberar a atualização automática para o Arquivo de Dados desejado.
 
Depois é necessário liberar a atualização automática para o Arquivo de Dados desejado.
 
Para isso clique sobre o arquivo importado (na interface do TaticView), selecionar '''Propriedades''', e marcar o checkbox '''Importação automática''', o que exibirá o código identificador de seu arquivo de dados, como no exemplo abaixo:
 
Para isso clique sobre o arquivo importado (na interface do TaticView), selecionar '''Propriedades''', e marcar o checkbox '''Importação automática''', o que exibirá o código identificador de seu arquivo de dados, como no exemplo abaixo:
 +
 +
After that, it will be necessary to enable the automatic update to the desired data file. To do so, access the TaticView [[Main Page Overview|main page]], click on data files, select <i>Settings</i>, and enable the <i>Automatic Update</i> option. After that, it will display the data files code on the screen. See the example below:
  
 
[[File:datamart-dropdown+pr-BR.png]]
 
[[File:datamart-dropdown+pr-BR.png]]
Line 73: Line 79:
  
 
[[File:automatic-importation+pr-BR.png]]
 
[[File:automatic-importation+pr-BR.png]]
 +
  
 
Estando o arquivo de dados previamente importado, liberado para atualização automática e você possuir o seu código identificador, será possível executar a importação por linha de comando.
 
Estando o arquivo de dados previamente importado, liberado para atualização automática e você possuir o seu código identificador, será possível executar a importação por linha de comando.
Line 86: Line 93:
 
   -wait (opcional)      - aguarda o final da importação. Necessário para testar '''Status de Saída'''
 
   -wait (opcional)      - aguarda o final da importação. Necessário para testar '''Status de Saída'''
 
   -nonotifyerror (opcional)    - não notifica o usuário caso ocorra um erro durante o processo
 
   -nonotifyerror (opcional)    - não notifica o usuário caso ocorra um erro durante o processo
   -notifyshare (opcional) - 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 erros. Funciona somente em conjunto com "-wait".
+
   -notifyshare (opcional) - 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 erros. Funciona somente em conjunto com "-wait".  
  
 
   '''Exemplos:'''
 
   '''Exemplos:'''
Line 99: Line 106:
 
=== Versão TVCli ===  
 
=== Versão TVCli ===  
  
Mostra a versão do TVCli na console e registra na log.  
+
Mostra a versão do TVCli na console e registra na log.
  
 
     '''Sintaxe: tvcli -version'''
 
     '''Sintaxe: tvcli -version'''
Line 113: Line 120:
 
Uma notificação será enviada para o usuário caso ocorra erro na atualização.
 
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).
 
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).
 +
 +
 +
=== Questions on how generate the automation commands? ===
 +
 +
Open a [https://support.taticview.com/open.php/?&lang=en_US support ticket]. In case you are having problems during the TVCli configuration process. It will be a pleasure to help.
 +
 +
Also, on the Data Files properties screen, when clicking the link <i>help to generate automation commands?</i>, it will display the [[TVCli Generate Commands]] screen, where you can obtain preset TVCli commands. All you have to do is inform some required data.
  
  
Line 130: Line 144:
 
   '''echo "Problemas na atualizacao do RH!"
 
   '''echo "Problemas na atualizacao do RH!"
 
  ''')'''
 
  ''')'''
 
 
<span style="color: red;">'''Importante'''</span>
 
 
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.
 

Revision as of 14:06, 7 March 2018

Other languages:
English • ‎português do Brasil


Você pode através desse processo automatizar as atualizações das informações dos seus Arquivos de Dados.

Para automatizar as atualizações de dados no TaticView são necessários alguns procedimentos de configuração e uso do programa de linha de comando TVCli.

Caso tenha dificuldades abra um ticket de suporte em https://support.taticview.com/open.php/?&lang=pt_br. Teremos prazer em lhe ajudar.

Instalando o TVCli

Primeiramente baixe o instalador:


Depois execute a instalação na mesma máquina onde estarão os arquivos que serão usados para as atualizações automáticas.


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.


Geração do TOKEN DE ACESSO

É necessário possuir um TOKEN DE ACESSO cadastrado no TaticView e no TVCli antes de poder executar uma automação de atualização. 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 TVCli, ele pode ser revogado por você a qualquer momento, permitindo assim que você decida quem pode acessar sua conta no TaticView e quando.

An Access TOKEN is always linked to a TaticViwe user. The TOKEN works like a TaticView generated password that allows access to TVCli. The TOKEN can be revoked at any moment, allowing you to decide who can access your TaticView account and when. It is important to remember that this access only allows the update of data files that are set to be automatically updated.


É 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
   Sintaxe: tvcli -cmd get_token_by_password -user <usuário> -password <senha> [-token_name "<nome do token>"]
 -cmd                   - get_token_by_password - Solicita e armazena 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 ACESSO. Nome default "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. Identificar-se no TaticView e acessar o Minha Conta 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. Executar o TVCli informando o TOKEN DE ACESSO gerado
   Sintaxe: tvcli -cmd store_token -user <usuário> -token <token gerado>
 -cmd   - store_token - armazena token gerado pela interface
 -user  - usuário TaticView 
 -token - token gerado pela interface
   Exemplo: tvcli -cmd store_token -user meuemail@email.com -token 9bdr845gh5r4r1vd5d5


Atualizando de forma automatizada

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

Depois é necessário liberar a atualização automática para o Arquivo de Dados desejado. Para isso clique sobre o arquivo importado (na interface do TaticView), selecionar Propriedades, e marcar o checkbox Importação automática, o que exibirá o código identificador de seu arquivo de dados, como no exemplo abaixo:

After that, it will be necessary to enable the automatic update to the desired data file. To do so, access the TaticView main page, click on data files, select Settings, and enable the Automatic Update option. After that, it will display the data files code on the screen. See the example below:

Datamart-dropdown+pr-BR.png


File:Automatic-importation+pr-BR.png


Estando o arquivo de dados previamente importado, liberado para atualização automática e você possuir o seu código identificador, será possível executar a importação por linha de comando.

   Sintaxe: tvcli -cmd import_file -user <usuário> -datamart <identificador> -file "<arquivo/planilha>" [-type <tipo>] [-wait -[notifyshare]] [-nonotifyerror] 
 -cmd                   - import_file   - faz upload do arquivo de dados e coloca na fila de atualização
 -user                  - usuário TaticView 
 -datamart              - identificador do arquivo de dados obtido na opção propriedades do Arquivo de Dados na Interface.
 -file                  - arquivo de dados Texto (CSV) ou planilha (XLSX,XLS) que será importado.
 -type (opcional)       - clear_and_add - Exclui todos os dados do Arquivo de Dados do TaticView e importa os novos dados (default)
                          append        - Adiciona os novos dados ao final do Arquivo de Dados do TaticView. É necessário ter cuidado para não duplicar dados.
 -wait (opcional)       - aguarda o final da importação. Necessário para testar Status de Saída
 -nonotifyerror (opcional)    - não notifica o usuário caso ocorra um erro durante o processo
 -notifyshare (opcional) - 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 erros. Funciona somente em conjunto com "-wait". 
 Exemplos:
 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" -wait -notifyshare
 tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx" -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 -nonotifyerror


Versão TVCli

Mostra a versão do TVCli na console e registra na log.

   Sintaxe: 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.

 0 - Sucesso
 8 - Erro

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


Questions on how generate the automation commands?

Open a support ticket. In case you are having problems during the TVCli configuration process. It will be a pleasure to help.

Also, on the Data Files properties screen, when clicking the link help to generate automation commands?, it will display the TVCli Generate Commands screen, where you can obtain preset TVCli commands. All you have to do is inform some required data.


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!"
)