Get 4D folder
Get 4D folder {( pasta {; options} {; *})} -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| pasta | Integer | → | Tipo de pasta (se omitido = pasta 4D ativa) |
| options | Object | → | 4D Client database folder path configuration |
| * | Operador | → | Retorna a pasta do banco local |
| Resultado | Text | ← | 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 |
O parâmetro opções permite personalizar la ruta de la carpeta de recursos locales. Sólo se tiene en cuenta cuando se utiliza la constante 4D Client database folder (ver abajo).
Nota: se o comando Get 4D folder for chamado desde um 4D remoto, a rota devolvida é a da máquina remota, não a de 4D Server.
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\
- No OS X: {Disco}:Usuarios: < nomeUsuario >:Library:Application Support:< nomeBanco >
Pasta Licenças
Pasta contendo os arquivos licença da máquina.
Nota: No caso de uma aplicação fusionada com 4D Volume Desktop, a pasta licenças é incluída no pacote da aplicação.
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)
Rota da pasta 4D criada em máquinas remotas 4D para salvar arquivos e pastas relacionados com o banco de dados (recursos, plug-ins, pasta Resources, etc.). O comando pode devolver:
- a rota para a aplicação atual quando for chamada em uma máquina remota e for omitod o parâmetro opcoes,
- a rota para toda aplicação quando se utilizar o parâmetro opcoes (em cujo caso Get 4D folder pode ser chamado em qualquer máquina).
Por padrão, a rota é:
- Em Windows: {*Disk}:\Users\{UserAccount}\AppData\Local\{ApplicationName}\{StructureName_IP_Port_key}
ex: C:\Users\John Doe\AppData\Local\myApp\myApp_192_168_2_134_19813_157 - Em macOS: {Disk}:Users:{UserAccount}:Library:Caches:{ApplicationName} Client:{StructureName_IP_Port_key}.
ex.:Users:John Doe:Library:Caches:myApp Client:myApp_192_168_2_134_19813_933
São usadas pastas diferentes se forem executadas simultaneamente várias instâncias da aplicação cliente na mesma máquina.
Nota: em Windows, nos projetos cliente fusionados, o local desta pasta se modifica se for utilizada a chave BuildApp ShareLocalResourcesOnWindowsClient .
Uso da pasta base 4D Client com o parámetro opções
Pode utilizar o parâmetro opciones se quiser calcular qualquer rota de pasta local de base 4D. Neste caso, a rota se constrói a partir da informação que quiser fornecer no objeto opces e o comando pode ser utilizado de uma aplicação 4D, 4D Server, ou remota. Graças a esta funcionalidade, pode precalcular as rotas de suas pastas de recursos, por exemplo para precarregar conteúdos.
Pode passar as propriedades abaixo no objeto opçoes:
| Propriedade | Tipo | Descrição |
|---|---|---|
| remoteAppPath | Text | Opcional - Rota de sistema executável da aplicação remota. Por padrão na rota executável da aplicação atual. |
| buildApplicationName | Text | Opcional: nome da aplicação (igual que o valor da chave xml BuildApp BuildApplicationName ). Por padrão é o nome da aplicação atual. |
| structureName | Text | Obrigatório exceto se definir o atributo clientServerSystemFolderName - Nome da estrutura. |
| ipAddress | Text | Obrigatorio exceto se definir oatributo clientServerSystemFolderName - Dirección IP del servidor (igual que el valor de la llave xml BuildApp IPAddress ). |
| portNumber | Number | Obrigatório exceto se definir o atributo clientServerSystemFolderName - Porto de publicação do servidor ( mesmo que o valor da chave xml BuildApp PortNumber ). |
| clientServerSystemFolderName | Text | Opcional - Opcional - Nome personalizado da pasta final de recursos locais (igual que o valor da chave xml BuildApp ClientServerSystemFolderName BuildApp). |
| shareLocalResourcesOnWindowsClient | Boolean | Opcional - Pasta de recursos locais compartidos (igual que o valor da chave xml BuildApp ShareLocalResourcesOnWindowsClient ). |
Nota: a rota devolvida se expressa utilizando a sintaxe de sistema da máquina que executa o comando.
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.
Note: Em Windows, em projetos cliente fusionados, a localização desta pasta é modificada se a chave ShareLocalResourcesOnWindowsClient BuildApp for usada.
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 go mobile.
Esta pasta está localizada no mesmo nível que o arquivo atual 4D data.
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 o qual quiser obter a rota de pasta. Esse parâmetro é apenas válido para as pastas Database folder, Database folder UNIX syntax e Current resources folder. É ignorado nos outros casos.
Quando o comando for chamado de um componente:
- Se o parâmetro * for passado, o comando retorna a rota da pasta host database,
- Se o parâmetro * não for passado, o comando retorna a rota da pasta componente.
A pasta database (Database folder e Database folder UNIX syntax) retornada difere de acordo com o tipo de arquitetura componente:- no caso de uma pasta/pacote .4dbase, o comando retorna a rota da pasta/pacote .4dbase,
- no caso de um arquivo.4db ou .4dc , o comando retorna a rota da pasta “Components”,
- no caso de um alias ou atalho, o comando retorna a rota da pasta contendo a matriz original da database. O resultado difere de acordo com o formato do banco de dados (pasta/pacote .4dbase ou arquivo .4db/.4dc ), como descrito acima.
Quando o comando for chamado da database host, sempre retorna a rota da pasta database host, independente de se o parâmetro * foi ou não passado.
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