- Criado por Fabio Garbin, última alteração em 02 dez, 2024
Você está vendo a versão antiga da página. Ver a versão atual.
Comparar com o atual Ver Histórico da Página
« Anterior Versão 2 Próxima »
Objetivo
A Ferramenta por linha de comando embutida no TOTVS | Application Server 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 TOTVS | Application Server| Parâmetro de Linha | Sistema Operacional | Descrição | Observações |
|---|---|---|---|
-console ou -debug | Windows | Executa o TOTVS | Application Server em modo console. | |
-daemon ou daemon | Linux | Executa o TOTVS | Application Server como um daemon no Linux. |
|
| -version | Linux / Windows | Exibe a versão do Application Server. |
|
| -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. |
|
-ini=<config_file.ini> ou -ini <config_file.ini> | Linux / Windows | Define um arquivo de configuração alternativo ao padrão do TOTVS | Application Server. |
|
| -install | Windows | Instalar o TOTVS | Application Server como um serviço do Windows. | |
| -remove | Windows | Remover o serviço do Windows do TOTVS | Application Server. | |
| -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 TOTVS | Application ServerCommand 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:
| Sim | |
| -includes | Informa o diretório de includes usado durante a o pré-processamento dos fontes. | Sim | |
| -src | |||
| -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 | A PARTIR DA VERSÃO 20.3.2.0, NÃO SERÁ MAIS UTILIZADA A AUTORIZAÇÃO DA CHAVE DE COMPILAÇÃ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 | DISPONÍ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
Exemplos:
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
Observaçã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.
Compatível com a chave de compilação gerada e utilizada no TDS e TDSCli. Para a utilização da ferramenta Compile, é preciso exportar as informações de uma nova ou já existente chave criando um arquivo com extensão .aut. No Linux, é utilizado o mesmo padrão de criação de chave realizando o controle pelo UUID do disco porem, a chave é criada e criptografada utilizando algoritmo AES 256bits.
Exemplos:
Windows
|
Linux
|
Para criação de uma nova chave no Linux, será necessário a coleta do UUID onde a ferramenta está instalada e posteriormente entrar em contato com a Tecnologia - AppServer.
Comando para obtenção do UUID no linux:
|
Patch
Geração de Patch
Recurso para geração de path. Por default, os patchs serão gerados na pasta "cmdgenpatch" dentro do Environment.
Parâmetros
Nome | Descrição | Obrigatório | |
|---|---|---|---|
| -compile | Necessário para inicialização da ferramenta | Sim | |
| -genpatch | Indica geração de Patch | Sim | |
| -files | Informa os programas que irão compor o patch da seguinte forma:
| Sim | |
| -env | Informa o ambiente que deverá ser acessado para compilação. | Sim | |
| -patchtype | Extensão de patch: ptm, upd ou pak. Por default, é gerado com extensão ptm. | Não | |
| -outgenpatch | Permite a definição de um diretório de output. | Não | DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.19 |
Exemplos:
appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw -env=environment -patchtype=ptm
appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw;teste.prw -env=environment -patchtype=ptm
appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm
appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm -outgenpatch=d:\patchs\teste1
Validação de Patch
DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.20
Este recurso permite ao desenvolvedor adicionar uma etapa de verificação do Patch antes de aplicá-lo. O resultado dessa verificação pode ser armazenado em um arquivo Log e analisado posteriormente.
Parâmetros
Nome | Descrição | Obrigatório |
|---|---|---|
| -compile | Necessário para inicialização da ferramenta | Sim |
| -validatePatch | Indica Validação de Patch | Sim |
| -files | Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK"). | Sim |
| -env | Informa o ambiente que deverá ser acessado para compilação. | Sim |
| -outreport | Gera o arquivo patch_errors.log contendo o resultado da verificação de patch. Também é possível definir o diretório de saída para esse arquivo. | Não |
Exemplo:
appserver.exe -compile -validatepatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -outreport
Aplicação de Patch
Recurso para aplicação de Patch.
Parâmetros
Nome | Descrição | Obrigatório | |
|---|---|---|---|
| -compile | Necessário para inicialização da ferramenta | Sim | |
| -applypatch | Indica aplicação de Patch | Sim | |
| -files | Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK"). | Sim | |
| -env | Informa o ambiente que deverá ser acessado para compilação. | Sim | |
| -applyoldprogram | Informa que serão aceitos fontes mais antigos que o RPO. Por default, aceita somente os fontes mais novos. | Não | |
| -cbfiles | Interno. Não é possível utilizar sem o token interno da TOTVS. | Não | DISPONÍVEL A PARTIR DA VERSÃO 20.3.1.3 |
Exemplo:
appserver.exe -compile -applypatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -applyoldprogram
Desfragmentação RPO
DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.15
Recurso DefragRPO para desfragmentação de RPO.
Parâmetros
Nome | Descrição | Obrigatório |
|---|---|---|
| -compile | Inicialização da ferramenta. | Sim |
| -defragrpo | Indica desfragmentação de RPO. | Sim |
| -env | Informa o ambiente que deverá ser desfragmentado. | Sim |
Exemplo:
appserver.exe -console -compile -defragrpo -env=advplc
Inspetor de Objetos
Run
- Sem rótulos
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas