Tutorial Scripting Studio 2.0 PDF

Tutorial Scripting Gua del Usuario
1

Datamine Studio

Scripting

Gua del Usuario

Edicin 1.0

Este documento es confidencial y no puede ser reproducido o expuesto a terceras partes sin un
permiso escrito de Datamine Corporate Limited.

Copyright: Datamine Corporate Limited 2005


2
ndice

NDICE................................................................................................................................... 2
INTRODUCCIN AL SCRIPTING.................................................................................... 5
Usando FrontPage 2000 ................................................................................................. 7
Configurando FrontPage ................................................................................................ 7
Instale Microsoft Script Editor ....................................................................................... 8
INTRODUCCIN A GUARDAR, REPRODUCIR, Y DILOGOS SIMPLES............ 9
GUARDANDO Y REPRODUCIENDO UN SCRIPT.....................................................10
Comenzando con la Grabacin de Script ..................................................................... 10
Deteniendo el grabado de Script................................................................................... 10
Reproduciendo el Script............................................................................................... 10
VISUALIZANDO EL SCRIPT..........................................................................................12
Visualizando la fuente HTML...................................................................................... 12
Guardando la Copia de Referencia del Script .............................................................. 13
Guardando la Imagen de Logo Datamine..................................................................... 13
Corriendo el script desde Internet Explorer.................................................................. 14
SINTXIS DE LOS COMANDOS DATAMINE.............................................................15
Sintxis de los comandos Datamine ............................................................................. 16
Ejemplos ....................................................................................................................... 16
AGREGANDO MTODOS WINDOWS.........................................................................17
Agregando una alerta : alert ( ) ..................................................................................... 17
Agregando un requerimiento : prompt ( )..................................................................... 18
Agregando una confirmacin : confirm ( ) ................................................................... 19
Resumen....................................................................................................................... 20
INTRODUCCIN AL COMPONENTE SCRIPT LIBRARY........................................22
Usando el SLC.............................................................................................................. 22
El explorador de archivos de Datamine........................................................................ 23
AGREGANDO EL EXPLORADOR DE ARCHIVO DEL PROYECTO.....................24
INTRODUCCIN PARA EL EJEMPLO DE CREACIN DE UN POLGONO.......26
Inicie Datamine Studio ................................................................................................. 26
CREANDO LA INTERFAZ...............................................................................................27
Dibuje una tabla que contenga los objetos de interfaz. ................................................ 27
Agregue texto y cajas de texto ...................................................................................... 27
Agregando cajas de chequeo para la seleccin de informacin................................... 28
Agregue los botones OK y Cancel........................................................................ 28
Asigne valores y nombres a los controles .................................................................... 28
Ordenando la tabla........................................................................................................ 29

3
Otorgue un ttulo a la pgina y gurdelo. ..................................................................... 30
Enlace a la hoja de estilo estndar de Datamine Studio ............................................... 31
AGREGANDO EL SCRIPT..............................................................................................32
El evento en carga en Ventana ..................................................................................... 32
El operador onClick del botn OK............................................................................... 34
Que es lo que hace el script? ........................................................................................ 35
CORRIENDO EL SCRIPT................................................................................................37
Depurando su script...................................................................................................... 37
Sugerencias para extensiones adicionales .................................................................... 39
INTRODUCCIN AL EXPLORADOR Y COPIAR.......................................................40
Comenzando ................................................................................................................. 41
Cree una tabla que contenga los objetos de interfaz..................................................... 41
Agregue texto y cajas de texto ...................................................................................... 41
Agregue botones de Exploracin.................................................................................. 42
Asigne nombres y valores a los controles .................................................................... 42
Enlace a la hoja de estilo estndar de Datamine Studio ............................................... 43
Otorgue a la pgina un ttulo y gurdela. ..................................................................... 44
El evento onload (en carga) de ventana........................................................................ 45
El evento onunload de ventana ..................................................................................... 46
El operador onclick del botn OK................................................................................ 46
Los botones de exploracin.......................................................................................... 47
Depurando su script...................................................................................................... 49
SUGERENCIAS PARA PRXIMAS EXTENSIONES................................................50
Copie un campo simple................................................................................................ 50
Copiando campos mltiples ......................................................................................... 51
INTRODUCCIN PARA CORRER UNA MACRO DESDE UN SCRIPT.................54
MACRO DE EJEMPLO USANDO XRUN.....................................................................56
Asigne Nombres y Valores a los Controles.................................................................. 59
Eventos a ser definidos ................................................................................................. 61
Mtodos de Componente de Librera Script................................................................. 61
Microsoft Script Editor ................................................................................................. 62
tblN1 Entrada de Caja de Texto de Archivo Collars ................................................. 63
BtnBrowseOUt1 - Salida del Botn de Exploracin del Archivo de Grfico a .......... 64
BtnCreatePlot Cree un Botn de Grfica .................................................................. 64

4
BtnLoad - Cargue Botones Predeterminados .............................................................. 65
Evento onload (en carga) en Ventana........................................................................... 65
Haciendo una conexin con el SLC ............................................................................. 66
Copie el JavaScript y pguelo dentro de su script........................................................ 67
El Script Completo ....................................................................................................... 67
Edite la Macro .............................................................................................................. 68
Corra la Script............................................................................................................... 68
Validacin..................................................................................................................... 68
INTRODUCCIN A EJEMPLOS DE SCRIPTS...........................................................69
CREACIN DE UN MODELO PROTOTIPO................................................................70
Objetos HTML ............................................................................................................. 70
Mtodos SLC................................................................................................................ 71
Creando el Wireframe .................................................................................................. 71
Comandos con respuestas interactivas ......................................................................... 72
El Monitor de Progreso ................................................................................................ 72
Puntos a tener en cuenta............................................................................................... 73
OTRO EJEMPLO DE MACRO.......................................................................................74
TENIENDO ACCESO A VALORES DE REGISTRO Y CAMPO..............................75
EL MTODO DE MEN COMMAND DCM..................................................................76
Ejemplo de Script......................................................................................................... 76
INFORMACIN FINAL.....................................................................................................77


5

Introduccin al Scripting

Datamine Studio le proporciona una nueva interfaz para la industria que le permite escri bir
scripts usando JavaScript o VBScript. Estos scripts se introducen en un documento HTML el cual
puede ser cargado en la interfaz de Datamine Studio para ejecutar los comandos Datamine. As
como corre comandos individuales de los scripts tambin puede correr macros existentes y
programas CL los cuales han sido por un largo tiempo una caracterstica de los sistemas Datamine.

HTML puede ser usado para crear interfases grficas simples o comprensivas para scripts. Se
puede pensar que esto es un reemplazo para el comando macro SCREEN, pero es muchas veces
ms poderoso.

La manera ms fcil de comenzar el uso de
esta poderosa oportunidad es grabando un
script, al seleccionar TOOLS/START
SCRIPT RECORDING de la barra de men.
Esto crea un documento HTML simple con
botones Execute (ejecutar) y Help (asistente
de ayuda) que permiten reproducir la
secuencia de comandos que ha grabado.

No obstante, querr hacer ms que eso. Querr cambiar la interfaz de modo que, por ejemplo,
pueda especificar nombres de archivo de entradas o salidas, tambin querr especificar un campo
y valores de parmetros; y por lo tanto puede agregar botones extra, botones de radio cajas de
texto, cajas de chequeo, y dems.

Si quiere hacer cambios en la interfaz edite el script de HTML. Sin embargo, de la misma manera
como agrega cajas de texto o botones tambin necesita definir la accin o evento que ocurre
cuando ingresa informacin en la caja de texto o haciendo clic en el botn. Esto se hace usando
JavaScript o VB Script. Puede correr tanto los comandos Database y Design Window desde estos
scripts, de la misma manera como realiza las funciones de programacin. Puede tambin aplicar
interfaz con otros sistemas para la programacin.

Hemos proporcionado algunas funciones tiles de Java Script para simplificar tareas como corrida
de macros e instalacin de listas. Estos se encuentran en el Script Library Component (SLC) el
cual se explica en este tutorial.


6
El tutorial lo lleva a travs de todos los pasos desde la grabacin y reproduccin hasta el diseo de
su propia interfaz y adicin de scripts. El objetivo de este tutorial no es el de ensear HTML o
JavaScript. Estos son lenguajes y existe inmensa cantidad de libros y otras fuentes que hacen ese
trabajo. Este tutorial se concentra en las herramientas necesarias para crear y manejar pginas
HTML, macro, y otros archivos usados en Datamine Studio.
Si es familiar con conceptos y mtodos de JavaScript y HTML, la comprensin del tutorial le
resultar har ms fcil.

Dos Libros tiles para JavaScript son:

JavaScript: The definitive Guide, Third Edition
By David Flannagan
Published by OReilly and Associates, Inc,
ISBN: 1-56592-392-8

Java Script Bible, 3rd Edition
By Danny Goodman, Brendan Eich
Published by IDG Books Worldwide
ISBN: 0-76453-188-3

Usuarios experimentados reconocern que la disponibilidad de una interfaz industrial COM
estndar para todos los comandos de Datamine Studio le abre enormes posibilidades para
integrarse a Dat amine Studio en su sistema IT global de compaa. Los comandos de Datamine
Studio pueden ser ejecutados y accedidos desde cualquier sistema o lenguaje de programacin,
incluyendo Access Basic, Sybase PowerBuilder, Borland Delphy, Visual Basic o C++.


7
Usando FrontPage 2000

Para el desarrollo de pginas HTML y scripts se requiere ms que un editor de texto. Existe un
nmero de editores HTML disponibles, tanto en freeware y shareware como en la parte comercial
de la internet. Estos productos varan considerablemente en su aproximacin a la generacin de
pginas HTML, pero casi todos estn diseados para crear para la Internet webs HTML y muy
pocos tienen soporte para el desarrollo de scripts ms elaboradas.

Microsoft FrontPage es la atraccin de Microsoft para el desarrollo de web y HTML. Su precio es
razonable y contiene un buen editor de grficos de HTML y un soporte excelente para el desarrollo
de scripts. Este es el paquete que actualmente recomendamos usar.

Antes de completar este tutorial, necesitar una copia de Microsoft Frontpage 2000. Para chequear
si su versin de FrontPage es la correcta, cargue FrontPage y seleccione Help/About Microsoft
FrontPage.

La versin debe ser 4.0.2.XXXX similar a la que se ve a continuacin

Configurando FrontPage

Cuando el script es usado para enviar informacin a un servidor web de Internet o Intranet, los
diferentes objetos de interfaz (cajas de texto, cajas de chequeo, etc) que son usados para
especificar valores son agrupados en una plantilla. Cuando el botn submit (enviar) es
presionado, los valores especificados por todos los campos en la plantilla son agrupados
conjuntamente y transmitidos. Esto no ser necesario para la programacin de ubicacin de
cliente (client -side), como ser usado en este tutorial.

Por defecto, FrontPage activa automticamente campos que inserta en la plantilla.
Deshabilitaremos esta caracterstica seleccionando Tools/ Page Options... y desactivando la caja
en el dialogo que aparece, de modo que luzca como sigue:

8

Instale Microsoft Script Editor
La edicin y depuracin de script es controlada por un componente opcional, el cual no est
instalado por defecto en FrontPage 2000, llamado Microsoft Script Editor. Si no instala el editor
de script, re instale su CD de FrontPage y cargue HTML Source Editing y los componentes de
Office Tools.

Primera leccin: Guardar, Reproducir y Dilogos Simples

9
Introduccin a Guardar, Reproducir, y Dilogos Simples

