GSAK 301!Automatizar GSAK: Introduccin a las macrosEsta es una gua bsica para aquellos que quieren utilizar la automatizacin GSAK, o "macros". Todo el texto se subraya en esta gua es un enlace a un sitio web - haga clic en el texto subrayado para ir directamente a esa pgina web. Por favor, tenga en cuenta: Esta gua cubre la automatizacin de GSAK. Est diseado para ser ledo de principio a fin (aunque no necesariamente en una sola sesin!), Y cada seccin se basa en el ltimo Si usted se salta a la partida de temas sin necesidad de leer a travs del material anterior, es posible que pierda los puntos clave y terminan irremediablemente confuso. Adems, esta gua asume que usted est familiarizado con las caractersticas y funciones GSAK. Si usted no est familiarizado con GSAK, por favor lea GSAK 101 - Introduccin y GSAK 201 Personalizacin GSAK. Muchas de las caractersticas GSAK no se abordan aqu - para obtener informacin sobre las caractersticas, consulte el archivo de ayuda GSAK (en GSAK, vaya al men "Ayuda", a continuacin, haga clic en "Ver", o pulse la tecla F1 del teclado del ordenador). Para obtener ayuda sobre macros, en GSAK ir a la "macro" del men y haga clic en "Ayuda". Aquellos con experiencia en programacin de computadoras puede encontrar esta gua muy bsico - si usted se siente cmodo con las secuencias de comandos, se puede bucear en derecho, utilizando el archivo de ayuda GSAK como su gua.

QU SON LOS "MACROS"?No, no estamos hablando de pasta. "Macro" es technospeak de una serie de instrucciones que automatizar una funcin o caracterstica. GSAK tiene la automatizacin o "macro" de apoyo que permite a los usuarios a escribir una serie de instrucciones GSAK un archivo de texto. Los usuarios pueden crear un archivo de macros con cualquier editor de texto, incluyendo GSAK construido en editor de macros (en GSAK, ir a la Macro> Editar / Crear para abrir el editor de macros).

POR QU UTILIZAR MACROS?Las macros se utilizan para automatizar las funciones ms utilizadas (por ejemplo, reemplazar una serie de acciones de los usuarios, con uno) o para habilitar las caractersticas ms potentes no estn disponibles en GSAK de "apuntar y hacer clic" interfaz de usuario. Digamos que con frecuencia descargar una pregunta de bolsillo, cargue el archivo GPX en GSAK, ordenar el archivo por "ltima GPX" la fecha, comprobar para ver si cachs que no fueron actualizados son archivados, el filtro de la distancia de su casa, y exportar el prximo 500 cachs a un programa de mapeo y su receptor GPS. En lugar de pasar por cada uno de estos pasos de forma manual cada vez que recibe una consulta de bolsillo, puede utilizar una macro para hacer todo esto con un solo clic del ratn (es decir, automatizar una serie de acciones).

O bien, digamos que usted desea ordenar de forma simultnea por mltiples columnas GSAK (por ejemplo, propietario de cach, la fecha colocada, encontrado por fin), o usar un pedazo de informacin en GSAK para el que no hay "etiqueta especial". Estas cosas pueden slo hacerse a travs de una macro (es decir, habilitar las caractersticas ms potentes).

SON MACROS DIFCIL DE USAR?Las macros son fciles de usar - Clyde (Autor GSAK) y los usuarios GSAK han creado muchas macros y les hizo disponible gratuitamente para todos los usuarios en el GSAK Macro Biblioteca. La biblioteca de macros est organizado en categoras generales basadas en el resultado final de la macro desde la perspectiva del usuario. Si usted no puede encontrar lo que ests buscando en una determinada categora o no quieren navegar por las categoras, utilizar la funcin de bsqueda en el foro para buscar en la biblioteca de macros entero. Nota: Hubo cambios significativos en las macros GSAK en la versin 6.6, y los cambios adicionales en la versin macro GSAK 7. Si usted no est utilizando la ltima versin del GSAK, por favor descargue la actualizacin de la GSAK tu pgina de inicio e instalarlo antes de intentar ejecutar estas macros. Esta gua asume que usted est utilizando la versin GSAK 7 o superior.

To utilizar una macro de la Biblioteca de Macro:1) Lea la descripcin del: Haga clic en un tema que le interese y lee lo que la macro. Si usted est interesado en esa macro, 2) Compruebe la macro para cualquier personalizacin requerida: La mayora de las macros no requieren ningn ajuste, pero algunos lo hacen (por ejemplo, crear un filtro guardado antes de ejecutar la macro, por primera vez). La descripcin en el foro de la Biblioteca Macro le dir si necesita realizar cambios en la macro para la configuracin nica. Si desea utilizar la macro, 3) Instale el Macro (Versin GSAK 7): La ltima versin de la macro est en el ltimo puesto en el tema, y puede contener caractersticas o correcciones adicionales en comparacin con versiones anteriores. A. Haga clic en el archivo adjunto:

B. La pantalla de descarga aparecer el siguiente - haga clic en "Abrir":

C. GSAK comenzar (si no est ya en ejecucin) y la siguiente pantalla aparecer. "Instalar la macro" debe seleccionado. Haga clic en el botn "Go": D. La macro se instalar.

ser

5) Personalizar (si es necesario - ver paso 2): Si usted est obligado a cambiar la configuracin de macros (por ejemplo, filtros guardados, nombres de archivos o las rutas de carpeta), abierto GSAK e ir a la Macro> men Editar / Crear. Haga clic en Archivo> Abrir en el editor de macros y seleccione la macro que acaba de instalar. Haga los cambios necesarios y guarde el archivo. 6) Ejecutar la macro: Para utilizar la macro, vaya a la macro> Ejecutar / Administrar en los mens GSAK (o pulse Ctrl-M en su teclado). El "Ejecutar macro" de dilogo se abrir, mostrando una lista de todas las macros instaladas:

Haga clic en la macro que desea ejecutar en "archivo de macro" y haga clic en el botn "Ejecutar" en la parte inferior del cuadro de dilogo (o simplemente haga doble clic en el nombre del archivo macro). La macro se ejecutar y llevar a cabo lo que sea la magia que fue diseado para llevar a cabo. Para obtener ms informacin sobre las caractersticas de dilogo Ejecutar / Administrar, consulte el archivo de ayuda GSAK (Ayuda> Contenido> Uso GSAK> Macros (automatizacin de GSAK)> Gestin y Ejecucin). GSAK usuarios que publican las macros tambin su mantenimiento. Por favor, recuerde que estos

son otros usuarios que voluntariamente ofrecen su trabajo a los dems. Si tiene alguna pregunta por favor, puesto en el Macros foro de soporte, con un enlace o referencia a la macro publicados. Nota: Si se trata de una macro que vamos a usar a menudo, es posible que desee agrega a su barra de herramientas. Ahora slo ser un clic de ratn!

ES DURO PARA CREAR MACROS?Ya sea que usted encontrar la creacin de una macro fcil o difcil depende de la complejidad de las tareas que desee automatizar. Tambin depende de la cantidad de atencin que usted paga a los detalles, su paciencia y su aptitud para el pensamiento lgico. Muchos escritores de macro comenzar la automatizacin de una tarea bastante fcil (vamos a dar ejemplos a continuacin), o comenzar por el estudio, copia de las piezas, o "pellizcar" un macro a alguien ms escribi. Todas las macros en el GSAK Macro Biblioteca puede ser libremente copiado y editado. Una gran manera de aprender cmo funcionan las macros es ver cmo los usuarios han hecho otras cosas en su macros.

ESCRIBIENDO SU PRIMERA MACRO BMacros AsicEn su forma ms simple, una macro puede ser una sola lnea. Slo para mojarse los pies, vamos a escribir y ejecutar una macro simple. Esta macro dir GSAK para detener lo que est haciendo y mostrar una ventana de dilogo con un mensaje que hemos creado (en este caso, el mensaje ser "Mi primera macro es un xito!"). En primer lugar, en GSAK, ir a la Macro> Editar / Crear. Ahora escriba (o copiar y pegar) el texto de color rosa exactamente como se muestra aqu (no ser color de rosa en el editor de macro - eso est bien): Mensaje PAUSA = "Mi primera macro es un xito!" Ahora ve al men Archivo en el editor de macros y seleccione "Guardar y ejecutar". Una ventana de dilogo pop-up le pide que nombre a su macro. Tipo "MyFirstMacro" en el cuadro Nombre de archivo (en lugar de "nueva macro") y haga clic en el botn "Guardar":

GSAK se guarde y ejecute la macro, y una ventana de dilogo se abrir, mostrando nuestro mensaje:

Haga clic en el botn "Continuar" para terminar la macro. Usted es ahora oficialmente un escritor macro GSAK!

PLanning una macro ms compleja - el proceso lgicoEl primer paso para escribir una macro ms compleja es definir claramente qu es lo que quieres hacer. Esto significa no slo el resultado final, sino tambin la secuencia de pasos en un orden lgico - es decir, "primero lo primero". Si usted quiere encontrar un geocach (el resultado final), primero tiene que entrar en su coche y conducir una ruta especfica, con varias vueltas en el camino (los pasos). En la planificacin de una bsqueda de tesoros, que no comenzara a pensar en donde puedes buscar el cach, una vez que llegamos all. En primer lugar, pensar en cmo llegar desde donde usted est en la memoria cach y slo entonces piensa usted de donde puedes buscar el cach. Escribir una macro consiste en una similar, paso a paso del proceso. Si olvida una vez a lo largo de la unidad que no va a terminar en la cach, y si se deja a un paso de una macro no obtendr el resultado deseado!

Para empezar, vamos a planear y escribir una macro relativamente simple, pero til. El resultado de esta macro es para seleccionar los 200 cachs ms cercanos a un punto dado para ver, enviar a un receptor GPS, o exportarlo a un archivo u otro programa (por ejemplo, un programa de mapeo o CacheMate). Los pasos lgicos para obtener este resultado son: 1) Seleccione la base de datos que contiene las memorias cach que desee, 2) Clasificar los cachs segn la distancia a la ubicacin seleccionada 3) Seleccione los primeros 200 cachs (los ms cercanos a su ubicacin) 4) Filtro para las cachs seleccionadas. Esta macro es similar a realizar las siguientes acciones de los mens GSAK: 1. Seleccione una base de datos (Base de datos> Seleccionar) 2. Ordenar la base de datos de la distancia desde la ubicacin actual (haga clic en las "millas" o de la columna "Km" la partida) 3. Borrar todas las banderas de los usuarios (Banderas de usuario> Borrar todos los estandartes de usuario) 4. Establecer las banderas de los usuarios para los prximos NN (Banderas de usuario> fijada para el prximo nn) 5. Establezca un filtro en las banderas de los usuarios = conjunto Sin embargo, una gran diferencia es que la macro utiliza la "bandera macro" para establecer y filtrar, en lugar de la bandera del usuario. Esto significa que los previamente establecidos banderas de los usuarios no se ven afectados por ejecutar la macro.

Tque GSAK Macro EditorAunque puede utilizar cualquier editor de texto plano para escribir una macro (por ejemplo el Notepad de Windows), GSAK tiene un editor de macros integrada que es fcil de usar, ya que est integrado con GSAK. Usted puede probar ejecutar las macros desde el editor de macros (Archivo> Guardar y ejecutar o CTRL-R) y, si la macro produce un error, usted puede pulsar un botn para volver al editor de macros en la lnea donde se produjo el error. Para crear una nueva macro en el editor de GSAK macro, en GSAK ir a la Macro> Editar / Crear.

Writing una macro - con ayuda de los archivos de ayuda macroAl escribir una macro, el archivo de ayuda GSAK macro es como un diccionario de la lengua extranjera - que le indica cmo traducir lo que quieres hacer en trminos que GSAK entiende. Para acceder al archivo de ayuda macro, en GSAK ir a la Macro> Ayuda. Al igual que cualquier lenguaje, hay varias categoras de trminos en el lenguaje de macros. Estos son sealados como enlaces en la parte superior de la Ayuda de Macro y haga clic en uno de los enlaces resaltados le llevar a la lista de trminos disponibles, sus definiciones, y su sintaxis (las opciones asociadas a ese trmino). No se preocupe por memorizar toda esta informacin ahora (hay tantas cosas que puedes hacer en macros GSAK que puede hacer girar su cabeza). Nosotros le daremos una visin general de las condiciones generales aqu, pero siempre se puede hacer referencia a la ayuda macro si se olvida

de lo que algo es. Tambin explicaremos cmo utilizar realmente algunos de estos trminos de nuestro ejemplo (ms adelante). Dicho esto, aqu estn los tipos de cosas que encontrars en la ayuda macro (el diccionario de lenguaje de macros): Comandos y funciones - Dice GSAK a tomar medidas! Estos son los "verbos" del lenguaje de macros (los programadores de computadoras le dir que hay una diferencia entre los comandos y funciones, y tienen razn, pero no vamos a entrar en eso aqu). Para ver todos los comandos disponibles en GSAK, haga clic aqu y luego haga clic en "Resumen de los comandos". Para obtener una lista de funciones disponibles en GSAK, haga clic aqu y luego haga clic en "resumen de la funcin". Variables: Son las cosas que emprender acciones al (los "sustantivos" del lenguaje de macros). Existen varios tipos de variables: Creado por el Usuario variables: son trminos que se definen para almacenar informacin, ya sea para uso en la macro, o para su utilizacin en el resultado. Todas las variables de usuario creadas comenzar con un signo de dlar ($) y se puede nombrar casi cualquier cosa que desee (por ejemplo, $ MiVariable es un usuario vlido variable creada), siempre es que comienza con $. La nica excepcin a las variables de usuario creadas libremente de nombres es cuando ese nombre se reserva para una variable de base de datos o sistema: Variables de base de datos: son trminos predefinidos que representan la informacin (datos) almacenados en GSAK. Todas las variables de bases de datos comienzan con "$ d_". Por ejemplo, el cdigo nico de GC o de otro tipo para una cach o punto de referencia se almacena en la base de datos variable $ d_Code. Para obtener una lista de variables de bases de datos disponibles en GSAK, haga clic aqu. No se puede utilizar $ d_ para nombrar creada por el usuario variable debido a que el prefijo est reservado para las variables de base de datos. Las variables del sistema: son trminos predefinidos que representan la informacin que existe en su sistema informtico cuando GSAK se est ejecutando, pero fuera de la base de datos en s (es decir, que no es punto de referencia o informacin de la cach). Todas las variables del sistema comienzan con "$ _". Por ejemplo, la base de datos seleccionada se almacena en $ _CurrentDatabase, y el lugar en el equipo donde est instalado GSAK se almacena en la variable de sistema $ _Install. Para obtener una lista de todas las variables disponibles en el sistema, haga clic aqu y haga clic en "variables del sistema". Una vez ms, no se puede utilizar el prefijo $ _ para una creada por el usuario variable porque est reservado para las variables del sistema. Expresiones: Las expresiones que permiten realizar acciones matemticos o lgicos o pruebas sobre las variables y datos. Por ejemplo, las expresiones le permiten sumar, restar, multiplicar, comparar (igual, no igual a, mayor que, menor que) o lgicamente combinar (AND, OR y NOT) trminos diferentes. Para ver las expresiones disponibles en GSAK, haga clic aqu y luego desplcese hacia abajo para "Operandos variable", "Operadores relacionales" y "Operadores lgicos" (no se preocupe, usted no tiene que ser un matemtico, a pesar de los nombres esotricos!).

Enough ya! Vamos a escribir una macro:

OK, vamos a empezar con el ejemplo que se menciona en "la planificacin de una macro", arriba. Recuerde que queremos mostrar ms cercanos a los 200 cachs a nuestra ubicacin, y son los pasos: 1) Seleccione una base de datos, 2) Ordenar la base de datos de la distancia desde la ubicacin actual, 3) Seleccione los primeros 200 cachs (los ms cercanos a la ubicacin), 4) Filtro para las cachs seleccionadas. Si an no lo ha hecho, abra el editor de GSAK macro (en GSAK, Macro> Editar / Crear) y vamos a empezar. Nota: El verdadero "cdigo de macro" (instrucciones) se muestran en esta gua en rosa para que sean fciles de distinguir de las explicaciones que la acompaan. Usted puede entrar en cada lnea a medida que avanzamos, o usted puede copiar y pegar la macro final (que se muestra al final de esta discusin) en el editor de macros. Paso uno: Es una buena prctica incluir comentarios en las macros. Un comentario es cualquier lnea que comienza con el carcter #, y cualquier lnea que comienza con # es ignorado por GSAK. Por lo tanto, la primera lnea de nuestra macro es un comentario que nos recuerda lo que hace esta macro: # Macro para seleccionar un nmero de cachs que son los ms cercanos a una ubicacin Puede utilizar comentarios en cualquier lugar de la macro que te gusta, y lo recomendamos encarecidamente! Las macros que estn "bien documentados" (tienen buenos comentarios) le ayudar a "depurar" (corregir los errores en) la macro, y que ayudar a usted ya otros a entender lo que la macro est haciendo (es increble lo rpido que se puede olvidar lo que hiciste , o por qu lo hizo, cuando uno mira hacia atrs en una macro que escribi). Paso dos: Ahora que sabemos lo que esta macro est destinada a hacer, tenemos que seleccionar una base de datos que tiene el cach que est interesado pulg Para el propsito de esta leccin, vamos a seleccionar la opcin "por defecto" base de datos porque siempre tiene GSAK un "defecto" de base de datos. El comando para seleccionar una base de datos es la siguiente: Nombre de la base = "default" Action = Select La primera parte de esa lnea (BASE DE DATOS) es el comando, y le dice a GSAK que queremos hacer algo con una base de datos. La segunda parte (= nombre) le dice a GSAK que base de datos que desea actuar. La tercera parte (Action =) dice GSAK qu que quieres hacer con esa base de datos. En este caso, le estamos diciendo a GSAK para seleccionar o cambiar a la base de datos llamada "Default". Si vas al archivo de ayuda macro (macro> Ayuda, o en lnea haga clic aqu), Haga clic en el "Resumen de los comandos" vnculo y, a continuacin, haga clic en "BASE DE DATOS", ver la siguiente "sintaxis" para el comando BASE DE DATOS:

BASE DE DATOS [] En los archivos de Ayuda de macros, se da la orden en primer lugar, por lo general en letras maysculas. "Fichas" completar el comando, y estn rodeadas por (no se incluyen estos cuando se crea una macro) y los elementos entre corchetes ([..]) son opcionales. Las opciones vlidas para los tokens estn separados por una | (una barra vertical). Todos los comandos, fichas, y los parmetros son no maysculas y minsculas (es decir, la capitalizacin no es importante). En este caso, el comando es DATABASE y deben ser incluidos. NAME es un smbolo necesario y "base de datos" (el nombre de su base de datos real) se debe incluir entre comillas dobles (que es por eso que se cita en el archivo de ayuda). Accin (en la plaza entre parntesis) es opcional - se puede incluir o no. Si la accin no est incluido, GSAK asumir "seleccionar" - este valor por defecto asumido por un token de opcionales siempre se destac en el archivo de ayuda. Debido a la accin por defecto para el comando BASE DE DATOS es "Select", que podra haber salido del Action = smbolo fuera y ha conseguido el mismo resultado. Paso tres: Ahora que hemos dicho GSAK qu base de datos que desea que la macro para trabajar, tenemos que ordenar los cachs en esa base de datos de la distancia desde la ubicacin actual, desde el ms cercano al ms lejano. Para ello, entramos en: ORDENAR POR = "distancia" Secuencia = A SORT es el comando, por = es la columna GSAK queremos ordenar (vase la SORT comando en el archivo de ayuda para obtener una lista de nombres de columna) y Secuencia = GSAK dice si queremos ordenar de menor a mayor (es decir, ascendente = A) o de mayor a menor (es decir, descendente = D). Secuencia = es opcional, y el valor por defecto es ascendente (A), por lo que podra haber dejado que fuera testigo y ha conseguido el mismo resultado. Paso cuatro: Bien, estamos en la base de datos correcta y hemos ordenados por distancia. Ahora vamos a pedir al usuario cmo muchos alijos que desea seleccionar. La siguiente lnea en la macro es la siguiente: Mensaje = INPUT "Cmo que muchos puntos de inters se desea seleccionar" default = "200" El comando INPUT permite al usuario "de entrada" (tipo de) informacin. Es un comando muy til cuando se desea para permitir diferentes respuestas a una pregunta. Mensaje = es el smbolo de mensaje - lo que pones despus de Mensaje = aparecer en la pantalla cuando se ejecuta la macro es decir, que le dice al usuario lo que est pidiendo (al igual que el comando de pausa en la macro primero que escribi ms arriba, salvo que de entrada permite que el usuario responda). = El valor predeterminado es opcional. Por defecto = GSAK dice cul es el valor a utilizar si el usuario slo tiene que presiona la tecla enter sin necesidad de escribir una respuesta. En este caso, le estamos diciendo a GSAK usar 200 si el usuario no introduce un nmero. Otra opcin para el comando de entrada es "BUSCA", que permite al usuario navegar (utilizar el punto y haga clic) para un archivo o una carpeta, pero estamos pidiendo un nmero de aqu, as que no vamos a utilizar esa opcin .

