Tutorial Scripting Studio 2.0 PDF

 

Tutorial Scripting – Guía del Usuario

Datamine Studio

Scripting Guía del Usuario Edición 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

1

 

Tutorial Scripting – Guía del Usuario Índice

ÍNDICE...................................................................................................................................2   INTRODUCC INTR ODUCCIÓN IÓN AL SCRIPTI SCRI PTING...... NG............ ............ ............ ............ ............ ............ ............ ............ ............ ........... ........... ........... .......... ........ ...55  Usando FrontPage 2000 20 00 ................................................................................................. ................................................................................................. 7 Configurando FrontPage ................................................................................................ 7 Instale Microsoft Microsoft Script Editor ....................................................................................... 8

INTRODUCCIÓN A GUARDAR, REPRODUCIR, Y DIÁLOGOS SIMPLES............9   GUARDANDO GUAR DANDO Y REPRO REPRODUCIENDO DUCIENDO UN SCRIPT...... SCRIPT ............ ............ ............ ............ ............ ............. .............. ..........10 ...10   Comenzando con la Grabación Comenzando Grabación de Script ..................................................................... 10 Deteniendo el grabado de Script................................................................................... Script................................................................................... 10 Reproduciendo Reproduciend o el Script............................................................................................. Script............................................................................................... .. 10

VISUALIZAND VISUA LIZANDO O EL SCRIPT SCRIP T ...... ............ ............ ............ ............ ............ ............ ............ ............ ............ ............ ............ ............ ............. ............12 .....12  Visualizando la fuente Visualizando fuente HTML...................................................................................... 12 Guardando la Copia Copia de Referencia del Script Script .............................................................. 13 Guardando la la Imagen de Logo Datamine..................................................................... Datamine..................................................................... 13 Corriendo el script script desde Internet Internet Explorer.................................................................. Explorer.................................................................. 14

SINTÁXIS SINTÁ XIS DE LOS COMANDOS DATAMI DATAMINE NE...... ............ ............ ............ ............ ............ ............. .............. ............. ...........15 .....15  Sintáxis de los comandos Sintáxis comandos Datamine Datamine ............................................................................. 16 Ejemplos.............................. Ejemplos ................................ .............................. .................................................................. ........................................................... ..................... 16

AGREGANDO AGREGA NDO MÉTODO MÉTODOS S WINDOWS ...... ............ ............ ............ ............ ............ ........... ........... ............ ............ ............ ............. ........17 .17   Agregando una alerta Agregando alerta : alert alert ( )..................................................................................... ) ..................................................................................... 17 Agregando un requerimiento requerimiento : prompt prompt ( )..................................................................... 18 Agregando Agregand o una confirmación confirmación : confirm confirm ( ) ................................................................... 19 Resumen....................................................................................................... Resu men....................................................................................................................... ................ 20

INTRODUCCIÓN AL COMPONENTE SCRIPT LIBRARY........................................22   Usando el SLC.......................................................................................................... SLC.............................................................................................................. .... 22 El explorador de archivos de Datamine........................................................................ 23

AGREGANDO EL EXPLORADOR EXPLO RADOR DE ARCHIVO DEL P ROYECTO ROYECTO... ....... ....... ....... ....... ....... ....24 24   INTRODUCCIÓN PARA EL EJEMPLO DE CREACIÓN DE UN POLÍGONO.......26  Iniciee Datamine Inici Datamine Studio Studio ................................................................................................. 26

CREANDO LA INTERFAZ...............................................................................................27   Dibuje una tabla que contenga contenga los objetos de de interfaz. interfaz. ................................................ 27 Agregue Agre gue texto texto y cajas cajas de de texto texto ...................................................................................... 27 Agregando cajas de chequeo para la selección de información................................. información................................... .. 28 Agregue los botones botones “OK” “OK” y “Cancel” “Cancel”........................................................................ ........................................................................ 28 Asignee valores Asign valores y nombres nombres a los los controles controles .................................................................... 28 Ordenando la la tabla........................................................................................................ tabla......... ............................................................................................... 29

2

 

Tutorial Scripting – Guía del Usuario

Otorgue un título Otorgue título a la la página y guárdelo. guárdelo. ..................................................................... 30 Enlace a la la hoja de estilo estilo estándar estándar de Datamine Datamine Studio Studio ............................................... 31

AGREGANDO EL SCRIPT..............................................................................................32   El evento en carga en Ventana ..................................................................................... 32 El operador onClick del botón OK............................................................................... 34 Que es lo que que hace hace el script? script? ........................................................................................ 35

CORRIENDO EL SCRIPT................................................................................................37   Depurando su script...................................................................................................... 37 Sugerencias para extensiones adicionales .................................................................... 39

INTRODUCCI INTRO DUCCIÓN ÓN AL EXPL EXPLORADOR ORADOR Y COP COPIAR IAR..... ........... ........... ........... ........... .................. .................... ............... ........40 40   Comenzando ................................................................................................................. 41

CREANDO LA INTERFAZ...............................................................................................41   Cree una tabla que contenga los objetos de interfaz..................................................... 41 Agregue Agre gue texto texto y cajas cajas de de texto texto ...................................................................................... 41 Agregue botones de Exploración Exploración.................................................................................. .................................................................................. 42 Asigne nombres nombres y valores valores a los controle controless .................................................................... 42 Enlace a la la hoja de estilo estilo estándar estándar de Datamine Datamine Studio Studio ............................................... 43 Otorgue a la página página un título título y guárdela. guárdela. ..................................................................... 44

AGREGANDO EL SCRIPT..............................................................................................45   El evento onload onload (en carga) carga) de ventana................ ventana........................................................................ ........................................................ 45 El evento evento onunload onunload de ventan ventanaa ..................................................................................... 46 El operador onclick del botón OK................................................................................ 46 Los botones de exploración .......................................................................................... 47

CORRIENDO EL SCRIPT................................................................................................49   Depurando su script...................................................................................................... 49

SUGERENCIAS PARA PRÓXIMAS EXTENSIONES................................................50  Copie un campo simple................................................................................................ simple ................................................................................................ 50 Copiando campos múltiples múltiples ......................................................................................... 51

INTRODUCCIÓN PARA CORRER UNA MACRO DESDE UN SCRIPT...... SCRIPT......... ...... ...... .....54 ..54  MACRO MAC RO DE EJEM EJEMPLO PLO USANDO XRUN ............ .................. ............ ............ ............ ............ ............ ............ ............ ...............56 .........56  CREANDO LA INTERFAZ...............................................................................................59   Asigne Nombres Nombres y Valores a los Controles.................................................................. Controles.................................................................. 59

AGREGANDO EL SCRIPT..............................................................................................61   Eventos a ser definidos ................................................................................................. 61 Métodos de Componente de Librería Script................................................................. Script................................................................. 61 Microsoft Microso ft Script Editor................................................................................................. Editor ................................................................................................. 62 tblN1 – Entrada de Caja Caja de Texto de Ar Archivo chivo Collar Collarss ................................................. 63 BtnBrowseOUt1 - Salida del Botón Botón de Exploración Exploración del Archivo Archivo de Gráfico a .......... 64 BtnCreatePlot BtnCreateP lot – Cree Cree un Botón Botón de Gráfica Gráfica .................................................................. 64 3

 

Tutorial Scripting – Guía del Usuario

BtnLoad - Cargue Botones Predeterminados .............................................................. 65 Evento onload onload (en carga) en Ventana Ventana ........................................................................... 65 Haciendo una conexión con el SLC ............................................................................. 66 Copie el JavaScript JavaScript y péguelo dentro dentro de su script........................................................ script........................................................ 67 El Script Completo ................................ ............................................................ ................................................................. ........................................... ...... 67

CORRIENDO EL SCRIPT................................................................................................68   Edite la Macro Macro .............................................................................................................. 68 Corraa la Script........................................................................................................... Corr Script............................................................................................................... .... 68 Validación..................................................................................................................... 68

INTRODUCCIÓN INTRODUCCIÓ N A EJEMP LOS DE SCRIPTS.......... SCRIP TS................ ............ ............ ............ ............. ............. ............ ............69 ......69  CREACIÓ CREA CIÓN ND DE E UN MODEL MOD ELO O PRO PROTOT TOTIPO........ IPO............... .............. ............... ................... .............. .............. .............. ...........70 ....70  Objetos HTML ............................................................................................................. 70 Métodos Mé todos SLC................................................................................................................ SLC ................................................................................................................ 71 Creando el Wireframe Wireframe .................................................................................................. 71 Comandos con respuesta respuestass iinteracti nteractivas vas ......................................................................... 72 El Monitor de Progreso ................................................................................................ 72 Puntos a tener en cuenta .................................................................. ............................................................................................... ............................. 73

OTRO EJEMPL EJEMPLO O DE MACR MACRO O .......... ............... .......... .......... .......... ............... ............... .......... .......... .......... .................. .................... ..............74 .......74  TENIENDO ACCESO A VALORES DE REGI REGISTRO STRO Y CAMPO ... ....... ....... ....... ....... ....... ....... ....... ......75 ..75  EL MÉT MÉTODO ODO DE MENÚ COMMAND COMM AND DCM ...... ............ ............ ............ ............ ............ ............ ............ ............ ............ ............76 ......76  Ejemplo de Script ......................................................................................................... 76

INFORMACIÓN FINAL.....................................................................................................77 

4

 

Tutorial Scripting – Guía del Usuario

