Tópico anterior: Diretrizes sobre scripts para migrar somente configuraçõesPróximo tópico: Visão geral sobre linguagem de script


Definições

As definições padrão a seguir são usadas em scripts do CA DMM:

Origem

Origem refere-se ao antigo sistema, caso o usuário seja da rede, ou ao arquivo de armazenamento de um sistema independente.

Destino

Destino refere-se ao novo computador.

Comentários

Você pode usar comentários no estilo C em qualquer lugar de um script. Todo e qualquer texto após um comentário na mesma linha é considerado parte do comentário. Você pode incluir um comentário na mesma linha que uma instrução depois do ponto-e-vírgula. Os comentários não podem ser aninhados. Também é possível usar duas barras invertidas (//) nos comentários.

Exemplos:

/*Files under SYSTEMPATH*/
StoreFile( SYSTEMPATH + "\\Olepro32.dll" );     /*Store the Olepro32.dll file*/
//This whole line is commented out
Variáveis

Variáveis são palavras reservadas definidas em script que são declaradas na primeira vez em que um valor é atribuído a elas. Elas podem ser qualquer combinação de letras, números e sublinhados. Entretanto, o primeiro caractere deve ser uma letra. As variáveis não podem usar nomes de palavras-chave nem constantes.

Constantes

As constantes são variáveis predefinidas ou definidas dinamicamente, fornecidas pelo intérprete de script. Seu valor depende do estado do intérprete e sua plataforma. As constantes não podem ser modificadas pelo script e mantêm o mesmo valor até o final da sessão.

As exceções são APPLICATIONPATH, iniciada com a palavra-chave Detect, e LANGUAGE, iniciada com o idioma do sistema operacional.

Constantes predefinidas

As constantes predefinidas são as seguintes:

WINDOWSPATH

O caminho do diretório Windows no computador de origem.

SYSTEMPATH

O caminho do sistema Windows no computador de origem.

APPLICATIONPATH

O caminho do diretório de aplicativos no computador de origem.

NEW_WINDOWSPATH

O caminho do diretório Windows no computador de destino.

NEW_SYSTEMPATH

O caminho do diretório System no computador de destino.

NEW_APPLICATIONPATH

O caminho do diretório do aplicativo no computador de destino.

WIN2000

Representa a plataforma Windows 2000.

WINXP

Representa a plataforma Windows XP de 32 bits.

WINXP64

Representa a plataforma Windows XP de 64 bits.

WINVI

Representa a plataforma Windows Vista de 32 bits.

WINVI64

Representa a plataforma Windows Vista de 64 bits.

WIN7

Representa a plataforma Windows 7 de 32 bits.

WIN764

Representa a plataforma Windows 7 de 64 bits.

WIN8

Representa a plataforma Windows 8 de 32 bits.

WIN864

Representa a plataforma Windows 8 de 64 bits.

ALWAYS

Sempre sobrescrever arquivos.

NEVER

Nunca sobrescrever arquivos.

NEWER

Sobrescrever arquivos somente se o arquivo substituto for mais recente do que o atual.

GENERAL

Um nível de impressão que indica que uma instrução de impressão sempre será impressa.

MODERATE

Um nível de impressão que indica que uma instrução de impressão será impressa em um log definido com o nível moderado.

DETAILED

Um nível de impressão que indica que uma instrução de impressão será impressa em um log definido com o nível detalhado.

VERY_DETAILED

Um nível de impressão que indica que uma instrução de impressão será impressa em um log definido com o nível muito detalhado.

LANGUAGE

Retorna o identificador de idioma do sistema operacional.

Exemplo:

   if (LANGUAGE == "enu")
	DoSomething();
Registro - Constantes relacionadas

As constantes a seguir estão definidas no registro, em HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders. É possível especificar estas constantes em vez de recuperar o valor no Registro.

APPDATAPATH

O caminho dos dados de aplicativos do usuário no computador de origem, como C:\Documents and Settings\Default User\Dados de aplicativos.

DESKTOPPATH

O caminho da pasta Desktop do usuário no computador de origem, como C:\Documents and Settings\Default User\Desktop.

FAVORITESPATH

O caminho da pasta Favoritos do usuário no computador de origem, como C:\Documents and Settings\Default User\Favoritos.

LOCALAPPDATAPATH

O caminho de Dados de aplicativos do usuário no computador de origem, como C:\Documents and Settings\Default User\Configurações locais\Dados de aplicativos.

PERSONALPATH

O caminho de Meus documentos do usuário no computador de origem, como C:\Documents and Settings\Default User\Meus documentos.

PROGRAMSPATH

O caminho da pasta Arquivos de programas do usuário no computador de origem, como C:\Arquivos de programas.

STARTMENUPATH

O caminho da pasta Menu Iniciar do usuário no computador de origem, como C:\Documents and Settings\Default User\Menu Iniciar.

STARTUPPATH

O caminho da pasta Inicializar do usuário no computador de origem, como C:\Documents and Settings\Default User\Menu Iniciar\Programas\Inicializar.

TEMPLATESPATH

O caminho da pasta Modelos do usuário no computador de origem, como C:\Documents and Settings\Default User\Modelos.

NEW_APPDATAPATH

O caminho dos Dados de aplicativos do usuário no computador de Destino, como C:\Documents and Settings\Default User\Dados de aplicativos.

NEW_DESKTOPPATH

O caminho da pasta Desktop do usuário no computador de destino, como C:\Documents and Settings\Default User\Desktop.

NEW_FAVORITESPATH

O caminho da pasta Favoritos do usuário no computador de destino, como C:\Documents and Settings\Default User\Favoritos.

NEW_LOCALAPPDATAPATH

O caminho de Dados de aplicativos do usuário no computador de destino, como C:\Documents and Settings\Default User\Configurações locais\Dados de aplicativos.

NEW_PERSONALPATH

O caminho da pasta Meus documentos do usuário no computador de Destino, como C:\Documents and Settings\Default User\Meus documentos.

NEW_PROGRAMSPATH

O caminho da pasta Arquivos de programas do usuário no computador de destino, como C:\Arquivos de programas.

NEW_STARTMENUPATH

O caminho da pasta Menu Iniciar do usuário no computador de destino, como C:\Documents and Settings\Default User\Menu Iniciar.

NEW_STARTUPPATH

O caminho da pasta Inicializar do usuário no computador de destino, como C:\Documents and Settings\Default User\Menu Iniciar\Programas\Inicializar.

NEW_TEMPLATESPATH

O caminho da pasta Modelos do usuário no computador de destino, como C:\Documents and Settings\Default User\Modelos.

Constantes relacionadas de valor booleano

As seguintes constantes são usadas com estes comandos para substituir o parâmetro Boolean:

As constantes são as seguintes:

SOURCE

Uma constante Boolean que retorna true ou false, dependendo de o CA DMM estar aplicando ou armazenando.

DESTINATION

Uma constante Boolean que sempre retorna False.

Exemplo:

function MyStoreFunction()
{
	var strSourceDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", SOURCE);
	
	// do something.
}

function MyApplyFunction()
{
	var strSourceDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", SOURCE);
	var strDestinationDesktop = RetrieveValue("HKCU\\Shell Folders", "Desktop", DESTINATION);

	// do something.
}
Níveis de impressão

Estes comandos são usados para o segundo parâmetro opcional nos seguintes comandos: Print, PrintException. O nível de importância é mais rigoroso para GENERAL e menos rigoroso para VERY_DETAILED. Se os níveis de impressão não estiverem especificados, o padrão do parâmetro será GENERAL.

Os seguintes níveis de impressão são suportados:

Uso:

Print(PrintException) <expressão da seqüência de caracteres>, [nível de impressão];

Exemplos:

print ("this is important", GENERAL);
PrintException ("this isn’t as important", DETAILED);
Booleano

Um valor, ou resultado, que pode ser verdadeiro ou falso.