Los objetivos de estas dos primeras lecciones son:

Usar las caractersticas de guardado y reproduccin para grabar comandos ingresados
interactivamente, y luego poder correrlos nuevamente.
Introducir tres mtodos de ventana comnmente usados : alert () (alerta), confirm()
(confirmacin) y promt() (requerimiento), las cuales utilizan cajas de dilogo simple
Usar el explorador de Datamine para poder seleccionar archivos.

Cargue Datamine Studio y seleccione la base de datos de proyecto Tutorial. Si ha considerado los
defaults al instalar Datamine Studio, la base de datos se encontrar en el directorio
c:/database/tutorial.


10
Guardando y Reproduciendo un Script

Para la primera parte de la leccin usted va a guardar y reproducir la secuencia de los comandos
Datamine para juntar y llenar la informacin referida al desurveying downhole.
Comenzando con la Grabacin de Script

Active la grabacin de script automtica haciendo clic en en la barra de herramientas
Scripting, o seleccione Tools/ Start Script Recording de la barra de men.
Cuando se le pida un nombre para el archivo script HTML ingrese el nombre : desurvey
Ejecute la siguiente secuencia de comando Datamine interactivamente.
1. !SORTX &IN=_collars &OUT=tempcollars *KEY1=BHID
2. !SORTX &IN=_assays &OUT=tempassays *KEY1=BHID *KEY2=FROM
3. !SORTX &IN=_geology &OUT=tempgeology *KEY1=BHID *KEY2=FROM
4. !SORTX &IN=_surveys &OUT=tempsurvey *KEY1=BHID *KEY2=AT
5. !JOIN &IN1=tempcollars &IN2=tempassays &OUT=temp1 *KEY1=BHID
@SUBSETR=1.0
6. !HOLMER &IN1=temp1 &IN2=tempgeology &OUT=temp2 *BHID=BHID
*FROM=FROM *TO=TO
7. !DESURV &IN1=temp2 &IN2=tempsurvey &OUT=holes
8. !DDLIST &IN=holes

Si comete un error al ingresa cualquiera de estos 8 comandos, no se preocupe. Ignore cualquier
error y reingrese el comando correctamente.

En realidad los comandos de arriba han sido combinados en procesos simples Datamine
HOLES3D, los cuales proporciona caractersticas adicionales tales como validacin de
informacin. Sin embargo es tambin til algunas veces, seguir los pasos individuales
descritos arriba.

Deteniendo el grabado de Script

Detenga el grabado automtico usando o Tools / Stop Script Recording.

Reproduciendo el Script
Ahora reproduzca el Script guardado usando o seleccione Tools/ Run Script. Cuando se le
pida por el nombre del script, seleccione desurvey.htm. Asegrese que la ventana Customization
es mostrada y seleccione el tab Script:


11

Haga clic en el botn Execute (ejecutar), y los comandos sern reproducidos. No se preocupes si
los comandos no se reproducen correctamente porque tal vez cometi un error durante la
grabacin de los mismos. Solucionaremos eso en la siguiente sesin.


12

Visualizando el Script

Primero haga clic en el botn Help en la interfaz de script en la ventana Costumization. Esto lleva
al frente otra ventana que proporciona un breve comentario acerca de las facilidades de
programacin de Datamine. Lea este comentario!. Cubriremos todas estas opciones en detalle
luego en el tutorial.

Visualizando la fuente HTML

Como mencionamos anteriormente usaremos FrontPage 2000 para editar el script. Sin embargo es
posible visualizar y de hecho editar el script usando un editor de texto, a pesar que esta no es la
forma recomendada de hacerlo.

Haga clic derecho sobre el fondo gris del tab script dentro de la ventana
Costumization y obtendr un men de tipo popup. Seleccione View
Source (Visualizar Fuente) y el archivo HTML, desurvey.htm, se cargar
en Notepad (Bloc de Notas).

Tranquilo! FrontPage 2000 y el editor Microsoft Script Editor le
proporcionarn las herramientas que necesita para editar este
archivo. Sin embargo es muy til dar un vistazo rpido al archivo
en este momento para ver que est sucediendo.
Las primeras 6 lneas en cdigo HTML contienen informacin
dirigente.
Luego hay cuatro prrafos de comentarios, cada lnea
comenzando con //. Esto le indica como trabaja un script. Lalo.
Entre los dos juegos de lneas de comentarios que comienzan con //------- se encuentran
algunas lneas de JavaScript. Estas estn dando inicio al Datamine Command Manager

13
(Administrador de Comandos Datamine) y el Explorador, dependiendo de qu mtodo est
siendo seleccionado.
Luego tenemos ms comentarios, seguidos de dos funciones JavaScript
btnExecute_onclick() y btnHelp_onclick(). Estas funciones describen qu accin es tomada
cuando se hace clic en el Execute (Ejecutor) o los botones Help (Asistente de Ayuda)
respectivamente.
Y finalmente aparece el cdigo HTML que describe la interfaz el logo Datamine y los
botones Help y Execute.

Guardando la Copia de Referencia del Script

Deseamos que tenga xito en la creacin de su propia copia de desurvey.htm. Sin embargo si
quiere visualizar la copia de referencia y o guardar una copia de ella haga clic en el botn
Esto abrir una nueva ventana y mostrar el script. Para visualizar el cdigo
actual debe hacer clic derecho en la ventana y seleccionar View Source (visualizar fuente), como
se explic anteriormente. Si quiere guardar una copia del archivo, seleccione File / Save As de la
barra de herramientas de Notepad (Bloc de Notas). Deber usar el explorador para llegar hasta su
directorio de proyecto Tutorial. Tambin deber cambiar el nombre del archivo. Por ejemplo, llame
al archivo desurvey1.htm. Asegrese de aadir la extensin .htm al finalizar el nombre de archivo, y
no use la extensin por defecto .txt.

Este mtodo de guardado para la copia de referencia de un archivo es usado frecuentemente en
este tutorial, de modo que asegrese de entenderlo.

Guardando la Imagen de Logo Datamine.

El script muestra el logo Datamine al lado del nombre del script. Sin embargo se asume que la
imagen del logo (dmlogo200x93.gif) se encuentra en su directorio de proyecto, lo que en un inicio
no ser el caso. El cdigo HTML que muestra la imagen est cerca del final del archivo:

Con el objetivo de obtener la imagen a ser mostrada puede:


14
Copiar la imagen a su directorio de proyecto. Encontrar el archivo dmlogo200x93.gif en el
directorio de instalacin de Datamine, usualmente en c:/Program
Files/datamine/DmStudio.140/Common/Images.
Agregar el prrafo completo al script:

El primer mtodo es probablemente el ms apropiado debido a que el archivo se encontrar en el
directorio correcto cuando guarde otros scripts luego en este tutorial. De otro forma necesitar
editar cada script que guarde. Puede desde luego correr el script sin el logo, pero eso no luce muy
ORDENADO!

Corriendo el script desde Internet Explorer

En vez de guardar una copia del script y correrla desde la ventana Customization en Datamine
Studio, puede correr el script directamente desde la ventana Internet Explorer. Solo haga clic en el
botn Execute (Ejecutar) y el script correr. Debe por supuesto para este momento haber abierto
Datamine Studio. Sin embargo es mejor correr el script dentro de Datamine Studio puesto que este
otorga acceso inmediato a otros comandos Datamine, y es ms fcil de mostrar tanto el script
como las otras ventanas Dat amine simultneamente.


15
Sintxis de los comandos Datamine

El Java Script que describe la accin tomada cuando se hace clic en el botn Execute (Ejecutar)
es mostrado abajo. Puede ver que cada comando Datamine ha sido corrido usando la funcin:
dm.command(). Este nombre de comando y los archivos correspondientes, campos y parmetros
son ingresados como una string de carcter encerrada entre comillas. Si la string se extiende a dos
o ms lneas entonces cada lnea es separada por una string y las strings se unen usando el
carcter +.

Note que los nombre de archivos son precedidas por macros simblicas & (eg&IN), nombres de
campo por * (ej *BHID) y los parmetros por @ (eg@BINS=5). Sin embargo a diferencia de las
macros hay signos de igual (=) entres los nombres de archivo reales y simblicos (ej &IN=_collars)
y entre los nombres de campo reales y simblicos (ej *KEWY1=BHID). Estas asignaciones a
archivos, campos y parmetros son separadas por uno o ms espacios.

Si comete un error al ingresar los comandos puede editar el cdigo. Asegrese que mantiene la
sintaxis correcta. Si durante el ingreso de comandos hace clic en la ventana Design, entonces
encontrar que el comando dm.command (select-string) ha sido grabado. Esto puede ser
eliminado.

Si ha realizado algn cambio entonces guarde el archivo antes de salir. Con el objetivo de correr la
edicin de script puede hacer clic ya sea en o seleccionando Tools/Run Script, como
previamente, o puede hacer clic en el fondo gris del tab para mostrar el men de opciones.

16
Seleccione Refresh (Actualizar) y corra el programa nuevamente haciendo clic en el botn
Execute (Ejecutar).

Sintxis de los comandos Datamine

La sintaxis completa para un comando Datamine es:

Note que:

... significa ser repetido cualquier nmero de veces.
[name =] significa que el nombre de archivo simblico es opcional
Datamine Studio usa &, * y @ de la misma manera como Datamine5
Los parmetros pueden tener mltiples valores, donde sea apropiado
Archivos con nombres extensos (ms de 20 caracteres) pueden ser usados, las macros
estn restringidas a 8 caracteres.

Ejemplos

Copie registros del archivo collars al archivo temp usando la referencia XCOLLAR>=10200:

Abra el archivo strings en la ventana Design sin filtrar

Cree una nueva string, en forma de cuadrado, en la ventana Design


17

Agregando Mtodos Windows

Existen tres mtodos de ventana generalmente usados, los cuales puede ser agregados a su
script.

alert() alerta muestra un mensaje al usuario
confirm() confirmacin le pregunta al usuario si bien hacer clic en el botn OK o
CANCEL para confi rmar o cancelar una operacin.
prompt () requerimiento le pregunta al usuario ingresar una string de texto.

Todos estos tres mtodos aparecen en simples cajas de dilogo.

Agregando una alerta : alert ( )

El mtodo de alerta, alert( ), es usado para mostrar una caja de dilogo que contiene el valor de
una variable o una string de texto. Por ejemplo inserte alert( ) al principio de una funcin para
mostrar el ttulo. Para hacer esto edite el script haciendo clic derecho y seleccionando View
Source (Visualizacin de Fuente); luego agregue alert( ) como se muestra debajo:

Guarde el archivo y regrese a Datamine Studio. Haga clic derecho en el fondo gris del tab script en
la ventana Customization para mostrar el men. Seleccione Refresh (Actualizar) y luego Execute
(Ejecutar).

El mensaje de alerta que acaba de ingresar ser
mostrado inmediatamente. Haga clic en OK para
continuar corriendo el script.


18
Agregando un requerimiento : prompt ( )

El mtodo prompt ( ) muestra un dilogo que incluye un mensaje prefijado por usted y que le
proporciona un campo de texto para ingresar una respuesta. Dos botones, Cancel y OK, le dan la
opcin para :

Cancel - cancela la operacin totalmente
OK - acepta la entrada y contina la operacin

El mtodo prompt ( ) tiene dos argumentos. El primero es el mensaje de requerimiento el cual es
mostrado en el dialogo. El segundo argumento es una respuesta predeterminada la cual es
mostrada en la caja de texto. Si no quiere especificar una respuesta predeterminada entonces solo
ingrese dos comillas sucesivas .

