Structure file

4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


Structure file {(*)} Alfa

ParámetroTipoDescripción
**Devuelve el archivo de estructura de la base local
ResultadoAlfaNombre largo del archivo de estructura de la base

Descripción

El comando Structure file devuelve el nombre largo del archivo de estructura de la base en la cual está trabajando actualmente.

En Windows

Si, por ejemplo, está trabajando con la base MisCDs ubicada en \DOCS\MisCDs en el disco G, el comando devuelve G:\DOCS\MisCDs\MisCDs.4DB.

En Macintosh

Si, por ejemplo, está trabajando, con la base ubicada en la carpeta Documentos:MisCDsƒ: en el disco Macintosh HD, el comando devuelve Macintosh HD:Documentos:MisCDsƒ:MisCDs.

Nota: En el caso particular de una base compilada y fusionada con 4D Desktop, este comando devuelve la ruta de acceso al archivo de la aplicación (archivo ejecutable) bajo Windows y Mac OS. Bajo Mac OS, este archivo está ubicado dentro del paquete del programa, en la carpeta [Contents:Mac OS]. Este funcionamiento viene de un antiguo mecanismo y se conserva por razones de compatibilidad. Si quiere obtener el nombre completo del paquete del programa, es preferible utilizar el comando Application file. La técnica consiste en probar la aplicación utilizando el comando Application type, luego se ejecuta Structure file o Application file dependiendo del contexto.

Advertencia: si llama este comando mientras utiliza 4D Client, sólo devuelve el nombre del archivo de estructura; no el nombre largo.

El parámetro opcional * es útil en el caso de una arquitectura que utilice componentes: permite determinar la estructura (local o componente) para la cual usted quiere obtener el nombre largo en función del contexto en el cual se llama el comando:

Cuando se llama el comando desde un componente:

- Si se pasa el parámetro *, el comando devuelve el nombre largo del archivo de estructura de la base local,

- Si no se pasa el parámetro *, el comando devuelve el nombre largo del archivo de estructura del componente.

El archivo de estructura del componente corresponde al archivo .4db o .4dc del componente que se encuentra en la carpeta "Components" de la base. Sin embargo, un componente también puede instalarse como un alias/atajo o un carpeta/paquete .4dbase:

- En el caso de un componente instalado en forma de alias/atajo, el comando devuelve la ruta de acceso del archivo .4db o .4dc original (el alias o atajo es resuelto).

- En el caso de un componente instalado como una carpeta/paquete .4dbase, el comando devuelve la ruta de acceso del archivo .4db o .4dc al interior de esta carpeta/paquete.

Cuando el comando se llama desde un método de la base local, siempre devuelve el nombre largo del archivo de estructura de la base local, sin importar si se pasa o no el parámetro *.

Ejemplos

1. Este ejemplo muestra el nombre y la ubicación del archivo de estructura que está utilizando:

   If (Application type#4D Client)
      $vsNombreArchivoEstructura:=Long name to file name (Structure file)
      $vsNombreRutaEstructura:=Long name to path name (Structure file)
      ALERT("Está utilizando actualmente la base "+Char(34)+$vsNombreArchivoEstructura+Char(34)+
                                 " ubicado en "+Char(34)+$vsNombreRutaEstructura+Char(34)+".")
   Else
      ALERT("Está conectado a la base "+Char(34)+Structure file+Char(34))
   End if
      

Nota: Los métodos de proyecto Long name to file name y Long name to path name se describen en detalle en la sección Documentos del sistema.


2. El siguiente ejemplo puede utilizarse para saber si el método se llama desde un componente:

   C_BOOLEAN($0)
   $0:=(Structure file#Structure file(*))
      ` $0=True si el método es llamado desde un componente

Ver también

Application file, COMPONENT LIST, Data file, DATA SEGMENT LIST.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente