Tema anterior: Directrices para la redacción de script destinados a migrar sólo valoresTema siguiente: Descripción general del lenguaje de scripts


Definitions

A continuación se indican las definiciones estándar que se utilizan en CA DMM:

Origen

Hace referencia al sistema anterior si el usuario está conectado a una red o al archivo de almacenamiento en el caso de un sistema autónomo.

Destino

El destino es el equipo nuevo.

Comentarios

Cabe la posibilidad de usar comentarios de tipo C en cualquier parte del script. El texto que siga a un comentario en la misma línea se considera parte del comentario. Los comentarios pueden compartir la línea de las sentencias detrás del punto y coma. Los comentarios no se pueden anidar. También se pueden incluir comentarios tras dos barras inclinadas (//).

Ejemplos:

/*Files under SYSTEMPATH*/
StoreFile( SYSTEMPATH + "\\Olepro32.dll" );     /*Store the Olepro32.dll file*/
//Esta línea es un comentario.
Variables

Las variables son palabras reservadas definidas mediante scripts que se declaran la primera vez que se les asigna un valor. Puede ser cualquier combinación de letras, números y guiones bajos. Sin embargo, el primer carácter debe ser una letra. Las variables no pueden contener nombres de palabras clave ni constantes.

Constantes

Las constantes son variables predefinidas o definidas dinámicamente que proporciona el intérprete de los scripts. Su valor depende del estado del intérprete y de su plataforma. Los scripts no pueden modificar las constantes, que, además, mantienen el mismo valor durante toda la sesión.

Hay dos excepciones: APPLICATIONPATH, que se inicia mediante la palabra clave Detect, y LANGUAGE, que se inicia según el idioma que utilice el sistema operativo.

Constantes predefinidas

Las constantes predefinidas son las que siguen:

WINDOWSPATH

Indica la ruta del directorio Windows del equipo de origen.

SYSTEMPATH

Indica la ruta del directorio del sistema del equipo de origen.

APPLICATIONPATH

Indica la ruta del directorio de la aplicación del equipo de origen.

NEW_WINDOWSPATH

Indica la ruta del directorio Windows del equipo de destino.

NEW_SYSTEMPATH

Indica la ruta del directorio del sistema del equipo de destino.

NEW_APPLICATIONPATH

Indica la ruta del directorio de aplicación del equipo de destino.

WIN2000

Representa la plataforma Windows 2000.

WINXP

Representa la plataforma de 32 bits de Windows XP.

WINXP64

Representa la plataforma de 64 bits de Windows XP.

WINVI

Representa la plataforma de 32 bits de Windows Vista.

WINVI64

Representa la plataforma de 64 bits de Windows Vista.

WIN7

Representa la plataforma de 32 bits de Windows 7.

WIN764

Representa la plataforma de 64 bits de Windows 7.

WIN8

Representa la plataforma de 32 bits de Windows 8.

WIN864

Representa la plataforma de 64 bits de Windows 8.

ALWAYS

Se emplea para sobrescribir siempre los archivos.

NEVER

Se emplea para no sobrescribir nunca los archivos.

NEWER

Se emplea para sobrescribir los archivos sólo si el nuevo es más reciente que el existente.

GENERAL

Hace referencia a un nivel de impresión que indica que una sentencia de impresión siempre se imprimirá.

MODERATE

Hace referencia a un nivel de impresión que indica que una sentencia de impresión se imprimirá en un registro establecido con un nivel moderado.

DETAILED

Hace referencia a un nivel de impresión que indica que una sentencia de impresión se imprimirá en un registro establecido con un nivel detallado.

VERY_DETAILED

Hace referencia a un nivel de impresión que indica que una sentencia de impresión se imprimirá en un registro establecido con un nivel muy detallado.

LANGUAGE

Devuelve el identificador de idioma del sistema operativo.

Ejemplo:

   if (LANGUAGE == "enu")
	DoSomething();
Constantes relacionadas con el registro

Las constantes siguientes se definen en el registro, en HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders. En vez de recuperar el valor del registro, cabe la posibilidad de especificar estas constantes.

APPDATAPATH

La ruta de los datos de aplicación del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Datos de aplicación.

DESKTOPPATH

La ruta de la carpeta Escritorio del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Escritorio.

FAVORITESPATH

La ruta de la carpeta Favoritos del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Favoritos.

LOCALAPPDATAPATH

La ruta de los datos de aplicación del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Local Settings\Datos de aplicación.

PERSONALPATH

La ruta de la carpeta Mis documentos del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Mis documentos.

PROGRAMSPATH

La ruta de los archivos de programa del usuario en el equipo de origen, como C:\Archivos de programa.

STARTMENUPATH

La ruta de la carpeta Menú Inicio en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Menú Inicio.

STARTUPPATH

La ruta de la carpeta Inicio en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Menú Inicio\Programas\Inicio.

TEMPLATESPATH

La ruta de la carpeta Plantillas del usuario en el equipo de origen, como C:\Documents and Settings\Usuario predeterminado\Plantillas.

NEW_APPDATAPATH

La ruta de los datos de aplicación del usuario en el equipo de destinado, como C:\Documents and Settings\Usuario predeterminado\Datos de aplicación.

NEW_DESKTOPPATH

La ruta de la carpeta Escritorio del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Escritorio.

NEW_FAVORITESPATH

La ruta de la carpeta Favoritos del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Favoritos.

NEW_LOCALAPPDATAPATH

La ruta de los datos de aplicación del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Local Settings\Datos de aplicación.

NEW_PERSONALPATH

La ruta de la carpeta Mis documentos del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Mis documentos.

NEW_PROGRAMSPATH

La ruta de los archivos de programa del usuario en el equipo de destino, como C:\Archivos de programa.

NEW_STARTMENUPATH

La ruta de la carpeta Menú Inicio del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Menú Inicio.

NEW_STARTUPPATH

La ruta de la carpeta Inicio en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Menú Inicio\Programas\Inicio.

NEW_TEMPLATESPATH

La ruta de la carpeta Plantillas del usuario en el equipo de destino, como C:\Documents and Settings\Usuario predeterminado\Plantillas.

Constantes relacionadas con valores booleanos

Las constantes siguientes se emplean con estos comandos para reemplazar el parámetro booleano:

Éstas son las constantes:

SOURCE

Constante booleana que devuelve Verdadero o Falso en función de la tarea que realice CA DMM: aplicación o almacenamiento.

DESTINATION

Constante booleana que siempre devuelve Falso.

Ejemplo:

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.
}
Niveles de impresión

Estos comandos se usan para el segundo parámetro opcional en los siguientes comandos: Print y PrintException. El nivel de mayor importancia corresponde a GENERAL y el de menor importancia, a VERY_DETAILED. Si no se especifican los niveles de impresión, el valor predeterminado del parámetro es GENERAL.

Se admiten los siguientes niveles de impresión:

Uso:

Print(PrintException) <expresión de cadena>, [nivel de impresión];

Ejemplos:

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

Cualquier valor o resultado que pueda ser verdadero o falso.