Comando DO SCRIPT

Ejecuta un script secundario o un script externo desde un script de Analytics.

Sintaxis

DO <SCRIPT> nombre_script {<IF prueba>|<WHILE prueba>}

Parámetros

Nombre	Descripción
SCRIPT nombre_script	El nombre del script que se debe ejecutar. Puede ejecutar los scripts secundarios del proyecto de Analytics o los scripts externos que se almacenan en los archivos de texto con extensiones como .aclscript, .txt. o .bat. Puede especificar una ruta de archivo a un script externo. Si la ruta contiene espacios, debe encerrarla entre comillas. Nota No puede invocar un script que ya está en ejecución. Por ejemplo, si ScriptA llama a ScriptB, ScriptB no puede llamar a ScriptA. ScriptA todavía se está ejecutando mientras espera que ScriptB se complete.
IF prueba opcional	Una expresión condicional que se evalúa una vez para determinar si se debe ejecutar el script. Si la condición se evalúa como verdadera, se ejecuta el script; de lo contrario, no se ejecuta. No se puede usar junto con WHILE en el mismo comando. Si se utilizan ambos, WHILE se ignora cuando se procesa el script. Se ingresa un comentario en el log, pero el script no deja de ejecutarse.
WHILE prueba opcional	Una expresión condicional que se evalúa después de que el script se ejecuta para determinar si se debe ejecutar el script nuevamente. Si la prueba se evalúa como verdadera, el script se ejecuta nuevamente; de lo contrario, no se ejecuta. Nota Si usa WHILE, asegúrese de que su prueba finalmente se evalúe como falsa. Si no lo hace, el script entrará en un bucle infinito. Si se crea un bucle infinito, puede presionar la tecla Esc para cancelar el procesamiento del script. No se puede usar junto con IF en el mismo comando. Si se utilizan ambos, WHILE se ignora cuando se procesa el script. Se ingresa un comentario en el log, pero el script no deja de ejecutarse.

Nombre

Descripción

SCRIPT nombre_script

El nombre del script que se debe ejecutar. Puede ejecutar los scripts secundarios del proyecto de Analytics o los scripts externos que se almacenan en los archivos de texto con extensiones como .aclscript, .txt. o .bat.

Puede especificar una ruta de archivo a un script externo. Si la ruta contiene espacios, debe encerrarla entre comillas.

Nota

No puede invocar un script que ya está en ejecución. Por ejemplo, si ScriptA llama a ScriptB, ScriptB no puede llamar a ScriptA. ScriptA todavía se está ejecutando mientras espera que ScriptB se complete.

IF prueba

opcional

Una expresión condicional que se evalúa una vez para determinar si se debe ejecutar el script. Si la condición se evalúa como verdadera, se ejecuta el script; de lo contrario, no se ejecuta.

No se puede usar junto con WHILE en el mismo comando. Si se utilizan ambos, WHILE se ignora cuando se procesa el script. Se ingresa un comentario en el log, pero el script no deja de ejecutarse.

WHILE prueba

opcional

Una expresión condicional que se evalúa después de que el script se ejecuta para determinar si se debe ejecutar el script nuevamente. Si la prueba se evalúa como verdadera, el script se ejecuta nuevamente; de lo contrario, no se ejecuta.

Nota

Si usa WHILE, asegúrese de que su prueba finalmente se evalúe como falsa. Si no lo hace, el script entrará en un bucle infinito. Si se crea un bucle infinito, puede presionar la tecla Esc para cancelar el procesamiento del script.

No se puede usar junto con IF en el mismo comando. Si se utilizan ambos, WHILE se ignora cuando se procesa el script. Se ingresa un comentario en el log, pero el script no deja de ejecutarse.

Ejemplos

Ejecución de un subscript reiteradamente hasta que se valide la entrada

Usted tiene un subscript que recolecta información del usuario a través de un cuadro de diálogo. Hace lo siguiente:

Le pide al usuario los valores necesarios.
Comprueba la información introducida por el usuario.
Establece la variable v_validada en verdadero cuando se validan los valores de información de entrada.

Para asegurarse de que el usuario introduzca información válida, usted usa DO SCRIPT e incluye una condición WHILE para que el script repita este comando hasta que se valide la entrada. Una vez que el valor de la variable cambie, el script principal pasa al siguiente comando:

DO SCRIPT ObtenerEntradaUsuario WHILE v_validada = F

Ejecutar un subscript desde una ubicación compartida

Usted mantiene subscripts útiles en una ubicación compartida. Cuando necesita uno de los subscripts durante un análisis, hace referencia a él utilizando la ruta completa a su ubicación compartida:

DO SCRIPT "C:\My utility scripts\ObtenerEntradaUsuario.aclscript"  WHILE v_validada = F

Observaciones

Comandos relacionados

DO SCRIPT es equivalente al comando DO BATCH que se puede encontrar en scripts creados con versiones anteriores de Analytics.

No puede incluir el comando DO SCRIPT dentro de un comando GROUP.

Utilidad de un script externo

Almacenar un script de forma externa e invocarlo desde un script de Analytics resulta útil cuando se desea volver a usar el mismo subscript en diferentes scripts y proyectos de Analytics.

Puede almacenar una copia única del script en una ubicación y actualizarlo en un solo lugar en vez de mantenerlo en varias ubicaciones.