TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 7

changes.mady.by.user Fabio Garbin

Gravado em

comparado com

Nova versão 8

changes.mady.by.user Fabio Garbin

Gravado em

Chave

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

Objetivo

A Ferramenta por linha de comando embutida no

Inclusão de trecho
Application Server
Application Server
nopaneltrue
permite diversas operações relacionadas a manipulação do RPO e execução de rotinas em batch. A ferramenta pode ser utilizada em processos de automação com a plataforma TOTVSTEC.

Principais características

  • Não tem comunicação cliente/server TCP, os comandos são executados diretamente no AppServer.
  • Ambiente simples que necessita apenas do appre, binário do appserver e arquivo de configuração "appserver.ini".
  • Compilação mais rápida.
  • Suporte a atual chave de compilação utilizada pelo TDS e TDSCli.
  • Chave de compilação para Linux utilizando criptografia AES 256bits.
  • Compatível com Sistemas Operacionais Windows e Linux.

Funcionalidades

  • Compilação de fontes e resources
  • Geração e aplicação de patches
  • Inspetor de Objetos
  • Execução de rotinas, sem interface
Section

Geral

Parâmetros

Parâmetros de linha do

Inclusão de trecho
Application Server
Application Server
nopaneltrue

Parâmetro de LinhaSistema OperacionalDescriçãoObservações

-console

ou

-debug

Windows
Executa o
Inclusão de trecho
Application Server
Application Server
nopaneltrue
em modo console.

-daemon

ou

daemon

Linux

Executa o

Inclusão de trecho
Application Server
Application Server
nopaneltrue
como um daemon no Linux.

  1. Ambas as formas, com ou sem o hífen, são aceitas para este parâmetro, obtendo o mesmo resultado final.
-versionLinux / WindowsExibe a versão do Application Server.
  1. Disponível a partir da versão 17.0.0.1.
-fullversionLinux / WindowsExibe informações mais completas sobre a versão do Application Server. tais como: Build Version, Profile (Debug, Release ou Release com Debug), Arquitetura, Plataforma, data de geração e demais informações.
  1. Disponível a partir da versão 20.3.2.8.

-ini=<config_file.ini>

ou

-ini <config_file.ini>

Linux / Windows

Define um arquivo de configuração alternativo ao padrão do

Inclusão de trecho
Application Server
Application Server
nopaneltrue
.

  1. Pode ser usado em conjunto com um dos parâmetros -daemon, ou daemon, ou -console, ou -debug, ou -install, conforme o sistema operacional.
  2. Deve ser usado ou com '=' sem espaços entre o parâmetro e o nome do arquivo, ou com apenas um espaço entre o parâmetro e o nome do arquivo.
  3. O arquivo de configuração alternativo <config_file.ini> deverá ter as mesmas características do arquivo padrão:
    1. estar no mesmo diretório do arquivo de configuração padrão;
    2. nome contendo apenas letras minúsculas, sem espaços, caracteres especiais, caminho do arquivo, etc.
    3. exemplos:
      1. -ini=newconfig.ini
      2. -ini alternative_file.ini
  4. Disponível a partir da versão 131227A NG 2.2.0.
-installWindows
Instalar o
Inclusão de trecho
Application Server
Application Server
nopaneltrue
como um serviço do Windows.

-removeWindows
Remover o serviço do Windows do
Inclusão de trecho
Application Server
Application Server
nopaneltrue
.

-compileWindows / LinuxOperações relacionadas ao acesso e alteração do repositório (RPO)Opção de linha do comando para operações de alteração e manutenção do RPO. Detalhes do comando disponível em: AppServer Command Line - Compilação por linha de comando
-runWindows / LinuxOperações relacionadas a execução de rotinas diretamente no Application Server.Opção de linha do comando para operações de execução de rotinas RPO. Detalhes do comando disponível em: AppServer Command Line - Execução por linha de comando
-helpWindows / Linux

Exibe no console uma ajuda com as opções disponíveis no

Inclusão de trecho
Application Server
Application Server
nopaneltrue
Command Line


Opção Compile

Estado
colourGreen
titleDisponível a partir da versão 17.3.0.9

Compilação

Parâmetros:

NomeDescriçãoObrigatórioObservações
-compileNecessário para inicialização da ferramentaSim
-files

Informa quais fontes serão compilados podendo ser informado das seguintes formas:

  • Arquivo Lst 
  • Pastas (Diretórios e sub-diretórios). Obs: O que não é programa será compilado como resource.
  • Arquivo único (fonte ou resource).
Sim
-includesInforma o diretório de includes usado durante a o pré-processamento dos fontes.Sim
-envInforma o ambiente que deverá ser acessado para compilação.Sim
-nodelfilesUtilizado para debug, caso informado, não deleta os arquivos gerados durante o pré-processamento e também mantem os arquivos temporários .Lst gerados durante o processo.


Não


-authorizationInforma a chave de compilação no formato de arquivo .aut, padrão TDS / TDSCli ou, o token de compilação no formato de arquivo .token, no padrão JWT.Não

Estado
colourBlue
titleA partir da versão 20.3.2.0, não será mais utilizada a autorização da chave de compilação.

-outreportGera os arquivos compile_sucess.log, que contem a lista de fontes compilados com sucesso no formato do arquivo .lst, e compile_errors.log, que contem a lista de fontes não compilados e os erros de compilação. A partir da versão 17.3.0.19, também é possível definir o diretório de saída para esses arquivos.Não

Estado
colourGreen
titleDisponível a partir da versão 17.3.0.15

Arquivo .Lst:

Tipo de arquivo com extensão .lst que pode conter uma lista de fontes e resources no formato de path absoluto, ou diretórios para compilação. Quando houverem diretórios, um novo arquivo .lst temporário com prefixo _generated será gerado para a extração dos arquivos contidos no diretório informado, compondo assim uma nova lista de arquivos a serem compilados. Por meio do parâmetro nodelfiles, é possível manter também esses arquivos temporários para análise.

O conteúdo do arquivo deverá respeitar as seguintes regras:

  • Usar separador ' ; '
  • Todos caminhos de arquivos ou diretórios devem ser inseridos em uma única linha com separador no final.


Veja o exemplo de arquivo anexado: exemplo.lst

Informações
titleExemplos:

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\teste.prw -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline-env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\lista.lst -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

Chave de compilação

Informações
titleObservação:

A partir da versão 20.3.2.0, os recursos de geração e de autenticação por meio de uma chave de compilação foram descontinuados. Será utilizado somente o token de compilação. Caso haja alguma tentativa de utilização destes parâmetros sejam será exibo um aviso informativo, "The Compilation key feature is no longer supported and the compilation token must be used from now on".

Índice
printablefalse





HTML
<style>.toc-macro {position: fixed; float: right}</style>