1. Utilização

INTRODUÇÃO

COMPATIBILIDADE

O TDSCLI funciona com todos servidores TOTVS (Protheus e Logix).

SINTAXE DE USO

Os parâmetros requeridos variam de acordo com o comando escolhido. Para saber quais são, utilize o -help.

java -jar tdscli.jar command parameters

O -help traz os parâmetros requeridos do comando.

java -jar tdscli.jar command -help

A opção @file é utilizada para receber um arquivo de parâmetro que contenha todos os parâmetros utilizado no comando.

java -jar tdscli.jar command @file

BÁSICO

TDSAPPRE

Para utilização de alguns comandos, é necessário setar a variável de ambiente TDS_APPRE com o diretório de instalação do TDS .

PARÂMETROS

Os parâmetros são separados apenas por espaço após o valor. Caso algum parâmetro não tenha valor, ou seja branco, apenas coloque o espaço para o próximo parâmetro, como no exemplo abaixo.

Todas as barras devem ser para a direita. 

Caso o valor tenha espaços, coloque-o todo com aspas, exemplo: parametro="valor com espaco", parametro2=valorSemAspas

LOG

Caso queira gerar um log da execução do comando, pode ser o utilizado o -logToFile=valor.

Esse comando gera um arquivo no formato texto contendo informações sobre a execução. 

ARQUIVO DE PARÂMETROS

O arquivo de parâmetros serve para substituir os parâmetros na linha de comando, afim de minimizar o tamanho da linha e separar os parâmetros em um único lugar e arquivo.

includes=D:/Servers/Protheus/includes
serverType=AdvPL
server=127.0.0.1
build=7.00.131227A
port=1312
user=admin
psw=
environment=P11
program=D:/Fontes/ADVPL/NEW_1.PRW;\
D:/Fontes/ADVPL/NEW_2.PRW;\
D:/Fontes/ADVPL/NEW_3.PRW
authorization=D:/Chave de compilacao/chave.aut
#recompile=t
#COMENTÁRIO

COMPILAÇÃO

O comando de compilação é utilizado tanto para fontes quanto para recursos, em qualquer servidor.

COMPILAÇÃO SIMPLES

Para compilação de apenas um arquivo, o parâmetro PROGRAM é obrigatório, ele deve conter o caminho do arquivo a ser compilado com extensão.

COMPILAÇÃO MÚLTIPLA

Podemos compilar vários arquivos em uma única linha de comando utilizando o parâmetro PROGRAM e separando cada caminho por ponto e vírgula.

COMPILAÇÃO DE DIRETÓRIO

O parâmetro PROGRAM também aceita um diretório como valor.

 TODOS os arquivos que estiverem dentro desta pasta, incluindo subpastas, serão compilados.

COMPILAÇÃO DE LISTA DE ARQUIVOS

O parâmetro PROGRAMLIST server para receber o caminho de um arquivo no formato .TXT que contenha o caminho dos arquivos a serem compilados separados por linha.

REMOVER PROGRAMAS DO RPO

Para remover um ou mais arquivos ou recursos do RPO, utilize o comando deleteProg.

Para deletar vários arquivos de uma só vez, basta separá-los por ponto e vírgula.

Para apagar os arquivos do RPO que existam em uma determina pasta local, informe no lugar do nome do programa na chave program, o caminho completo da pasta.

GERAÇÃO DE PATCH

Para gerar patch, utilize o comando PATCHGEN.

GERAÇÃO LOCAL

Para salvar localmente o patch gerado, utilize o parâmetro SAVELOCAL, passando o diretório no qual será salvo.

GERAÇÃO REMOTE

Para salvar no servidor o patch gerado, utilize o parâmetro SAVEREMOTE, passando o caminho relativo no servidor onde o patch será salvo. 

APLICAÇÃO DE PACOTE

Aplica o patch em servidor escolhido.

APLICAÇÃO DE PATCH LOCAL

APLICAÇÃO DE PATCH REMOTE

LISTAR CONTEÚDO DO PATCH

Retorna quais os nomes dos arquivos que existem no patch, tipo do arquivo, build que foi compilado, data da ultima alteração do arquivo e tamanho.

DESFRAGMENTAÇÃO DE RPO 

Esse procedimento pode ser feito em mais de um ambiente, separando-os por ponto e vírgula (;)

LIMPAR O HISTÓRICO DO RPO

Para utilizar essa funcionalidade em vários ambiente, separe-os por ponto e vírgula.