|
O TDSCLI.JAR deve estar na mesma pasta de instalação do TDS. Os comandos devem ser executados na pasta onde foi instalado o TDS. Como exemplo usaremos a pasta " |
O TDSCLI funciona com todos servidores TOTVS (Protheus e Logix).
Nesse exemplo iremos utilizar um servidor Protheus, mas também poderemos utilizar servidores Logix. A única mudança é que os parâmetros de |
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 |
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 .
SET TDS_APPRE=C:\TOTVS\TOTVS Developer Studio\ |
A variável deve conter o verdadeiro diretório de instalação do TDS. Não é necessário aspas. |
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
|
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.
|
|
Utilizaremos o comando de compilação somente para demonstração. Cada comando será detalhado em sua seção. |
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 |
O comando de compilação é utilizado tanto para fontes quanto para recursos, em qualquer servidor.
Parâmetro | Descrição | Requerimento |
---|---|---|
INCLUDE | PASTA DE INCLUDES | OBRIGATÓRIO |
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE PARA COMPILAÇÃO | OBRIGATÓRIO |
PROGRAM | CAMINHO PARA O ARQUIVO A SER COMPILADO | OBRIGATÓRIO *** |
PROGRAMLIST | CAMINHO DO ARQUIVO COM A LISTA DE COMPILAÇÃO | OBRIGATÓRIO *** |
AUTHORIZATION | CAMINHO PARA CHAVE DE COMPILAÇÃO .AUT | OPCIONAL |
RECOMPILE | FORÇA A RECOMPILAÇÃO DO ARQUIVO( T OU F) | OPCIONAL |
Os parâmetros PROGRAM e PROGRAMLIST não podem ser utilizados juntos, deve ser escolhido apenas um. |
Dependendo do arquivo a ser compilado, é necessário utilizar a chave de compilação com o parâmetro AUTHORIZATION. Deve ser utilizado contendo o caminho da chave com extensão. |
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.
|
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.
java -jar tdscli.jar compile 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 -logToFile=D:/LogTesteTDS/logMultiplo.log |
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.
|
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.
|
D:/Fontes/ADVPL/NEW_1.PRW D:/Fontes/ADVPL/NEW_2.PRW D:/Fontes/ADVPL/NEW_3.PRW D:/Fontes/ADVPL/NEW_4.PRW D:/Fontes/ADVPL/NEW_5.PRW |
|
Para remover um ou mais arquivos ou recursos do RPO, utilize o comando deleteProg.
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE PARA REMOÇÃO | OBRIGATÓRIO |
PROGRAM | NOME DO RECURSO/FONTE ou CAMINHO COM OS ARQUIVO A SEREM REMOVIDOS | OBRIGATÓRIO |
AUTHORIZATION | CAMINHO PARA CHAVE DE COMPILAÇÃO .AUT | OPCIONAL |
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.
A geração de patch só leva em consideração os fontes existentes no RPO. Caso o fonte não exista, o patch será gerado normalmente sem o fonte descrito. |
Para gerar patch, utilize o comando PATCHGEN.
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE PARA GERAÇÃO | OBRIGATÓRIO |
FILERESOURCE | NOME DO ARQUIVO QUE IRÁ PARA O PATCH | OBRIGATÓRIO |
PATCHTYPE | EXTENSÃO DE PATCH ("PTM", "UPD" E "PAK") | OBRIGATÓRIO |
SAVELOCAL | DIRETÓRIO PARA SALVAR O PATCH LOCALMENTE | OBRIGATÓRIO *** |
SAVEREMOTE | CAMINHO RELATIVO PARA SALVA DE PATCH NO SERVIDOR | OBRIGATÓRIO *** |
Os parâmetros SAVELOCAL e SAVEREMOTE não podem ser utilizados juntos, deve ser escolhido apenas um. |
O parâmetro FILERESOURCE recebe apenas o nome do arquivo que está no RPO com extensão. Ex: fileresource=new_1.prw Para passar múltiplos arquivos, separe-os com ponto e vírgula. Ex: fileresource=new_1.prw;new_2.prw;new_3.prw |
Para salvar localmente o patch gerado, utilize o parâmetro SAVELOCAL, passando o diretório no qual será salvo.
|
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 patch em servidor escolhido.
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE PARA APLICAÇÃO | OBRIGATÓRIO |
LOCALPATCH | "T" PARA PATCH SALVO LOCAL "F" PARA PATCH SALVO REMOTE | OBRIGATÓRIO |
PATCHFILE | CAMINHO COMPLETO DO PATCH COM EXTENSÃO | OBRIGATÓRIO |
APPLYOLDPROGRAM | "T" PARA ACEITAR FONTES MAIS ANTIGOS QUE O RPO "F" PARA ACEITAR SOMENTE OS MAIS NOVOS | OBRIGATÓRIO |
|
|
Repare que na aplicação via remote, o PATCHFILE é o caminho relativo do patch com extensão. Esse caminho será buscado no servidor. |
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.
Funcionalidade disponível em build superior a "7.00.121227P" do servidor Protheus. |
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE | OBRIGATÓRIO |
LOCALPATCH | "T" PARA PATCH SALVO LOCAL "F" PARA PATCH SALVO REMOTE | OBRIGATÓRIO |
PATCHFILE | CAMINHO COMPLETO DO PATCH COM EXTENSÃO | OBRIGATÓRIO |
OUTPUT | GRAVA AS INFORMAÇÕES DO PATCH EM UM ARQUIVO ESPECÍFICO | OPCIONAL |
|
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE A SER DESFRAGMENTADO | OBRIGATÓRIO |
Esse procedimento pode ser feito em mais de um ambiente, separando-os por ponto e vírgula (;)
|
Parâmetro | Descrição | Requerimento |
---|---|---|
SERVERTYPE | TIPO DE SERVIDOR (ADVPL OU 4GL) | OBRIGATÓRIO |
SERVER | IP OU NOME DA MÁQUINA | OBRIGATÓRIO |
BUILD | BUILD DO SERVIDOR | OBRIGATÓRIO |
PORT | PORTA DO SERVIDOR | OBRIGATÓRIO |
USER | USUÁRIO DO SERVIDOR | OBRIGATÓRIO |
PSW | SENHA DO SERVIDOR | OBRIGATÓRIO |
ENVIRONMENT | AMBIENTE A SER LIMPO | OBRIGATÓRIO |
Para utilizar essa funcionalidade em vários ambiente, separe-os por ponto e vírgula.
|