INTRODUÇÃO
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 "C:\TOTVS\TOTVS Developer Studio\"
, como local de instalação e sistema operacional Windows. Nos demais sistemas operacionais os procedimentos é o mesmo mudando somente a forma de acessar a pasta do TDS.
Para obter instruções, acesse a linha de comando (command ou terminal) e digite:
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.
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
ARQUIVO DE PARÂMETROS
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.
Regras
- Pode ser utilizado para qualquer comando, desde que os parâmetros dentro do arquivo sejam válidos para o comando utilizado.
- Deve ter o formato .txt e tem que estar no mesmo diretório raiz que o TDSCLI.JAR.
Exemplo Chamada
java -jar tdscli.jar command @compilacao.txt
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 authorization=D:/Chave de compilacao/chave.aut recompile=t #COMENTÁRIO
Regras de Sintaxe
- TODAS as barras devem ser para o lado direito. (Exceto para separar a lista de fontes).
- Para os comentários devem ser utilizados #.
- Não existe aspas ou apóstrofo no arquivo.
- Cada chave deve ficar em um linha.
- Deve se respeitar a estrutura:
chave=valor
- Espaços não necessitam de barra invertida ou aspas.
- Os parâmetros não utilizados podem ser apagados ou comentados.
BÁSICO
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\
OBS
A variável deve conter o verdadeiro diretório de instalação do TDS. Não é necessário aspas.
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 |
AUTHORIZATION | CAMINHO PARA CHAVE DE COMPILAÇÃO .AUT | OPCIONAL |
PROGRAM | CAMINHO PARA O ARQUIVO DE COMPILAÇÃO | OBRIGATÓRIO |
RECOMPILE | FORÇA A RECOMPILAÇÃO DO ARQUIVO( T OU F) | OPCIONAL |