Tabla Directory
La tabla Directory especifica el diseño de directorio para el producto. Cada fila de la tabla indica un directorio tanto en el origen como en el destino.
La tabla Directory tiene estas columnas.
| Columna | Tipo | Clave | Nullable |
|---|---|---|---|
| Directorio | Identificador | Y | No |
| Directory_Parent | Identificador | No | Y |
| DefaultDir | DefaultDir | No | No |
Columnas
-
Directory
-
La columna Directory contiene un identificador único de una ruta de acceso de directorio o directorio. Esta columna puede contener el nombre de una propiedad que se establece en la ruta de acceso completa de un directorio de destino. Si esta columna contiene una propiedad, el directorio de destino toma el nombre especificado en la columna DefaultDir y toma el directorio principal especificado en la columna Directory_Parent.
El directorio de origen siempre toma el nombre especificado en la columna DefaultDir y toma el directorio principal especificado en la columna Directory_Parent.
Si la columna Directory_Parent es null o igual que el valor de la columna Directory, esta columna representa un directorio de destino raíz. Solo se puede especificar un directorio raíz en la tabla Directory.
-
Directory_Parent
-
Esta columna es una referencia al directorio principal del directorio. Un registro que tiene una columna Directory_Parent igual a null o igual a la columna Directory representa un directorio raíz. La ruta de acceso completa del directorio principal que se resuelve por referencia en la columna Directory_Parent es una clave externa en la columna Directory. Por ejemplo, si una carpeta tiene un directorio principal llamado PDIR, el directorio principal de PDIR se proporciona en la columna Directory_Parent de la fila con PDIR en la columna Directory.
-
DefaultDir
-
La columna DefaultDir contiene el nombre del directorio (localizable) bajo el directorio principal. De forma predeterminada, este es el nombre de los directorios de origen y destino. Para especificar distintos nombres de directorio de origen y destino, sepárelos con dos puntos como se indica a continuación: [targetname]:[sourcename].
Si el valor de la columna Directory_Parent es null o es igual al de la columna Directory, la columna DefaultDir especifica el nombre de un directorio de origen raíz.
En el caso de un directorio de origen no raíz, un punto (.) escrito en la columna DefaultDir para el nombre del directorio de origen o el nombre del directorio de destino indica que el directorio debe encontrarse en su directorio principal sin un subdirectorio.
Los nombres de directorio de esta columna pueden tener el formato de nombre de archivo corto | pares largos de nombre de archivo.
Observaciones
Cada registro de la tabla representa un directorio en las imágenes de origen y destino. La tabla Directory debe especificar un único directorio raíz con un valor de columna Directory igual a la propiedad TARGETDIR.
Para una instalación administrativa, instale la imagen administrativa en el directorio raíz denominado TARGETDIR y use los nombres de directorio de origen para resolver los directorios de destino.
Tenga en cuenta que el instalador establece una serie de propiedades estándar en rutas de acceso de carpeta del sistema. Consulte la referencia sobre propiedades para obtener una lista de las propiedades que se establecen en las carpetas del sistema.
La resolución de directorios se realiza durante la acción CostFinalize y se hace de la siguiente manera:
Directorio de destino raíz
Solo puede haber un único directorio de destino raíz. Para especificar el directorio de destino raíz, establezca la columna Directory en la propiedad TARGETDIR y la columna DefaultDir en la propiedad SourceDir. Si se define la propiedad TARGETDIR, el directorio de destino se resuelve en el valor de la propiedad. Si la propiedad TARGETDIR no está definida, se usa la propiedad ROOTDRIVE para resolver la ruta de acceso.
Directorio de origen raíz
El valor de la columna DefaultDir para la entrada del directorio raíz debe establecerse en la propiedad SourceDir.
Directorios de destino no raíz
El valor de directorio de un directorio no raíz también se interpreta como el nombre de una propiedad que define la ubicación del destino. Si se define la propiedad, el directorio de destino se resuelve en el valor de la propiedad. Si la propiedad no está definida, el directorio de destino se resuelve en un subdirectorio bajo el directorio de destino resuelto para la entrada Directory_Parent. El valor DefaultDir define el nombre del subdirectorio.
Directorios de origen no raíz
El directorio de origen de un directorio no raíz se resuelve en un subdirectorio del directorio de origen resuelto para la entrada Directory_Parent. De nuevo, el valor DefaultDir define el nombre del subdirectorio.
Nombres de archivo cortos o largos
Al resolver directorios de destino, los nombres de archivo cortos especificados en la columna DefaultDir se usan si la propiedad SHORTFILENAMES se ha establecido o el volumen en el que se encuentra el directorio no admite nombres de archivo largos. De lo contrario, se usa el nombre de archivo largo.
Tenga en cuenta que, cuando los directorios se resuelven durante la acción CostFinalize, las claves de la tabla Directory se convierten en propiedades establecidas en rutas de acceso de directorio.
Para crear carpetas vacías durante una instalación, consulte Tabla CreateFolder.
Para más información sobre la tabla Directory, incluidos ejemplos, consulte Uso de la tabla Directory.
Validación