Histórico da Página
INTRODUÇÃO
Aviso |
---|
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:
| ||
|
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 |
Sem Formato |
java -jar "
|
|
COMPATIBILIDADE
O TDSCLI funciona com todos servidores TOTVS (Protheus e Logix).
Informações |
---|
Nesse exemplo iremos utilizar um servidor Protheus, mas também poderemos utilizar servidores Logix. A única mudança é que os parâmetros de |
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 |
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 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 |
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 .
Informações | ||||
---|---|---|---|---|
| ||||
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
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.
title | Regras |
---|
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 texto contendo informações sobre a execução.
Informações | ||||
---|---|---|---|---|
| ||||
|
Aviso |
---|
|
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 | ||||
---|---|---|---|---|
| ||||
|
Nota | ||
---|---|---|
| ||
|
Bloco de código | ||||
---|---|---|---|---|
|
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 .
Informações | ||||
---|---|---|---|---|
| ||||
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 | ||||
---|---|---|---|---|
| ||||
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.PRWauthorization=" ;\ D:/Chave de compilacao/chave.aut" -logToFile=D:/LogTesteTDS/logSimples.log Fontes/ADVPL/NEW_2.PRW;\
D:/Fontes/ADVPL/NEW_3.PRW
authorization=D:/Chave de compilacao/chave.aut
#recompile=t
#COMENTÁRIO |
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 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.
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 | ||
---|---|---|
| ||
|
REMOVER PROGRAMAS DO RPO
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.
Informações | ||||
---|---|---|---|---|
| ||||
|
|
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
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. |
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 *** |
Nota | ||
---|---|---|
| ||
Os parâmetros SAVELOCAL e SAVEREMOTE não podem ser utilizados juntos, deve ser escolhido apenas um. |
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 | ||||
---|---|---|---|---|
| ||||
|
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 | ||||
---|---|---|---|---|
| ||||
|
APLICAÇÃO DE PACOTE
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 |
APLICAÇÃO DE PATCH LOCAL
Informações | ||||
---|---|---|---|---|
| ||||
|
APLICAÇÃO DE PATCH REMOTE
Informações | ||||
---|---|---|---|---|
| ||||
|
Informações | ||
---|---|---|
| ||
Repare que na aplicação via remote, o PATCHFILE é o caminho relativo do patch com extensão. Esse caminho será buscado no servidor. |
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.
Aviso | ||
---|---|---|
| ||
Funcionalidade disponível em build igual ou 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 |
Informações | ||||
---|---|---|---|---|
| ||||
|
DESFRAGMENTAÇÃO DE RPO
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 (;)
Informações | ||||
---|---|---|---|---|
| ||||
|
LIMPAR O HISTÓRICO DO RPO
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.
Informações | ||||
---|---|---|---|---|
| ||||
|
...