El mtodo responde un valor cuando hace clic en uno de los botones. Haciendo clic en el botn
Cancel responde un valor nulo, independientemente de lo que est en la caja de texto. Haciendo
clic en el botn OK responde el valor de la string de texto en la caja de texto.

Use el mtodo prompt ( ) para pedir el nombre del archivo collars, y almacenar el valor en la
variable cfile. Luego debe agregar una prueba para chequear el valor de cfile. Si cfi le est vaco ()
o nulo entonces return terminar la funcin.

Finalmente necesitar reemplazar el nombre de cdigo fuerte name_collars con el nombre variable
cfile en el comando Datamine que provee el archivo. Note que cfile es una variable, y como tal no
debe ser encerrada en comillas dobles. Por lo tanto el argumento para dm.command es dividido en
tres partes separas por un + como se muestra en el ejemplo debajo. Asegrese que existe un
espacio inmediatamente frente a &OUT=tempcollars, asimismo los archivos, campos y parmetros
estn separados por espacios.

Guarde el archivo de texto, actualice el script y crrala nuevamente. Luego de alert( ) que muestra
el ttulo, el dilogo prompt( ) ser mostrado


19

Para acept ar el nombre predeterminado name_collars, solo haga clic en OK. El resto del script
tambin correr.

Puede ahora tambin agregar requerimientos similares para los otros cuatro archivos, usando los
nombres:

Assays afile
geology gfile
surveys sfile
holes hfile

No olvide reemplazar los nombres para todos los archivos (_assays, _geology, etc) con el nombre
de variable correspondiente (afile, gfile, etc) en todos los enunciados necesarios dm.command.

Agregando una confirmacin : confirm ( )

El mtodo confirm ( ) muestra un dialogo que incluye un mensaje especificado por el usuario y que
le proporciona dos botones, Cancel y OK. Esto es similar a prompt( ) excepto que la nica
respuesta es hacer clic en uno de los dos botones. El mtodo responde al valor Boolean, valor true
(verdadero) si se hace clic en OK o false (falso) para Cancel. Puede entonces agregar un cdigo

20
para actuar de acuerdo con el botn en el que se ha hecho clic. Por ejemplo use confirm( ) para
mostrar los nombres de los archivos que han sido seleccionados, y luego para que aborte la
operacin si se ha hecho clic en Cancel.

/n dentro de una string de texto iniciar una nueva lnea

! al lado de confirm ( ) regresa al valor Boolean. Por ejemplo si se ha hecho clic en Cancel, el valor
de confirm( ) ser false. Sin embargo agregando ! la respuesta sera true, de modo que la accin
ser return y la operacin habr terminado. El dilogo confirm( ) lucir como el siguiente:

Resumen

Los mtodos alert ( ) y confirm ( ) son particularmente usados para depurar un script. A pesar de
que el mtodo prompt ( ) puede ser usado para ingresar un valor, sera una forma forzada de
hacerlo. Una de las principales ventajas de la programacin es el uso de HTML para crear una
interfaz atractiva, as como veremos en la siguiente parte del tutorial.


21
Para ver el contenido del script completo con los mtodos alert( ), prompt ( ) y confirm ( ) haga clic
en :

Siguiente leccin: El componente Script Library


22
Introduccin al componente Script Library

El componente Script Library bsico (SLC) provee de una fuente de funciones tiles Java Script
para simplificar tareas tales como el acceso al File Browser (Explorador de Archivos), corrida de
macros e instalacin de listas de men. Un resumen de propiedades y mtodos asociados con el
SLC esta disponible al hacer clic aqu Escoja una Propiedad o un Mtodo de la lista
desplegable para mostrar los detalles correspondientes. Usaremos algunas de estas propiedades y
mtodos luego en este tutorial.

En una leccin anterior, Visualizando el Script, se fij la atencin a los argumentos incluidos en el
script cuando corresponde guardarlo automticamente. Datamine Studio es operado desde un
script a partir de dos objetos ActiveX : el DCM (Administrador de Comandos Datamine) y el
explorador Project File (dmBrowser). Un script guardado automticamente incluye cdigos para
inicializar ambos objetos ActiveX, los que crean una conexin entre el script y su proyecto
Datamine. El mtodo por defecto, (method =1 ), inicializa los objetos Active X: DCM y del
explorador explcitamente.

Alternativamente, si quiere modificar el script, sera preferible usar el SLC. Al inicializar el SLC, el
DCM y dmBrowser son inicializados automticamente para usted, adems el SLC le provee de un
nmero de funciones convenientes que hacen que la modificacin del script sea ms fcil. Con el
propsito de us ar el SLC debe instalarlo con el CD de instalacin de Datamine Studio. No se
instala por default, por lo tanto, debe seleccionar la opcin para instalarlo. Debe adems estar
trabajando con la versin 5, o superior, de Internet Explorer.

Usando el SLC

Primero haga una copia del script (desurvey.htm) que ha creado en el ejercicio previo, y nombre el
nuevo script desurvey.2.htm. Luego edite el nuevo script y cambie de method=1 a method =2, para
que pueda usar la biblioteca.

Note que seleccionado el method 2, las dos lneas de cdigo de inicializacin son :


23
La variable dm es solo un nombre usado en el script. De hecho no tiene por que ser dm. En
realidad en algunos de los ejemplos siguientes del tutorial usaremos dmlib.

El explorador de archivos de Datamine

En el siguiente ejemplo usaremos el File Browser (Explorador de Archivo) para seleccionar
nombres de archivos en vez del mtodo de la ventana prompt( ). Este es el mismo Explorador de
Archivo que usa cuando corre los comandos Datamine.


24
Agregando el Explorador de Archivo del Proyecto

Se accede al Explorador de Archivo de Datamine usando el mtodo browseForFile( ) . Estos son
los tres argumentos para ste mtodo:

1. El tipo de archivo

Las opciones son:

Si el archivo requerido no es uno de los tipos especficos, entonces debe usar typeAny.

2. El nombre de archivo predeterminado
Use null (nulo) o si no hay un default apropiado

3. Habilitar un nuevo nombre de tabla (true (verdadero) o false (false))?
true si el nombre de archivo puede ser especificado, o false si el usuario debe seleccionar
un archivo existente.

Reemplace el mtodo prompt( ) usando el Explorador de Archivo, para cada uno de los cinco
archivos. Por ejemplo


25
Note que no hay necesidad de examinar si los primero cuatro archivos estn en blanco o nulos
porque estableciendo el tercer argumento en false se asegura que el archivo ya existe. Sin
embargo el archivo de perforacin de salida puede ser un nuevo archivo (true), de modo que
necesitaremos examinar el valor de hfile.

Corra el script y asegrese que todava trabaja correctamente!. La versin de referencia es incluida
aqu:

Note que los nombres de todos los mtodos y propiedades son cajas sensibles. Por este
motivo el mtodo browseForFile debe tener dos cajas superiores F, y la propiedad
tipeCollars debe tener una caja superior C.

Siguiente Leccin: Ejemplo de Script para Crear un Polgono


26
Introduccin para el Ejemplo de Creacin de un Polgono

Esta leccin lo introduce a muchas ideas detrs de Datamine Studio Scripting, y desarrolla un
ejemplo muy til, paso a paso. Desarrollar una nueva interfaz con cajas de texto y botones, y
agregar el script. De ahora en adelante usar Microsoft FrontPage 2000 y el editor Microsoft
Script Editor (MSE) como se mencion en la introduccin de este tutorial. Asegrese que ambos
estn instalados.

Datamine Studio contiene una serie prctica de procesos llamada CONPOL, para encontrar la
convexidad de casco alrededor de un juego de puntos. El script desarrollado en este tutorial integra
el proceso CONPOL a la ventana Design de Datamine Studio, por lo que cada seleccin de
informacin de punto y string actualmente en la ventana Design puede ser trasladada a CONPOL,
y el polgono cargado resultante regresa a la ventana Design. El script procesa las coordenadas X
e Y , ej: trabaja en una vista de plano.

Inicie Datamine Studio

Cree informacin de punto en la ventana Desi gn de Datamine Studio. Escoja dos o tres colores
diferentes para la informacin de punto.

Probablemente est corriendo este tutorial desde el men desplegable en Datamine Studio
Help/Scripting. Esto significa que si minimiza Datamine Studio entonces el tutorial tambin ser
minimizado. Si quiere, puede correr una versin independiente de este tutorial haciendo doble clic
en el archivo script_tutorial.chm en la ventana Explorer en el directorio de instalacin de Datamine
generalmente se encuentra en c: /Program files/datamine/DmStudio.140. Esto le permite
minimizar Datamine Studio mientras est corriendo FrontPage 2000.


27
Creando la Interfaz

En la parte inferior de la ventana FrontPage hay tres tabs: Normal, HTML y Preview (Vista Previa).
El tab Normal es en donde diseamos la plantilla HTML, y el tab Preview es en donde nosotros
podemos dar una vista previa a lo que estamos diseando, incluso operar los controles y
comandos. Usamos la vista HTML solo cuando estamos agregando el script a la pgina.

Esta es la interfaz que vamos a crear.

Dibuje una tabla que contenga los objetos de interfaz.

Con el tab Normal seleccionado, seleccione Table/ Instert / Table... y fije una tabla con cinco filas
y dos columnas.

En lugar de Table/ Insert / Table... puede usar Table/ Draw Table... y efectivamente
dibujar las lneas separando las filas y dos columnas. Esta caracterstica es
particularmente til si quiere dibujar tablas con alta resolucin de arreglos de celdas.

Agregue texto y cajas de texto

Ahora queremos agregar dos cajas de texto en las dos celdas superiores de la mano derecha de la
tabla. El texto que describe el contenido de estas cajas va dentro de las dos celdas superiores de
la mano izquierda.

Mueva el cursor a la celda de la parte superior izquierda y escriba Extension distance (Distancia
de extensin). Luego dirjase a la segunda fila, columna de la mano izquierda y escriba Filter
(Filtro). Ahora aadiremos dos cajas de texto. Site su cursor en la celda superior de la mano
derecha, y seleccione Insert/ Form/ One-Line Text Box. FrontPage insertar la caja de texto.
Ahora inserte otra caja de texto en la columna de la mano derecha, al lado de la etiqueta Filter

Tal vez prefiere tener los elementos de plantillas disponibles en la barra de herramientas
. Para hacer esto, seleccione Insert/ Form, luego arrastre el

28
sub menu y llvelo a la barra de herramientas.

Agregando cajas de chequeo para la seleccin de informacin

Inserte una caja de chequeo (Insert/Form/Check Box o ) en la celda de la mano derecha en la
fila tres, y agregue el texto: Include point data (Incluir informacin de punto) a su derecha.

Inserte otra caja de chequeo en la celda debajo, con el texto Include string data (Incluir
informacin de string)

Agregue los botones OK y Cancel

