Open main menu

TaticView β

Referência dos comandos do TVCli

Revision as of 18:34, 14 July 2022 by Fh (talk | contribs)
Other languages:
English • ‎português do Brasil

Contents

Referência de comandos do TVCli


Aqui você descrevemos os comandos do TVCli e suas opções.

import_file

TVCli enviando dados para o Arquivo de Dados

Use o import_file para enviar dados a um Arquivo de Dados. Você pode usar o tutorial para ajudá-lo neste processo, além disso temos um Wizard que constrói o comando completo para você


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

get_token_by_password

TVCli criando e armazenando no repositório local um novo token

Use o comando get_token_by_password para gerar uma requisição de um novo access TOKEN.

Você pode ler nosso tutorial para ajudá-lo no nosso processo, além disso, temos um Wizard para construir um comando completo


Sintaxe do comando:

 tvcli -cmd get_token_by_password -user <seu usuário TaticView> -password <sua senha TaticView> [-token_name "<nome/descrição do 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".         

Examplo:

 tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli token exemplo" 

store_token

TVCli salva/armazena um token no repositório local

Use o comando store_token para salvar um access TOKEN previamente gerado no repositório local de tokens do TVCli.

Você pode ler nosso tutorial para ajudá-lo no nosso processo, além disso, temos um wizard para construir um comando completo


Command Syntax:

 tvcli -cmd store_token -user <your TaticView user> -token <the token generated on TaticView> [-token_name "<token name>"]


 -cmd                   - store_token - The command save the informed access TOKEN the TVCli Token Store for future use.
 -user                  - Your TaticView user (access e-mail).
 -token                 - the access TOKEN.
 -token_name (optional) - The name you want to set to your access TOKEN. The default name TaticView CLI will be set if you do not specify a name.         


Example:

 tvcli -cmd store_token  -user myemail@email.com -token 9bdr845gh5r4r1vd5d5 -token_name "TVCli sample token" 

version

Visualizando a versão do TVCli

Use o comando version para saber qual a versão do TVCli está sendo executada. Este comando mostra a versão na console do sistema operacional e também a registra na log.


Sintaxe do Commando :

 tvcli -version

show_logs

Mostrando a log do TVCli

a partir da versão 1.1

Use o comandoshow_logs para mostrar o arquivo de log das execuções do TVCli no console do sistema operacional.

tvcli -cmd show_logs - Exibe as logs do dia atual 
tvcli -cmd show_logs -all - Exibe todas as logs do diretório tvcli\logs