Árvore de páginas

Versões comparadas

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

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

Índice
printablefalse





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