Finalmente agregamos dos botones (Insert / Form / Push Button or ) a las dos celdas en la
ltima fila. No se preocupe por las etiquetas de los botones por ahora (por defecto dirn Button
(botn); lo arreglaremos luego. La interfaz debe ser como la mostrada debajo. Dependiendo de los
atributos predeterminados de celda puede o no puede tener bordes alrededor de cada celda.
Trataremos eso luego.

Asigne valores y nombres a los controles

Antes de hacer correr algo, necesitamos asignar nombres y valores iniciales a todos los controles
de la interfaz. Los nombres pueden ser cualquier cosa que desee, pero recuerde que las letras de
las cajas superior e inferior son distintas (esto es diferente a Esto). Una buena idea es usar
prefijos en los nombres de los controles con dos o tres letras que identifiquen el tipo de control. Ej:
btnOK para un botn OK, o ctArchivoSeleccionado para una caja de texto que contenga el
nombre del archivo seleccionado.

29

Hay tres maneras de asignar un nombre a un control:

1. Seleccinelo con el mouse y presione Alt+Enter
2. Haga clic derecho en el control para mostrar el men context (contexto), y seleccione Form
Field Properties (Formar propiedades de Campo). .
3. Haga doble clic en el control.

No es importante que mtodo use todos muestran el dialogo Properties (propiedades).
Haga esto primero para la caja de texto Extention Distance. Asigne el nombre tbExtension (tb =
text box =ct =caja de texto) y fije el valor inicial en 0.

Asegrese de usar los nombres exactos para los controles tal como se proporcionan en
el texto.

Acto seguido, asigne el nombre tbFilter (tb = text box = ct = caja de texto) y ningn valor inicial a la
segunda caja de texto. Luego asigne el nombre cbIncludePoints (cb=check box =cc= caja de
chequeo) a la caja de chequeo include point data y seleccione checked (chequeado) como el
Initial State (Estado inicial). Nombre la segunda caja de chequeo cbIncludeStrings y deje el Initial
State como Not Checked (no chequeado).

Finalmente, nombre el botn de la mano izquierda btnOK y fije el Valor/Etiqueta como OK
(agregue dos espacios de conduccin y arrastre para hacerlo del mismo tamao que el botn
Cancel), y nombre el botn de la mano derecha btnCancel y fije su Valor/Etiqueta en Cancel.

Ordenando la tabla

Ahora, podemos mejorar la vista de nuestra tabla. Este paso no es absolutamente necesario, pero
mejorar la integracin visual a Datamine Studio, y har que la interfaz se comporte mejor si la
ventana de script en Datamine Studio es ajustada nuevamente.

Todas las mejoras de disposicin de tabla y cambios en los valores en los dilogos resultantes
pueden ser hechas haciendo clic de recho en el mouse. Sin embargo, esta leccin le dar los
comandos de men alternativos.

Primero, seleccione todas las celda en la tabla, haciendo clic y arrastrando el mouse con el botn
derecho hacia la celda superior izquierda. Seleccione Table/ Properties/ Cell y desactive las cajas
Specify Width (Ancho especfico) y Specify Height (Altura especfica), para permitir al explorador
seleccionar el mejor ancho y alto para las celdas.

30

La alturas y ancho de tabla y celda solo sern fijadas si usa la caracterstica de dibujo de
tabla (draw table), o si ha re-ajustado el tamao de tabla de alguna manera.

Luego, seleccione toda la tabla (ubique el puntero del mouse dentro de la tabla y seleccione Table
/Select Table... , esto es diferente a seleccionar todas las celdas en la tabla), luego seleccione
Table / Properties/Table. Cambie la alineacin de tabla, tamao de borde, ancho mnimo y altura,
de modo que se parezca al dialogo debajo:

Al posicionarnos en la alineacin center (al centro) la tabla se mantendr en el centro de la
ventana script al tiempo que su tamao es re-ajustado.

Fijando el tamao del borde en cero, ocultar las lneas entre las columnas y las filas, pero la
estructura de la tabla mantendr todo en su lugar apropiado.

Al desactivar el mnimo de altura y ancho, permitir al explorador el re-ajuste del tamao de tabla
para terminar con el tamao ms pequeo posible.

Finalmente, resalte la ltima fila de celdas (haga clic y arrastre el mouse) y seleccione
Table/Properties/Cells. Cambie la Alineacin Horizontal (Aligment Horizontal a Center), para
centrar los botones en las celdas.
Otorgue un ttulo a la pgina y gurdelo.

Ahora la interfaz est casi completada. Deber darle un nombre a la pgina HTML (Haga clic
derecho), seleccione Page Properties... (Propiedades de Pgina) e ingrese un ttulo como Script
de Polgono (Polygon Script)), y guarde la pgina en el mismo directorio que su proyecto Datamine
Studio, con el nombre poligono.htm (polygon.htm).


31
Enlace a la hoja de estilo estndar de Datamine Studio

Nuevamente, este paso no es necesario, pero al hacer un enlace entre su HTML y la hoja de estilo
estndar de Datamine Studio se mejorar cuantiosamente la visin integral del script.

La hoja de estilo de Datamine Studio se encuentra en un archivo llamado , y
debe ser localizado en el mismo directorio que el script antes de ser corrido. Si necesita una copia
de esta hoja de estilo, haga clic en el botn para abrir el documento, luego copie y pegue el texto
dentro de un archivo llamado dmstyle.css en su directorio Tutorial.

Para hacer un enlace en la hoja de estilo, seleccione Format/ Style Sheet Links... presione Add
(agregar), busque y seleccione la hoja de estilo Datamine dmstyle.css.

Ahora haga clic en el tab preview, para visualizar como lucir la interfaz completada


32
Agregando el script

El primer paso ya est completado: tenemos una interfaz de usuario HTML, conjuntamente con
todos los atractivos de un script.

Recuerde, que la nueva caracterstica importante de Datamine Studio es que este puede ser
programado. El lenguaje del script en uso no es parte de Datamine Studio puede usar cualquier
tipo del gran nmero de lenguajes de programacin estndar: Java Script, VBScript, PerlScript,
PowerBuilders, Power Script, etc. Los dos lenguajes usados por FrontPage son VBScript y
JavaScript.

A diferencia de las macros y mens, los scripts son usualmente creados de un nmero de eventos
guas, pequeas secciones de script que son ejecutadas por un explorador cuando algn evento
relevante ocurre. Solo dos de estos eventos son manejados en este script:

Cuando la ventana se carga (un evento de ventana en carga), el script hace su conexin al
DCM (Datamine Command Manager, Administrador de Comandos Datamine).
Cuando el botn OK es presionado (un evento de botn en clic), el explorador ejecuta un
script que guarda y procesa informacin de punto y/o string.

El evento en carga en Ventana

Para empezar el ingreso del script, que hace que el HTML cobre vida, haga clic en el tab Normal,
luego seleccione Tools/ Macro/ Microsoft Script Editor del men. Una nueva ventana aparece,
mostrando su interfaz en HTML.

Como estar usando el editor Microsoft Script Editor frecuentemente sera una buena
idea aadir este botn en la barra de herramientas. Seleccione Tools/ Customize y del
dialogo Customize seleccione el tab Commands. De la pestaa Categories resalte Tools,
y despliegue la pestaa Commands hasta que el icono Microsoft Script Editor se
muestre. Arrastre el icono y colquelo en la barra de herramientas por ejemplo la barra de
herramientas Forms que contiene los botones y cajas de texto.

Ahora configure el Script Editor para usar JavaScript: seleccione View/ Prorpety Pages, o
presione Shift+F4. Fije el lenguaje de programacin predeterminado para scripts de Usuario (Client
scripts) de modo que este sea JavaScript, y presione OK. Necesitar hacer esto cada vez que

33
use Script Editor en un document o diferente. El Script Editor no guarda el cambio a JavaScript
como predeterminado.

Ahora, de la barra de men, seleccione View/Toolbox, luego
View/Other Windows/ Script Outline. Deber visualizar una
lista de objetos que aadi a su interfaz (btnCancel, btnOK,
etc.). Haga doble clic en window (ventana), y haga doble clic
en el evento en carga (onload event): el evento que se emite
como su documento est cargado en el explorador. El Script
Editor inserta el HTML necesario para contener su script, y
define una funcin window_onload( ).

(Si el encabezado dice Sub window_onload ( ), es porque
FrontPage es configurado para usar VBScript. Presione
Shitf+F4 y cambie esto antes de proceder).

Ahora necesitamos ingresar el cdigo JavaScript ha ser ejecutado cuando este evento ocurre.
Primero, necesitamos establecer una conexin entre el script y el SLC (Datamine Studio Scripting
Library Component, Componente Scripting Library de Datmine Studio). En trminos de
programacin, necesitamos crear un ejemplo del SLC. Esto se realiza con el siguiente argumento
en JavaScript:

Si est leyendo este documento en lnea, Copie las lneas JavaScript en el portapapeles,
luego use Pegar como HTML del men Edit (Edicin) de FrontPage para pegarlo en su
documento HTML.

Este argumento crea una variable (global), llamada dmlib, a travs de la cual nos comunicaremos
con Datamine Studio. Por favor dirjase al manual de JavaScript si no entendi esta seccin.
Luego, necesitamos decirle a la biblioteca que se inicialice. Ingrese una segunda lnea de cdigo,
que diga:

Note que el programa Script Editor le ayuda mostrando una lista de mtodos y propiedades
disponibles en la biblioteca. Cuando se ejecuta, el mtodo de inicializacin intentar conectarse a

34
la ejecucin actual de la sesin de Datamine Studio. Por esta razn, Datamine Studio deber estar
corriendo antes que ejecutemos exitosamente este (y todos) script desarrollado usando el SLC.

El operador onClick del botn OK

Ahora haga doble clic en btnOK, y haga doble clic en el evento onclick (en clic). Otra definicin de
funcin, llamada btn_onclick( ),es insertada. El Script Editor tambin modifica el HTML que crea el
botn de OK, de tal forma que esta funcin es llamada cuando el evento es mencionado. Deslcese
hacia la parte inferior del HTML para buscar el rtulo <input> (entrada) para el botn OK para
visualizar, si est interesado, lo que ha sido insertado.

Cuando el botn es presionado, el script debe guardar la informacin de string y/o punto, la
procesa usando CONPOL y otros comandos, luego re carga el polgono resultante de regreso en la
ventana Design. Este cdigo es bastante claro, pero significativamente extenso. Es mostrado en la
caja debajo. Ingrese los argumentos JavaScript en el interior del cuerpo de la funcin
btnOK_onclick ( ), usando Copiar y Pegar como HTML (Paste as HTML) en el caso que est
leyendo esto en lnea. De otro modo, asegrese de escribir el cdigo de la misma forma como se
muestra.


35

Despus de haber aadido el script a su documento HTML, gurdelo, y cierre la ventana del Script
Editor. La ventana FrontPage reaparecer, pero ahora su script est incluida en ella. Seleccione el
tab HTML y dirjase hacia la parte superior para chequear esto.

Que es lo que hace el script?

El script de operador de evento btnOK_onclic ( ) crea y usa varios archivos temporales, todos con
el nombre _tmp00n, los cuales son eliminados al principio y al final del script.


36
Si la caja de chequeo Include point data (Incluye informacin de punto) es activada, el script
escribe toda la informacin de punto en un archivo, usando el filtro especificado en la caja de texto
Filter (filtro), en el caso que halla alguno. Este archivo es posteriormente procesado por EXTRA
para remover todos los campos sin considerar XP e YP.

Si la caja de chequeo Include string data (Incluye informacin de string) es activada, el script
escribe toda la informacin de string en un archivo, de la misma forma usando cualquier filtro
especificado y usa EXTRA para remover y renombrar campos. Si ambas cajas de texto estuvieran
activas, se adjunta toda la data en un solo archivo.

Posteriormente, el script corre CONPOL. Note como el comando bsico es asignado a una variable
JavaScript, y si es apropiado el valor para el parmetro EXTDIS, este es aadido.

CONPOL no cierra el polgono resultante. Sin embargo el script usa PROPER para cerrarlo antes
de recargar el polgono en la ventana Design.