Introducción al Scripting Datamine Studio le proporciona una nueva interfaz para la industria que le permite escrib escribir ir scripts usando JavaScript o VBScript. Estos scripts se introducen en un documento HTML el cual scripts usando puede ser cargado en la interfaz de Datamine Studio para ejecutar los comandos Datamine. Así como corre comandos individuales de los scripts también puede correr macros existentes y programas CL los cuales han sido por un largo tiempo una característica de los sistemas Datamine. HTML puede ser usado para crear interfases gráficas simples o comprensivas para scripts. Se puede pensar que esto es un reemplazo para el comando macro ¡SCREEN, pero es muchas veces más poderoso. La manera más fácil de comenzar el uso de esta poderosa oportunidad es grabando un script,

al

seleccionar

TOOLS/START

SCRIPT RECORDING de 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 más que eso. Querrá cambiar la interfaz de modo que, por ejemplo, pueda especificar nombres de archiv archivo o de entradas o salidas, también querrá especificar un campo y valores de parámetros; y por lo tanto puede agregar botones extra, botones de radio cajas de texto, cajas de chequeo, y demás.

Si quiere hacer cambios en la interfaz edite el script de HTML. Sin embargo, de la misma ma manera nera como agrega cajas de texto o botones también necesita definir la acción o evento que ocurre cuando ingresa información en la caja de texto o haciendo clic en el botón. 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 programación. Puede también aplicar interfaz con otros sistemas para la programación. Hemos proporcionado algunas funciones útiles de Java Script para simplificar tareas como corrida de macros e instalación de listas. Estos se encuentran en el Script Library Component (SLC) el cual se explica en este tutorial.

5

 

Tutorial Scripting – Guía del Usuario El tutorial lo lleva a través de todos los pasos desde la grabación y reproducción hasta el diseño de su propia interfaz y adición de scripts. El objetivo de este tutorial no es el de enseñar 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 páginas HTML, macro, y otros archivos usados en Datamine Studio. Si es familiar con conceptos y métodos de JavaScript y HTML, la comprensión del tutorial le resultará hará más fácil. Dos Libros útiles para JavaScript son: JavaScript: The definitive Guide, Third Edition By David Flannagan Published by O’Reilly 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 reconocerán que la disponibilidad de una interfaz industrial COM estándar para todos los comandos de Datamine Studio le abre enormes posibilidades para integrarse integra rse a D Dat at amine am ine Studio en su sistema IT global de compañía. Lo Loss comandos de Datamine Studio pueden ser ejecutados ejecutados y accedidos desde cual cualquier quier sistema o lenguaje de programación, programación, incluyendo Access Basic, Sybase PowerBuilder, Borland Delphy, Visual Basic o C++.

6

 

Tutorial Scripting – Guía del Usuario

Usando FrontPage 2000 Para el e l desarrollo desarrol lo de páginas HTML y scripts se requiere más que un editor de texto. Existe Exis te un número de editores HTML disponibles, tanto en freeware y shareware como en la parte comercial de la internet. Estos productos varían considerablemente en su aproximación a la generación de páginas HTML, pero casi todos están diseñ diseñados ados para crear para la Internet webs HTML y muy pocos tienen soporte para el desarrollo de scripts más elaboradas. Microsoft FrontPage es la atracción de Microsoft para el desarrollo de web y HTML. Su precio es razonable y contiene un buen editor de gráficos de HTML y un soporte excelente para el desarrollo de scripts. Este es el paquete que actualmente recomendamos usar.  Antes de d e completar este tu tutorial, torial, necesitará n ecesitará una copia de Microso Microsoft ft Frontpage Frontpa ge 2000. Para cchequear hequear si su versión de FrontPage es la correcta, cargue FrontPage y seleccione Help/About Microsoft FrontPage. La versión debe ser 4.0.2.XXXX similar a la que se ve a continuación

Configurando FrontPage Cuando el script es usado para enviar información a un servidor web de Internet o Intranet 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 botón “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 programación de “ubicación de cliente” (client-side), como será usado en este tutorial. Por defecto, FrontPage activa automáticamente campos que inserta en la plantilla. Deshabilitaremos Deshabilitarem os esta característica característica seleccionando seleccionando Tools/ Page Options... Options... y desactivando la caja en el dialogo que aparece, de modo que luzca como sigue:

7

 

Tutorial Scripting – Guía del Usuario

Instale Microsoft Script Editor La edición y depuración 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 Editing  y los componentes de de script, re instale su CD de FrontPage y cargue HTML Source Editing y Office Tools. Tools.

Primera lección: Guardar, Reproducir y Diálogos Simples

8

 

Tutorial Scripting – Guía del Usuario Introducción a Guardar, Reproducir, y Diálogos Simples   Los objetivos de estas dos primeras lecciones son:

•

 

Usar llas as características características de guardado guardado y reproducción para grabar grabar comandos ingresados interactivamente, interactivam ente, y luego poder correrlos nuevamente.

•

 

Introducir tres métodos de ventana comúnmente usados : alert () (alerta),

confirm()

(confirmación)) y promt() (requerimiento), (confirmación (requerimient o), las cuales cuales utilizan cajas de diálogo 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.

9

 

Tutorial Scripting – Guía del Usuario Guardando y Reproduciendo un Script Para la primera parte de la lección usted va a guardar y reproducir la secuencia de los comandos Datamine para juntar y llenar la información referida al desurveying downhole. Comenzando con la Grabación de Script

•

 

Active la grabación de script automática haciendo clic en

en la barra de herramientas

Scripting,, o seleccione Tools/ Start Script Recording de la barra de menú. Scripting •

 

Cuando se le pida un nombre para el archivo script HTML ingrese el nombre : desurvey

•

 

Ejecute la siguiente secuencia de comando Datamine interactivamente. 1. 2. 3. 4. 5.

!SORTX &IN=_collars &OUT=tempcollars &OUT=tempcollars *KEY1=BHID *KEY1=BHID !SORTX &IN=_assays &OUT=tempas &OUT=t empassays says *KEY1=BHID *KEY2=FROM !SORTX &IN=_geology &OUT=tempgeology *KEY1=BHID *KEY2=FROM !SORTX &IN=_surveys &IN=_survey s &OUT=tempsurvey &OUT=temps urvey *KEY1=BHID *KEY1=BHI D *KEY2=AT !JOIN &IN1=tempcolla &IN1=tempcollars rs &IN2=tempassays &IN2=tempassays &OUT=temp1 *KEY1=BHID @SUBSETR=1.0

6. 7. 8.

!HOLMER &IN1=temp1 &IN1=temp 1 &IN2=tempgeo &IN2=tempgeology logy &OUT=tem &OUT=temp2 p2 *BHID= *BHID= BHID *FROM=FROM *FROM=F ROM *TO=TO !DESURV &IN1=temp2 &IN1=temp2 &IN2=tempsurvey &IN2=tempsurvey &OUT=holes &OUT=holes !DDLIST &IN=holes &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 características adicionales tales como validación de información. Sin embargo es también útil algunas veces, seguir los pasos individuales descritos arriba.

Deteniendo Detenie ndo el grabado de Script Detenga el grabado automático usando

o Tools / Stop Script Recording. Recording .

Reproduciendo el Script o seleccione Tools/ Run Script. Script. Cuando se le

 Ahora reproduzca el Script guardado usando

pida por el nombre del script, seleccione desurvey.htm. Asegúrese que la ventana Customization es mostrada y seleccione el tab Script:

10

 

Tutorial Scripting – Guía del Usuario

Haga clic en el botón Execute (ejecutar), (ejecutar), y los comandos serán reproducidos. No se preocupes si los comandos no se reproducen correctamente porque tal vez cometió un error durante la grabación de los mismos. Solucionaremos eso en la siguiente sesión.

11

 

Tutorial Scripting – Guía del Usuario

Visualizando el Script Primero haga clic en el botón Help Help en  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 programación 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)  Fuente)  y el archivo HTML, desurvey.htm, se cargará en Notepad (Bloc de Notas). Notas). •

  ¡Tranquil ¡Tranquilo o ! FrontPage FrontPage 2000 y el editor Microsoft Script Editor le proporcionarán las herramientas que necesita para editar este archivo. Sin embargo es muy útil dar un vistazo rápido al archivo en este momento para ver que está sucediendo.

•

  Las p primeras rimeras 6 líneas líneas en código HTML contienen información dirigente.

•

  Luego

hay cuatro párrafos de comentarios, cada línea

comenzando con //. Esto le indica como trabaja un script. Léalo. •

 

Entre los dos juegos de líneas de comentarios que comienzan con //------- se encuentran algunas líneas de JavaScript JavaScript.. Estas están dando inicio ini cio al Datamine Command Manager

12

 

Tutorial Scripting – Guía del Usuario (Administrador de Comandos Datamine) y el Explorador, dependiendo de qué método está siendo seleccionado. •

 

Luego

tenemos

más

comentarios,

seguidos

de

dos

funciones

JavaScript

–

btnExecute_onclick() btnExecute _onclick() y btnHelp_onclick(). Estas funciones describen qué acción es tomada cuando se hace clic en el Execute (Ejecutor) o los botones Help (Asistente de Ayuda) respectivamente. •

 

Y finalmente aparece el código HTML que describe la interfaz – el logo Data Datamine mine y los botones Help y Execute.

