Histórico da Página
INTRODUÇÃO
Nota |
---|
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 " |
Para obter instruções, acesse a linha de comando (command ou terminal) e digite:
Sem Formato |
---|
java -jar "C:\TOTVS\TOTVS Developer Studio\tdscli.jar" -help |
SINTAXE DE USO
Os parâmetros requeridos variam de acordo com o comando escolhido. Para saber quais são, utilize o -help.
Sem Formato |
---|
java -jar tdscli.jar command parameters |
O -help
traz os parâmetros requeridos do comando.
Sem Formato |
---|
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.
Sem Formato |
---|
java -jar tdscli.jar command @file |
ARQUIVO DE PARÂMETROS
Informações |
---|
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.
Nota | ||
---|---|---|
| ||
|
Informações | ||||
---|---|---|---|---|
| ||||
|
Bloco de código | ||||
---|---|---|---|---|
| ||||
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 |
Nota | ||
---|---|---|
| ||
|
Bloco de código | ||||
---|---|---|---|---|
| ||||
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 |
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 .
Bloco de código | ||
---|---|---|
| ||
SET TDS_APPRE=C:\TOTVS\TOTVS Developer Studio\ |
Informações | ||
---|---|---|
| ||
A variável deve conter o verdadeiro diretório de instalação do TDS. Não é necessário aspas. |
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
Informações | ||
---|---|---|
| ||
|
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 que desejar contendo todas as informações da execução.
Informações | ||||
---|---|---|---|---|
| ||||
|
Aviso |
---|
|
COMPILAÇÃO
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 |
Nota | ||
---|---|---|
| ||
Os parâmetros PROGRAM e PROGRAMLIST não podem ser utilizados juntos, deve ser escolhido apenas um. |
Aviso | ||
---|---|---|
| ||
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. |
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.
Informações | ||||
---|---|---|---|---|
| ||||
|
COMPILAÇÃO MULTIPLA
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.
Informações | ||||
---|---|---|---|---|
| ||||
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 |
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.
Informações | ||||
---|---|---|---|---|
| ||||
|
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.
Informações | ||||
---|---|---|---|---|
| ||||
|
Bloco de código | ||||
---|---|---|---|---|
| ||||
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 |
Nota | ||
---|---|---|
| ||
|
GERAÇÃO DE PATCH
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 COMPILAÇÃ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 *** |
Nota | ||
---|---|---|
| ||
Os parâmetros SAVELOCAL e SAVEREMOTE não podem ser utilizados juntos, deve ser escolhido apenas um. |
Aviso |
---|
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. |
Nota | ||
---|---|---|
| ||
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 |
GERAÇÃO LOCAL
Para salvar localmente o patch gerado, utilize o parâmetro SAVELOCAL, passando o diretório no qual será salvo.
Informações | ||||
---|---|---|---|---|
| ||||
java -jar tdscli.jar patchgen serverType=AdvPL server=127.0.0.1 build=7.00.131227A port=1312 environment=P11 user=admin psw= fileResource=NEW_1.PRW;NEW_2.PRW;NEW_3.PRW savelocal=D:/Patchs patchType=ptm |
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.
Informações | ||||
---|---|---|---|---|
| ||||
java -jar tdscli.jar patchgen serverType=AdvPL server=127.0.0.1 build=7.00.131227A port=1312 environment=P11 user=admin psw= fileResource=NEW_1.PRW;NEW_2.PRW;NEW_3.PRW saveremote=/protheus_data/ patchType=ptm |
...