Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 48 Próxima »

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

Exemplo 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
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: parametro=valor.
  • Cada parâmetro deve ficar em uma linha.
  • Espaços não necessitam de barra invertida ou aspas.
  • Os parâmetros não obrigatórios podem ser apagados ou comentados.
  • Caso algum parâmetro não tenha valor, apenas pule de linha.

 


 

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 .

Para setar a variável de ambiente, execute a linha
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.

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

java -jar tdscli.jar command parametro1=valor parametro2= parametro3=valor

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. 

Exemplo de Uso

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 authorization="D:/Chave de compilacao/chave.aut" -logToFile=D:/LogTesteTDS/logSimples.log

  • É obrigatório a utilização do hífen "-" antes do comando, ficando -logtofile.
  • É necessário informar a extensão do arquivo. Ex: .log, .txt

 


 

COMPILAÇÃO

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

ParâmetroDescriçãoRequerimento
INCLUDEPASTA DE INCLUDESOBRIGATÓRIO
SERVERTYPETIPO DE SERVIDOR (ADVPL OU 4GL)OBRIGATÓRIO
SERVERIP OU NOME DA MÁQUINAOBRIGATÓRIO
BUILDBUILD DO SERVIDOROBRIGATÓRIO
PORTPORTA DO SERVIDOROBRIGATÓRIO
USERUSUÁRIO DO SERVIDOROBRIGATÓRIO
PSWSENHA DO SERVIDOROBRIGATÓRIO
ENVIRONMENTAMBIENTE PARA COMPILAÇÃOOBRIGATÓRIO
PROGRAMCAMINHO PARA O ARQUIVO A SER COMPILADO

OBRIGATÓRIO ***

PROGRAMLIST

CAMINHO DO ARQUIVO COM A LISTA DE COMPILAÇÃO

OBRIGATÓRIO ***
AUTHORIZATIONCAMINHO PARA CHAVE DE COMPILAÇÃO .AUTOPCIONAL
RECOMPILEFORÇA A RECOMPILAÇÃO DO ARQUIVO( T OU F)OPCIONAL

Observação ***

Os parâmetros PROGRAM e PROGRAMLIST não podem ser utilizados juntos, deve ser escolhido apenas um.

 

AUTHORIZATION

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.

Compilação Simples

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 authorization="D:/Chave de compilacao/chave.aut" recompile=t

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.

Compilação Multipla

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.

Compilação de Diretório

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 authorization="D:/Chave de compilacao/chave.aut" recompile=t

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.

Compilação de Lista

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 programList=D:/lista.txt authorization="D:/Chave de compilacao/chave.aut" recompile=t

Exemplo do Arquivo de Lista
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

Regras da Lista

  • Cada arquivo deve estar em um linha.
  • TODAS as barras para a direita.
  • Não é necessário aspas.
  • Não é necessário separar com ponto e vírgula.
  • O formato deve ser TXT.

GERAÇÃO DE PATCH

ParâmetroDescriçãoRequerimento
SERVERTYPETIPO DE SERVIDOR (ADVPL OU 4GL)OBRIGATÓRIO
SERVERIP OU NOME DA MÁQUINAOBRIGATÓRIO
BUILDBUILD DO SERVIDOROBRIGATÓRIO
PORTPORTA DO SERVIDOROBRIGATÓRIO
USERUSUÁRIO DO SERVIDOROBRIGATÓRIO
PSWSENHA DO SERVIDOROBRIGATÓRIO
ENVIRONMENTAMBIENTE PARA COMPILAÇÃOOBRIGATÓRIO
FILERESOURCENOME DO ARQUIVO QUE IRÁ PARA O PATCHOBRIGATÓRIO
PATCHTYPEEXTENSÃO DE PATCH ("PTM", "UPD" E "PAK")OBRIGATÓRIO
SAVELOCALDIRETÓRIO PARA SALVAR O PATCH LOCALMENTEOBRIGATÓRIO

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.

FILERESOURCE

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.

Geração Local

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  

 

  • Sem rótulos