Guardando la Copia de Referencia del Script Deseamos que tenga éxito en la creación 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 botón Esto abrirá una nueva ventana y mostrará el script. Para visualizar el código 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 As de la barra de herramientas de Notepad (Bloc de Notas). Deberá usar el explorador para llegar hasta su directorio de proyecto Tutorial. También deberá cambiar el nombre del archivo. Por ejemplo, llame al archivo desurvey1.htm. Asegúrese de añadir la extensión .htm al finalizar el nombre de archivo, y no use la extensión por defecto .txt. Este método de guardado para la copia de referencia de un archivo es usado frecuentemente en este tutorial, de modo que asegúrese 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 código HTML que muestra la imagen está cerca del final del archivo:

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

13

 

Tutorial Scripting – Guía del Usuario •

 

Copiar la imagen a su directorio de proyecto. Encontrará el archivo dmlogo200x93.gif en el directorio

de

instalación

de

Datamine,

usualmente

en

c:/Program

Files/datamine/DmStudio.140/Common/Images. •

 

Agregar el párrafo completo al script:

El primer método es probablemente probablemente el más apropiado debid debido o 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 botón 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 más fácil de mostrar tanto el script como las otras ventanas Datamine simultáneamente.

14

 

Tutorial Scripting – Guía del Usuario Sintáxis de los comandos Datamine El Java Script que describe la acción tomada cuando se hace clic en el botón Execute (Ejecutar) es mostrado abajo. Puede ver que cada comando Datamine Datamine ha sido corrido usando la funci función: ón: dm.command(). Este nombre de comando y los archivos correspondientes, campos y parámetros son ingresados como una string de carácter encerrada entre comillas. Si la string se extiende a dos o más líneas entonces cada línea es separada por una string y las strings se unen usando el carácter +.