Finalmente, el script elimina todos los archivos temporales creados durante la ejecucin.


37
Corriendo el Script

Asegrese que ha guardo el script completo. Si quiere usar una versin de referencia entonces
tome una copia de en su base de datos Tutorial.

Puede correr el script en una de estas dos formas: primero, puede ir a Datamine Studio y
seleccionar Tools / Run Script y especificar el nombre del archivo HTML que ha sido creado. Esto
es como generalmente correra, y esta es la nica forma en la que puede chequear que la interfaz
HTML luzca correctamente dentro de Datamine Studio. Pero para una vista rpida, existe otra
forma de correr el script ... simplemente seleccionando el tab Preview (Vista Previa) en FrontPage.
Esta es una forma conveniente de chequear que todo est trabajando en la manera que usted
espera, sin tener que recordar guardar el archivo, vaya a Datamine Studio y recargue el archivo
cada vez que ocasione un cambio.
Si est corriendo su script desde el panel Preview de FrontPage, recuerde que debe
tener a Datamine Studio corriendo.

Depurando su script
Depurando con alert ( )

Microsoft le proporciona un nmero de entornos de depuracin sofisticados, que son de lejos la
mejor forma de entender en que parte un script no est yendo correctamente. Pero para este
ejemplo, la ms simple ayuda de depuracin es la llamada alert ( ) de JavaScript. Usando alert( )
puede mostrar mensajes y valores de variables en una caja de mensaje pop up, la cual es creada
en algn momento durante la ejecucin de su script. Por ejemplo, para chequear el valor de la caja
de texto Filter antes de intentar usarla, puede agregar el siguiente argumento ya sea al principio del
procedimiento createPolygon, o dentro del operador de evento btnOK onClick.

Cuando es ejecutado, el argumento produce una caja de mensaje similar a la siguiente:


38

Depurando con Microsoft Script Editor

Una discusin completa de cmo usar el Microsoft Script Editor para depurar est fuera de los
propsitos de este tutorial. Para mayores detalles, dirjase al Asistente de Ayuda en lnea.

Sin embargo, para darle un resumen de lo que es posible, investiguemos algunas de las
caractersticas disponibles. Primero, active el Script Editor desde FrontPage, seleccionando Tools/
Macro / Microsoft Script Editor...

Parea comenzar a depurar, seleccione Debug / Start en el editor de script. Esto hace que el editor
de script se reconfigure por si mismo, y que inicie una ventana de Internet Explorer que contiene su
HTML y script.

Puede volver al editor de script en cualquier momento, e insertar un breakpoint (punto de quiebre)
en una lnea particular. Para insertar un breakpoint, haga clic en el margen gris de la mano
izquierda adyacente a la lnea en donde requiera que la ejecucin sea interrumpida. Por ejemplo,
para interrumpir en la primera lnea del operador de evento btnOK on click( ), el editor de script se
debera ver como el siguiente:

Cuando la ejecucin de script alcanza el breakpoint, la ejecucin se detiene y el control retorna al
editor de script. Luego, puede visualizar los valores de las variables, dar pasos simples a travs del

39
script, incluso cambiar el flujo de ejecucin y los valores de las variables. Ms detalles son
proporcionados en el Ayudante en lnea de Script Editor.

Para finalizar la depuracin, seleccione Debug / Detach All processes del men Script Editor.

Sugerencias para extensiones adicionales

Este ejemplo trabajado est diseado para ser una leccin instructiva. El script resultante tiene un
nmero de limitaciones. Usted querr tratar alguna de las siguientes mejoras por si mismo:

Use filtros separados para puntos y strings
Permita al usuario especificar un valor para el parmetro @MAXLEN en CONPOL
Realce el script de modo que trabaje en cualquier plano ortogonal (consejo: use botones
de radio)
Realce el script de modo que trabaje en cualquier plano ( hard )

Siguiente Leccin: Script de ejemplo para Explorar y Copiar


40

Introduccin al Explorador y Copiar

En esta leccin introduciremos el explorador de Archivo de Proyecto (Project File)

El explorador es la interfaz grfica en su proyecto Datamine Studio. Es un control Active X, lo que
significa que es un componente de software, el cual puede ser adjuntado ya sea a Datamine
Studio, o independientemente a un script que usted cree.

Esta leccin crea un script para copiar un archivo con criterio de recuperacin opcional. Usa el
explorador del Archivo de Proyecto a travs del SLC (Datamine Studio Script Library Component).
Obviamente, este ejemplo puede fcilmente ser extendido para llevar acabo cualquier proceso de
archivo durante el curso, o por ejemplo crear un script que lea archivos de entrada mltiples y que
cree uno o ms archivos de salida.


41
Comenzando

Inicie Datamine Studio. Como en todas estas lecciones, debe comenzar a correr Datamine Studio,
y dejarlo corriendo de modo que pueda responder cuando sea requerido.

Inicie FrontPage 2000. Asegrese que sta sea la versin correcta y que est configurada
correctamente como se describi en una leccin previa. Tambin estar usando Microsoft Script
Editor.
Creando la Interfaz

Vamos a crear una interfaz con tres cajas de texto y tres botones de pulso.

Cree una tabla que contenga los objetos de interfaz

Como en las lecciones previas, crearemos una tabla que contenta las cajas de texto, botones de
pulso y texto asociado. En FrontPage elija el tab Normal y luego seleccione el men desplegable
Table / Insert / Table... y especifique una tabla con cinco filas y tres columnas. No se preocupe por
el diseo o parmetros de estilo. Trataremos esto ms tarde.

Agregue texto y cajas de texto

En la celda de la parte superior izquierda (donde el cursor se posicion en un inicio), escriba Copy
a File (Copiar un archivo). Si lo desea puede resaltar el texto y seleccionar Negrita de la barra de
herramientas. Luego seleccione Insert / Horizontal Line del men Front Page.

Ahora queremos combinar las celdas juntas en la fila superior, y escribir Input file (Archivo de
entrada). Luego, presione el botn de la flecha hacia abajo para moverse a la tercera fila, columna

42
de la mano izquierda y escriba Output File (Archivo de Salida). Presione la flecha hacia abajo
nuevamente (en la tercera fila) y escriba Retrieval Criteria (Criterio de Recuperacin).

Ahora agregaremos las dos cajas de texto que contengan os nombres de los archivos de entrada y
salida. Posicione su cursor en la segunda fila, columna del medio, y seleccione Insert / Form /
One Line Text Box o . Front page insertar la caja de texto. Ahora inserte otra caja de texto
en la celda debajo, al lado de la etiqueta Output fi le (Archivo de Salida).
Finalmente, inserte otra caja de texto en la cuarta fila, columna del medio. Aqu es en donde
ingresar el criterio de recuperacin.

Agregue botones de Exploracin

Ahora agregue botones de pulso en la columna de la mano derecha en las filas dos y tres. Por
ahora no se preocupe por las etiquetas de botn (dirn Botn por defecto); arreglaremos esto ms
tarde. Finalmente, agregue otro botn en la celda del medio de la ltima fila.

Ahora haga clic derecho en la tabla, seleccione Table Properties... y fije el tamao del borde en
cero. Luego seleccione la celda del medio en la fila inferior, haga clic derecho, seleccione Cell
Properties...y fije la alineacin horizontal de celda a Center (Centro). Haga lo mismo para la
celda en la primera fila.

Asigne nombres y valores a los controles

Ahora necesitamos asignar nombres a cada uno de los controles, y cambiar las etiquetas de botn.
Asignaremos nombres individuales de modo que podamos referirnos a cada control en la script.

Para asignar un nombre a un control, seleccinelo con el mouse y muestre el dialogo Properties
(presione Alt+Enter, o haga clic derecho y seleccione Form Field Properties... o haga doble clic).
Asigne el nombre tbInputFile a la primera caja de texto, tbOutputFile a las segunda y tbRetrieval a
la tercera caja de texto.

Luego, asigne los nombres btnBrowse1 y btnBrowse2 a los primeros dos botones, y cambie la
etiqueta de cada uno a Browse.... Finalmente, asigne el nombre btnOK al botn en la fila inferior,
y cambie su etiqueta a OK. Si pone dos espacios en algn lado del texto ( OK ) el botn ser
ms ancho. La interfaz deber verse como esta:


43

Enlace a la hoja de estilo estndar de Datamine Studio

Deber hacer un enlace a la hoja de estilo estndar de Datamine Studio, dmstyle.css, para mejorar
la integracin visual del script. Ya debe haber creado el archivo dmstyle.css como se describi en
una leccin previa.

Para hacer un enlace a la hoja de estilo, seleccione Format / Style Sheet Links... presione Add
(Agregar), luego use el explorador para seleccionar la hoja de estilo Datamine dmstyle.css.

Ahora, haga clic en el tab preview, para visualizar como luce la interfaz completada:


44
Otorgue a la pgina un ttulo y gurdela.

La interfaz ahora est casi completa. Debe proporcionar un nombre a la pgina HTML (haga clic
derecho, seleccione Page Properties... e ingrese un ttulo como Ejemplo de Explorador), y
guardar la pgina en el directorio de proyecto Tutorial, con el nombre copyfile1.htm.


45

Agregando el Script

El primer paso, hacer la interfaz HTML, ha sido completado. Ahora necesitamos mejorarlo y
agregar el script que har que las piezas trabajen.

Recuerde que los scripts son usualmente creados de un nmero de operadores de evento. Estos
son pequeas secciones de script ejecutadas cuando un evento relevante ocurre. Este script
responde a los siguientes eventos.

Cuando la ventana carga (una ventana de evento onload), el script hace su conexin al
SLC (Datamine Script Library Component).
Cuando cualquiera de los botones del explorador es presionado ( un botn de evento
onclick) el script ejecuta una llamada al SLC, el cual muestra el explorador de base de
datos, espera por una seleccin y copia el nombre de cualquier tabla seleccionada dentro
de la caja de texto correspondiente.
Cuando el botn OK es presionado (otro evento onclick), un script chequea ambos
archivos que han sido especificados, agrega cualquier criterio de recuperacin que haya
sido especificado, luego ejecuta el comando Datamine Studio para copiar el archivo,
nuevamente via el SLC.
El evento onload (en carga) de ventana

Como en las lecciones previas, el script es ingresado, editado y depurado usando el editor
Microsoft Script. Del Tab Normal de la vista de Pgina en FrontPage, seleccione Tools / Macro /
Microsoft Script Editor o .
Configure el Script Editor para usar JavaScript: seleccione View / Property Pages, o haga clic en
el panel HTML y presione Shift + F4. Fije el lenguaje de scripting Predeterminado para scripts de
Cliente de modo que sea JavaScript, y presione OK.

Ahora, del men, seleccione View / Other Windows / Script
Outline. En esta ventana, seleccione Client Objects & Event.
Ahora visualizar una lista de los objetos que usted ha agregado
en su interfaz.

Haga doble clic en Windows y doble clic en el evento onload; el
evento que se anuncia como su documento es cargado en el

46
explorador. El Script Editor inserta el HTML necesario para contener su script, y define una funcin
window_onload.

Recuerde que si el encabezado dice Sub window_onload( ), es porque Front Page est
configurado para usar VBScript. Haga clic en el panel HTML, y presione Shift+F4 y cambie esto
antes de proceder.

Cuando la ventan se carga, necesitamos establecer una conexin entre el script y el SLC e
inicializarla. Esto se hace con el siguiente argumento JavaScript:

