Objetivo

A Ferramenta por linha de comando embutida no 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

Geral

Parâmetros

Parâmetros de linha do

Parâmetro de Linha	Sistema Operacional	Descrição	Observações
-console ou -debug	Windows	Executa o em modo console.
-daemon ou daemon	Linux	Executa o como um daemon no Linux.	Ambas as formas, com ou sem o hífen, são aceitas para este parâmetro, obtendo o mesmo resultado final.
-version	Linux / Windows	Exibe a versão do Application Server.	Disponível a partir da versão 17.0.0.1.
-fullversion	Linux / Windows	Exibe 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.	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 .	Pode ser usado em conjunto com um dos parâmetros -daemon, ou daemon, ou -console, ou -debug, ou -install, conforme o sistema operacional. 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. O arquivo de configuração alternativo <config_file.ini> deverá ter as mesmas características do arquivo padrão: estar no mesmo diretório do arquivo de configuração padrão; nome contendo apenas letras minúsculas, sem espaços, caracteres especiais, caminho do arquivo, etc. exemplos: -ini=newconfig.ini -ini alternative_file.ini Disponível a partir da versão 131227A NG 2.2.0.
-install	Windows	Instalar o como um serviço do Windows.
-remove	Windows	Remover o serviço do Windows do .
-compile	Windows / Linux	Operaçõ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
-run	Windows / Linux	Operaçõ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
-help	Windows / Linux	Exibe no console uma ajuda com as opções disponíveis no Command Line

Opção Compile

Compilação

Parâmetros:

Nome	Descrição	Obrigatório
-compile	Necessário para inicialização da ferramenta	Sim
-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
-includes	Informa o diretório de includes usado durante a o pré-processamento dos fontes.	Sim
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-nodelfiles	Utilizado 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
-authorization	Informa 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
-outreport	Gera 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

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

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

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