Note que los nombre de archivos son precedidas por macros simbólicas & (eg&IN), nombres de eg@BINS=5). ). Sin embargo a diferencia de las campo por * (ej*BHID) y los parámetros por @ ((eg@BINS=5 macros hay signos de igual (=) entres los nombres de archivo reales y simbólicos (ej &IN=_collars) y entre entre los nombres de campo reales y simbólicos (ej*KEWY1=BHID). (ej *KEWY1=BHID). Estas asignaciones asi gnaciones a archivos, campos y parámetros son separadas por uno o más espacios. Si comete un error al ingresar los comandos puede editar el código. Asegúrese 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”) (“select-string”) ha sido grabado. Esto puede ser eliminado. Si ha realizado algún cambio entonces guarde el archivo antes de salir. Con el objetivo de correr la edición 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.

15

 

Tutorial Scripting – Guía del Usuario Refresh   (Actualizar) y corra el programa nuevamente haciendo clic en el botón Seleccione Refresh Execute  (Ejecutar).

Sintáxis de los comandos Datamine La sintaxis completa para un comando Datamine es:

Note que:  

“...” significa ‘será repetido cualquier número de veces’.

•

   

“[name =]” significa que el nombre de archivo simbólico es opcional Datamine Studio usa “&”, “*” y “@” de la misma manera como Datamine5

•

 

Los parámetros pueden tener múltiples valores, donde sea apropiado

•

 

Archivos con nombres extensos (más de 20 caracteres) pueden ser usados, las macros

•

•

están 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

16

 

Tutorial Scripting – Guía del Usuario

Agregando Métodos Windows Existen tres métodos de ventana generalmente generalmente usados, los cuales puede ser agregados agregados a su script.

•

 

alert() alerta

•

 

confirm() confirma conf irmación ción

muestra un mensaje al usuario le pregunta al usuario si bien hacer clic en el botón OK o CANCEL para confirmar o cancelar una operación.

•

   prompt () requer requerimient imiento o

le pregunta al usuario ingresar una string de texto.

Todos estos tres métodos aparecen en simples cajas de diálogo.

Agregando una alerta : alert ( ) El método de alerta, alert( ), es usado para mostrar una caja de diálogo que contiene el valor de una variable o una string de texto. Por ejemplo inserte alert( ) al principio de una función para mostrar el título. Para hacer esto edite el script haciendo clic derecho y seleccionando View Source (Visualización 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)  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.

17

 

Tutorial Scripting – Guía del Usuario Agregando un requerimiento : prompt ( ) El método  prompt   ( ) muestra un diálogo 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 opción para : •

 

Cancel

- cancela la operación operació n totalmente totalmen te

•

 

OK

- acepta la entrada y continúa la operación

El método  prom  prompt pt ( )  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 pred eterminada entonces solo ingrese dos comillas sucesivas ””. El método responde un valor cuando hace clic en uno de los botones. Haciendo clic en el botón Cancel responde un valor nulo, independientemente de lo que esté en la caja de texto. Haciendo clic en el botón OK responde el valor de la string de texto en la caja de texto. Use el método  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 cfile está vacío (””) o nulo entonces return terminará la función. Finalmente necesitará reemplazar el nombre de código 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. Asegúrese que existe un espacio inmediatamente frente a &OUT=tempcollars, &OUT=tempcollars, asimismo los archivos, arc hivos, campos y parámetros estén separados por espacios.

Guarde el archivo de texto, actualice el script y córrala nuevamente. Luego de alert( ) que muestra el título, el diálogo  prompt( ) será mostrado

18

 

Tutorial Scripting – Guía del Usuario

Para acept aceptar ar el nombre predeterminado name_collars, name_collar s, solo haga clic en OK. El resto del script también correrá. Puede ahora también agregar requerimientos similares para los otros cuatro archivos, usando los nombres:

•

 

As Assa says ys

afile

•

 

geology

gfile

•

 

surve surveys ys

sfile

•

 

holes holes

hfile 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 confirmación : confirm ( ) El método confirm ( ) muestra un dialogo que incluye un mensaje especificado por el usuario y que Cancel   y OK. Esto es similar a  pro le proporciona dos botones, Cancel  prompt mpt(( ) excepto que la única respuesta es hacer clic en uno de los dos botones. El método respo responde nde al  valor Boolean, valor true (verdadero) si se hace clic en OK o false (falso)  para Cancel Cancel.. Puede entonces agregar un código

19

 

Tutorial Scripting – Guía del Usuario para actuar de acuerdo con el botón en el que se ha hecho clic. Por ejemplo use confirm( ) para mostrar los nombres de los archivos que que han sido sido seleccionados, seleccionados, y luego para que aborte la operación si se ha hecho clic en Cancel.

/n dentro de una string de texto iniciará una nueva línea ! 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 sería true, de modo que la acción será return y la operación habrá terminado. El diálogo confirm( ) lucirá como el siguiente:

Resumen Los métodos alert ( ) y confirm ( ) son particularmente usados para depurar un script. A pesar de que el método  prompt ( ) puede ser usado para ingresar un valor, sería una forma forzada de hacerlo. Una de las principales ventajas de la programación es el uso de HTML para crear una interfaz atractiva, así como veremos en la siguiente parte del tutorial.

20

 

Tutorial Scripting – Guía del Usuario Para ver el contenido del script completo con los métodos alert( ), prompt ( ) y confirm ( ) haga clic en : Siguiente lección: El compone componente nte Script Library

21

 

Tutorial Scripting – Guía del Usuario Introducción al componente Script Library El componente Script Library básico (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 instalación de listas de menú. Un resumen de propiedades y métodos asociados con el SLC esta disponible al hacer clic aquí

Escoja una Propiedad o un Método de la lista

desplegable para mostrar los detalles correspondientes. Usaremos algunas de estas propiedades y métodos luego en este tutorial. En una lección anterior, Visualizando Visualizando el Script, se fijó la atención a los argumentos incluidos incluidos en el script cuando corresponde corresponde guardarlo automáticamente. 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 automáticamente incluye códigos para inicializar ambos objetos ActiveX, los que crean una conexión entre el script y su proyecto Datamine. El método por defecto, (method =1 ), inicializa los objetos Active X: DCM y del explorador explícitamente.  Alternativame  Altern ativamente, nte, ssii quiere qui ere modificar modifi car el script, sería preferible preferibl e usa usarr el SLC. Al inicializar in icializar el SLC, S LC, e ell DCM y dmBrowser son inicializados automáticamente para usted, además el SLC le provee de un número de “funciones convenientes” que hacen que la modificación del script sea más fácil. Con el propósito de us ar el SLC debe instalarlo con el CD de instalación de Datamine Studio. No se instala por default, por lo tanto, debe seleccionar la opción para instalarlo. Debe además estar trabajando con la versión 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 que seleccionado el method 2, las dos líneas de código de inicialización son :

22

 

Tutorial Scripting – Guía del Usuario 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 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 método de la ventana  prompt( ). Este es el mismo Explorador de  Archivo que usa cuando cuando corre los comandos Datamine.

23

 

Tutorial Scripting – Guía del Usuario Agregando el Explorador de Archivo del Proyecto Se accede al Explorador de Archivo de Datamine usando el método browseForFi browseForFile( le( ) . Estos son los tres argumentos para éste método:

1. El tipo de archivo Las opciones son:

Si el archivo requerido no es uno de los tipos específicos, 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 método  pro  prompt mpt(( ) usando el Explorador de Archivo, para cada uno de los cinco archivos. Por ejemplo

24

 

Tutorial Scripting – Guía del Usuario Note que no hay necesidad de examinar si los primero cuatro archivos están en blanco o nulos porque estableciendo el tercer argumento en false  se asegura que el archivo ya existe. Sin embargo el archivo de perforación de salida puede ser un nuevo archivo (true), de modo que necesitaremos examinar el valor de hfile. Corra el script y asegúrese que todavía trabaja correctamente!. La versión de referencia es incluida aquí: Note que los nombres de todos los métodos y propiedades son cajas sensibles. Por este motivo el método browseForFile  debe tener dos cajas superiores F, y la propiedad tipeCollars debe tener una caja superior C.

Siguiente Lección: Ejemplo de Script para Crear un Polígono

25

 

Tutorial Scripting – Guía del Usuario Introducción para el Ejemplo de Creación de un Polígono Esta lección lo introduce a muchas ideas detrás 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 el script. De ahora en adelante adelante usará Microsoft FrontPage 2000 y el editor Microsoft Script Editor (MSE) como se mencionó en la introducción de este tutorial. Asegúrese que ambos estén instalados. instalados. Datamine Studio contiene una serie práctica 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 selección de información de punto y string actualmente en la ventana Design puede ser trasladada trasla dada a CONPOL, y el polígono 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 información de punto en la ventana Design de Datamine Studio. Escoja dos o tres colores diferentes para la información 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 también será minimizado. Si quiere, puede correr una versión independiente de este tutorial haciendo doble clic en el archivo script_tutorial.chm en la ventana Explorer en el directorio de instalación de Datamine  – generalmente general mente se encuentra encuent ra en c: /Program /Progra m files/datamine/DmStudio files/data mine/DmStudio.140. .140. Esto le permite minimizar Datamine Studio mientras está corriendo FrontPage 2000.

26

 

Tutorial Scripting – Guía del Usuario 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 diseñamos la plantilla HTML, y el tab Preview es en donde nosotros podemos dar una vista previa a lo que estamos diseñando, incluso operar los controles y comandos. Usamos la vista HTML solo cuando estamos agregando el script a la página. Esta es la interfaz que vamos a crear.

Dibuje una tabla que contenga los objetos de interfaz. Table... y fije una tabla con cinco filas Con el tab Normal seleccionado, seleccione Table/ Instert / Table... y y dos columnas. Table// Inse rt / Table... Table...   puede usar Table/ Draw Table... Table... y efectivamente En lugar de Table dibujar las líneas separando las filas y dos columnas. Esta característica es particularmente útil si quiere dibujar tablas con alta resolución de arreglos de celdas.

Agregue texto y cajas de te texto xto  Ahora queremos q ueremos agregar a gregar dos d os cajas de texto en las dos celd celdas as superiores superi ores de la mano derecha d de e 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 extensión). Luego diríjase a la segunda fila, columna de la mano izquierda y escriba “Filter” (Filtro). Ahora añadiremos dos cajas de texto. Sitúe su cursor en la celda superior de la mano Box . FrontPage insertará la caja de texto. derecha, y seleccione Insert/ Form/ One-Line Text Box.  Ahora inserte inser te otra caja de texto en la columna de la mano derecha, al lado de la etiqueta “Fil “Filter” ter” Tal vez prefiere tener los elementos de plantillas disponibles en la barra de herramientas . Para hacer esto, seleccione Insert/ Form, Form, luego arrastre el

27

 

Tutorial Scripting – Guía del Usuario sub menu y llévelo a la barra de herramientas.

Agregando cajas de chequeo para la selección de información Inserte una caja de chequeo (Insert/Form/Check (Insert/Form/Check Box o ) en la celda de la mano derecha en la fila tres, y agregue el texto: “Include point data” (Incluir información de punto) a su derecha. Inserte otra caja de chequeo en la celda debajo, con el texto “Include string data” (Incluir información de string)

Agregue los botones “OK” y “Cancel” Finalmente agregamos dos botones (Insert (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 dirán “Button” (botón)”; 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”) “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 botón OK, o “ctArchivoSeleccionado” para una caja de texto que contenga el nombre del archivo seleccionado.

28

 

Tutorial Scripting – Guía del Usuario

Hay tres maneras de asignar un nombre a un control: 1. Selecciónelo 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 método use –todos muestran el dialogo Properties (propiedades). Haga esto primero para la caja de texto “Extention Distance”. Asigne el nombre tbExtension (tb = tex textt box =ct =caja de texto) y fije el valor valor inicial en “0”.  Asegúrese de usar los nombres exactos para los controles tal como se proporcionan en el texto.  Acto seguido, s eguido, asigne a signe el nombre tbFilter t bFilter (tb = text box bo x = ct = caja de texto) y ningún ningú n 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 chequ chequeo eo cbIncludeStrings y deje el “Initial State” como “Not Checked” (no chequeado). Finalmente, nombre el botón de la mano izquierda “btnOK” y fije el Valor/Etiqueta como “OK” (agregue dos espacios de conducción y arrastre para hacerlo del mismo tamaño que el botón Cancel), y nombre el botón de la mano derecha “btnCancel” y fije su Valor/Etiqueta en “Cancel”.

Ordenando la tabla  Ahora, podemos mejorar la vista v ista de nuestra n uestra tabla. Este paso no e ess abs absolutament olutamente e necesario, ne cesario, pero mejorará la integración 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 disposición de tabla y cambios en los valores en los diálogos resultantes pueden ser hechas haciendo haciendo clic derecho de recho en el mouse. Sin embargo, esta lección le dará los comandos de menú alternativos. Primero, seleccione todas las celda en la tabla, haciendo clic y arrastrando el mouse con el botón Cell y desactive las cajas derecho hacia la celda superior izquierda. Seleccione Table/ Properties/ Cell y “Specify Width” (Ancho específico) y “Specify Height” (Altura específica), para permitir al explorador seleccionar el mejor ancho y alto para las celdas.

29

 

Tutorial Scripting – Guía del Usuario

La alturas y ancho de tabla y celda solo serán fijadas si usa la característica característica de “dibujo de tabla” (draw table), o si ha re-ajustado el tamaño de tabla de alguna manera. Luego, seleccione toda la tabla (ubique el puntero del mouse dentro de la tabla y seleccione Table  /Selec t Table...  /Select Table.. .  , esto es diferente a seleccionar todas las celdas en la tabla), luego seleccione Table / Properties/Table. Properties/Table. Cambie  Cambie la alineación de tabla, tamaño de borde, ancho mínimo y altura, de modo que se parezca al dialogo debajo:

 Al posicionarn posici onarnos os en la aline alineación ación “center” “cente r” (a all centro) centr o) la tabla se manten mantendrá drá en el centro centr o de la ventana script al tiempo que su tamaño es re-ajustado. Fijando el tamaño del borde en cero, ocultará las líneas entre las columnas y las filas, pero la estructura de la tabla mantendrá todo en su lugar apropiado.  Al desactivar el mínimo de altura y ancho, permitirá al explorador el re-ajuste del tamaño de tabla para terminar con el tamaño más pequeño posible. Finalmente, resalte la última fila de celdas (haga clic y arrastre el mouse) y seleccione Table/Properties/Cells.. Cambie la Alineación Horizontal (Aligment Horizontal a Center), para Table/Properties/Cells centrar los botones en las celdas. Otorgue un título a la página y guárdelo.  Ahora la interfaz interfa z está casi completada. completa da. Deberá darle un nombre a la página HTML (Haga cclic lic derecho), seleccione Page Properties... (Propiedades de Página) e ingrese un título como “Script de Polígono” (Polygon Script)), y guarde la página en el mismo directorio que su proyecto Datamine Studio, con el nombre “poligono.htm” (polygon.htm).

30

 

Tutorial Scripting – Guía del Usuario Enlace a la hoja de estilo estándar de Datamine Studio Nuevamente, este paso no es necesario, pero al hacer un enlace entre su HTML y la hoja de estilo estándar de Datamine Studio se mejorará cuantiosamente la visión 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 botón 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 Links... presione Add (agregar), busque y seleccione la hoja de estilo Datamine dmstyle. dmstyle.css. css.  Ahora haga clic en el tab preview, para visualizar como lucirá la interfaz completada

31

 

Tutorial Scripting – Guía del Usuario Agregando el script El primer paso ya está completado: tenem tenemos os una interfaz de usuario HTML, conjuntamente con todos los atractivos de un script. Recuerde, que la nueva característica importante de Datamine Studio es que este puede ser programado. El lenguaje del del script en uso no es parte de D Datamine atamine Studio – puede usar cualquier tipo del gran número de lenguajes lenguajes de programación estándar: estándar: Java Script, VBScript, Perl PerlScript, Script, PowerBuilder’s, Power Script, etc. Los dos lenguajes usados por FrontPage son VBScript y JavaScript.  A diferencia di ferencia de la lass macros macr os y menús, los scripts s cripts son u usualmente sualmente creados de un número de eve eventos ntos guías, pequeñas secciones de script que son ejecutadas por un explorador cuando algún 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 conexión al DCM (Datamine Command Manager, Administrador de Comandos Datamine).

•

 

Cuando el botón OK es presionado (un evento de botón en clic), el explorador ejecuta un script que guarda y procesa información de punto y/o string.

El evento en carga en Ventana 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   del menú. Una nueva ventana aparece, mostrando su interfaz en HTML. Como estará usando el editor Microsoft Script Editor frecuentemente sería una buena idea añadir este botón en la barra de herramientas. Seleccione Tools/ Customize y del dialogo Customize seleccione el tab Commands. De la pestaña Categories resalte Tools, y despliegue la pestaña Commands hasta que el icono Microsof Microsoftt Script Editor se muestre. Arrastre el icono y colóquelo en la barra de herramientas – por ejemplo la barra de herramientas herramient as Forms que contiene los botones y cajas de texto.  Ahora configure configur e el Script Editor para usar JavaScript: JavaScrip t: seleccione View/ Prorpety Pages, o presione Shift+F4. Fije el lenguaje de programación programación predeterminado para scripts de Usuario (Client scripts) de modo que este sea JavaScript, y presione “OK”. Necesitará hacer esto cada vez que

32

 

Tutorial Scripting – Guía del Usuario use Script Editor en un documento diferente. El Script Editor no guarda el cambio a JavaScript como predeterminado. predeterminado.  Ahora, de la barra de menú, seleccione seleccio ne View/Toolbox View/Toolbox,, luego View/Other Windows/ Script Outline Outline.. Deberá visualizar una lista de objetos que añadió 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 función 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 necesitamo s ingresar el código JavaScrip JavaScriptt ha ser ejecutado cuando este evento ocurre. Primero, necesitamos establecer establecer una conexión entre el script y el “SLC” (Datamine Studio Scripting Library Component, Componente Scripting Library de Datmine Studio). En términos de programación, necesitamos crear un ejemplo del SLC. Esto se realiza con el siguiente argumento en JavaScript:

Si está leyendo este documento en línea, Copie Copie las  las líneas JavaScript en el portapapeles, HTML del menú Edit (Edición) de FrontPage para pegarlo en su luego use Pegar como HTML del documento docume nto HTML. Este argumento crea una variable (global), llamada “dmlib”, a través de la cual nos comunicaremos con Datamine Studio. Por favor diríjase al manual de JavaScript si no entendió esta sección. Luego, necesitamos decirle a la biblioteca que se inicialice. Ingrese una segunda línea de código, que diga:

Note que el programa Script Editor le ayuda mostrando una lista de métodos y propiedades disponibles en la biblioteca. Cuando Cuando se ejecuta, el método de iniciali inicialización zación intenta intentará rá conectarse a

33

 

Tutorial Scripting – Guía del Usuario la ejecución actual de la sesión de Datamine Studio. Por esta razón, Datamine Studio deberá estar corriendo antes que ejecutemos exitosamente este (y todos) script desarrollado usando el SLC.

El operador onClick del botón OK  Ahora haga doble clic en btnOK, b tnOK, y haga hag a doble dob le clic cl ic e en n el evento onclick (en clic). c lic). Otra definic definición ión de de función, llamada btn_onclick( ),es insertada. El Script Editor también modifica el HTML que crea el botón de OK, de tal forma que esta función es llamada cuando el evento es mencionado. Deslícese hacia la parte inferior del HTML para buscar el rótulo (entrada) para el botón OK para visualizar, si está interesado, lo que ha sido insertad insertado. o. Cuando el botón es presionado, el script debe guardar la información de string y/o punto, la procesa usando CONPOL y otros comandos, luego re carga el polígono resultante de regreso en la ventana Design. Este código es bastante claro, pero significativame significativamente nte extenso. Es mostrado en la caja debajo. Ingrese los argumentos JavaScript en el interior del cuerpo de la función btnOK_onclick ( ), usando Copiar y Pegar como HTML (Paste as HTML) en el caso que esté

leyendo esto en línea. De otro modo, asegúrese de escribir el código de la misma forma como se muestra.

34

 

Tutorial Scripting – Guía del Usuario

Después de haber añadido el script a su documento HTML, guárdelo, y cierre la ventana del Script Editor. La ventana FrontPage reaparecerá, pero ahora su script está incluida en ella. Seleccione el tab HTML y diríjase 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.

35

 

Tutorial Scripting – Guía del Usuario Si la caja de chequeo “Include point data” (Incluye información de punto) es activada, el script escribe toda la información 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 información de string) es activada, el script escribe toda la información 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 básico es asignado a una variable JavaScript, y si es apropiado el valor para el parámetro EXTDIS, este es añadido. CONPOL no cierra el polígono resultante. Sin embargo el script usa PROPER para cerrarlo antes de recargar el polígono en la ventana Design.

Finalmente, el script elimina todos los archivos temporales creados durante la ejecución.

36

 

Tutorial Scripting – Guía del Usuario Corriendo el Script •

  Asegúrese que ha guardo el script completo. Si quiere usar una versión de referencia entonces

tome una copia de

en su base de datos Tutorial.

•

    Puede correr correr el script script en una una de estas estas dos formas: formas: primero, primero, puede ir a Da Datamine tamine Studio Studio y seleccionar Tools / Run Script y Script y especificar el nombre del archivo HTML que ha sido creado. Esto •

es como generalmente correría, 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 rápida, 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 número de entornos de depuración sofisticados, que son de lejos la mejor forma de entender en que parte un script no está yendo correctamente. Pero para este ejemplo, la más simple ayuda de depuración 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 algún momento durante la ejecución 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:

37

 

Tutorial Scripting – Guía del Usuario

Depurando con Microsoft Script Editor Una discusión completa de cómo usar el Microsoft Script Editor para depurar está fuera de los propósitos de este tutorial. Para mayores detalles, diríjase al Asistente de Ayuda en línea. Sin embargo, para darle un resumen de lo que es posible, investiguemos algunas de las características disponibles. Primero, active el Script Editor desde FrontPage, seleccionando Tools/ Macro / Microsoft Script Editor ... . .. Parea comenzar a depurar, seleccione Debug / Start en 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 línea particular. Para insertar un breakpoint, breakpoint, haga clic en el margen gris gris de la mano izquierda adyacente a la línea en donde requiera que la ejecución sea interrumpida. Por ejemplo, para interrumpir en la primera línea del operador de evento btnOK on click( ),  el editor de script se debería ver como el siguiente:

Cuando la ejecución de script alcanza el breakpoint, la ejecución se detiene y el control retorna al editor de script. Luego, puede visualizar los valores de las variables, dar pasos simples a través del

38

 

Tutorial Scripting – Guía del Usuario script, incluso cambiar el flujo de ejecución y los valores de las variables. Más detalles son proporcionados en el Ayudante en línea de Script Editor. Para finalizar la depuración, seleccione Debug / /  Detach All processes del processes del menú Script Editor.

Sugerencias para extensiones adicionales Este ejemplo trabajado está diseñado para ser una lección instructiva. El script resultante tiene un número 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 parámetro @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 )

Lección: ción: Script de ejemplo para Explorar y Copiar  Copiar   Siguiente Lec

39

 

Tutorial Scripting – Guía del Usuario

Introducción al Explorador y Copiar En esta lección introduciremos el explorador de Archivo de Proyecto (Project File) El explorador es la interfaz gráfica en su proyecto Datamine Studio. Es un control Active X, lo que 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 lección crea un script para copiar un archivo con criterio de recuperación opcional. Usa el explorador del Archivo de Proyecto a través del SLC (Datamine Studio Script Library Component). Obviamente, este ejemplo puede fácilmente ser extendido para llevar acabo cualquier proc proceso eso de archivo durante el curso, o por ejemplo crear un script que lea archivos de entrada múltiples y que cree uno o más archivos de salida.

40

 

Tutorial Scripting – Guía del Usuario 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. Asegúrese que ésta sea la versión correcta y que que esté configurada configurada correctamente como se describió en una lección previa. También 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ú desp desplegable legable Table / Insert / Table... y Table... y especifique una tabla con cinco filas y tres columnas. No se preocupe por el diseño o parámetros de estilo. Trataremos esto más 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 botón de la flecha hacia abajo para moverse a la tercera fila, columna

41

 

Tutorial Scripting – Guía del Usuario 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 Recuperación).  Ahora agregaremos agregaremo s las dos cajas caj as de texto que q ue contengan conte ngan os nombres de los archivos de entrada ent rada 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 file” (Archivo de Salida). Finalmente, inserte otra caja de texto en la cuarta fila, columna del medio. Aquí es en donde ingresará el criterio de recuperación.

Agregue botones de Exploración  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 botón (dirán Botón por defecto); arreglaremos esto más tarde. Finalmente, agregue otro botón en la celda del medio de la última fila.  Ahora haga clic derecho en la tabla, seleccione Table Properties... y Properties...  y fije el tamaño del borde en cero. Luego seleccione la celda del medio en la fila inferior, haga clic derecho, seleccione

Cell

Properties...y fije la alineación horizontal de celda a “Center” (Centro). Haga lo mismo para la Properties...y celda en la primera fila.

Asigne nombres y valores a los controles    Ahora necesitamos ne cesitamos asignar nombres a cada uno de los controles, y cambiar cambia r las etiquetas de botón. botón .  Asignaremos nombres individuales indi viduales de modo que podamos referirnos refe rirnos a cada control en la script. Para asignar un nombre a un control, selecciónelo con el mouse y muestre el dialogo Properties (presione Alt+Enter, o haga clic clic derecho y seleccione “Form Field Properties...” Properties...” o haga doble clic).  Asigne el e l nombre tbInputFile a la primera caja caj a de texto, tbO tb O utputFile a las segunda y tbRet tbRetrieval rieval 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 botón en la fila inferior, y cambie su etiqueta etiqueta a “OK”. Si pone dos espacios en algún algún lado del texto texto (“ OK “) el botón será será más ancho. La interfaz deberá verse como esta:

42

 

Tutorial Scripting – Guía del Usuario