Paso cinco: El comando INPUT recoge la informacin que escribe desde el teclado y se crea una variable llamada $ resultado por defecto (se puede decir el comando de entrada para asignar la respuesta a alguna otra variable, utilizando la opcin de VarName, pero no necesitamos hacer eso aqu) . Debido a que es la aceptacin de informacin escrita desde el teclado, el comando INPUT se supone que el resultado es lo que se llama una "cadena" variable. Una variable de cadena es cualquier combinacin de letras, nmeros y smbolos y se trata como texto por GSAK. Un equipo no puede contar o realizar operaciones matemticas en el texto de otra, por lo que el siguiente paso en nuestra macro es decir GSAK para convertir ese texto "200" a la nmero 200, y para asignarlo a un usuario creado la variable que hemos llamado $ Nmero (esto podra ser llamado $ pepino si te gusta, pero tiene sentido para nombrar variables para representar lo que son). La siguiente lnea en la macro es la siguiente: $ Nmero = Val ($ resultado) Hay dos partes en esta lnea. La primera parte, $ = Nmero, dice GSAK para crear una variable llamada $ Nmero y almacenar todo lo que venga despus del signo igual en esa variable. La segunda mitad de la lnea, Val ($ resultado) est utilizando el "Valor" la funcin para convertir una cadena (de texto) en un nmero (valor). En este caso estamos diciendo "encubierta de la variable $ resultado (que vino del comando INPUT) en un nmero. Paso seis: Puesto que queremos contar con los cachs que son los ms cercanos a nuestra ubicacin, ahora tenemos que decirle GSAK para mover el "puntero" (lo que le dice a GSAK que cach que est en su base de datos) a la parte superior de la lista ordenada de los depsitos de (la memoria cach de nuestra ubicacin ms cercana). La siguiente lnea es la siguiente: Posicin GOTO = Top El comando GOTO dice GSAK para mover el "puntero" en torno a una base de datos. Las opciones son: "de arriba" (la memoria cach de primer lugar en la lista actual), "de abajo" (la memoria cach de ltimo en la lista actual), "al lado" (el cach siguiente debajo de donde el puntero es ahora) y "nn" ( un cierto nmero de cachs por debajo de la cach actual - por ejemplo, "10" se mueve el puntero hacia abajo de 10 cachs de la posicin actual). Paso siete: Como se mencion anteriormente, vamos a utilizar la "Bandera Macro", que funciona igual que las banderas de los usuarios, pero slo dentro de una macro. Mediante el indicador macro deja sin banderas de los usuarios establecidos previamente intacta. Antes de establecer los indicadores macro, tenemos que asegurarnos de que no hay banderas de macro ya establecidos, por lo que nuestro siguiente lnea es: MacroFlag Tipo =Borrar Serie= Todos El comando es MacroFlag, Tipo = es la seal que le dice a GSAK lo que queremos hacer con la bandera de macro (en este caso, claro), y Rango = GSAK dice que las banderas de macro que desea borrar (en este caso, todos los ellos).

Paso Ocho: Ahora que sabemos que las banderas son macro definida, queremos establecer para el nmero de cachs que el usuario solicita (a travs del comando INPUT). Nuestro siguiente lnea es: MacroFlag Tipo =Establecer Serie= $ Numero Este es el mismo comando que en el paso siete, pero ahora le estamos diciendo a GSAK establecer los indicadores macro para el rango que es igual a la variable $ numero ($ recordar que el nmero es el valor numrico de la respuesta que el usuario le dio en respuesta a el comando de entrada!). Paso Nueve: Por ltimo, queremos establecer un filtro para los cachs que han sido marcados con la bandera de macro: Si MFILTER = $ d_MacroFlag MFILTER es el comando que le dice GSAK para establecer un filtro dentro de una macro. Es similar a ir a buscar Filtro> en los mens GSAK, excepto que usted puede filtrar por cualquier variable de la base de datos (vase la macro> Ayuda para obtener una lista de todos los variables de la base de datos se puede utilizar). En este caso, le estamos diciendo a GSAK para filtrar en la base de datos de la variable $ d_MacroFlag, que es el lugar donde GSAK almacena la informacin acerca de si o no una memoria cach se encuentra en posicin. Eso es! Toda la macro se parece a esto (se puede copiar y pegar esto en el editor de macros): # Macro para seleccionar los primeros cachs NN en un filtro de Nombre de la base = "default" Action = Select ORDENAR POR = "distancia" Secuencia = A ENTRADA msg = "Primeros puntos nn para seleccionar" default = "200" $ Nmero = Val ($ resultado) Posicin = Ir a Inicio MacroFlag Tipo =Borrar Serie= Todos MacroFlag Tipo =Establecer Serie= $ Numero Si MFILTER = $ d_MacroFlag Una vez que tenga todo eso en el editor de macros, vaya a Archivo> Guardar y ejecutar. Dar un nombre de la macro (qu tal "SelectNN", sin las comillas) y haga clic en el botn "Guardar". GSAK se ejecutar automticamente la macro y cuando termina, su base de datos, sern ordenados por los cachs ms cercanos a su ubicacin seleccionada y filtrada para la primera 200, listo para exportar o enviar a su receptor GPS!

