Tabela Directory
A tabela Directory especifica o layout do diretório para o produto. Cada linha da tabela indica um diretório na origem e no destino.
A tabela Binary tem as colunas a seguir.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Diretório | Identificador | S | N |
| Directory_Parent | Identificador | N | S |
| DefaultDir | DefaultDir | N | N |
Colunas
-
Directory
-
A coluna Directory contém um identificador exclusivo para um diretório ou caminho de diretório. Essa coluna pode conter o nome de uma propriedade definida como o caminho completo de um diretório de destino. Se essa coluna contiver uma propriedade, o diretório de destino usará o nome especificado na coluna DefaultDir e usará o diretório pai especificado na coluna Directory_Parent.
O diretório de origem sempre usa o nome especificado na coluna DefaultDir e usa o diretório pai especificado na coluna Directory_Parent.
Se a coluna Directory_Parent for nula ou igual ao valor da coluna Directory, esta representará um diretório de destino raiz. Somente um diretório raiz pode ser especificado na tabela Directory.
-
Directory_Parent
-
Essa coluna é uma referência ao diretório pai do diretório. Um registro que tem uma coluna Directory_Parent igual a nulo ou igual à coluna Directory representa um diretório raiz. O caminho completo do diretório pai é resolvido por referência na coluna Directory_Parent é uma chave externa na coluna Directory. Por exemplo, se uma pasta tiver um diretório pai chamado PDIR, o diretório pai do PDIR será fornecido na coluna Directory_Parent da linha com PDIR na coluna Directory.
-
DefaultDir
-
A coluna DefaultDir contém o nome do diretório (localizável) no diretório pai. Por padrão, esse é o nome dos diretórios de destino e de origem. Para especificar diferentes nomes de diretório de origem e de destino, separe os nomes de destino e de origem com dois-pontos da seguinte maneira: [nomedodestino]:[nomedaorigem].
Se o valor da coluna Directory_Parent for nulo ou for igual à coluna Directory, a coluna DefaultDir especificará o nome de um diretório de origem raiz.
Para um diretório de origem não raiz, um ponto (.) inserido na coluna DefaultDir para o nome do diretório de origem ou o nome do diretório de destino indica que o diretório deve estar localizado em seu diretório pai sem um subdiretório.
Os nomes de diretório nessa coluna podem ser formatados como pares de nome de arquivo curto | nome de arquivo longo.
Comentários
Cada registro na tabela representa um diretório nas imagens de origem e de destino. A tabela Directory precisa especificar um único diretório raiz com um valor de coluna Directory igual à propriedade TARGETDIR.
Para uma instalação administrativa, instale a imagem administrativa no diretório raiz chamado TARGETDIR e use os nomes do diretório de origem para resolver os diretórios de destino.
Observe que o instalador define várias propriedades padrão para os caminhos de pasta do sistema. Confira a Referência de Propriedade para obter uma lista das propriedades definidas como pastas do sistema.
A resolução de diretório é executada durante a ação CostFinalize e é feita da seguinte maneira:
Diretório de Destino Raiz
Pode haver apenas um único diretório de destino raiz. Para especificar o diretório de destino raiz, defina a coluna Directory como a propriedade TARGETDIR e a coluna DefaultDir como a propriedade SourceDir. Se a propriedade TARGETDIR for definida, o diretório de destino será resolvido para o valor da propriedade. Se a propriedade TARGETDIR for indefinida, a propriedade ROOTDRIVE será usada para resolver o caminho.
Diretório de Origem Raiz
O valor da coluna DefaultDir para a entrada do diretório raiz precisa ser definido como a propriedade SourceDir.
Diretórios de destino não raiz
O valor Directory de um diretório não raiz também é interpretado como o nome de uma propriedade que define o local do destino. Se a propriedade for definida, o diretório de destino será resolvido para o valor da propriedade. Se a propriedade não estiver definida, o diretório de destino será resolvido para um subdiretório abaixo do diretório de destino resolvido para a entrada Directory_Parent. O valor DefaultDir define o nome do subdiretório.
Diretórios de origem não raiz
O diretório de origem de um diretório não raiz é resolvido para um subdiretório do diretório de origem resolvido para a entrada Directory_Parent. Novamente, o valor DefaultDir define o nome do subdiretório.
Nomes de arquivos curtos ou longos
Ao resolver diretórios de destino, os nomes de arquivo curtos especificados na coluna DefaultDir serão usados se a propriedade SHORTFILENAMES estiver definida ou o volume no qual o diretório está localizado não der suporte a nomes de arquivo longos. Caso contrário, o nome de arquivo longo será usado.
Observe que quando os diretórios são resolvidos durante a ação CostFinalize, as chaves na tabela Diretório se tornam propriedades definidas como caminhos de diretório.
Para criar pastas vazias durante uma instalação, confira Tabela CreateFolder.
Para obter mais informações sobre a tabela Directory, incluindo exemplos, confira Usando a tabela Directory.
Validação