Puede ingresar el cdigo directamente o resaltar el texto de arriba y seleccionar Copy (Copiar) del
men del clic derecho. Luego mueva la ventana Script Editor y haga clic con el cursor en la lnea
en blanco entre las lneas function window_onload( ) {and}. Del men del clic derecho seleccione
Paste as HTML ( Pegue como HTML) .

El evento onunload de ventana

Luego, cree un operador de evento onunload, e inserte la siguiente lnea de cdigo dentro de l:

Esto descarga correctamente el SLC y libera cualquier memoria almacenada por si mismo,
mientras que la ventana es descargada (ej: cuando es reemplazado por otra pgina HTML)

El operador onclick del botn OK

Ahora, haga doble clic en btnOK, y doble clic en el evento onclick . Otra definicin de funcin,
llamada btnOK_onclick ( ), es insertada.

Cuando el botn es presionado, el script debe chequear que ambos nombres de archivo de
entrada y salida hayan sido especificados, si es as, ejecuta el comando para copiar el archivo,
opcionalmente con los contenidos de la caja de texto criterio de recuperacin.


47
Ingrese los argumentos de Java Script dentro del cuerpo de la funcin btnOK_onclick ( ), usando
Copy (Copiar) y Paste as HTML (Pegar como HTML), si est leyendo esto en lnea. De otro modo,
asegrese de escribir este cdigo exactamente como se muestra:

El valor de cada caja de texto ( ej: la propiedad value de cada caja de texto) es chequeado para
ver si hay una string de carcter vaca. Si alguna se est olvidando, la script no har nada.

En otro caso, un comando Datamine Studio es construido por la concatenacin de cuatro sub
strings (dos bits fijados, adems de los valores contenidos en ambas cajas de texto). Luego, si
alguno ha sido ingresado dentro de la caja de texto de Criterio de Recuperacin, este es aadido al
final del comando a ser ejecutado entre un par de corchetes ({ and}).

Finalmente, el comando construido es trasladado al SLC, y desde aqu a Datamine Studio para su
ejecucin.
Los botones de exploracin

Cada uno de estos botones de exploracin deben manejar ms o menos la misma funcin: agregar
o actualizar el valor en una de las cajas de texto. El SLC contiene una funcin especfica para
lograr esto:
Primero, agregue un operador onclick para el primer botn de exploracin, e inserte el siguiente
cdigo:

El mtodo browseForFile usa el explorador de Datamine Studio para requerir un archivo Datamine.
El nombre de este archivo es devuelto, y su nombre es insertado dentro de la propiedad .value de
la caja de texto tbInputFile.


48
El primer argumento especifica la clase de archivo que puede ser seleccionado. El SLC le permite
seleccionar entre todos los tipos disponibles: dmlib.typeAny permitir al usuario escoger cualquier
clase de archivo. Alternativamente, dmlib.typeModel fuerza al usuario a seleccionar un archivo de
modelo de bloque.
Si requiere permitir al usuario seleccionar ms de un tipo de archivo, puede agregar diferentes
tipos de valores conjuntamente. Para encontrar el valor de tipo para cualquier categora dirjase a
, seleccione el tipo de archivo apropiado de la caja desplegable Properties. El valor
de tipo es mostrado en la caja Value.

