4D Doc Center : Get 4D folder

4D v14.3

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	cadeia	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 operacional.

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
Database folder	Inteiro longo	4
Database folder Unix syntax	Inteiro longo	5
Extras folder	Inteiro longo	2
HTML Root folder	Inteiro longo	8
Licenses folder	Inteiro longo	1
Logs folder	Inteiro longo	7

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.
Com algumas versões de Mac OS, os nomes das pastas são traduzidos:
- A pasta Library é chamada Biblioteca
- A pasta Application Support chamada Suporte a Aplicações.

Pasta 4D Ativa

O ambiente 4D usa a pasta 4D 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 v11, Favoritos v12 ou Favoritos v13 (caminhos para os bancos de dados locais e remotos que foram abertos)

A pasta 4D é criada por padrão no seguinte local:

No Windows 7 e seguintes: {Disco}:\Usuarios\Usuario\AppData\Roaming\4D
No OS X: {Disco}:Usuarios:Usuario:Library:Preferences:4D

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\Usuario atual\AppData\Roaming\4D\Licences\
- No OS X: {Disco}:Usuarios:Usuario:Biblitoeca:Application Support:4D:Licenses

Pasta Extras (obsoleta)

Pasta com conteúdos customizados baixados para cada máquina cliente.

Nota de compatibilidade: Começando com a versão 11.2 do 4D v11 SQL, já não é aconselhável a utilização da pasta Extras para a comunicação personalizada entre o servidor e máquinas remotas. Agora, é recomendado usar a pasta Recursos para este fim (veja a descrição da pasta Recursos abaixo). A pasta Extras no entanto, é ainda usada por 4D Server, de modo a manter a compatibilidade das aplicações existentes.

Nota: Se a pasta Extras não existe na base, será criado executando o comando Get 4D folder com a constante Extras Folder.

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 7 e superiores: {Disco}:\Usuarios\Usuario atual\AppData\Local\4D\NomeDoBanco_Endereço
No OS X: {Disco}:Usuarios:Usuario atual:Biblioteca:Caches:4D:NomeDoBanco_Endereço

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.

Current Resources folder

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.

Pasta Logs

A pasta Logs do banco de dados. Esta pasta centraliza os arquivos de log do banco de dados atual. Ela é criado no mesmo nível da estrutura de arquivo e contém os seguintes arquivos de log:

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

Nota: 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 *.

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, no método Método banco de dados On Startup, você pode escrever um código semelhante a este:

 MAP FILE TYPES("PREF";"PRF";"Preferences file")

  ` Associa o tipo de arquivo PREF em Mac OS à extensão de arquivo .PRF em Windows

 $vsPrefNomeDoc:=Get 4D folder+"MinhasPrefs" ` Construir o endereço de acesso ao arquivo Preferencias

  ` Verificar se o arquivo existe

 If(Test path name($vsPrefNomeDoc+(".PRF"*Num(On Windows)))#Is a document)

    $vtPrefDocRef:=Create document($vsPrefNomeDoc;"PREF") ` Se não, criar

 Else

    $vtPrefDocRef:=Open document($vsPrefNomeDoc;"PREF") ` Se sim, abrir

 End if

 If(OK=1)

  ` Processar o conteúdo do documento

    CLOSE DOCUMENT($vtPrefDocRef)

 Else

  ` Controlar o erro

 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.