Tsante y "Depuracin de un macro": No importa cunta experiencia han escrito las macros, lasprobabilidades son de que habr "errores" en la macro la primera vez que lo escribo (por lo general se trata de errores tipogrficos, o se pueden producir errores en el uso de un comando, funcin o variable ). GSAK revisa el cdigo de macro antes de que comience a funcionar, y es lo suficientemente inteligente como para atrapar a estos tipos de errores y que le avise al problema.

Esto se llama "depuracin" de la macro, y es un paso necesario en el proceso de creacin de macros. A modo de ejemplo, digamos que hicimos un error tipogrfico al entrar en nuestra macro y entr en la primera lnea (despus de que el comentario) como este (el segundo una falta en el comando BASE DE DATOS): Nombre datbase = "default" Action = Select En la prueba de nuestra macro, GSAK descubrir este error y aparecer un mensaje de error que se parece a esto:

GSAK nos est diciendo que nuestra macro actual ("SelectNN.txt") tiene un error en la lnea 3. Nos muestra la lnea con el error ("Nombre datbase = ..."). Nos dice cul es el error (datbase no es un comando vlido, porque el comando es vlido DATABASE). Y que se detenga la ejecucin de la macro ("Macro ahora abortar!") Para que nuestro comando no vlido, no causa ningn problema. La belleza de utilizar el construido en el editor de macros es que, si hace clic en "Editar macros" botn, GSAK le llevar a el editor de macros y coloque el cursor en la lnea con el error, de modo que usted puede hacer fcilmente la correccin , guardar y volver a ejecutar la macro para una segunda prueba. Esto puede no parecer un gran problema con un error en la tercera lnea, pero si el error est en la lnea 73, esto es realmente un placer! El comando DEBUG: GSAK tambin tiene una funcin incorporada para ayudar a los errores de seguimiento de las macros - el comando DEBUG. La sintaxis del archivo de Ayuda se parece a esto: DEBUG [] [] [] [] El comando DEBUG le permite pasar a travs de una macro, un comando a la vez. Cada comando en la macro mostrar un cuadro de dilogo que muestra el comando y el valor de todas las variables, justo antes de que se ejecuta el comando. A partir de este dilogo tiene la opcin de

aceptar el comando, omita el comando, o detener la macro. Usted puede dar vuelta DEBUG dentro y fuera de cualquier lugar de la macro utilizando el token Estado correspondiente ("on" u "off"). Height, Width, Left y Top son opcionales y permiten cambiar el tamao y la posicin del cuadro de dilogo de depuracin. Todas las medidas (NNN) en pxeles de la pantalla. Es una buena idea, especialmente cuando ests aprendiendo primero las macros, para incluir = estado de depuracin en el inicio de cualquier nuevo bloque de cdigo que se escribe. Una vez que tenga la macro funciona como se espera, tendr que borrar el comando DEBUG (o cambiar el estado en "off") para que la macro no se detiene en cada paso!

Ucantar una base de datos de prueba: La macro se utiliz anteriormente se conoce como "nodestructiva", ya que no hace ningn cambio permanente en su base de datos. Es seguro para poner a prueba una macro no destructiva de los datos "reales" porque incluso si usted se equivoca, no hay dao hecho (en este caso, basta con cancelar el filtro y todo ha vuelto la forma en que comenz). Sin embargo, El lenguaje de macros es muy potente y se puede utilizar para hacer cosas que son "destructivas", sustituyendo las variables de base de datos (los datos de la cach) o borrar las cachs de bases de datos incluso enteras! Por lo tanto, recomendamos que cree una nueva base de datos en GSAK denominado "Test" y la copia (no mueva) algunos puntos de referencia en la base de datos de prueba, a continuacin, utilizar esta base de datos de prueba cada vez que se est depurando una macro. Si su macro accidentalmente borra todos los cachs en su base de datos de prueba, no hay ningn dao, porque ese es su nico propsito en la vida. Usted puede simplemente copiar algunos puntos de inters de nuevo en la base de datos de prueba y comenzar de nuevo (imaginar su horror si elimina accidentalmente todos los waypoints en una "verdadera" base de datos)!

OTROS CONCEPTOS DE MACRO Y CONSEJOS TILES Add una macro a un botn: En la ventana Personalizar Speedbar (ver GSAK 201 Personalizacin GSAK para informacin ms detallada sobre cmo personalizar el acelerador GSAK), el siguiente a la ltima categora es "Macros". Si hace clic en esa categora, ver una serie de botones con la etiqueta "todas las macros" y Macro1 y Macro2, etc Si usted descarga o crear una macro que vamos a usar a menudo, recuerde que usted agregue la macro a un botn , a continuacin, arrastre para el pedal del acelerador, y las instrucciones personalizadas para GSAK son slo un clic de distancia! Si se asigna a los botones de las macros y agregue el "todas las macros" para el pedal del acelerador, el botn todas las macros acta como un men desplegable, que le permite seleccionar cualquiera de las macros asignadas a partir de un solo botn! El botn tambin muestra todas las macros de texto ms descriptivo para cada macro de lo que puede caber en un botn de macro.

