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

From TaticView
Jump to: navigation, search
(Created page with "=== Teste de retorno do comando ===")
(Created page with "O executável do TVcli retorna códigos distintos para informar o sucesso ou falha na execução.")
Line 92: Line 92:
 
=== Teste de retorno do comando ===
 
=== Teste de retorno do comando ===
  
The TVCI executable returns different codes to report the success or failure during the execution process.
+
O executável do TVcli retorna códigos distintos para informar o sucesso ou falha na execução.
  
 
   '''0 - Success'''
 
   '''0 - Success'''

Revision as of 17:37, 18 October 2016

Automação de importações de dados no TaticView

Você pode através dess processo automatizar importações dos seus Arquivos de Dados.

Para automatizar as importações 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 de suporte em https://support.taticview.com/open.php/?&lang=pt_br. Teremos prazer em lhe ajudar.

Instalando o TVcli

Primeiramente baixe o instalador:

  • Windows
  • Linux
  • Mac-OS

Depois execute a instalação na mesma máquina onde estarão os arquivos que serão importados automaticamente.


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 importaçã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.

É 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 de solicitação: 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.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.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


Importando de forma automatizada

Somente é possível automatizar importaçõ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 importaçã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:

!datamart-dropdown.png!


!automatic-importation.png!.

Estando o arquivo de dados previamente importado, liberado para importaçã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] [-noerror] -[notifyshare]
   -cmd                   - import_file   - faz upload do arquivo de dados e coloca na fila de importaçã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 Sáida
 -noerror (opcional)    - não notifica 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 erros.
 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 -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 -noerror


Teste de retorno do comando

O executável do TVcli retorna códigos distintos para informar o sucesso ou falha na execução.

 0 - Success
 8 - Error

A notification is sent to the user if an error occurs during the import process. A log with the imports details is generated in the logs directory, below the directory where TVcli was installed.

An example of Windows running script:

 tvcli -cmd import_file -user meuemail@email.com -datamart 246 -file "c:\taticview\imp\planilha.xlsx" -notifyshare
 if errorlevel <> 0
   Error notification by email
 fi


Important

The free version grants you automation import from only one data source. You need to configure the feature "*automatic data update*" in your subscription to automate the imports of more data sources.