Enlace a la hoja de estilo estándar de Datamine Studio Deberá hacer un enlace a la hoja de estilo estándar de Datamine Studio, dmstyle.css, para mejorar la integración visual del script. Ya debe haber creado el archivo dmstyle.css como se describió en una lección previa. Links... presione Add Para hacer un enlace a la hoja de estilo, seleccione Format / Style Sheet Links... presione (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 comple completada: tada:

43

 

Tutorial Scripting – Guía del Usuario Otorgue a la página página un título y guárdela. La interfaz ahora está casi completa. completa. Debe proporcionar proporcionar un nombre a la página HTML (haga clic derecho, derec ho, seleccione

Page Properties...  Properties...  e ingrese un título como “Ejemplo de Explorador”), y

guardar la página en el directorio de proyecto Tutorial, con el nombre “copyfile1.htm”.

44

 

Tutorial Scripting – Guía del Usuario

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 número de operadores de evento. Estos son pequeñas 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 conexión al SLC (Datamine Script Library Component).

•

 

Cuando cualquiera de los botones del explorador es presionado ( un botón de evento onclick )  el script ejecuta una llamada al SLC, el cual muestra el explorador de base de

datos, espera por una selección y copia el nombre de cualquier tabla seleccionada dentro de la caja de texto correspondiente. •

 

Cuando el botón OK es presionado (otro evento onclick ), ), un script chequea ambos archivos que han sido especificados, agrega cualquier criterio de recuperación 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 Página en FrontPage, seleccione Tools / Macro / Microsoft Script Editor o

.

Pages, o haga clic en Configure el Script Editor para usar JavaScript: seleccione View / Property Pages, 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 selec cione View / Other Windows / Script Outline.   En esta ventana, seleccione Outline.

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

45

 

Tutorial Scripting – Guía del Usuario explorador. El Script Editor inserta el HTML necesario para contener su script, y define una función window_onload .