Yonteracting con el usuario: Se han utilizado dos formas de interactuar con el usuario (la pausay los comandos de entrada) en las macros de nuestro ejemplo, pero hay varios otros: SHOWSTOP Y Showstatus: El comando muestra un dilogo SHOWSTOP pequea parada cuando una macro se est ejecutando. Por lo general, pondra esto como el primer comando en una macro con muchos comandos. Esto le permite terminar la macro haciendo

clic en el botn de parada. Si usted no utiliza el comando DEBUG, le recomendamos que incluya el comando SHOWSTOP al inicio de cualquier nueva macro que ests escribiendo, ya que le dar una salida si escribes a tu manera en un bucle infinito (donde el equipo sigue procesando un comando que no tiene fin, y tienes que terminar el programa o reiniciar el equipo para salir de ella!). Una vez que la macro se depure (funcionando de la manera que usted desea), puede eliminar el comando SHOWSTOP. Showstatus es similar, pero que muestra el progreso GSAK en el procesamiento de una gran cantidad de datos (es decir, hacer algo con una gran base de datos). Vea el archivo de Ayuda de Macro para obtener ms informacin sobre el uso del comando showstatus. ELEGIR: ELEGIR es similar a INPUT, salvo que le permite ofrecer al usuario las opciones predefinidas. Es til para evitar errores tipogrficos y tambin para limitar las opciones del usuario a un conjunto de opciones (es decir, el usuario no puede escribir algo que no existe o tiene sentido). ShowForm: La funcin de macro ShowForm permite a los escritores para crear formas muy similares a los de GSAK. Usted puede agregar etiquetas de texto (instrucciones, avisos, preguntas, etc), controles diversos (botones, casillas de verificacin, marque la casilla de lista, cuadro combinado, la fecha de caja, cuadro de edicin, caja de archivo, carpeta, botones de radio, caja de nota), y imgenes. Puede cambiar los colores de su forma y controlar el diseo de todos los elementos. Para ms informacin sobre ShowForm, vaya a macros> Ayuda> Comandos y funciones, y desplcese hacia abajo y haga clic en "ShowForm".

Ucantan las sentencias condicionales, bucles y subrutinas: Hay varios comandos en GSAK quele permiten probar algo antes de seguir adelante, o para repetir una accin o conjunto de acciones sin volver a escribir el mismo cdigo una y otra vez: IF / ELSE / ENDIF: Comando le permite crear una rama condicional en la macro. Si algo es cierto, hacer esto. ELSE (si hay algo que no es cierto), hacer eso. MIENTRAS / ENDWHILE: Comando le permite continuar realizando un conjunto de acciones siempre que una condicin es verdadera. Un uso comn ya que mientras es "caminar" a travs de una serie de escondites, uno por uno, las pruebas de cada cach (por ejemplo, si se ha encontrado), hasta llegar a la final de la lista. La sintaxis para que (la variable de sistema $ _EoL GSAK dice cuando est en el "Fin de la lista"): Posicin GOTO = Top MIENTRAS no ($ _EoL) Si [condicin] [Hacer algo] ELSE [Hacer otra cosa] EndIf GOTO = Posicin Siguiente EndWhile

GOSUB: Los comandos BeginSub, EndSub GOSUB y le permiten crear un conjunto de cdigo de macro (una subrutina) que puede utilizar ms de una vez en la macro. Tambin le permite segregar a un complejo conjunto de cdigos del resto de la macro, para que sea ms fcil de seguir y depurar. Por favor, consulte la ayuda de Macro para obtener ms informacin sobre el uso de los comandos IF, WHILE y GOSUB. Eso es suficiente para una "Introduccin" de gua (algunos de ustedes podran decir que es demasiado!). Las macros pueden parecer intimidante al principio, pero como tantas cosas en la vida, tienen sentido una vez que empezar a usarlas.

Recuerde: Empezar por la automatizacin de una tarea relativamente fcil o mediante el estudio,copia de las piezas, o "pellizcar" una macro a otra persona escribi. Todas las macros en el GSAK Macro Biblioteca puede ser libremente copiado y editado, y son una gran manera de aprender cmo funcionan las macros!