Tabela de diretório
A tabela Diretório especifica o layout do diretório para o produto. Cada linha da tabela indica um diretório na origem e no destino.
A tabela Diretório tem as colunas a seguir.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Diretório | identificador de | Y | N |
| Directory_Parent | identificador de | N | Y |
| DefaultDir | DefaultDir | N | N |
Colunas
-
Diretório
-
A coluna Diretório contém um identificador exclusivo para um diretório ou caminho de diretório. Esta coluna pode conter o nome de uma propriedade definida como o caminho completo de um diretório de destino. Se esta 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 Diretório, a coluna Diretório representará um diretório de destino raiz. Apenas um diretório raiz pode ser especificado na tabela Diretório.
-
Directory_Parent
-
Esta 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 Diretório 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 Diretório. Por exemplo, se uma pasta tiver um diretório pai chamado PDIR, o diretório pai do PDIR será dado na coluna Directory_Parent da linha com PDIR na coluna Diretório.
-
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: [nome de destino]:[nome-fonte].
Se o valor da coluna Directory_Parent for nulo ou for igual à coluna Diretório, a coluna DefaultDir especifica o nome de um diretório de origem raiz.
Para um diretório de origem não raiz, um período (.) 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 nesta coluna podem ser formatados como nome de arquivo curto | pares de nome de arquivo longos.
Observações
Cada registro na tabela representa um diretório nas imagens de origem e de destino. A tabela Diretório deve especificar um único diretório raiz com um valor de coluna de diretório 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 uma série de propriedades de padrão para caminhos de pasta do sistema. Consulte o de Referência da 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 Diretório como a propriedade TARGETDIR e a coluna DefaultDir para 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 propriedadeROOTDRIVE será usada para resolver o caminho.
Diretório de origem raiz
O valor da coluna DefaultDir para a entrada do diretório raiz deve ser definido como a propriedade SourceDir.
Diretórios de destino não raiz
O valor do Diretório para 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 arquivo curtos ou longos
Ao resolver diretórios de destino, os nomes de arquivo curtos especificados na coluna DefaultDir são usados se a propriedade SHORTFILENAMES estiver definida ou se o volume no qual o diretório estiver localizado não oferecer suporte a nomes de arquivo longos. Caso contrário, o nome do 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, consulte CreateFolder Table.
Para obter mais informações sobre a tabela Diretório, incluindo exemplos, consulte Usando a tabela de diretório.
Validação