Changes

Jump to: navigation, search

Automate Update data/pt-br

702 bytes added, 13:27, 15 April 2023
no edit summary
<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.
Primeiramente baixe o instalador:* <u>Baixe a [https://wiki.taticview.com[TVCli Download/taticfiles/tvclipt-windows-installer.exe Windowsbr|versão atual]]</u>
 
'''''Atenção'''''<br>
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".
Depois execute * '''Execute a instalação na máquina ''' no computador onde serão criados os agendamentos vai ser agendado o TVCli para a sua 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
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.
<div class ="mw-translate-fuzzy">===Pelo Usando TVCli (linha de comando)====# Executar o comando via linha de comando do Windows o pedindo de geração de um novo [[Manage_Access/pt-br#Tokens|TOKEN de Acesso]]. <Para ajudá-lo aqui temos um [[TVCli Commands/div>pt-br|Wizard]]
-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 email 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".
'''tvcli -cmd get_token_by_password -user meuemail@email.com -password 123466 -token_name "TVCli Servidor 1"'''
<div class="mw-translate-fuzzy">===Via Usando a interface gráfica do TaticView==== 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 '''GERAR NOVO TOKEN'''.
# Um TOKEN de Acesso será gerado [[File:generated-token+pr-BR.png]]
# Execute o comando de armazenamento de TOKENS do TVCli (<i>store_token</i>), informando o TOKEN recém gerado.
</div>
-cmd - store_token - Comando responsável por armazenar os tokens gerados diretamente no TaticView.
-user - Seu usuário do TaticView (e-mail email de acesso).
-token - Token gerado no TaticView.
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 você deverá acessar as propriedades do ''arquivo de dados'' desejado. O acesso está disponível no menu de contexto do cartão do arquivo de dados, na [[Main Page Overview/pt-br|página principal do TaticView]]:
{| class="images-table"
-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 email 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).
'''Call "C:\Program Files\TvCli\tvcli" -cmd import_file -user meuemail@email.com -datamart 246 -file "D:\taticview\imp\file.xlsx" -wait'''
=== Running Executando TVCli from em um arquivo BAT (Script) file ===
You can create Você pode criar arquivos BAT files to schedule a bunch of para agendar vários comandos ao TVCli commands. Doing so the entire process can be automatedFazendo isso, o processo inteiro de atualização de dados pode ser automatizado. As you can schedule using Já que você pode agendar a execução destes arquivos BAT no agendador do Windows scheduler or other , ou em uma ferramenta similar tool.
'''''AttentionAtenção'''''<br>To execute Para executar o TVCli from a em um arquivo BAT file, you have to use the Windows é necessário usar o comando [https://docs.microsoft.com/enpt-usbr/windows-server/administration/windows-commands/call CALL] command. Iedo Windows.Por exemplo:
'''CALL''' C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\Users\jonathan\Documents\TaticView\Import Files\rh.xlsx" -datamart 673 -wait
<div class="mw-translate-fuzzy">=== Teste de retorno Avaliando se o comando do comando TVCli foi executado com sucesso====</div>
<div class="mw-translate-fuzzy">O executável Ao final da execução do comando o 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:</div>Isto permite que os arquivos BAT verifiquem se a execução prévia do comando pelo TVCli teve sucesso ou não.
Currently, the available codes areExistem dois códigos de retorno possíveis:
<div class="mw-translate-fuzzy"> '''0 - Sucesso'''
'''8 - Erro'''
</div>
<div class="mw-translate-fuzzy">Com base nesses Você pode tratar os códigos de retorno, é possível efetuar tratamentos no seu script arquivo BAT.Para isso você pode usar a variável de automaçãoambiente [https://docs.<microsoft.com/pt-br/previous-versions/windows/it-pro/windows-server-2012-r2-and-2012/div>cc754335(v=ws.11) ERROLEVEL] do Windows. Por exemplo:
if %errorlevel% == 0 (
echo SALES updated successfullyVendas atualizado com sucesso!
) else (
echo Problems updating SALESProblemas na atualização do Vendas!
)
<div class="mw-translate-fuzzy">=== Exemplo de BAT (Script ) ====</div>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.
<div class="mw-translate-fuzzy">'''@ECHO OFF''' '''call C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\Usuários\jonathan\Documentos\TaticView\Arquivos Importacao\Vendas.xlsx" -datamart 674 -wait
'''if %errorlevel% == 0 (
'''echo VENDAS atualizado com sucesso!
'''echo Problemas na atualizacao do VENDAS!
''')
'''call C:\TaticView\tvcli -cmd import_file -user jonathan@sadig.com -file "C:\Usuários\jonathan\Documentos\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!
''')'''
</div>
<div class="mw-translate-fuzzy">=== Dúvidas Mais dúvidas sobre como gerar os comandos de automação? ===</div>
<div class="mw-translateO TaticView tem um wizard para ajudá-fuzzy">Além dissolo neste processo, na tela de propriedades dos Arquivos de Dados ao clicar no link <i>Ajuda para gerar os comandos de automação?</i> 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.</div>
<div class="mw-translate-fuzzy">
Caso tenha dificuldades durante o processo de configuração do [[TVCli/pt-br|TVCli]], abra um [https://support.taticview.com/open.php/?&lang=pt_br ticket de suporte]. Teremos prazer em lhe ajudar.
</div>
 
 
=== Other TVCli commands ===
 
<div class="mw-translate-fuzzy">
=== Versão TVCli ===
</div>
 
Para visualizar em qual <i>versão</i> 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'''
 
<div class="mw-translate-fuzzy">
=== Logs do TVCli (a partir da versão 1.1) ===
</div>
 
''since TVCli version 1.1''
 
Para exibir as logs do TVCli você pode executar o comando com a opção <i>show_logs</i>.
 
Sintaxe do comando:
'''tvcli -cmd show_logs - Exibe as logs do dia atual'''
'''tvcli -cmd show_logs -all - Exibe todas as logs do diretório tvcli\logs'''

Navigation menu