Get 4D folder

4D v16.3

Get 4D folder


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

Parámetro	Tipo	Descripción
carpeta	Entero largo	Tipo de carpeta (si se omite = carpeta activa 4D)
*	Operador	Devuelve la carpeta de la base local
Resultado	Cadena	Ruta de acceso a la carpeta designada

Descripción

El comando Get 4D folder devuelve la ruta de acceso a la carpeta 4D activa de la aplicación actual o de la carpeta del entorno 4D especificada por el parámetro carpeta, si se pasa. Este comando le permite obtener la ruta de acceso actual a las carpetas utilizadas por la aplicación 4D. Utilizando este comando, asegura que su código funcionará correctamente en todas las plataformas que se ejecuten en un sistema localizado.

En carpeta, puede pasar una de las siguientes constantes, ubicadas en el tema "Entorno 4D":

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

Abajo encontrará una descripción de cada carpeta:

Notas preliminares sobre los nombres de las carpetas:

{Disk} es el disco donde está instalado el sistema.
La palabra Usuario representa el nombre del usuario que abrió la sesión.

Carpeta 4D activa

Las aplicaciones del entorno 4D utilizan una carpeta especifica para almacenar la siguiente información:

Archivos de preferencias utilizados por las aplicaciones 4D
Archivo Shortcuts.xml (atajos de teclado personalizados)
Carpeta Macros v2 (macro comandos del editor de métodos)
Carpeta Favorites v1x, por ejemplo Favorites v13 (rutas de acceso de las bases locales y remotas que se hayan abierto)

Con las aplicaciones 4D principales (4D y 4D Server), la carpeta 4D activa se llama 4D y se encuentra por defecto en la siguiente ubicación:

En Windows 7 y siguientes: {Disco}:\Users\<nomUsuario>\AppData\Roaming\<nombreBase>D
Bajo Mac OS: {Disco}:Usuarios:<nomUsuario>:Library:Application Support:<nombreBase

Carpeta Licencias

Carpeta que contiene los archivos de licencia del equipo.

La carpeta Licenses se encuentra en la siguiente ubicación:

En Windows 7 y superiores: {Disco}:\Datos de programa\4D\Licences\
En OS X: {Disco}:Library:Application Support:4D:Licenses

Notas:

En el caso de una aplicación fusionada con 4D Volume Desktop, la carpeta de licencias está incluída en el paquete de la aplicación.
Si la carpeta de licencias no puede crearse en el sistema por falta de autorización, se crea en la siguiente ubicación:
- En Windows 7 y superiores: {Disco}:\Usuarios\<userName>\AppData\Roaming\4D\Licenses
- En OS X: {Disco}:Usuarios:<userName>:Library:Application Support:4D:Licenses

Carpeta de datos

Ruta de la carpeta que contiene el archivo de datos actual. La ruta de acceso se expresa utilizando la sintaxis estándar de la plataforma actual.

Carpeta base 4D Client (máquinas clientes)

Carpeta de la base 4D creada en local en cada equipo 4D Client para guardar archivos y carpetas relacionadas con la base (recursos, plug-ins, carpeta Extras, etc.).

La carpeta 4D Client Database está en la siguiente ubicación en cada equipo cliente:

En Windows 7 y superiores: {Disco}:\Usuarios\<nombreUsuario>\AppData\Local\4D\<NombreDeLaBase_Direccion>
En OS X: {Disco}:Usuarios:<nombreUsuario>:Library:Caches:4D:<NombreDeLaBase_Direccion>

Carpeta base (Database Folder)

Carpeta que contiene el archivo de estructura de la base. La ruta de acceso se expresa utilizando la sintaxis estándar de la plataforma actual.

Con la aplicación 4D Client, esta constante es estrictamente equivalente a la constante anterior 4D Client Database Folder: el comando devuelve la ruta de acceso de la carpeta creada localmente.

Carpeta base sintaxis Unix (Database Folder Unix Syntax)

Carpeta que contiene el archivo de estructura de la base. Esta constante designa la misma carpeta que la anterior pero la ruta de acceso que devuelve se expresa utilizando sintaxis Unix (Posix), de tipo/Usuarios/... Esta sintaxis se usa principalmente cuando utiliza el comando LAUNCH EXTERNAL PROCESS bajo OS X.

Carpeta de Resources

Carpeta Resources de la base. Esta carpeta contiene los elementos adicionales (imágenes, textos) utilizados por la interfaz de la base. Un componente puede tener su propia carpeta Resources. La carpeta Resources está ubicada junto al archivo de estructura de la base.