El segundo argumento especifica un valor predeterminado para el nombre de la tabla, y el tercer
argumento (el cual pude ser true (verdadero) o false (falso) especifica si el nombre de una tabla
nueva puede ser ingresado. Si est fijado en false, entonces una tabla del archivo de proyecto
existente debe ser seleccionada.

Finalmente, agregue un operador onclick para el segundo botn de exploracin, con el siguiente
cdigo:

Luego que haya agregado el script en su documento HTML, gurdelo, y cierre la ventan del Script
Editor. La ventana FrontPage reaparecer, pero ahora se le ha aadido su script. Seleccione el tab
HTML y deslcese a la parte superior para chequear esto.


49
Corriendo el Script

Asegrese que ha guardo el script completo. Si quiere usar una versin de referencia entonces
tome una copia de en su base de datos Tutorial.

Puede correr el script en una de estas dos formas: primero, puede ir a Datamine Studio y
seleccionar Tools / Run Script y especificar el nombre del archivo HTML que ha sido creado. Esto
es como generalmente correra, y esta es la nica forma en la que puede chequear que la interfaz
HTML luzca correctamente dentro de Datamine Studio. Pero para una vista rpida, existe ot ra
forma de correr el script, simplemente seleccionando el tab Preview (Vista Previa) en FrontPage.
Esta es una forma conveniente de chequear que todo est trabajando en la manera que usted
espera, sin tener que recordar guardar el archivo, vaya a Datamine Studio y recargue el archivo
cada vez que ocasione un cambio.

Si est corriendo su script desde el panel Preview de FrontPage, recuerde que debe tener a
Datamine Studio corriendo.

Depurando su script

Use los mtodos descritos en lecciones previas para depurar su script.


50
Sugerencias para prximas extensiones

El objetivo de esta leccin ha sido el de aprender a disear la interfaz y fijar los operarios de
eventos. Sin embargo el script resultante tiene un nmero de limitaciones. Puede intentar las
siguientes mejoras por su cuenta.

Copie un campo simple

Esto convierte el comando copiar de Datamine en una copia selectiva, o selcop. Primero,
necesitar insertar una fila adicional a la tabla HTML, y agregarle un elemento SELECT (Instert /
Form /Drop Down Menu o ). Nombre el elemento como selFields. Con el objetivo de
especificar el ancho del objeto SELECT (que inicialmente est vaco), necesitar usar la barra de
herramientas Positioning (View/Toolbars/Positioning en el men). Sombree el objeto SELECT,
e ingrese un ancho de 115 pxeles en la caja Width: (ancho) de la barra de herramientas
Positioning.

La interfaz del usuario deber lucir como esta:

Con el objetivo de rellenar la lista con los nombres de los campos en el archivo de entrada, use
el mtodo SLC makeFieldsPicklist( ) dentro del operario de evento onclick para btnBrowse1. El
cdigo de operario de evento en su integridad deber lucir como este:


51

makeFieldsPicklist( ) toma dos argumentos : el nombre de la tabla de archivo, y el nombre de
la lista seleccionada en donde los nombres estn para ser aadidos. Es posible aadir un tercer
argumento, opcional para este mtodo, el cual da el valor predeterminado a ser mostrado. El valor
predeterminado no necesita necesariamente ser el nombre del campo en el archivo.

Finalmente, necesitaremos modificar el operario onclick para el botn OK, btnOK. El
comando copy (copiar) se convierte en selcop (copia selecta), y necesitamos aadir el nombre
del archivo seleccionado al comando. El nuevo cdigo luce como este:

La versin de referencia de puede ser visualizada y guardada en su base
de datos de proyecto Tutorial.
Copiando campos mltiples

Los cambios a la Interfaz del Usuario son fciles: en el dialogo Properties para el elemento
SELECT, fije la altura (Height) a 4 lneas, y chequee el botn de radio Allow multiple selections
(Permitir selecciones mltiples ). La Interfaz del Usuario deber lucir como esta:


52

No se necesitan cambios en el script, aparte de aadir un cdigo para extraer el valor de los
tems seleccionados en el objeto SELECT. Esto se hace posible haciendo ms cambios en el
operador onclick para btnOK.

La codificacin requiere una comprensin ms detallada de JavaScript y los trabajos del objeto
SELECT por si mismo. El cdigo completo para la versin final del operador onclick est aqu:


53

La versin de referencia de puede ser visualizada y guardada en su base
de datos de proyecto Tutorial.

Siguiente Leccin: Script de Ejemplo para Correr una Macro


54
Introduccin para Correr una Macro desde un Script

Tal vez ya tiene macros que usted usa para correr secuencias de comandos Datamine. El ingreso
de estas macros ocurre usualmente a travs de los comandos PROMPT o SCREEN. Sin embargo
como ya se habr dado cuenta la interfaz HTML le proporciona un mtodo ms atractivo, fcil de
uso y comprensivo para el ingreso de archivos, campos, parmetros y otras variables funcionales.
La buena noticia es que para sacar ventaja de la interfaz HTML no tiene que convertir su macro en
un script. Puede simplemente fijar la interfaz en HTML y trasladar los valores de las variables a su
macro. Por lo tanto los nicos cambios que necesita para hacer a su macro son el de remover los
comandos PROMPT y SCREEN y en vez de ellos colocar la macro de modo que pueda leer los
valores de variable que ha ingresado a travs de la interfaz HTML. Al final de la macro puede
trasladar los valores de las variables de regreso al script.

El script usa el archivo var para transferir variables y sus valores entre el script y la macro. Este
es el archivo ya usado por los comandos de macro VARLOAD y VARSAVE para guardar
informacin entre las sesiones Datamine. Es tambin el archivo usado por versiones anteriores a
estos comandos, STKPAR y STKSAV. Los mtodos VARLOAD( ) y VARSAVE( ) proveen las
funciones equivalentes en programacin y son incluidas como parte del SLC (Script Library
Component, Componente de Librera de Script). Tambin existe el mtodo runMacro( ) en la
biblioteca para facilitar la corrida de una macro desde un script. El siguiente ejemplo usar todos
los tres mtodos.

VARLOAD( )

Variables de sustitucin de un archivo

Las variables ledas desde un archivo son aadidas a la lista actual si el parmetro MERGE es
igual a 1, de otro modo cualquier otra variable actual ser borrada. VARLOAD cargar (por
defecto) todas las variables de sustitucin, pero permitir solo a un juego de variables nominados
ser cargados y fusionados desde el archivo.

Apuntes:
El formato: !VARLOAD <file>[,MERGE=<merge>] [,DESC=$dname#][ ,$name# ...]
<file> es el nombre de ruta de archivo de sistema de hasta 56 caracteres de longitud. Si el
parmetro MERGE no es especificado, o si <merge> es 1, cualquier variable que actualmente
exista en la memoria es actualizada con el valor de archivo, y nuevas variables son aadidas a
este en la memoria. Tanto <file> y <merge> pueden ser variables sustitutas. La descripcin
entregada cuando el archivo fue creado puede ser reemplazada opcionalmente por una variable de

55
almacenaje <$dname>. Si la lista de variables opcional es presentada, solo estas variables son
consideradas, de otro modo todas las variables seran cargadas. Esta lista se puede extender en
tantas lneas como seas necesario; la continuacin es posible finalizando la lnea anterior con una
coma.

Por ejemplo: !varload \datamine\projects\$proj, merge=1 , $title1#, $title2#, $xmin#, $xmax#,
$ymin#, $ymax#

VARSAVE( )

Guarda o fusiona variables sustitutas en un archivo. VARSAVE guardar (por defecto) todas las
variables sustitutas, pero solo permitir solo a un juego de variables nominadas ser guardadas o
fusionadas en el archivo.

Apuntes:

El formato: !VARSAVE <file>[,MERGE=<merge>] [,DESC=<description>][ ,$name# ...]
<file> es el nombre de ruta de archivo de sistema de hasta 56 caracteres de longitud. Si el
parmetro MERGE no es especificado, o si <merge> es 0, todo el contenido es borrado primero.
Si <merge> es 1, cualquier variable que actualmente exista en la memoria es actualizada con el
valor de macro actual, y nuevas variables son aadidas a estas en la memoria. Tanto <file> y
<merge> pueden ser variables sustitutas. Una descripcin para el contenido del archivo puede ser
suministrada. La descripcin es suministrada en la primera lnea del registro del archivo con el
nmero de revisin, y puede ser de hasta 68 caracteres de longitud. Las comillas pueden ser
usadas para encerrar una descripcin. Si la lista de variables opcional es presentada, solo estas
variables son consideradas, de otro modo todas las variables seran guardadas. Esta lista se
puede extender en tantas lneas como seas necesario; la continuacin es posible finalizando la
lnea anterior con una coma.

Por ej emplo: !varsave \ datamine\projects\$proj, merge=1 , $title1#, $title2#, $xmin#, $xmax#,
$ymin#, $ymax#


56
Macro de Ejemplo Usando XRUN

Para este ejercicio aadiremos una interfaz HTML a una macro que crea un plan de locacin de
collar. La macro usa las tcnicas estndar para fijar valores predeterminados y de requerimiento.
Los pasos principales son:
Definir los valores predeterminados para variables de sustitucin
Probar si el archivo var existe, y si es as, cambiar los defaults iniciales por los valores guardados.
Usar PROMPT para definir los valores actuales, con defaults como fueron definidos en pasos
previos.
Crear y mostrar el archivo de grfica
Guardar las variables de sustitucin

Examine el macro

Usted ver que las cinco variables de sustitucin que son requeridas para usar el comando
PROMPT son:

$COLLFILE# - el archivo collar de entrada
$PLOTFILE# - el archivo de grfica de salida
$VALUE# - el campo a ser inscrito
$TITLE# - el ttulo de grfica
$NUMBER# - el nmero de referencia de grfica

Removeremos estos requerimientos de la macro y crearemos una script con la interfaz HTML de
modo que corra con la macro.

Guarde una copia de la macro colalr1a.mac como archivo collar1.mac en su directorio de proyecto
Tutorial. Luego corra la macro tomando todos los valores predeterminados de los requerimientos.
La macro crear y mostrar una grfica de locacin de collar:


57

El texto en su ventana Output (de salida) deber comenzar as:

Note que los valores de las cinco variables de sustitucin estn mostrados. Despus que la grfica
ha sido creada la variable $NUMBER# es incrementada en 1, y las variables son guardadas en el
archivo var collplot.var. Los nuevos valores son mostrados en la ventana Output (de salida):


58

La principal razn para incrementar el valor de $NUMBER# es la de demostrar como un nuevo
valor puede ser trasladado de una macro a un script.


59
Creando la Interfaz

Ahora usaremos FronPage para crear una interfaz y para ingresar cinco variables de sustitucin
requeridas para correr la macro. Inicie un nuevo archivo (File/ New /Page / Normal Page o ) e
inserte una tabla de 7 filas y 3 columnas para crear una interfaz como la mostrada en el diagrama.
Los mtodos usados para la fijacin de una interfaz son descritos en las lecciones previas.

La caja de entrada Field to annotate (Campo a ser inscrito) es un men desplegable. Este
contendr una lista de todos los nombres en el archivo Input Collars.

Para ajustar el ancho de la caja de men desplegable (Field to annotate) necesitar usar la barra
de herramientas Positioning. La puede mostrar seleccionando View / Toolbars y chequeando el
item Positioning. Un ancho de aproximadamente 150 ser suficiente.

Por defecto, los valores ingresados en las cajas de texto son alineados a la izquierda. Esto es
apropiado para valores alfanumricos pero tal vez prefiere valores numricos alineados a la
derecha. Para hacer esto, haga doble clic en la caja de texto Plot Number para mostrar el dialogo
Text Box Properties (Propiedades de Caja de Texto) y seleccione Style / Format / Paragraph
/Alignment: Right

Asigne Nombres y Valores a los Controles

Asigne nombres a las cajas de texto, botones y listas desplegables como sigue:

DESCRIPCIN TIPO NOMBRE
Input collars file name / Ingresa un archivo de collar Caja de Texto tbIN1
Browse for collars file / Explora por un nombre de Botn a pulso btnBrowseIN1

60
archivo de collar
Field to annotate/ Campo a ser inscrito Desplegable ddFieldsIN1
Output plot file name / Salida de nombre de archivo
de grfica
Caja de Texto tbOUT1
Browse for output file / Busca por un archivo de salida Botn a pulso btnBrowseOUT1
Plot title / Ttulo de Grfica Caja de Texto tbPlotTitle
Plot number / Nmero de Grfica Caja de Texto tbPlotNumber
Creat Plot / Crea grficos Botn a Pulso btnCreatePlot
Load defaults / Carga defaults Botn a Pulso btnLoad

Puede usar Format /Style Sheet Li nks... para hacer un vnculo a la hoja de estilo de Datamine
Studio dmstyle.css. Guarde el archivo en su directorio Tutorial como collar_plot_1.htm.


61

Agregando el Script

Eventos a ser definidos

La columna 4 de la siguiente tabla muestra los eventos que necesitamos asociar con las cajas de
texto y botones. Ms detalles se proporcionan en las secciones de abajo:

DESCRIPCIN TIPO NOMBRE Evento
Input collars file name / Ingresa
un archivo de collar
Caja de Texto tbIN1 Onpropertychange
Browse for collars file / Explora
por un nombre de archivo de
collar
Botn a pulso btnBrowseIN1 onclick
Field to annotate/ Campo a ser
inscrito
Desplegable ddFieldsIN1
Output plot file name / Salida de
nombre de archivo de grfica
Caja de Texto tbOUT1
Browse for output file / Busca por
un archivo de salida
Botn a pulso btnBrowseOUT1
Plot title / Ttulo de Grfica Caja de Texto tbPlotTitle
Plot number / Nmero de Grfica Caja de Texto tbPlotNumber Onclick
Creat Plot / Crea grficos Botn a Pulso btnCreatePlot Onclick
Load defaults / Carga defaults Botn a Pulso btnLoad Onclick

Mtodos de Componente de Librera Script

Los operadores de eventos que estamos a punto de crear usan los mtodos y propiedades de
librera resumidos en la tabla. Ms detalles son proporcionados en la seccin relevante debajo

tipo Nombre DESCRIPCIN
Mtodo makeFieldsPicklist( ) Llena una lista seleccionada con los nombres de los
campos en un archivo Datamine
Mtodo browseForFile( ) Explora una tabla de archivo en un proyecto actual
Datamine Studio
Mtodo runMacro ( ) Ejecuta una macro Datamine, luego vuelve al script
Mtodo varsave ( ) Guarda valores a ser usados como variables

62
sustitutas en una macro
Mtodo vrload ( ) Carga valores de un archivo de macro !VARLOAD
Mtodo initialize ( ) Inicializa el Componente de Biblioteca de Scrip
Datamine Studio SLC
propiedad typeCollars Escribe un cdigo para el archivo Collars de
Datamine Studio
propiedad typePlot Escribe un cdigo para el archivo de Grfica de
Datamine Studio
propiedad proj ectFolder La carpeta que contiene la carpeta actual del
proyecto Datamine Studio

Microsoft Script Editor

Abra el editor Microsoft Script Editor (Tools/Microsoft Script Editor o ) y asegrese que est
creando JavaScript no VBScript. (View/ Property Pages/ General / Default scripting language/
Client: JavaScript).

Para mostrar la lista de objetos que estn incluidos en la interfaz
HTML seleccione View/ Other Windows / Script Outline.


63
tblN1 Entrada de Caja de Texto de Archivo Collars

Haga doble clic en el item tbIN1 en el men Script Outline (contorno de script), o un clic simple en
el carcter +, para mostrar la lista de eventos y seleccione el evento onpropertychange. Esta
eleccin es preferible que el evento onchange puesto que el evento onchange solo es activado si el
valor en la caja de texto es cambiado manualmente escribiendo directamente dentro de la caja
de texto. El evento onchange no es activado si el valor es cambiado de forma programada va el
explorador. El evento onpropertychange es activado cada vez que cualquier propiedad (en este
caso la propiedad value) cambia, por cualquier razn.

El script que corre cuando el nombre del archivo de entrada cambia usa el mtodo
makeFieldsPicklist ( ) para crear la lista de nombres de campo que se muestra debajo:

El primer argumento es el de value (valor), el segundo argumento es el nombre de lista
desplegable, y el tercero es el valor default.

Copie el JavaScript de la caja de arriba (sin incluir la primera y ltima
lnea) y cpielo dentro del script en la ventana del editor Microsoft Script
Editor (MSE). Cuando lo pegue en la ventana MSE debe usar la opcin
Paste as HTML (Pegar como HTML), el cual obtiene del men haciendo
clic derecho.

btnBroseIN1 Entrada al Botn del Explorador del Archivo Collars

Agregue un evento onclick para el ingreso del botn del explorador del archivo collars
btnBrowseIN1. Esto traer al frente al explorador del archivo:


64

Los argumenos del mtodo browseForFile ( ) son:

1. Tipo de archivo requerido : un archivo collars
2. Nombre de archivo predeterminado: ingrese un valor nulo para no default. Note que el
nombre predeterminado solo va a estar mostrado en el dialogo Browser, y no va a estar
mostrado en la caja de texto tbIN1
3. Habilite un nuevo archivo a ser especificado (verdadero, true, false, falso)?: en este
ejemplo necesitamos false (falso) porque el archivo ya existe.

Copie el JavaScript y pguelo en el script.

BtnBrowseOUt1 - Salida del Botn de Exploracin del Archivo de Grfico a

Agregue un evento onclick para la salida del botn de exploracin del archivo de grfica
btnBrowseOUT1. Esto traer al frente al explorador del archivo.

Note que en este caso el tercer argumento de brosweForFile ( ) es verdadero (true) queremos
habilitar un nuevo archivo para ser especificado. Copie el JavaScript y peguelo dentro del Script.

BtnCreatePlot Cree un Botn de Grfica

Agregue un evento onclick para la creacin de botn de grfica btnCreatePlot

Este evento usa el mtodo varsave( ) para guardar los valores de variables en el archivo var. Los
argumentos de varsave( ) son:

65
1. El nombre (path, trayecto) del archivo var a ser guardado
2. Fusionar (true, verdadero) o sobreescribir el archivo var (false, falso)

El evento tambin usa el mtodo runMacro( ) para correr una macro. Los argumentos de
runMacro( ) son:
1. El nombre del archivo macro
2. El nombre de la macro en el archivo macro

Copie el JavaScript y pguelo dentro del script.

BtnLoad - Cargue Botones Predeterminados

Agregue un evento onclick para la carga de botones predeterminados btnLoad

Este evento usa el mtodo varload( ) para cargar los valores de variables desde el archivo var. El
argumento de varload( ) es:

1. El nombre del archivo a ser cargado.

Copie el JavaScript y pguelo dentro de su script.

Evento onload (en carga) en Ventana

Agregue un evento de ventana onload . Este evento se emite tan pronto como todo en una pgina
ha finalizado su carga, y pueda por lo tanto ser usado para su inicializacin. Cuatro tareas de
inicializacin necesitan ser llevadas acabo para habilitar la corrida del script correctamente.

1. Definir el nombre del archivo var para transferir variables entre el script y la macro. El
trayecto es descrito creando una string de texto combinando la propiedad proyectFolder y
el nombre de archivo como fue definido por la variable collplot.var. Note que es requerido
en frente del nombre de archivo, porque una simple est reservada par caracteres

66
2. Defina los objetos (variables) cuyos valores estn por ser guardados en archivos var.
Hacemos esto aadiendo una propiedad .macro a estos objetos. Existen formas
alternativas de definir los valores como veremos en ejercicios prximos.
3. Fije valores iniciales (ej. Defaults) para las cajas de texto. Los valores predeterminados
pueden tambin ser fijados usando Format / Properties en FrontPage e ingresando el
default en la caja de entrada de la etiqueta Value (Valor).
4. Fije el valor inicial para esta lista de campos. Esto es requerido porque hemos definido un
nombre de archivo predeterminado (_collars). Si omitimos este item, entonces la lista no
estar llenada hasta que la propiedad value de la caja de texto tbIN1 haya cambiado.

Copie el JavaScript y pguelo dentro de su script

Haciendo una conexin con el SLC

Los eventos que hemos definido hasta ahora usan mtodos como el SLC (Script Component
Library) y nos hemos referido a estos usando el objeto dm. Por ejemplo dm. Varsave( ) y
dm.browseForFile( ) . Antes que estos eventos puedan ser usados necesitamos establecer la
conexin entre el script y el SLC e inicializarla, la que puede ser resuelta en la ventana de evento
onload. . Sin embargo para hacer esto desde la ventana de evento onload necesitaremos definir

67
dm como una variable global. Esto no es una prctica recomendad puesto que la variable podra
ser usada en cualquier otra parte en la biblioteca para cualquier propsito. Por lo tanto definimos
dm para ser local a nuestro script poniendo la definicin al principio de la seccin de JavaScript del
documento como se ve en el siguiente ejemplo

Copie el JavaScript y pguelo dentro de su script

Evento onunload (en descarga) en ventana

Es buena prctica la de aadir una ventana de evento onunload. Esto descarga el SLC y despeja
cualquier memoria que fue asignada cuando la pgina fue cargada.

El Script Completo

Un ejemplo de script completo es mostrado aqu . Si quiere usar la
versin de referencia, entonces abra el archivo haciendo clic en el botn y use File / Save As para
guardarlo en su directorio de proyecto Tutorial.


68
Corriendo el Script

Usted debe de tener el archivo collar_plot_1.htm en su directorio de proyecto Tutorial.

Edite la Macro

Antes de que pueda correr el script necesitar editar la macro y remover los argumentos del
!PROMPT. El mtodo runMacro ( ) que ha especificado en collar_plot_1.htm llama al archivo macro
collplot1b.mac. Por lo tanto copie collplot1a.mac a collplot1b.mac y remueva los argumentos
!PROMTP. Puede tambin remover el cdigo inicial en la macro el cual fija los valores por defecto
para las variables de sustitucin de la misma forma que todos los valores son fijados en el script.
Alternativamente, abra la versin de referencia del macro en Notepad (bloc de notas) haciendo clic
en el botn y use File/ Save As para guardarla en el directorio de proyecto
Tutorial.

Corra la Script

Corra Datamine Studio y seleccione
Tools /Run Script de la barra de Men
Principal. Todos los defaults son fijados
de modo que todo lo que necesita hacer
es hacer clic en el botn Create Plot
(Crear Grafica)

Cuando el script haya corrido haga clic
en el botn Load Defaults (Cargue
Defaults). Esto cargar las variables del
archivo var que fue creado por la
macro. Note que el nmero de plot ha
cambiado de 1 a 2.

Validacin

No hemos incluido alguna validacin en los valores que han sido ingresados en la interfaz de
script. Valores nulos o inapropiados pueden causar problemas cuando la macro est corriendo.
La validacin puede ser realizada usando JavaScript, pero no es parte de este ejercicio.

Siguiente Leccin: Otros Ejemplos


69

Introduccin a Ejemplos de Scripts

Una de las mejores formas de aprender a escribir su propia script es observando los ejemplos.
Estas secciones contienen varios scripts las cuales ilustran diferentes caractersticas del lenguaje
scripting.

70

Creacin de un Modelo Prototipo

Este script de ejemplo le provee de una interfaz para la definicin de
parmetros de un modelo de prototipo. Luego este mismo crea un modelo wireframe alrededor de
la parte externa del modelo de prototipo, y carga el wireframe dentro del visualizador. Usa tanto la
base de datos como los comandos de ventana Design.

Objetos HTML

Los objetos HTML y los eventos correspondientes usados por el script son los siguientes:

DESCRIPCIN Tipo Nombre Evento
Model File Name / Nombre de Archivo
de Modelo
Caja de Texto tbModel
Browser Botn a pulso btnBrowse Onclick
X Origin / Origen Caja de Texto tbOriginX onchange
onchange onchange onchange onchange

71
Maximum / Mximo X Caja de Texto tbMaxX
Maximum / Mximo Y Caja de Texto tbMaxY
Maximum / Mximo Z Caja de Texto tbMaxZ
Sub-Cell Selection/ Seleccin de Sub
Celda
Caja de Chequeo cbSubcells
Run Script / Correr Script Botn a Pulso btnOK onclick

Mtodos SLC

Los mtodos SLC usados por la script son los siguientes:

tipo nombre descripcin
mtodo initialize ( ) Inicializa el componente de Librera
de Script de Datamine Studio (SLC).
mtodo unLoadDMLib( ) Libera una conexin al SLC
mtodo command ( ) Ejecuta un comando Datamine
Studio
mtodo browse for File ( ) Busca una tabla de archivo en el
proyecto actual de Datamine Studio.

Creando el Wireframe

El wireframe es creado definiendo una string cerrada alrededor de cada una de las seis caras del
modelo rectangular y vinculndolas. Las esquinas del modelo son numeradas como se ilustran
aqu:


72

Comandos con respuestas interactivas

Si registra un comando de base de datos como PROTOM que tiene respuestas interactivas
entonces las respuestas sern registradas en comillas simples. Estas comillas simples son
opcionales y pueden ser removidas. Sin embargo deben incluir un espacio entre cada respuesta
interactiva dentro del script. Un espacio es insertado entre un carcter de string como .

El Monitor de Progreso

Puede agregar un monitor de progreso dentro de su script usando Insert / Advanced /
ActiveXControl / Microsoft ProgressBar Control, versin 6. Si el control Active X no est
disponible entonces trate usando el editor Microsoft Script Editor como sigue:

1. Haga clic en el cursor exactamente luego de la etiqueta </table>
2. Seleccione View / Toolbox y haga clic derecho en el rea gris del panel de la caja de
herramientas.
3. Seleccione la caja de herramientas Customize
4. Chequee el item Microsoft Progress Bar, versin 6.

Al inicio de la funcin principal defina una variable (delta) y fjela de modo que sea igual al nmero
de veces que piensa actualizar el monitor (ej: 7). Exprsela como un porcentaje. Inicialice el valor
de la Barra de Progreso. Por ejemplo:

73

Entonces tendr que insertar el nmero correcto (ej: 7) de actualizaciones de la Barra de Progreso
dentro del cdigo:

Este es un atajo para aadir delta al valor actual de ProgressBar1.Value. Al final de la funcin
deber reajustar el valor a cero.

Puntos a tener en cuenta

Las cajas de texto Mximas (Maximum) estn protegidas contra escritura. Tambin estn dotadas
con un fondo sombreado


74

Otro ejemplo de Macro

En el ejemplo previo de corrida de macro desde una script, todas las variable que fueron
trasladadas desde y para la macro (usando varsave y varload) fueron especificadas usando cajas
de texto. Una propiedad .macro fue aadida al nombre de cada caja de texto de modo que las
variables seran escritas al archivo var. Si quiere transferir variables que estn calculadas dentro
del script en vez que especificadas por el usuario entonces aqu hay una forma alternativa de
hacerl o como se ilustra en la script y macro .

En este ejemplo el clculo de las dimensiones del grfico es logrado dentro del script y las
variables son trasladadas a una macro. Hay muchas otras diferencias del ejemplo anterior por lo
que se le recomendamos examinar cuidadosamente el script y la macro


75
Teniendo acceso a Valores de Registro y Campo

Este ejemplo de script muestra como acceder al valor de un campo en
un registro seleccionado un archivo Datamine. Este usa el mtodo attachTable ( ) para definir un
objeto de tabla, y luego la propiedad openrecords ( ) para crear un registro ActiveX Data Object,
ADO, (Objeto de informacin Active X) fijado sobre el objeto de tabla. Este puede ser usado para
manipular el registro de propiedades. Para ms informacin sobre ADO dirjase a
www.microsoft.com/data/ado.

El proveedor OLEDB de Datamine actualmente le permite la lectura y actualizacin de registros
existentes. Pero no permite la creacin de nuevos registros o nuevos archivos.


76
El mtodo de men Command DCM

En los ejemplos anteriores todos los procesos y comandos de la ventana Design han estado
disponibles a travs del mtodo command del DCM o del SLC bsico. La sintaxis para ambos es
idntica. Por ejemplo:

En cada caso el juego total de archivos, parmetros y respuestas interactivas debe ser incluido
dentro de la string que es enviada mediante el mtodo command al DCM (Datamine Command
Manager, Administrador de Comandos Datamine). Si quiere hacer uso de un comando Datamine
desde un script, pero requiere respuestas que sean apropiadamente interactivas en lugar que pre
especificadas, entonces debe usar el mtodo menuCommand del DCM en lugar del mtodo
command. Por ejemplo:

En el primer ejemplo interactivamente se le requerir por: el origen del modelo, tamao de celdas,
etc, y para el comando de archivo de modelo abierto se le requerir, con un dilogo interactivo:
ingresar el nombre de archivo, usando el explorador de archivo de proyecto, y luego la densidad
predeterminada y seleccin de campo.

Note que la sintaxis para el argumento del mtodo de menuCommand es diferente al mtodo
command. El mtodo menuCommand usa la misma sintaxis que en las macro. Por lo tanto las
especificaciones de archivo y campo usan parntesis en vez de signos de igual, y se usa la coma
como limitante en vez de un espacio.

Ejemplo de Script

El script adjunto proporciona un ejemplo usando el mtodo menuCommand. La
interfaz le permite seleccionar un archivo de grfica Datamine usando el explorador y
sobreponindola en la ventana Design. Luego le provee botones de zoom y pan.

Los comandos grficos de zoom y pan requieren interaccin de usuario. Los grficos de zoom
necesitan que el usuario para seleccione una esquina del rectngulo del zoom y luego que
arrastre el cursor a la esquina de la diagonal opuesta, y los grficos-pan requieren dos puntos a ser
seleccionados. Por lo tanto estos dos comandos trabajan usando el mtodo menuCommand. Note

77
que el cursor no cambia a una lupa magnificadora cuando usa grficos de zoom con
menuCommand, como si lo hace cuando usa el command directamente. Esta es una caracterstica
de Windows!

A pesar que todos los comandos pueden correr usando menuCommand, solo debe usar este
mtodo cuando requiera interaccin de usuario. Para otros propsitos use el mtodo command.
Esto es porque usando el mtodo command cada comando debe completarse antes que el
siguiente sea activado, en tanto que, si menuCommand es usado sin interaccin de usuario es
posible que un comando comience antes que el primero haya finalizado, lo cual puede causar un
problema.

En vez de hacer clic en un botn, una accin puede ser iniciada haciendo clic en un grfico. Use el
comando Insert / Form / Picture para insertar un grfico, y luego seleccione el grfico y use Format
/ Properties para asignarle un nombre. Todos los eventos (onclick, etc) para el grfico estarn
disponibles cuando use MSE. Por lo tanto puede fcilmente cambiar los botones por sus propios
conos.

Informacin Final

Esperamos que haya disfrutado el tutorial de programacin y lo haya encontrado muy til.
Para informacin de entrenamiento de scripting por favor contacte a su oficina de soporte
Datamine (soporte@datamine.com.pe )

Tutorial Scripting Studio 2.0 PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Tutorial Scripting Studio 2.0 PDF

Uploaded by

Copyright:

Available Formats

Tutorial Scripting Gua del Usuario

You might also like