Merge pull request #570 from totvs/dev

Dev

CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+# Versão [1.2.0]
+
+## Genéricas
+
+- Documentação e ajustes no [Sistema de Privilégios](docs/servers.md)
+- Implementação de opção para visualização do log do repositório
+
+## Implementação da API generatePPO
+
+- Foi implementada a API generatePPO que gera o conteúdo do PPO do arquivo em edição. Maiores detalhes em [API exportadas](https://github.com/totvs/tds-vscode/blob/dev/docs/exported-api.md)
+
+## Chave de compilação Inválida [Issue 563](https://github.com/totvs/tds-vscode/issues/563)
+
+### Problema:
+
+- Ao aplicar uma chave de compilação ocorre erro indicando que a chave é inválida.
+
+### Solução:
+
+- Foi aplicada uma correção interna nas validações da chave de compilação.
+
+## Implementação chamado #269
+
+- Opção de manter as configurações de servidores na área de trabalho e [troca rápida](docs/servers.md)
+
+## Correção chamado #553
+
+- Erro de compilação [FATAL] não é exibido na aba PROBLEMS e nem no LOG do AppServer.
+
 # Versão [1.1.1]
 
 ## Correção chamado #549

docs/exported-api.md

@@ -0,0 +1,26 @@
+# API exportadas
+
+Ao instalar a extensão tds-vscode é possível acessar as suas seguintes APIs exportadas.
+
+Clique na API para mais detalhes.
+
+<details>
+<summary>
+  generatePPO(filePath: string, options?: any): Promise&lt;string&gt;
+</summary>
+
+<br/>
+Obtém o arquivo PPO correspondente referente ao arquivo informado.
+
+| Parâmetro | Descrição |
+| --------- | --------- |
+| filePath: string | Caminho completo do arquivo a ser processado. |
+| options?: any | encoding com o qual o retorno deve ser codificado. Se omitido, o padrão cp1252 será utilizado. |
+
+| Retorno   | Descrição |
+| --------- | --------- |
+| Promise&lt;string&gt; | Conteúdo do PPO gerado. |
+
+* O PPO será gerado com as mesmas características do arquivo compilado.
+* Um servidor deve estar conectado para que o PPO seja gerado.
+</details>

docs/servers.md

@@ -1,7 +1,7 @@
 # Visão `Servers`
 
 > Requisitos:
-> - servidor a ser utilizado em execução
+> - servidor a ser utilizado ou registrado em execução
 
 ## Registro de servidores
 
@@ -22,3 +22,68 @@
 - A conexão com servidores pode ser efetuada pela seleção do texto `[Selecionar servidor/ambiente]` na barra de ferramentas. Ou pelo atalho `CTRL + SHIFT + P` digite `TOTVS: Select Server`.
 
 ![Connect Server](./gifs/ConnectServer.gif)
+
+## Configurações das definições
+
+As configurações com os registros dos servidores podem ser editados manualmente, desde que com cuidado, via editor de texto.
+
+Pode-se acessá-lo acionando o ícone semelhante a uma engrenagem.
+
+![Edit file server](./gifs/serversEditFile.gif)
+
+## Local de gravação
+
+Por padrão, o arquivo com os registros de servidores é armazenado no arquivo `servers.json`, na área do usuário conforme o sistema operacional.
+
+* **Windows** `%USERPROFILE%\\.totvsls\\settings.json`
+* **MacOS** `$HOME/.totvsls/settings.json`
+* **Linux** `$HOME/.totvsls/settings.json`
+
+Caso deseje ter o registro de servidores por área de trabalho, ative a opção em `File | Preferences | Settings | Extensions | TOTVS | Workspace server config`.
+
+![Workspace Server Config](./images/workspaceServerConfig.png)
+
+Ou use a troca rápida disponível na barra de _status_.
+
+![Workspace Server Config](./gifs/toggleWorkspaceConfig.gif)
+
+> A troca rápida aplica-se somente a área de trabalho corrente e se sobrepoem a configuração padrão ou por usuário. Detalhes em [User and Workspace Settings](https://code.visualstudio.com/docs/getstarted/settings).
+
+## Sistema de Privilégios
+
+O **TDS-VSCode**, suporta um sistema simples de privilégios, baseada em configuração efetuada no arquivo _appServer.ini_, podendo-se configurar  privilégios para determinadas operações e estações, através da adição de chaves na sessão `[TDS]`.
+
+> Para manter o mesmo comportamento de ambientes com versões mais antigas, todas as operações vem liberadas por padrão, na ausência da sessão `[TDS]` ou da chave da operação.
+
+### Especificação da sessão
+
+```
+[TDS]
+ALLOWAPPLYPATCH=<ip list>
+ALLOWEDIT=<ip list>
+ENABLEDISCONNECTUSER=<ip list>
+ENABLESENDMESSAGE=<ip list>
+ENABLEBLOCKNEWCONNECTION=<ip list>
+ENABLESTOPSERVER=<ip list>
+ALLOWBUILDPATCH=<ip list>
+ALLOWMONITOR=<ip list>
+ALLOWCOMPILE=<ip list>
+```
+
+Chave | Permissão |
+----- | --------- |
+ALLOWAPPLYPATCH | Aplicar pacotes de atualização (_patchs_)
+ALLOWEDIT | Editar configurações do _appServer_
+ENABLEDISCONNECTUSER | Desconectar usuários
+ENABLESENDMESSAGE | Enviar mensagens
+ENABLEBLOCKNEWCONNECTION | Bloquear novas conexões
+ENABLESTOPSERVER | Encerrar o _appServer_
+ALLOWBUILDPATCH | Gerar pacotes de atualização (_patchs_)
+ALLOWMONITOR | Monitorar conexões/sessões do _appServer_
+ALLOWCOMPILE | Compilar fontes e recursos
+|
+
+- `Chave` deve ser sempre em maiúsculas
+- `<ip list>` é a lista de estações com o privilégio liberado, identificadas pelo seu endereço IP e separadas por `,`.
+
+> Para liberar o privilégio a qualquer estação, omita a chave ou coloque `*`.

i18n/ptb/package.i18n.json

@@ -13,6 +13,7 @@
 	"tds.package.show.ask.compile.result": "Pedir para exibir tabela com resultados da compilação",
 	"tds.package.clear.console.before.compile": "Limpar o console antes da compilação",
 	"tds.package.show.console.on.compile": "Exibir console na compilação",
+	"tds.package.show.banner": "Apresenta banner na inicialização",
 	"tds.package.reconnectLastServer": "Reconectar ao último servidor conectado na inicialização.",
 	"tds.package.generate.ppo": "Gere arquivo PPO.",
 	"tds.package.show.precompile": "Mostrar comando pré compilador.",
@@ -115,5 +116,6 @@
 	"tds-monitor.open-monitor-view": "Abrir exibição do monitor",
 	"tds.package.workspaceServerConfig": "Use a área de trabalho para manter as configurações do servidor.",
 	"tds.package.OpenTimeLineWebview": "Abrir visão da linha de tempo",
-	"tds.package.apply.formatting": "Aplica a formatação aos arquivos fontes TOTVS e suas variações."
+	"tds.package.apply.formatting": "Aplica a formatação aos arquivos fontes TOTVS e suas variações.",
+	"tds-monitor.open-rpoinfo": "Log de Repositório"
 }