Protheus: Configuração do ambiente no Sistema Indústria

Ambiente de desenvolvimento

Ferramentas necessárias

  • Visual Studio Code

Pré requisitos

  • Estar conectado na VPN do Sistema Indústria.
  • Ter acesso ao CA PAM Client.

Informações adicionais

  • Servidor de desenvolvimento: ensi-dverp03
  • Compartilhamento Windows (Samba) do servidor de desenvolvimento: \\ensi-dverp03\F
  • Ambiente de desenvolvimento da PHL TI: http://ensi-dverp03:8089/rest
  • Projeto na Azure: https://dev.azure.com/CNI-STI/Protheus
  • Branch no repositório GIT: phlti/develop

Configuração do Visual Studio Code

Conectar na VPN do Sistema Indústria

Iniciar o Windows Explorer

    1. Clicar com o botão direito do mouse em “This PC”.
    2. Clicar em “Map Network Drive”.
    3. Selecionar “Drive” “P:”.
    4. Preencher “Folder” com “\\ensi-dverp03\F”
    5. Deixar marcado “Reconnect at sign-in”.
    6. Marcar “Connect using different credentials”.
    7. Clicar em “Finish”.
    8. Preencher o usuário “SISTEMA-CNI\t-plima” e a respectiva senha.
    9. Conferir o mapeamento de rede em funcionamento.

Visual Studio Code

  1. Criar diretório para o projeto do Protheus.
    1. No Prompt de Comando acessar o diretório da área de trabalho: cd D:\Programming\vscode-workspace
    2. Clonar o repositório do GIT: git clone https://<seu usuário>@dev.azure.com/CNI-STI/Protheus/_git/Protheus protheus-sistemaindustria
    3. Acessar o novo diretório: cd protheus-sistemaindustria
    4. Alternar para a branch de desenvolvimento da PHL TI: git checkout phlti/develop
    5. Configurar nome para o GIT: git config user.name “<seu nome completo>”
    6. Configurar e-mail para o GIT: git config user.email <seu e-mail>
  2. Iniciar a ferramenta
  3. Clicar no ícone “Extensions” ou pressionar “Ctrl+Shift+X”.
  4. Digitar “TOTVS Developer Studio” no filtro e instalar a extensão TOTVS Developer Studio
  5. Após concluída a instalação, abrir o menu “File” e clicar em “Open folder”.
  6. Selecionar a pasta do projeto clonado do GIT: D:\Programming\vscode-workspace\protheus-sistemaindustria
  7. Ao iniciciar na nova pasta, será exibida uma tela de boas vindas da extensão “TOTVs Developer Studio”.
  8. Preencher “Path to your SmartClient” com “P:\TOTVS\Bin\smartclient\smartclient.exe”.
  9. Preencher “Includes directory” com “P:\include”.
  10. Clicar em “SAVE/CLOSE”.

Trabalhando com o código

Para identificar o código-fonte de uma API, basta procurar pelo prefixo no diretório Fontes. No exemplo abaixo, procuramos por CNIGCT que foi encontrado no arquivo “CNIGCTAPI.prw”.

Configurando o servidor

  1. Clique no ícone do TOVS Developer Studio  à esquerda do Visual Studio Code.
  2. Na parte superior esquerda da tela é apresentado o cabeçalho “TOTVS:SERVERS” e os ícones de adicionar, configurar e abrir a visão do monitor.
  3. Clicar em adicionar (sinal de +), exibindo a tela “New Server”.
  4. Preencher “Server Name” com “PHL TI: Desenvolvimento”.
  5. Preencher “Address” com “ensi-dverp03”.
  6. Preencher “Port” com “13111”.
  7. Prencher “Includes directory” com “P:\include”.
  8. Clicar em “SAVE/CLOSE”.
  9. Clicar no ícone “Connect”
  10. Será exibido um pedido de informações para conexão.
    1. Name of the environment: PHLDEV
    2. User identification: t-plima
    3. Access password: t-plima
  11. O ícone mudará para indicar que está conectado.

Executando uma função

Com o arquivo “.prw” aberto, pressione F5 e ele pedirá o nome da função. Preencher com “u_<nome da funcão”, sempre com o prefixo “u_”.

Os arquivos gerados pela PHL TI ficam no compartilhamento em P:\TOTVS\APO\PHL.

Banco de dados

Desenvolvimento

  • Host: ENSI-DVDATA012
  • Usuário: usr_protheus
  • Senha: DEV8688

Homologação

  • Host: ENSI-HDATA012
  • Usuário:
  • Senha:

Produção

  • Host: ENSI-DATA01
  • Usuário:
  • Senha:

Consultas SQL

Para verificar o conteúdo de uma consulta, pode-se utilizar o seguinte SQL:

select * from ZQY010 where ZQY_NUM = '601';

Neste caso, a consulta é a de número 601.