Recuerde que si el encabezado dice dice “ Sub window_onload( 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 conexión entre el script y el SLC e inicializarla. Esto se hace con el siguiente argumento JavaScript:

Puede ingresar el código 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 línea en blanco entre las líneas “function window_onload( window_onload( ) {“and”}. Del menú del clic derecho seleccione “Paste as HTML” ( Pegue como HTML) .

El evento onunload onunload de ventana Luego, cree un operador de evento onunload  e inserte la siguiente línea de código 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 página HTML)

El operador onclick del botón OK  Ahora, haga doble clic en btnOK, y doble clic en el evento onclick . Otra definición de función, llamada btnOK_onclick ( ), es insertada. Cuando el botón 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 recuperación”. recupera ción”.

46

 

Tutorial Scripting – Guía del Usuario Ingrese los argumentos de Java Script dentro del cuerpo de la función btnOK_onclick ( ), usando Copy (Copiar) y Paste as HTML (Pegar como HTML), si está leyendo esto en línea. De otro modo, asegúrese de escribir este código 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 carácter vacía. Si alguna se está olvidando, la script no hará nada. En otro caso, un comando Datamine Studio es construido por la concatenación de cuatro sub strings (dos bits fijados, además de los valores contenidos en ambas cajas de texto). Luego, si alguno ha sido ingresado dentro de la caja de texto de Criterio de Recuperación, este es añadido 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 ejecución. Los botones de exploración Cada uno de estos botones de exploración deben manejar más o menos la misma función: agregar o actualizar el valor en una de las cajas de texto. El SLC contiene una función espec específica ífica para lograr esto: Primero, agregue un operador onclick  para   para el primer botón de exploración, e inserte el siguiente código:

El método 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.

47

 

Tutorial Scripting – Guía del Usuario 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 más de un tipo de archivo, puede agregar diferentes tipos de valores conjuntamente. Para encontrar el valor de tipo para cualquier categoría diríjase 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 botón de exploración, con el siguiente código:

Luego que haya agregado el script en su documento HTML, guárdelo, y cierre la ventan del Script Editor. La ventana FrontPage reaparecerá, pero ahora se le ha añadido su script. Seleccione el tab HTML y deslícese a la parte superior para chequear esto.

48

 

Tutorial Scripting – Guía del Usuario Corriendo el Script •

  Asegúrese que ha guardo el script completo. Si quiere usar una versión de referencia entonces

tome una copia de •

en su base de datos Tutorial. Tutoria l.

 

  Puede correr correr el script script en una una de estas estas dos formas: formas: primero, primero, puede ir a Da Datamine tamine Studio Studio y seleccionar Tools / Run Script y Script y especificar el nombre del archivo HTML que ha sido creado. Esto •

es como generalmente correría, y esta es la única forma en la que puede chequear que la interfaz HTML luzca correctamente dentro de Datamine Studio. Studio. Pero para una vista rápida, 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 Studio corriendo corriendo..

Depurando su script Use los métodos descritos en lecciones previas para depurar su script.

49

 

Tutorial Scripting – Guía del Usuario Sugerencias para próximas extensiones

•

  El objetivo de esta lección ha sido el de aprender a diseñar la interfaz y fijar los operarios de

eventos. Sin embargo el script resultante tiene un número de limitaciones. Puede intentar las siguientess mejoras por su cuenta. siguiente

Copie un campo simple

•

  Esto convierte el comando “copiar” de de Datamine Datamine en una una co copia pia sselectiva, electiva, o ““selcop”. selcop”. Primero,

Instert / 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á vacío), necesitará usar la barra de herramientas “Positioning” (View/Toolbars/Positioning (View/Toolbars/Positioning en el menú). Sombree el objeto SELECT, e ingrese un ancho de 115 píxeles 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 método SLC makeFieldsPicklist( ) dentro del operario de evento onclick para btnBrowse1. El código de operario de evento en su integridad deberá lucir como este:

50

 

Tutorial Scripting – Guía del Usuario

•

  makeFieldsPicklist( ) toma dos argumentos : el nombre de la tabla de archivo, y el nombre de

la lista list a selec seleccionada cionada en donde los nombres están para ser añadidos. Es posible posibl e añadir un tercer argumento, opcional para este método, 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 necesitaremo s modificar el operario onclick   para el botón “OK”, btnOK. El

comando “copy” (copiar) se convierte en “selcop” (copia selecta), y necesitamos añadir el nombre del archivo seleccionado al comando. El nuevo código luce como este:

  La versión de referencia de de datos de proyecto Tutorial.

puede ser visualizada y guardada en su base

•

Copiando campos múltiples •

  Los cambios a la Interfaz del Usuario son fáciles: en el dialogo Properties para el elemento

SELECT, fije la altura (Height) a 4 líneas, y chequee el botón de radio “Allow multiple selections” (Permitir selecciones múltiples ). La Interfaz del Usuario deberá lucir como esta:

51

 

Tutorial Scripting – Guía del Usuario

•

  No se necesitan cambios en el script, aparte de añadir un código para extraer el valor de los

ítems seleccionados en el objeto SELECT. Esto se hace posible haciendo más cambios en el operador onclick  para btnOK.  

•

  La codificación requiere una comprensión más detallada de JavaScript y los trabajos del objeto

SELECT por si mismo. El código completo para la versión final del operador onclick está aquí:

52

 

Tutorial Scripting – Guía del Usuario

•

  La versión de referencia de

puede ser visualizada y guardada en su base

de datos de proyecto Tutorial. Siguiente Lección: Script de Ejemplo para Correr una Macro

53

 

Tutorial Scripting – Guía del Usuario Introducción 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 través de los comandos PROMPT o SCREEN. Sin embargo como ya se habrá dado cuenta la interfaz HTML le proporciona un método más atractivo, fácil de uso y comprensivo para el ingreso de archivos, campos, parámetros 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 través 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 información entre las sesiones Datamine. Es también el archivo usado por versiones anteriores a estos comandos, STKPAR y STKSAV. Los métodos VARLOAD( ) y VARSAVE( ) proveen las funciones equivalentes en programación y son incluidas como parte del SLC (Script Library Component, Componente de Librería de Script). También existe el método runMacro( ) en la biblioteca para facilitar la corrida de una macro desde un script. El siguiente ejemplo usará todos los tres métodos. VARLOAD( ) Variables de sustitución de un archivo Las variables leídas desde un archivo son añadidas a la lista actual si el parámetro MERGE es igual a 1, de otro modo cualquier otra variable actual será borrada. VARLOAD cargará (por defecto) todas las variables de sustitución, pero permitirá solo a un juego de variables nominados ser cargados y fusionados desde el archivo.  Apuntes: El formato: !VARLOAD [,MERGE=] [,MERGE=] [,DESC=$dname#][ ,$name# ...] es el nombre de ruta de archivo de sistema de hasta 56 caracteres de longitud. Si el parámetro “MERGE” no es especificado, o si es 1, cualquier variable que actualmente exista en la memoria es actualizada con el valor de archivo, y nuevas variables son añadidas a este en la memoria. Tanto y pueden ser variables sustitutas. La descripción entregada cuando el archivo fue creado puede ser reemplazada opcionalmente por una variable de

54

 

Tutorial Scripting – Guía del Usuario almacenaje . . Si la lista de variables opcional es presentada, presentada, solo estas variables variables son consideradas, de otro modo todas las variables serían cargadas. Esta lista se puede extender en tantas líneas como seas necesario; la continuación es posible finalizando la línea 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 [,MERGE=] [,DESC=][ [,DESC=][ ,$name# ...] es el nombre de ruta de archivo de sistema de hasta 56 caracteres de longitud. Si el parámetro “MERGE” no es especificado, o si es 0, todo el contenido es borrado primero. Si es 1, cualquier variable que actualmente exista en la memoria es actualizada con el valor de macro actual, y nuevas variables son añadidas a estas en la memoria. Tanto y pueden ser variables sustitutas. Una descripción para el contenido del archivo puede ser suministrada. La descripción es suministrada en la primera línea del registro del archivo con el número de revisión, y puede ser de hasta 68 caracteres de longitud. Las comillas pueden ser usadas para encerrar una descripción. Si la lista de variables opcional es presentada, solo estas variables son consideradas, de otro modo todas las variables serían guardadas. Esta lista se puede extender en tantas líneas como seas necesario; la continuación es posible finalizando la línea anterior con una coma. Por ejemplo: !varsave \datamine\projects\$proj, merge=1 , $title1#, $title2#, $xmin#, $xmax#, $ymin#, $ymax#  $ymax# 

55

 

Tutorial Scripting – Guía del Usuario Macro de Ejemplo Usando XRUN Para este ejercicio añadiremos una interfaz HTML a una macro que crea un plan de locación de collar. La macro usa las técnicas estándar para fijar valores predeterminados y de requerimiento. Los pasos principales son: Definir los valores predeterminados para variables de sustitución Probar si el archivo “var” existe, y si es así, cambiar los defaults iniciales por los valores gua rdados. Usar PROMPT para definir los valores actuales, con defaults como fueron definidos en pasos previos. Crear y mostrar el archivo de gráfica Guardar las variables de sustitución

Examine el macro Usted verá que las cinco variables de sustitución que son requeridas para usar el comando PROMPT son: •

  $COLLFILE#

- el archivo collar de entrada

•

  $PLOTFILE#

- el archivo de gráfica de salida

•

  $VALUE $VA LUE# #

- el campo a ser inscrito

•

  $TITLE# $T ITLE#

- el título de gráfica

•

  $NUMBER# $NUM BER#

- el número de referencia de gráfica

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. Tutori al. Luego corra la macro tomando todos los valores predeterminados de los requerimientos. La macro creará y mostrará una gráfica de locación de collar:

56

 

Tutorial Scripting – Guía del Usuario

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

Note que los valores de las cinco variables de sustitución están mostrados. Después que la gráfica ha sido creada la variable $NUMBER# $NUMBER# es incrementada en 1, y las variables variables son guardadas en e ell archivo var collplot.var. Los nuevos valores son mostrados en la ventana Output (de salida):

57

 

Tutorial Scripting – Guía del Usuario

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

58

 

Tutorial Scripting – Guía del Usuario Creando la Interfaz  Ahora usaremos FronPage FronPa ge para crear una interfaz interf az y para ingresar ingresa r cinco variab variables les de sustit sustitución ución File/ New /Page / Normal Page  Page  o requeridas para correr la macro. Inicie un nuevo archivo ((File/

)e

inserte una tabla de 7 filas y 3 columnas para crear una interfaz como la mostrada en el diagrama. Los métodos usados para la fijación 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á será suficiente. Por defecto, los valores ingresados en las cajas de texto son alineados a la izquierda. Esto es apropiado para valores alfanuméricos pero tal vez prefiere valores numéricos 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  Right 

Asigne Nombres y Valores a los Controles  Asigne nombres a las l as cajas de texto, botones y listas desplegables como sigue sigue:: DESCRIPC DESC RIPCIÓN IÓN

TIPO TIPO

NOMBRE

Input collars file name / Ingresa un archivo de collar

Caja de Texto

tbIN1

Browse for collars file / Explora por un nombre de Botón a puls pulso o

59

btnBr btnBrowseIN owseIN1 1

 

Tutorial Scripting – Guía del Usuario archivo de collar Field to annotate/ Campo a ser inscrito

Desplegable

Output plot file name / Salida de nombre de archivo Caja de Texto

ddFieldsIN1 tbOUT1

de gráfica Browse for output file / Busca por un archivo de salida Botón a pulso puls o Plot title / Título de Gráfica Caja de Texto

btnBrowseOUT1 tbPlotTitle

Plot number / Número de Gráfica

Caja de Texto

tbPlotNumb tbPlo tNumber er

Creat Plot / Crea gráficos

Botón a Pulso

btnCreatePlot

Load defaults / Carga defaults

Botón a Pulso

btnLoad

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

60

 

Tutorial Scripting – Guía del Usuario

Agregando el Script 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. Más detalles se proporcionan en las secciones de abajo: DESCRIPC DESC RIPCIÓN IÓN

TIPO

Input collars file name / Ingresa Caja de Texto Texto

NOMBRE

Evento

tbIN1

Onpropertychange

btnBrowseIN1

onclick

un archivo de collar Browse for collars file / Explora Botón a pulso por un nombre de archivo de collar Field to annotate/ Campo a ser Desplegable

ddFieldsIN1

inscrito Output plot file name / Salida de Caja de Texto nombre de archivo de gráfica

tbOUT1 tbOU T1

Browse for output file / Busca por Botón a pulso

btnBrowseOUT1 btnBrowseOU T1

un archivo de salida Plot titl title e / Título Títul o de Gráfica Gráfi ca

Caja de Texto

tbPlotTitle tbPlotTi tle

Plot number / Número de Gráfica

Caja de Texto Texto

tbPlotNumber

Oncli Onclick ck

Creat Plot / Crea gráficos

Botón a Pulso

btnCreatePlot btnCreatePlot

Onclick Oncli ck

Load defaults / Carga defaults

Botón a Pulso

btnLoad

Oncli Onclick ck

Métodos de Componente de Librería Script Los operadores de eventos que estamos a punto de crear usan los métodos y propiedades de librería resumidos en la tabla. Más detalles son proporcionados en la sección relevante debajo tipo

Nombre

DESCRIPC DESC RIPCIÓN IÓN

Método Métod o

makeFieldsPicklist( )

Llena una lista seleccionada con los nombres de los campos en un archivo Datamine

Método

browseForFile( browseForFil e( )

Explora una tabla de archivo en un proyecto actual Datamine Studio

Método

runMacro ( )

Ejecuta una macro Datamine, luego vuelve al script

Método

varsave ( )

Guarda valores a ser usados como variables

61

 

Tutorial Scripting – Guía del Usuario sustitutas en una macro Método

vrload ( )

Carga valores de un archivo de macro “!VARLOAD” “!VARLO AD”

Método

initialize initiali ze ( )

Inicializa el Componente de Biblioteca de Scrip Datamine Studio SLC

propiedad

typeCollar typeCollarss

Escribe un código para el archivo Collars de Datamine Studio

propiedad

typePlot ty pePlot

Escribe un código para el archivo de Gráfica de Datamine Studio

propiedad

proj proj ectF ectFolder older

La carpeta que contiene la carpeta actual del proyecto Datamine Studio

Microsoft Script Editor

 Abra el editor ed itor Microsoft Script Editor (Tools/Microsoft Script Editor o

) y asegúrese que está

creando JavaScript no VBScript. (View/ (View/ Property Pages/ General / Default scripting language/ Client: JavaScript). JavaScript).  

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

62

 

Tutorial Scripting – Guía del Usuario 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 carácter +, para mostrar la lista de eventos y seleccione el evento onpropertychange. Esta elección 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 – vía el explorador. El evento onpropertychange  es activado cada vez que cualquier propiedad (en este caso la propiedad “value”) cambia, por cualquier razón. El script que corre cuando el nombre del archivo de entrada cambia usa el método makeFieldsPicklist makeFieldsPickli st ( ) 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 línea) y cópielo dentro del script en la ventana del editor Microsoft Script Editor (MSE). Cuando lo pegue en la ventana MSE debe usar la opción Paste as HTML (Pegar como HTML), el cual obtiene del menú haciendo clic derecho.

btnBroseIN1 – Entrada al Botón del Explorador del Archivo Collars  Agregue un evento onclick para el ingreso del botón del explorador del archivo collars btnBrowseIN1. Esto traerá al frente al explorador del archivo:

63

 

Tutorial Scripting – Guía del Usuario

Los argumenos del método browseForFile ( ) son: 1. Tipo de archivo requerido : un un archivo collars 2. Nombre de archivo archivo predeterminado: predeterminado: ingrese un valor nulo nulo para no default. default. Note qu que e 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) falso) porque el archivo ya existe. Copie el JavaScript y péguelo en el script.

BtnBrowseOUt1 - Salida del Botón de Exploración del Archivo de Gráfico a  Agregue un evento onclick para la salida del botón de exploración del archivo de gráfica 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 Botón de Gráfica  Agregue un evento onclick para la creación de botón de gráfica btnCreatePlot  

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

64

 

Tutorial Scripting – Guía del Usuario 1. El nombre (path, trayecto) del archivo var a ser guardado guardado 2. Fusionar (true, verdadero) o sobreescribir el archivo var (false, falso) El evento también usa el método 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 péguelo dentro del script.

BtnLoad - Cargue Botones Botones Predeterminados Predeterminados  Agregue un evento onclick  para   para la carga de botones predeterminados btnLoad

Este evento usa el método 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 péguelo dentro de su script.

Evento onload onload (en carga) en Ventana  Agregue un evento de ventana onload  .  . Este evento se emite tan pronto como todo en una página ha finalizado su carga, y pueda por lo tanto ser usado para su inicialización. Cuatro tareas de inicialización necesitan ser llevadas acabo para habilitar la corrida del script correctamente. 1. Definir Definir el nombre del archivo archivo var para transferir var variables iables entre el script y la ma macro. cro. El trayecto es descrito creando una string de texto combinando la propiedad  proyectFolder   y el nombre nombre de archivo como fue definido por la variable collplot.var. Note que que

es requerido

en frente del nombre de archivo, porque una simple está reservada par caracteres

65

 

Tutorial Scripting – Guía del Usuario 2. Defina los objetos (variables) cuyos valores están por ser guardados en archivos var. Hacemos esto añadiendo una propiedad “.macro” a estos objetos. Existen formas alternativas de definir los valores como veremos en ejercicios próximos. 3. Fije valores iniciales (ej. Defaults) para las cajas de texto. Los valores predeterminados pueden también ser fijados usando Format / Properties  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 péguelo dentro de su script Haciendo una conexión con el SLC Los eventos que hemos definido hasta ahora usan métodos 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

conexión 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

66

 

Tutorial Scripting – Guía del Usuario dm como una variable global. Esto no es una práctica recomendad puesto que la variable podría ser usada en cualquier otra parte en la biblioteca para cualquier propósito. propós ito. Por lo tanto definimos dm para ser local a nuestro script poniendo la definición al principio de la sección de JavaScript del documento como se ve en el siguiente ejemplo

Copie el JavaScript y péguelo dentro de su script Evento onunload (en descarga) en ventana Es buena práctica la de añadir una ventana de evento onunload . Esto descarga el SLC y despeja cualquier memoria que fue asignada cuando la página fue cargada.

El Script Completo Un ejemplo de script completo es mostrado aquí

. Si quiere usar la

versión de referencia, entonces abra el archivo haciendo clic en el botón y use File / Save As para  

guardarlo en su directorio de proyecto Tutorial.

67

 

Tutorial Scripting – Guía del Usuario 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 método runMacro ( ) que ha especificado en collar_plot_1.htm 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 también remover el código inicial en la macro el cual fija los valores por defecto para las variables de sustitución de la misma forma que todos los valores son fijados en el script.  Alternativamente,  Alternat ivamente, abra lla a versión vers ión de referencia referenci a del macro en Notepad Note pad (b (bloc loc de notas) haciendo clic en el botón

As  para guardarla en el directorio de proyecto y use File/ Save As 

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 botón Create Plot (Crear Grafica) Cuando el script haya corrido haga clic en el botón Load Defaults (Cargue Defaults). Esto cargará las variables del archivo var que fue creado por la macro. Note que el número de plot ha cambiado de 1 a 2.

Validación No hemos hem os incluido incl uido alguna alguna validación 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 validación puede ser realizada usando JavaScript, pero no es parte de este ejercicio. Siguiente Lección: Otros Ejemplos

68

 

Tutorial Scripting – Guía del Usuario

Introducción 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 características del lenguaje scripting.

69

 

Tutorial Scripting – Guía del Usuario

Creación de un Modelo Prototipo Este script de ejemplo

le provee de una interfaz para la definición de

parámetros 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: DESCRIPC DESC RIPCIÓN IÓN

Tipo

Nombre

Model File Name / Nombre de Archivo Caja de Texto

Evento

tbModel tbMode l

de Modelo Model o Browser Brows er

Botón a pulso

btnBrows btnBrowse e

Onclick Oncli ck

X Origin / Origen

Caja de Texto Texto

tbOriginX

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

onch onc hange an ge

onchange onchan ge

onchange

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

70

 

Tutorial Scripting – Guía del Usuario onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

onchange onch ange

onchange onchan ge

onchange

onchange onchan ge

Maximum Max imum / Máximo Máxi mo X

Caja de Texto

tbMa tb MaxX xX

Maximum / Máximo Y

Caja de Texto Texto

tbMaxY

Maximum Maxi mum / Máximo Máxi mo Z

Caja de Texto

tbMaxZ tbMa xZ

Sub-Cell Selection/ Selección de Sub Caja de Chequeo

cbSubcells

Celda Run Script / Correr Script  

Botón a Pulso

btnOK

onclick onclic k

Métodos SLC Los métodos SLC usados por la script son los siguientes: tipo

nombre

descripción descripción

método

initialize initiali ze ( )

Inicializa el componente de Librería de Script de Datamine Studio (SLC).

método

unLoadDMLib unLoa dDMLib(( )

Libera una conexión al SLC

método métod o

command ( )

Ejecuta

un

comando

Datamine

Studio método

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 vinculándolas. Las esquinas del modelo son numeradas como se ilustran aquí:

71

 

Tutorial Scripting – Guía del Usuario

Comandos con respuestas interactivas Si registra un comando de base de datos como PROTOM que tiene respuestas interactivas entonces las respuestas serán 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 carácter de string como “ ”.

El Monitor de Progreso Puede agregar un monitor de progreso dentro de su script usando Insert / Advanced / ActiveXControl / Microsoft ProgressBar Control, versión 6. Si el control Active X no está disponible entonces trate usando el editor editor Microsoft Script Editor como sigue: 1. Haga clic en el cursor exactamente luego de la etiqueta 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, Bar, versión versión 6.  Al inicio i nicio de la función principal defina una vvariable ariable (delta) y fíjela fí jela de modo que ssea ea igual igu al al número de veces que piensa actualizar el monitor (ej: 7). Exprésela como un porcentaje. Inicialice el valor de la Barra de Progreso. Progreso. Por ejemplo:

72

 

Tutorial Scripting – Guía del Usuario

Entonces tendrá que insertar el número correcto (ej: 7) de actualizaciones de la Barra de Progreso dentro del código:

Este es un atajo para añadir delta al valor actual de ProgressBar1.Value. Al final de la función deberá reajustar el valor a cero.

Puntos a tener tener en cuenta Las cajas de texto Máximas (Maximum) están protegidas contra escritura. También están dotadas con un fondo sombreado

73

 

Tutorial Scripting – Guía del Usuario

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 añadida al nombre de cada caja de texto de modo que las variables serían escritas al archivo var. Si quiere transferir variables que están calculadas dentro del script en vez que especificadas por el usuario entonces aquí hay una forma alternativa de hacerlo como se ilustra en la script

y macro

.

En este ejemplo el cálculo de las dimensiones del gráfico 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

74

 

Tutorial Scripting – Guía del Usuario 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 método attachTable ( ) para definir un objeto de tabla, y luego la propiedad openrecords ( )  para crear un registro ActiveX Data Object,  ADO , (Objeto  ADO, Objet o de información infor mación Active X) ffijado ijado sobre el objeto o bjeto de tabla. tabla. Este puede ser u usado sado para manipular el registro de propiedades. Para más información sobre ADO diríjase a www.microsoft.com/data/ado . El proveedor OLEDB de Datamine actualmente le permite la lectura y actualización de registros existentes. Pero no permite la creación de nuevos registros o nuevos archivos.

75

 

Tutorial Scripting – Guía del Usuario El método de menú Command DCM DCM En los ejemplos anteriores todos los procesos y comandos de la ventana Design han estado disponibles a través del método command   del DCM o del SLC básico. La sintaxis para ambos es idéntica. Por ejemplo:

En cada caso el juego total de archivos, parámetros y respuestas interactivas debe ser incluido dentro de la string que es enviada mediante el método 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 método menuCommand   del DCM en lugar del método command. Por ejemplo:

En el primer ejemplo interactivamente se le requerirá por: el origen del modelo, tamaño de celdas, etc, y para el comando de archivo de modelo abierto abierto se le requerirá, con un diálog diálogo o interactivo: ingresar el nombre de archivo, usando el explorador de archivo de proyecto, y luego la densidad predeterminada y selección de campo. Note que la sintaxis para el argumento del método de menuCommand   es diferente al método command . El método menuCommand   usa la misma sintaxis que en las macro. Por lo tanto las

especificaciones de archivo y campo usan paréntesis 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 método menuCommand . La interfaz le permite seleccionar un archivo de gráfica Datamine usando el explorador y sobreponiéndola en la ventana Design. Luego le provee botones de zoom y pan. Los comandos gráficos de zoom y pan requieren interacción de usuario. Los gráficos de zoom necesitan que el usuario para seleccione una esquina del rectángulo del zoom y luego que arrastre el cursor a la esquina de la diagonal opuesta, y los gráficos-pan requieren dos puntos a ser seleccionados. Por lo tanto estos dos comandos trabajan usando el método menuCommand . Note

76

 

Tutorial Scripting – Guía del Usuario que el cursor no cambia a una lupa magnificadora cuando usa gráficos de zoom con menuCommand  , como si lo hace cuando usa el command  directamente.  directamente. Esta es una característica

de Windows!

 A pesar que todos los comandos pueden pueden correr usando menuCommand , solo debe usar este método cuando requiera interacción de usuario. Para otros propósitos use el método command . Esto es porque usando el método command   cada comando debe completarse antes que el siguiente sea activado, en tanto que, si menuCommand   es usado sin interacción 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 botón, una acción puede ser iniciada haciendo clic en un gráfico. Use el comando Insert / Form / Picture para insertar un gráfico, y luego seleccione el gráfico y use Format / Properties para asignarle un nombre. Todos los eventos (onclick, etc) para el gráfico estarán disponibles cuando use MSE. Por lo tanto puede fácilmente cambiar los botones por sus propios íconos.

Información Informaci ón Final Esperamoss que haya disfrutado el tutorial de programación y lo haya encontrado muy útil. Esperamo Para información de entrenamiento de scripting por favor contacte a su oficina de soporte Datamine (([email protected] [email protected] )

77