Ejemplos de guiones

Puede usar estos ejemplos de guiones que se proporcionan en la Ayuda como punto de partida para crear los suyos propios. También se incluyen varios guiones en las soluciones iniciales de FileMaker Pro.

1. Elija el menú Guiones > Espacio de trabajo de guiones. O bien, elija el menú Archivo > Gestionar > Guiones.

Los pasos de guion If, Else If, Else y End If definen una estructura que controla la ejecución de los pasos de guion. Este control depende del resultado de una condición comprobable o cálculo de tipo booleano.

•Cuando el resultado del cálculo es cualquier número excepto cero, la condición se evalúa como True y se ejecutan los pasos de guion siguientes.

•Si el resultado del cálculo es cero, blanco o contenido que no se resuelve en ningún número, la condición se evalúa como False y no se ejecutan los pasos de guion subsiguientes.

Los pasos Else If proporcionan pruebas booleanas adicionales. Los pasos Else proporcionan pasos alternativos que se ejecutan si todas las condiciones se evalúan como False.

Realiza una búsqueda. Si no se encuentra ningún registro, aparece un cuadro de diálogo personalizado. Si se encuentran registros, ordena el conjunto encontrado.

Ejecutar búsqueda [Restaurar]
If [Get ( FoundCount ) = 0]
Mostrar cuadro de diálogo personalizado ["Buscar registros" ; "No se encontraron registros."]
Else
Ordenar registros [Restaurar ; Con diálogo: Inactivo]
End If

Realiza una búsqueda. Si no se encuentra ningún registro, aparece un cuadro de diálogo personalizado. Si se encuentra un registro, remite a la presentación Detalles de la factura. Si se encuentra más de un registro, remite a la presentación Facturas.

Ejecutar búsqueda [Restaurar]
If [Get ( FoundCount ) = 0]
Mostrar cuadro de diálogo personalizado ["Buscar registros" ; "No se encontraron registros."]
Else If [Get ( FoundCount ) = 1]
Ir a la presentación ["Detalles de la factura"]
Else
Ir a la presentación ["Facturas"]
End If

Los pasos de guion Loop, Exit Loop If y End Loop definen una estructura que permite que se repitan los pasos de guion. Los pasos de guion entre un Loop y un End Loop se ejecutan continuamente, hasta que se cumpla la condición definida en Exit Loop If o Salir después del último para un paso Ir al registro/petición/página o Ir a la fila del portal.

Utilice el paso de guion Exit Loop If para especificar el cálculo que se va a evaluar. Cuando el resultado del cálculo es distinto de cero, se evalúa como True y el bucle finaliza. Cuando el resultado del cálculo es cero, se evalúa como False y el bucle continúa.

Ir al registro/petición/página [Primero]
Loop
Establecer campo [Clientes::Contacto diario ; Clientes::Teléfono del trabajo]
Ir al registro/petición/página [Siguiente ; Salir después del último]
End Loop

Se desplaza por los registros para exportar los archivos que se encuentran en los campos contenedores. Sale del bucle si un registro tiene un campo contenedor vacío.

Establecer variable [$RUTA ; Valor: Get ( DocumentsPath ) & Productos::Contenedor]
Ir al registro/petición/página [Primero]
Loop
Exit Loop If [IsEmpty ( Productos::Contenedor )]
Exportar contenido del campo [Productos::Contenedor ; "$RUTA"]
Ir al registro/petición/página [Siguiente ; Salir después del último]
End Loop

Un guion de arranque puede personalizar la vista de un usuario de una base de datos o realizar otras acciones cuando se abre una base de datos. El activador de guion OnFirstWindowOpen ejecuta los guiones de arranque. Para obtener información sobre cómo configurar un guion de arranque Establecer opciones de archivo.

Acceda a la presentación Administración si a la cuenta se le ha asignado el conjunto de privilegios de acceso total. De lo contrario, vaya a la presentación Entrada de datos.

If [Get ( AccountPrivilegeSetName ) = "[acceso total]"]
Ir a la presentación ["Administración"]
Else
Ir a la presentación ["Entrada de datos"]
End If

Compruebe la versión de FileMaker Pro o FileMaker Go que ha abierto la base de datos y acceda a la presentación Clientes adecuada.

If [Get ( Device ) = 3]
Ir a la presentación ["Clientes iPad"]
Else If [Get ( Device ) = 4]
Ir a la presentación ["Clientes iPhone"]
Else
Ir a la presentación ["Clientes"]
End If

Ejecutar guion ejecuta un guion que está definido en el archivo actual o en otro archivo de FileMaker Pro.

Los parámetros de guion opcionales pueden pasar texto a un guion. Por ejemplo, puede utilizar un parámetro de guion para guardar el número de registros activos cuando se inicia el guion, facilitando volver a ese registro al final del guion. O puede llamar al mismo guion desde distintos botones en la misma presentación, y determinar fácilmente qué botón ha llamado al guion mediante un parámetro de guion distinto para cada botón.

Cuando especifica un parámetro, puede acceder a él dentro de un guion o pasarlo a otros guiones a través de la función Get ( ScriptParameter ).

También se pueden utilizar parámetros complejos, como listas de nombres u otros valores. Los parámetros complejos que están separados por retornos de carro se pueden analizar usando la función LeftValues, función MiddleValues y la función RightValues. Estas funciones devuelven los valores iniciales, del medio y finales de listas que están separadas por retornos de carro. Los parámetros complejos separados por otros caracteres pueden ser analizados como texto usando funciones como función Left, función Middle y función Right.

Utiliza un campo, Nombre del cliente, como parámetro. Las facturas del cliente actual se devuelven en una nueva ventana con la presentación Informe de factura.

Buscar registros concordantes [Reemplazar ; Facturas::ID de cliente]
#Invoca al subguion "Ver facturas del cliente" definido a continuación
Ejecutar guion ["Ver facturas del cliente" ; Parámetro: Facturas::Nombre del cliente]

Nueva ventana [Nombre: "Cliente: " & Get ( ScriptParameter ) ; Estilo: Documento]
Ir a la presentación ["Informe de factura"]
Ordenar registros [Restaurar ; Con diálogo: Inactivo]

•Un parámetro de guion existe solo durante la duración del guion. Los parámetros de guion se restablecen cada vez que se ejecuta un guion. Si desea que un parámetro de guion persista mientras un archivo está abierto, puede emplear una variable global como parámetro de guion.

•Un parámetro de guion existe solo dentro del guion principal, a no ser que se pase explícitamente a otro guion mediante la función Get ( ScriptParameter ).

•Se puede utilizar (pero no modificar) un parámetro de guion dentro de un guion y se puede pasar junto con subguiones mediante la función obtener ( ScriptParameter ) como parámetro para el subguion. También puede especificar distintos parámetros cada vez que se invoca al subguion mediante Ejecutar guion. Si se cambian los parámetros llevados a un subguion no se modificará el valor de los parámetros devueltos desde Get ( ScriptParameter ) en el guion principal.