En modo cliente/servidor, esta carpeta permite organizar la transferencia de datos personalizados (imágenes, archivos, subcarpetas...) entre el equipo servidor y los equipos clientes. El contenido de esta carpeta se actualiza automáticamente cada vez que un equipo cliente se conecta. Todos los mecanismos de referenciación asociados a la carpeta Resources son soportados en modo cliente/servidor (carpeta .lproj, XLIFF, imágenes...). Adicionalmente, 4D ofrece varias herramientas que pueden utilizarse para administrar y actualizar esta carpeta dinámicamente, particularmente un explorador de recursos.

Nota: si la carpeta Resources no existe para la base, se creará ejecutando el comando Get 4D folder con la constante Current Resources folder.

Carpeta Logs

La carpeta Logs de la base. Esta carpeta centraliza los archivos log de la base actual. Se crea al mismo nivel del archivo de estructura y contiene los siguientes archivos log:

conversión de la base,
peticiones al servidor web,
verificación y reparación de los datos
verificación y reparación de la estructura
diario de actividades backup/restaurar
depuración de los comandos
peticiones 4D server (generadas en equipos cliente y en el servidor).

Nota: si la carpeta Logs no existe para la base, ejecutando el comando Get 4D folder con la constante Logs Folder.

Carpeta raíz HTML

Carpeta raíz HTML actual de la base. La ruta de acceso devuelta se expresa con la sintaxis estándar de la plataforma actual. La carpeta raíz HTML es la carpeta en la cual el servidor web de 4D busca las páginas y archivos web solicitados. Por defecto, se llama WebFolder y se encuentra junto al archivo de estructura. Su ubicación puede definirse en la página Web/Configuración de las Preferencias o dinámicamente vía el comando WEB SET ROOT FOLDER.
Si el comando Get 4D folder se llama desde un 4D remoto, la ruta devuelta es la del equipo remoto, no la de 4D Server.

El parámetro opcional * es útil en el caso de una arquitectura que utiliza componentes: permite determinar la base (local o componente) para la cual quiere obtener la ruta de acceso a la carpeta. Este parámetro sólo es válido para las carpetas Database Folder, Database Folder Unix Syntax y Current Resources folder. Se ignora en todos los demás casos.
Cuando el comando se llama desde un componente:

Si pasa el parámetro *, el comando devuelve la ruta de acceso de la carpeta de la base local,
Si no pasa el parámetro *, el comando devuelve la ruta de acceso de la carpeta Componentes.
La carpeta de la base (Database Folder y Database Folder Unix Syntax) devuelta difiere en función del tipo de arquitectura del componente:
- En el caso de una carpeta/paquete .4dbase, el comando devuelve la ruta de acceso de la carpeta/paquete .4dbase,
- En el caso de un archivo .4db ó .4dc, el comando devuelve la ruta de acceso de la carpeta "Componentes",
- En el caso de un alias o atajo, el comando devuelve la ruta de acceso de la carpeta que contiene la base matriz original. El resultado difiere de acuerdo al formato de esta base (carpeta/paquete .4dbase o archivo .4db/.4dc), como se describió anteriormente.

Cuando el comando se llama desde la base local, devuelve la ruta de acceso de la carpeta de la base local, sin importar si se pasa o no el parámetro *.

Ejemplo 1

Durante el inicio de una base monousuario, usted quiere cargar (o crear) sus propios parámetros y almacenarlos en un archivo ubicado en la carpeta 4D. Para hacer esto, en el método de base On Startup Database Method, puede escribir las siguientes líneas:

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

  ` Asocia el tipo de archivo PREF en Mac OS a la extensión de archivo .PRF en Windows

 $vsPrefNombreDoc:=Get 4D folder+"MisPrefs" ` Construir la ruta de acceso al archivo Preferencias

  ` Verificar si el archivo existe

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

    $vtPrefDocRef:=Create document($vsPrefNombreDoc;"PREF") ` Si no, crearlo

 Else

    $vtPrefDocRef:=Open document($vsPrefNombreDoc;"PREF") ` Si sí, abrirlo

 End if

 If(OK=1)

  ` Procesar el contenido del documento

    CLOSE DOCUMENT($vtPrefDocRef)

 Else

  ` Manejar el error

 End if

Ejemplo 2

Este ejemplo ilustra el uso de la constante Database Folder Unix Syntax bajo Mac OS para listar el contenido de la carpeta de la base:

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

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

 $in:=""

 $out:=""

 $err:=""

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

Nota: bajo Mac OS, es necesario colocar las rutas de acceso entre comillas cuando contienen los nombres de archivos o de carpetas con espacios. La secuencia de escape "\" permite insertar el carácter comillas en la cadena. También puede utilizar la instrucción Char(Double quote).

Variables y conjuntos del sistema

Si el parámetro carpeta no es válido o si la ruta de acceso devuelta está vacía, la varible sistema OK toma el valor 0.

Ver también

COMPONENT LIST
Get 4D file
System folder
Temporary folder
Test path name
WEB SET ROOT FOLDER