Tempo de leitura: 2 minutos
Você precisa saber o caminho completo do seu diretório protheus_data em tempo de execução no Protheus? A função GetSrvProfString é a sua melhor aliada para isso!
O que é GetSrvProfString?
A função GetSrvProfString é uma das funções nativas do ADVPL utilizadas para ler chaves de configuração dentro da seção do ambiente atual no arquivo de configuração do Application Server (geralmente o appserver.ini.
Em outras palavras, ela permite que seu código leia as configurações definidas no servidor de aplicação que está executando o Protheus.
Sintaxe
GetSrvProfString(cChave,cValPad)
Parâmetro(s):
Retorno:
🛠️ Como Obter o Diretório protheus_data
O diretório principal onde o Protheus armazena os dados (como arquivos de configuração, relatórios temporários, etc.) é definido pela chave RootPath na seção environment do appserver.ini.
Para ler o caminho completo desse diretório, você pode usar a GetSrvProfString da seguinte forma:
#include 'protheus.ch'
/*{Protheus.doc} User Function fGetSPSt
Exemplo da função GetSrvProfString que recupera valores do arquivo appserver.ini
@type Function
@author Adilio Costa
@since 30/10/2025
@version 1.0
@Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@Conheça os Cursos do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function fGetSPSt()
Local aArea := FWGetArea()
// Define uma variável para armazenar o caminho
Local cProtheusData := ""
// Chama a função para ler a chave "RootPath" na seção do ambiente em uso
// Caso não encontre, retorna uma string vazia ("")
cProtheusData := GetSrvProfString( "RootPath", "" )
// Exemplo de uso: mostrar o caminho
FWAlertInfo( "O diretório protheus_data é: " + cProtheusData, "Caminho do protheus_data" )
// O resultado será o caminho configurado no appserver.ini, como por exemplo:
// "C:\TOTVS\Protheus\protheus_data"
FWRestArea(aArea)
Return
✅ Dica: A chave RootPath é amplamente utilizada e confiável para obter o caminho da pasta protheus_data configurada para o ambiente que está sendo executado.
Por que isso é útil?
-
Caminhos Dinâmicos: Garante que seu código sempre aponte para o diretório correto, mesmo que a instalação do Protheus mude de lugar ou você execute o código em ambientes diferentes.
-
Integrações: Essencial para rotinas que precisam gravar arquivos temporários, logs ou relatórios na estrutura de pastas do Protheus.
Bem, finalizamos mais um post aqui do Blog ProtheusAdvpl.
Se esse conteúdo lhe foi útil nos ajude compartilhando ele em suas redes sociais do TOTVS Protheus.
Grande abraço e fica com Deus.
Link de referência:https://tdn-homolog.totvs.com/display/tec/GetSrvProfString
#ADVPL #TOTVS #Protheus #Desenvolvimento #GetSrvProfString #ProtheusData
