TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 14

changes.mady.by.user Matheus Silva Dos Santos Sales

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Ricardo Mansano Godoi

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Utilizando Workspace:

Aviso
titleTérmino do suporte ao TDSCli-Eclise
  • O suporte ao TDSCli (linha de comando) Eclipse 11.3 se encerra em 31/12/2020
  • O TDSCli distribuido no pacote TDS-Eclipse 11.3.12 é compatível com AppServer menor ou igual à release 17.x.x.
  • Para o uso com AppServer release 19.x.x é preciso utilizar o TDSCli distribuido no pacote TDS-Eclipse 11.3.15,
    que passa a ser um     plug-in do Eclipse, mais detalhes quanto à instalação clique aqui.
  • A partir de Janeiro/2021 nossa extensão para o editor VSCode passa a ser a única IDE suportada,
    e a ferramenta de linha de comando advpls ira substituir o TDSCli-Eclipse, mais informações sobre o advpls clique aqui,
    mais informações sobre o plugin de desenvolvimento AdvPL para VSCode, clique aqui.
Aviso
titleCompatibilidade

Essa funcionalidade só é compatível com workspaces do TDS 11.3 a partir do dia  

Utilizando Workspace:

No TDSCLI agora também é possível utilizar uma estrutura de workspace que pode ser compartilhada com o TDS Comum.

Caso não tenha familiaridade com o TDSCli ou deseja mais informações, consulte TDS Linha de Comando.

Instalação

O TDS CLI 11.3 foi incorporado ao TDS e para a sua instalação tem que instalar o seu adicional. Para isso acione o menu Ajuda -> Instalar Novo Programa. Selecione o updatesite do TDS 11.3 em Instalar de: e na lista de adicionais selecione o TDS Linha de Comando. Finalize a instalação.

Instalação do TDS Linha de ComandoImage Added

Utilização

Após a instalação do adicional, será disponibilizado na pasta raiz da instalação do TDS o arquivo tdscli.bat (ambiente Windows) ou tdscli.sh (ambiente Linux) para acionar os comandos. Verifique abaixo os exemplos de utilização deste arquivo.Com isso, será possível aproveitar a estrutura dos seus projetos utilizados no TDS Comum para compilar projetos, pastas físicas, arquivos físicos, pastas virtuais, arquivos linkados e outros. 

Parâmetros Utilizados:

Nome do ParâmetroDescriçãoExemplosObservação
-dataRecebe o caminho completo do workspace.

-data D:/Workspace

-data D:/WorkspaceTDS113

O nome do parâmetro e o valor devem ser separados por espaço.

Esse parâmetro não pode ser passado dentro do arquivo de configuração.

workspace

Recebe "true" ou "t" para utilizar workspace definido no "-data".

Qualquer valor diferente de "true" será considerado como false.

workspace=true

ou

workspace=t

No TDSCLI agora também é possível utilizar uma estrutura de workspace que pode ser compartilhada com o TDS Comum.

Com isso, será possível aproveitar a estrutura dos seus projetos utilizados no TDS Comum para compilar projetos, pastas físicas, arquivos físicos, pastas virtuais, arquivos linkados e outros.

O nome do parâmetro e o valor devem ser separados pelo sinal de igual "=".

Caso o parâmetro não seja informado, será tratado como false.

program

Recebe o caminho do que deseja ser compilado a partir do workspace.

Pode ser um Projeto, pasta, recurso, arquivo e etc. Desde que seja respeitada a estrutura de projetos.

program=Nome_do_Projeto/

program=Projeto/Pasta

program=Projeto/Pasta/recurso.prw

program=Projeto/logo.png

No parâmetro program, deve ser passado o caminho relativo a partir do projeto. Caso deseje compilar um arquivo que esteja dentro de várias pastas, todas as pastas devem ser passadas no caminho, como:

program=Projeto/pasta1/pasta2/pasta3/pasta4/arquivo.4GL

No caso de diretórios, todos os arquivos dentro dos diretórios serão compilados

.
 

.

filterProgram

Recebe filtros que se aplicam ao nome dos arquivos.

Para mais de um filtro, é necessário separa-los por ponto e virgula ( ; ).

filterProgram=*.prw;*.prg;*.txt

filterProgram=*123*

filterProgram=*1?3*

O asterisco significa que antes ou depois pode existir 0 ou mais caracteres.

O ponto de interrogação simboliza a existência de um caractere.

Exemplos de Linha de Comando Completa:

 


Informações
iconfalse
titleCompilando um Arquivo do Workspace

Linha de Comando:

eclipsec.exe -nosplash -application br.com.totvs.tds.cli.tdscli compile tdscli.sh compile -data D:/Workspaces/workspaceTDSCLI workspace=true program=Projeto/pasta/arquivolink.prw includes=D:/Servers/Protheus/includes serverType=AdvPL server=localhost build=7.00.131227A port=1312 user=admin psw= environment=P11 authorization=D:/Chaves/matheus.AUT recompile=t

Projeto no Workspace TDS:

O que foi compilado:

Somente o "arquivolink.prw" foi compilado, pois ele não é um diretório.

Informações
titleOBS

A compilação de arquivos físicos funciona da mesma maneira que arquivos linkados.

