Get 4D folder

4D v19.8

Get 4D folder


Get 4D folder {( pasta {; *} )} -> Resultado

Parâmetro	Tipo	Descrição
pasta	Inteiro longo	Tipo de pasta (se omitido = pasta 4D ativa)
*	Operador	Retorna a pasta do banco local
Resultado	String	Endereço para a pasta 4D

Descrição

O comando Get 4D folder retorna o caminho para a pasta 4D ativa do aplicativo atual, ou para a pasta do ambiente 4D especificado pelo parâmetro pasta, se fornecido.

Este comando lhe permite obter o caminho real das pastas utilizadas pela aplicação 4D. Ao usar este comando, você garante que seu código irá funcionar em qualquer plataforma rodando qualquer sistema localizado.

Na pasta, você pode passar uma das seguintes constantes, que estão localizadas no tema "Ambiente 4D":

Constante	Tipo	Valor
4D Client database folder	Inteiro longo	3
Active 4D Folder	Inteiro longo	0
Current resources folder	Inteiro longo	6
Data folder	Inteiro longo	9
Database folder	Inteiro longo	4
Database folder Unix syntax	Inteiro longo	5
HTML Root folder	Inteiro longo	8
Licenses folder	Inteiro longo	1
Logs folder	Inteiro longo	7
MobileApps folder	Inteiro longo	10

Você encontrará abaixo uma descrição de cada pasta:

Notas preliminares sobre os nomes das pastas:

{Disco} é o disco onde o sistema está instalado.
A palavra Usuário representa o nome do usuário que abriu a sessão.

Pasta 4D Ativa

Aplicações em ambiente 4D usar a pasta específica para armazenar as seguintes informações:

Arquivos de preferências usado pelo ambiente de aplicações 4D
Arquivo Shortcuts.xml (atalhos de teclado personalizados)
Pasta Macros v2 (comandos de macro do editor de Métodos)
Pasta Favoritos v1x, por exemplo Favoritos v13 (caminhos para os bancos de dados locais e remotos que foram abertos)
Pasta Logs para históricos de manutenção e quando dados forem de apenas leitura

Com as principais aplicações 4D (4D e 4D Server), a pasta 4D ativa chamada 4D e está localizada por padrão no seguinte local:

No Windows 7 e seguintes: {Disco}:\Usuarios\<nomeUsuario>\AppData\Roaming\<nomeBanco>
No OS X: {Disco}:Usuarios:<nomeUsuario>:Library:Application Support:<nomeBanco>

Pasta Licenças

Pasta contendo os arquivos de Licenças da máquina.

A pasta de Licenças é colocado no local a seguir:

No Windows 7 e superiores: {Disco}:\Arquivos de programa\4D\Licences\
No OS X: {Disco}:Biblioteca:Application Support:4D:Licenses

Notas:

Notas: No caso de um pedido de fusão com 4D Volume Desktop, a pasta de licenças está incluída no pacote do aplicativo.
Se a pasta de licenças não podem ser criadas no sistema devido à falta de autorização, ela é criado, nos seguintes locais:

- No Windows 7 e superiores: {Disco}:\Usuarios\<nomeUsuario>\AppData\Roaming\4D\Licenses
- No OS X: {Disco}:Usuarios:<nomeUsuario>:Library:Application Support:4D:Licenses

Pasta Data

Rota da pasta que contém o arquivo de dados atual. O caminho da rota é expresso usando a sintaxe normal da plataforma atual.

Pasta 4D Client Database (máquinas cliente)

A pasta 4D database é criada em cada máquina cliente 4D para armazenamento de arquivos e pastas relacionadas ao banco de dados (recursos, plug-ins, a pasta Resources, etc.).

A pasta do banco de dados 4D Client é colocada no seguinte local em cada máquina cliente:

No Windows : {Disco}:\Usuarios\<nomUsuario>\AppData\Local\4D\<NomeDoBanco_Endereço_Porta_chave>
No macOS : {Disco}:Usuarios:<nomUsuario>:Biblioteca:Caches:4D:<NomeDoBanco_Endereço_Porta_chave>

Nota: o valor chave se incrementa (e a pasta local do banco de dados 4D se duplica) quando outra instância da aplicação cliente for executada simultaneamente na mesma máquina.

Pasta Banco de Dados

Pasta contendo o arquivo de estrutura de banco de dados. O caminho é expressado utilizando a sintaxe padrão da plataforma atual.

Com a aplicação 4D Client, essa constante é rigorosamente equivalente à constante anterior: o comando retorna o caminho da pasta criada localmente.

Pasta base sintaxe Unix (Database Folder Unix Syntax)

Pasta contendo o arquivo de estrutura de banco de dados. Esta constante designa a mesma pasta que o anterior, mas o caminho retornado é expressado utilizando a sintaxe UNIX (POSIX), de tipo /Users/ ... Esta sintaxe é usada principalmente quando você usa o comando LAUNCH EXTERNAL PROCESS sob OS X.

Pasta Current Resources

A pasta Recursos de banco de dados. Esta pasta contém os itens adicionais (fotos, textos) utilizados para a interface de banco de dados. Um componente pode ter a sua pasta de recursos próprios. A pasta de Recursos está localizado junto à estrutura do arquivo de banco de dados.

No modo cliente / servidor, essa pasta pode ser usada para organizar a transferência de dados personalizados (fotos, arquivos, subpastas, etc) entre a máquina do servidor e as máquinas cliente. O conteúdo desta pasta é atualizado automaticamente em cada máquina cliente quando ela se conecta. Todos os mecanismos de referência associados com a pasta Recursos são suportados em modo cliente / servidor (Pasta .lproj, XLIFF, fotos, e assim por diante). Além disso, 4D fornece várias ferramentas que podem ser utilizadas para gerir e atualizar esta pasta de forma dinâmica, mais particularmente, um explorador de recursos.

