Next Topic

Previous Topic

Book Contents

Configuração

O elemento <Configuração/> descreve uma configuração que é migrada por este pacote.

Mapeamento

Todas as sequência são mapeadas da origem para o destino. Se o diretório Arquivos de programas muda entre máquina, o mecanismo observa e corrige os caminhos que apontam para o mesmo. De forma similar, se a pasta Documento do usuário é movida, os caminhos são atualizados antes de serem aplicados.

Abreviaturas de caminho do registro

Muitas configurações são armazenadas no registro e referenciadas por seu caminho de registro. s seguintes abreviaturas são reconhecidas pelo mecanismo e torna mais fácil a leitura do pacote de configurações. Todos os exemplos as utilizam .

Abreviatura

Referências

HKCU

HKEY_CURRENT_USER

HKLM

HKEY_LOCAL_MACHINE

HKCR

HKEY_CLASSES_ROOT

HKU

HKEY_USERS

HKCC

HKEY_CURRENT_CONFIG

HKDD

HKEY_DYN_DATA

HKPD

HKEY_PERFORMANCE_DATA

Configurações dentro de configurações

Pode ser útil agrupas configurações para que o pacote de configurações seja mais fácil de ser lido.

        <Nome da configuração="Security">
            <Nome da configuração="EnablePGP">
                <Tipo de localização="registry" SubType="value">
                    HCKU\Software\Crunch\EnablePGP
                </Localização>
            </Configuração>
            <Nome da configuração="RequirePassword">
                <Tipo de localização="registry" SubType="value">
                    HCKU\Software\Crunch\PasswordRequired
                </Localização>
            </Configuração>
        </Configuração>

Observe que isto é a apenas um grupo lógico dentro do pacote de configurações. Ele não tem de corresponder com como estas configurações são armazenadas. Qualquer número de configurações podem ser agrupadas em qualquer profundidade.

O nomes destas configurações são também um pouco diferentes. A configurações aninhadas têm nomes qualificados que são os nomes qualificados de seu principal, um barra adiante, e seu próprio nome. Estas iriam cria estes nomes qualificados de configurações Security/EnablePGP e Security/RequirePassword.

Migrando uma chave de árvore com registry/subkey

Na maioria das vezes, você apenas deseja mover toda a chave de registro, todos os seus valores, e todas suas subchaves e todos seus valores. Isso pode ser feito com Tipo="registry" Subtipo="subkey".

        <Nome da configuração="CrunchSettings">
            <Tipo de localização="registry" SubType="subkey">
                HKCU\Software\Crunch
            </Localização>
        </Configuração>

Todas as sequências são automaticamente mapeadas, e todos os tipos de dados são automaticamente determinados. Em determinados casos, se o registro contém caminhos para arquivos que você deseja migrar, estes precisam ser tratados separadamente usando filepath. Tente primeiro o método registry/subkey. Use outros Subtipos de registro somente se for necessário.

Migrando um valor de registro com registry/value

Um valore de registro pode ser migrado ao fornecer seu caminho:

        <Nome da localização="ReticulateSplines">
            <Tipo de localização="registry" SubType="value">
                HKCU\Software\Crunch\ReticulateSplines
            </Localização>
        </Configuração>

Migrando se um valor de registro existe ou não com registry/valueexistence

Algumas vezes um aplicativo não armazena nenhuma informação em um valor de registro, mas verifica a sua existência. Isso pode ser migrado como segue:

        <Nome da configuração="IsRegistered">
            <Location Type="registry" SubType="valueexistence">
                HKCU\Software\Crunch\Registered
            </Localização>
        </Configuração>

Migrando um arquivo com file

Migrando um arquivo com uma posição fixa é simples:

        <Nome da configuração="DataFile">
            <Tipo de localização="file" File="C:\Path\To\File.dat" />
        </Configuração>

Sempre que possível, use variáveis:

        <Nome da configuração="DataFile">
            <Tipo de localização="file" File="%ProgramFiles%\Crunch\File.dat" />
        </Configuração>

Migrando um arquivo cujo caminho está no registro com filepath

Quando uma configuração é de fato um caminho para um arquivo, você com frequência deseja armazenar não somente o caminho, mas também o arquivo. Neste caso, adicione o atributo Tipo="filepath" em <Configuração/>, e o mecanismo irá mover o arquivo por você, O valor do registro é mapeado e migrado, e o arquivo é migrado e aplicado na localização mapeada apropriada.

        <Nome da configuração="DataFile" Tipo="filepath">
            <Tipo de localização="registry" SubType="value">
                HKCU\Software\Crunch\DataFilePath
            </Localização>
        </Configuração>

Atributos

Descrição

Valores possíveis

Necessário?

Nome

O nome da configuração. Para configurações aninhadas, o nome qualificado é o nome qualificado do principal, uma barra adiante, e a seguir seu valor de atributo.

Texto usando somente os caracteres a-z, A-Z, 0-9, ponto, hífen e sublinhado. Espaços não são permitidos.

Sim

Tipo

Esta configuração deveria ser tratada de forma diferente do que uma sequência reta? Se o valor tem um significado adicional, o Tipo pode identificar aquele significado.

filepath ou nada.

Não

VersãoSO

Somente migre isso no SOs especificados. Para múltiplos OSs, separe-os com |: por exemplo, Windows95|Windows2000. Observe que alguns dos valores que possam fazer isso por vocêos que começam por Qualquer.

Windows2000 ou WindowsXP ou WindowsVista. QualquerWindows irá coincidir com qualquer um destes.

Não

Secundário

Mínimo

Máxima

<Localização/>

0

Qualquer

<Padrão/>

0

1

<Configuração/>

0

Qualquer

<SettingsList/>

0

Qualquer