Informações
iconfalse
titleCompilando uma Pasta

Linha de Comando:

eclipsec.exe -nosplash -application br.com.totvs.tds.cli.tdscli compile -tdscli.sh compile -data D:/Workspaces/workspaceTDSCLI workspace=true program=Projeto/pasta includes=D:/Servers/Protheus/includes serverType=AdvPL server=localhost build=7.00.131227A port=1312 user=admin psw= environment=P11 authorization=D:/Chaves/matheus.AUT recompile=t


Projeto no Workspace TDS:

O que foi compilado:

Todos os arquivos dentro da "Pasta" foram compilados: arquivofisico.prw e arquivolink.prw.
Informações
iconfalse
titleCompilando um Projeto

Linha de Comando:

eclipsec.exe -nosplash -application br.com.totvs.tds.cli.tdscli compile -tdscli.sh compile -data D:/Workspaces/workspaceTDSCLI workspace=true program=Projeto/ includes=D:/Servers/Protheus/includes serverType=AdvPL server=localhost build=7.00.131227A port=1312 user=admin psw= environment=P11 authorization=D:/Chaves/matheus.AUT recompile=t


Projeto no Workspace TDS:

O que foi compilado:

Todos os arquivos dentro do "Projeto" : arquivofisico.prw, arquivoLink.prw, arquivo.prw e resource.png.
Informações
iconfalse
titleFiltros

Utiliza os caracteres curinga * e ? para filtrar arquivos, utilizando o parâmetro filterProgram. Para passar mais de um filtro, separe-os por ponto e virgula ( ; )

Aviso
Todos os outros arquivos que não se encaixarem nos filtros serão ignorados.
Nota
O conteúdo da chave pode ser alterado de acordo com o filtro que desejar. Abaixo alguns exemplos:

Filtro utilizando asterisco ( * )

Filtro no final:

filterProgram=*.png;*.prw

Irá compilar somente os arquivos que terminam com .png ou .prw. Por exemplo: resource.png e arquivo.prw.

Filtro no inicio:

filterProgram=arquivo*

Irá compilar somente os arquivos que começam com "arquivo". Por exemplo: arquivofisico.prw

Filtro por conteúdo:

filterProgram=*io*

Irá compilar os arquivos que contenham "ivo" independente da posição. Por exemplo: arquivo.prw

Filtros Utilizando interrogação ( ? )

 A interrogação ( ? ) simula a existência de um caractere qualquer. Pode ser usado junto ao asterisco ( * )

Filtro no inicio:

filterProgram=?arquivo.prw

Irá compilar os arquivos que comecem com um caractere qualquer e "arquivo". Por exemplo: 1arquivo.prw ou xarquivo.prw.

Filtro no fim:

filterProgram=arquivo.pr?

Irá compilar os arquivos que comecem com "arquivo.pr" e termine com um caractere qualquer. Por exemplo: arquivo.prw ou arquivo.prg.

Filtro por conteúdo:

filterProgram=arquivo???.prw

Irá compilar os arquivos que comecem por "arquivo" contenham 3 caracteres quaisquer e terminem com ".prw". Por exemplo: arquivo123.prw ou arquivoXY1.prw

Expandir
titleDúvidas Frequentes
Expandir
titlePosso utilizar um workspace do TDS11.2?

Não. Não recomendamos a utilizado do workspace do TDS 11.2 no TDS CLI 11.3.

Expandir
titleE as demais operações do TDSCli 11.2?

O TDSCli 11.3 é totalmente compatível com o da versão 11.2, exceto na forma de invocá-lo, que passou para:
java -jar plugins\org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar -application br.com.totvs.tds.cli.tdscli -nosplash %*

(estrela) Se estiver utilizando tdscli.bat (ou tdscli.sh), distribuídos com a aplicação, você não precisa se preocupar com a forma de execução.

Para saber mais sobre o TDSCli, consulte TDS Linha de Comando.

Expandir
titleSe não informar o -data o que acontece?

O DeveloperStudio TDS utilizará um workspace padrão, podendo não encontrar os recursos indicados.

Expandir
titleComo eu sei qual workspace está sendo utilizado?

No console do TDS será exibida uma mensagem: ATENÇÃO O WORKSPACE UTILIZADO É .....

Expandir
titleAinda posso compilar sem utilizar um workspace?

Sim. Remova o parâmetro "workspace=" e passe o caminho completo do arquivo no parâmetro "program="

Expandir
titleErros Frequentes
Expandir
titleERRO: O recurso XXX nao foi encontrado no workspace XXX

O nome do recurso que foi informado não está no seu workspace. Verifique se o arquivo passado no parâmetro "program=" foi passado corretamente ou se o arquivo realmente existe no workspace.

Verifique também se a chave -data está recebendo o caminho correto do workspace.

Expandir
titleO arquivo XXX não foi encontrado

Esse erro acontece quando o TDS não está utilizando workspace e não encontrou o arquivo especificado.

Se deseja utilizar o workspace, verifique se a chave "workspace=" foi fornecida com o "true".

Se não deseja utilizar o workspace, verifique se o caminho passado está correto. Ele deve corresponder ao caminho completo do arquivo com nome e extensão, ou somente nome para diretórios.