Nota:

se a pasta de Recursos não existe para o banco de dados, executando o comando Get 4D folder com a pasta Recursos corrente constante irá criá-la.

Em Windows, em projetos cliente fusionados, a localização desta pasta é modificada se a chave ShareLocalResourcesOnWindowsClient BuildApp for usada.

Pasta Logs

A pasta Logs do banco de dados criada no mesmo nível da estrutura de arquivo. Esta pasta centraliza os seguintes arquivos de log do banco de dados atual:

conversão de banco de dados,
as solicitações do servidor da Web,
atividades de backup / restore,
a depuração de comando,
os pedidos de 4D Server (gerado em máquinas cliente e no servidor).

Notas:

Uma pasta adicional Logs, que está na pasta de preferências de usuário de sistema (Active 4D Folder é usada para arquivos de histórico de manutenção (compactar, verificar, reparar). É recomendado chamar Get 4D file (compactação de arquivo de log) por exemplo quando quiser acessar tais arquivos de log). Esta pasta Logs também é usada em casos onde a pasta Logs normal não pode ser escrita
Se a pasta Logs não existe para o banco de dados, executando o comando Get 4D folder com a constante Logs Folder irá criá-la.

Pasta HTML Root

Pasta HTML raiz do banco de dados. O caminho retornado é expressado com a sintaxe padrão da plataforma atual. A pasta raiz HTML é a pasta na qual o servidor Web 4D olha para as páginas Web e arquivos solicitados. Por padrão, ela é denominada WebFolder e é colocado ao lado da estrutura de arquivo (ou sua cópia local, no caso de 4D em modo remoto). Sua localização pode ser definida na página de Configuração das preferências ou dinamicamente através do comando WEB SET ROOT FOLDER.

Se o comando Get 4D folder é chamado através de um 4D remoto, o caminho retornado é o da máquina remota, não de 4D Server.

O parâmetro opcional * é útil no caso de uma arquitetura usando componentes: pode ser usado para determinar o banco de dados (host ou componente) para os quais você deseja obter o caminho da pasta. Este parâmetro só é válido para as pastas Database Folder, Database Folder Unix Syntax e Current Resources folder. Os demais casos são ignorados.

Quando o comando é chamado desde um componente:

Se o parâmetro * for passado, o comando retorna o caminho da pasta base de dados do host,
Se o parâmetro * não for passado, o comando retorna o caminho da pasta do componente.
A pasta base de dados (Database Folder e Database Folder Unix Syntax) retornada difere de acordo com o tipo de arquitetura de componentes:
- No caso de uma pasta/pacote .4dbase, o comando retorna o caminho da pasta/pacote .4dbase,
- No caso de arquivo .4db ou .4dc, o comando retorna o caminho dos "componentes" da pasta,
- No caso de um alias ou atalho, o comando retorna o caminho da pasta que contém a matriz do banco de dados original. O resultado varia de acordo com o formato desta base de dados (pasta .4dbase/ pacote ou arquivo .4db ou .4dc), como descrito acima.
Quando o comando é chamado desde o host do banco de dados, ele sempre retorna o caminho da pasta banco de dados do host, independentemente de haver ou não o parâmetro *.

Pasta MobileApps

Pasta que contém todas os arquivos existentes de sessão (json) usados pelas aplicações 4D para referenciar sessões de usuário de app mobile (ou seja, sessões de 4D para apps iOS). Arquivos de sessão são agrupadas em subpastas de aplicação e são criadas automaticamente. Para saber mais, veja a documentação 4D for iOS.

Esta pasta está localizada no mesmo nível que o arquivo atual 4D data.

Exemplo 1

Durante a inicialização de um banco de dados único, você deseja carregar (ou criar) as suas próprias configurações em um arquivo localizado na pasta 4D. Para fazer isso, em Método banco de dados On Startup,, você pode escrever um código semelhante a este:

 $vsPrefDocName:=Get 4D folder+"MyPrefs.prf" //Constrói nome rota ao arquivo Preferences

  // Checa se o arquivo existe

 If(Test path name($vsPrefDocName)#Is a document)

    $vtPrefDocRef:=Create document($vsPrefDocName.prf) //Se não, o criaI

 Else

    $vtPrefDocRef:=Open document($vsPrefDocName.prf) //Se sim, o abre

 End if

 If(OK=1)

  //Processa conteúdos dos documentos

    CLOSE DOCUMENT($vtPrefDocRef)

 Else

  //Maneja erros

 End if

Exemplo 2

Este exemplo ilustra o uso da constante Database Folder Unix Syntax sob Mac OS para listar o conteúdo da pasta do banco:

 $posixpath:="\""+Get 4D folder(Database folder Unix syntax)+"\""

 $myfolder:="ls -l "+$posixpath

 $in:=""

 $out:=""

 $err:=""

 LAUNCH EXTERNAL PROCESS($myfolder;$in;$out;$err)

Nota: sob Mac OS, é necessário colocar os endereços de acesso entre aspas quando contém os nomes de arquivos ou de pastas com espaços. A sequência de escape "\" permite inserir o caractere aspas na string. Também é possível utiilzar a instrução Char(Double quote).

Variáveis e conjuntos do sistema

Se o parâmetro pasta não é válido ou se o endereço de acesso retornado é vazio, a variável sistema OK recebe o valor 0.

Ver também

COMPONENT LIST
System folder
Temporary folder
Test path name
WEB SET ROOT FOLDER