fmpa10 guia desarrollo

FileMaker® Pro 10 Advanced

Guía de desarrollo

© 2007-2009 FileMaker, Inc. Reservados todos los derechos.

FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054

FileMaker y el logotipo de la carpeta de archivos, Bento y el logotipo de Bento son marcas registradas de FileMaker, Inc., en EE. UU. y en otros países. Mac y el logotipo de Mac son propiedad de Apple Inc. registradas en EE.UU. y otros países. Las demás marcas comerciales pertenecen a sus respectivos propietarios.

La documentación de FileMaker está protegida por derechos de autor. Se prohíbe la realización de copias o la distribución de esta documentación sin el consentimiento por escrito de FileMaker. Esta documentación sólo puede utilizarse con una copia del software de FileMaker que tenga una licencia válida.

Las personas y compañías, direcciones de correo electrónico y direcciones URL mencionadas en los ejemplos son puramente ficticios, y cualquier parecido con personas, compañías, direcciones de correo electrónico y direcciones URL reales es mera coincidencia. Los créditos aparecen en los documentos Agradecimientos que acompañan a este software. La mención de productos y direcciones URL de terceros es meramente informativa y no representa ningún tipo de garantía ni recomendación. FileMaker, Inc. no asume ninguna responsabilidad respecto al rendimiento de estos productos.

Para más información, visite nuestra página Web en www.filemaker.com.

Edición: 01

Índice

Capítulo 1 Introducción a FileMaker Pro AdvancedAcerca de esta guía 5

Uso de la documentación de FileMaker Pro Advanced 5

Dónde encontrar documentación en PDF 6Cumplimiento del contrato de licencia para soluciones en tiempo de ejecución 6

Responsabilidades como creador 7

Capítulo 2 Creación de soluciones de base de datosUso de las Utilidades de creador 9

Acerca de la creación de soluciones en tiempo de ejecución 10

Conversión y actualización de soluciones anteriores 11Enlazar la solución 12Inicio de soluciones de bases de datos en tiempo de ejecución 13

Distribución de soluciones en tiempo de ejecución 13

Organización de componentes de la solución 13Selección de un método de distribución 14Prueba anterior y posterior a la creación de la solución 15Distribución de actualizaciones en soluciones de bases de datos en tiempo de ejecución 16

Creación de soluciones de quiosco 17

Capítulo 3 Personalización de las soluciones de base de datosCopiar e importar esquemas de campo y de tabla 19

Creación de funciones personalizadas 20

Acerca de los menús personalizados 20

Ejemplo de menú personalizado 21Creación de menús personalizados 22Creación de elementos de menú personalizados 22Creación de conjuntos de menús personalizados 24

Creación de temas de presentación personalizados 25

Requisitos para los archivos de temas 27

Capítulo 4 Depurar y analizar archivosDepuración de guiones 29

Desactivación de pasos de guión 30Uso del Visor de datos 31

Usar el informe de diseño de base de datos 33

4 Guía de desarrollo de FileMaker Pro Advanced

Capítulo 5 Desarrollo de plug-ins de FileMaker por parte de otros fabricantesAcerca de las funciones externas 35

Acerca del plug-in de ejemplo 35

Contenido de la carpeta FMExample 36Contenido de la carpeta Example 36Contenido de la carpeta Support 36

Instalación, activación y configuración del plug-in de ejemplo 37

Descripción de las funciones externas del plug-in FMExample 38

Uso del plug-in de ejemplo 39

Personalización del plug-in de ejemplo 40

Personalización de los recursos de ejemplo 40Personalización de FMPluginExample.cpp 40Personalización de FMPluginPrefs.cpp 41Personalización de FMPluginFunctions.cpp 41

Requisitos para escribir plug-ins con funciones externas 41

Archivos de código API 41Sintaxis de la cadena de opciones 42Especificaciones de nombres de archivos para funciones externas 42

Mensajes de FileMaker enviados al plug-in 42

Mensaje de Inicialización 43Mensaje de Apagado 43Mensaje de En espera 44Mensaje de Preferencias 44Mensaje de Función externa 44Mensaje de GetString 45

Evitación de posibles conflictos de recursos en Mac OS X 45

Inclusión de documentación en su plug-in 45

Apéndice A Comparación de funciones de la aplicación en tiempo de ejecución con FileMaker ProPreferencias de aplicaciones y documentos 48

Comparación de comandos de menú 49

Pasos de guión ignorados 54

Configuración o preferencias almacenadas del registro 55

Índice 57

Capítulo 1 Introducción a FileMaker Pro Advanced

Bienvenido a FileMaker®Pro Advanced. Este producto incluye herramientas avanzadas de desarrollo y personalización diseñadas especialmente para desarrolladores de bases de datos. Puede utilizar FileMaker Pro o FileMaker Pro Advanced para crear y probar las soluciones de base de datos.

Además de todas las funciones disponibles con FileMaker Pro, FileMaker Pro Advanced incluye:

1 Utilidades de creador para crear, personalizar e implementar soluciones de base de datos en tiempo de ejecución

1 La función de informe de diseño de base de datos, para publicar una completa documentación sobre las estructuras o los esquemas de las bases de datos

1 Depurador de guiones, para las pruebas y depuraciones sistemáticas de guiones de FileMaker

1 Visor de datos, para supervisar campos, variables y cálculos

1 Función de copia, para copiar campos o tablas. También puede importar el esquema de tabla para utilizarlo en el mismo archivo o en archivos distintos

1 Función de menús personalizados, para crear menús personalizados para la solución

1 Prestación Funciones personalizadas, para crear funciones personalizadas y utilizarlas en cualquier parte de la solución

Acerca de esta guíaEsta Guía de desarrollo incluye información sobre las funciones disponibles en FileMaker Pro Advanced. Además, esta guía proporciona una visión general de cómo crear temas de presentación personalizados y plug-ins de funciones externas.

Consulte la Ayuda de FileMaker Pro para obtener información detallada sobre las funcionalidades del producto.

Si desea enviar información acerca de esta guía, visite www.filemaker.com/company/documentation_feedback.html.

Uso de la documentación de FileMaker Pro AdvancedEsta Guía de desarrollo forma parte de un completo conjunto de documentos proporcionado con FileMaker Pro Advanced. Algunos de los documentos se incluyen en formato impreso y en PDF (Portable Document Format), mientras que otros sólo están disponibles en PDF. FileMaker Pro Advanced también incluye un sistema de ayuda en línea que proporciona más información sobre las funcionalidades de FileMaker Pro.

Esta guía asume que el usuario ya conoce FileMaker Pro o FileMaker Pro Advanced y que ha creado una solución de base de datos con la que desea trabajar mediante el uso de las funciones de FileMaker Pro Advanced. Si acaba de incorporarse a la familia de FileMaker, comience con la Guía del usuario de FileMaker Pro.

Se incluyen los siguientes manuales:

1 Guía de desarrollo de FileMaker Pro Advanced (este manual): describe cómo se utilizan las funciones de FileMaker Pro Advanced

1 Guía de instalación y de nuevas funciones de FileMaker Pro y FileMaker Pro Advanced: contiene instrucciones de instalación y una lista de nuevas funciones de la versión actual.


1 Guía del usuario de FileMaker Pro: contiene conceptos clave y procedimientos básicos.

1 Tutorial de FileMaker Pro: contiene indicaciones paso a paso para enseñarle a crear y usar bases de datos de FileMaker Pro.

1 Manual FileMaker Pro Advanced Database Design Report XML Output Grammar: describe la gramática de salida del informe de diseño de base de datos (DDR) XML de FileMaker Pro para aquellos usuarios que quieran crear herramientas que analizan o procesan la estructura de las bases de datos.

1 Guía para la publicación en la Web al instante: describe cómo poner bases de datos de FileMaker Pro y FileMaker Pro Advanced a disposición de los usuarios de un navegador Web a través de una Intranet o de Internet.

1 Guía de ODBC y JDBC de FileMaker: describe cómo compartir datos de FileMaker con otras aplicaciones mediante ODBC y JDBC.

Dónde encontrar documentación en PDFPara acceder a los archivos PDF de la documentación de FileMaker:

1 en FileMaker Pro Advanced, elija menú Ayuda> Documentación del producto

1 haga clic en el botón Más información en la pantalla de Inicio rápido

1 visite www.filemaker.es/downloads para obtener documentación adicional

La mayoría de los manuales PDF se encuentran en la carpeta en la que instaló FileMaker Pro Advanced. Si instaló FileMaker Pro Advanced en la carpeta predeterminada, los manuales PDF se encuentran aquí:

1 Windows: C:\Archivos de programa\FileMaker\FileMaker Pro Advanced\Extras español\Documentación electrónica

1 Mac OS: Macintosh HD/Aplicaciones/FileMaker Pro Advanced/Extras español/Documentación electrónica

Para ver los archivos PDF, necesita un lector de PDF. En Mac OS X, puede utilizar la aplicación de Vista previa incorporada o Adobe Reader. Los usuarios de Windows necesitan Adobe Reader. Si no dispone de esta aplicación, puede descargarla del sitio Web de Adobe en www.adobe.com.

Cumplimiento del contrato de licencia para soluciones en tiempo de ejecuciónEl contrato de licencia de FileMaker Pro Advanced permite la distribución sin derechos de autor de un número ilimitado de soluciones de base de datos en tiempo de ejecución de FileMaker Pro. Sin embargo, en el contrato de licencia hay varios términos y condiciones que se deben cumplir, entre los que se incluyen los siguientes:

1 Debe proporcionar toda la asistencia técnica al usuario final.

1 Debe proporcionar una presentación "Acerca de" que incluya su nombre, dirección y el número de teléfono para obtener asistencia técnica. Para obtener más información sobre cómo crear una presentación "Acerca de", consulte la sección siguiente.

Nota Debe leer y aceptar los términos y condiciones del contrato de licencia de FileMaker Pro Advanced, que se encuentran en el programa de instalación de FileMaker Pro Advanced, antes de utilizar el software.

Capítulo 1 | Introducción a FileMaker Pro Advanced 7

Responsabilidades como creadorFileMaker ha establecido procedimientos de reparación de archivos. Si un cliente sigue estos procedimientos, FileMaker puede proporcionarle un archivo reparado.

Si distribuye archivos de bases de datos con contraseñas o ha retirado los privilegios de acceso total y no desea que FileMaker repare un archivo para el cliente que lo solicite, debe:

1. Notificarles a los clientes por escrito (y llevar un registro de dichos avisos) que la solución de base de datos contiene contraseñas o datos que sólo usted puede proporcionar.

2. Todos los archivos de la solución de base de datos en tiempo de ejecución deben contener una presentación accesible desde cualquier presentación de la base de datos.

3. El nombre de la presentación debe comenzar con la palabras "Acerca de".

4. La presentación "Acerca de" debe contener estos elementos:

1 nombre de la solución

1 nombre de su empresa y su información de contacto

1 su política de asistencia técnica (por ejemplo, cómo y cuándo está disponible para realizarla)

5. La presentación "Acerca de" debe contener esta advertencia exacta:

“ADVERTENCIA PARA USUARIOS: Esta solución de base de datos contiene contraseña(s) que sólo puede proporcionar el creador identificado más arriba”.

Para obtener más información sobre cómo crear una presentación "Acerca de", consulte la Ayuda.

6. Si se han retirado de forma permanente los privilegios de acceso completo a la solución de base de datos mediante la selección de la opción Eliminar acceso de administrador a los archivos permanentemente en Utilidades de creador, la presentación "Acerca de" debe contener esta advertencia exacta:

“ADVERTENCIA PARA USUARIOS: Este archivo no se puede personalizar. Póngase en contacto con el creador denominado anteriormente si desea información sobre la personalización de esta solución de base de datos”.

La protección de cuentas y privilegios de un archivo de FileMaker no se debe contemplar como una barrera absoluta que impide que el cliente obtenga acceso a los archivos. FileMaker no garantiza que el cliente no pueda identificar o evitar la contraseña mediante herramientas o soluciones de otros fabricantes. Por tanto, FileMaker le recomienda que lleve a cabo los pasos necesarios para proteger sus esfuerzos de desarrollo y asesoría sin confiar únicamente en el procedimiento de contraseña. Para obtener más información sobre cuentas y privilegios, consulte la Ayuda.

Si tiene una disputa con un cliente, debe resolverla directamente con él. FileMaker no puede en ningún caso resolver dichas disputas.

Capítulo 2 Creación de soluciones de base de datos

FileMaker Pro Advanced incluye Utilidades de creador que le permiten:

1 cambiar el nombre de todos los archivos de base de datos y actualizar automáticamente los enlaces internos a guiones y archivos relacionados;

1 enlazar archivos de base de datos en una solución de base de datos en tiempo de ejecución independiente que no requiere el uso de FileMaker Pro o FileMaker Pro Advanced en el equipo;

1 eliminar el acceso administrativo de todas las cuentas y evitar que los usuarios modifiquen gran parte de los elementos estructurales o de diseño de la base de datos;

1 mostrar los archivos de base de datos en modo Quiosco;

1 añadir a los archivos la extensión de nombre de archivo de FileMaker Pro.

Nota Consulte la Ayuda para obtener información completa y pormenorizada y procedimientos detallados sobre el uso de FileMaker Pro Advanced.

Uso de las Utilidades de creadorPara personalizar sus archivos de base de datos o enlazarlos a una solución en tiempo de ejecución:

1. Cierre todos los archivos de base de datos que vaya a personalizar.

2. Seleccione el menú Herramientas > Utilidades de creador.

3. Si ha utilizado las Utilidades de creador en la misma solución de base de datos anteriormente y ha guardado la configuración, haga clic en Cargar configuración.

Se abre un cuadro de diálogo que le permite examinar y localizar el archivo de configuración.

4. Haga clic en Añadir para encontrar los archivos que desea personalizar.

5. Si va a enlazar varios archivos en una solución en tiempo de ejecución, haga doble clic en un archivo de la lista para especificar el archivo primario.

6. Para cambiar el nombre de un archivo, selecciónelo en la lista, escriba el nuevo nombre en el cuadro Renombrar archivo y haga clic en Cambiar.

7. Para quitar un archivo, selecciónelo en la lista y haga clic en Quitar.

8. En la carpeta Project, haga clic en Especificar para elegir la ubicación en la que se guardará la copia de la solución de base de datos.

9. Si no desea que los nuevos archivos sobrescriban las versiones anteriores, desactive la opción Sobrescribir archivos coincidentes dentro de la carpeta Project.

Importante Si se selecciona la opción Sobrescribir archivos coincidentes dentro de la carpeta Project, las Utilidades de creador sobrescriben los archivos que tienen los mismos nombres que los que se encuentran en la lista de archivos.


10. Realice una de las opciones siguientes:

1 Si desea crear una copia de sus archivos de base de datos con nuevos nombres, haga clic en Crear.

Nota FileMaker Pro Advanced actualiza de forma automática enlaces internos a archivos y guiones relacionados.

1 Si desea continuar la personalización o el enlace de sus archivos de base de datos, en Opciones de solución, haga clic en Especificar.

11. Seleccione una o varias opciones en el cuadro de diálogo Especificar opciones de solución:

12. Haga clic en Aceptar.

13. Para poder repetir rápidamente el proceso, haga clic en Guardar configuración y seleccione una carpeta y una ubicación para el archivo de configuración. Para obtener más información sobre cómo guardar la configuración de la solución, consulte la Ayuda.

14. Haga clic en Crear.

Acerca de la creación de soluciones en tiempo de ejecuciónUtilice las Utilidades de creador para crear una solución de base de datos en tiempo de ejecución independiente a la que puedan tener acceso los usuarios sin ejecutar FileMaker Pro o FileMaker Pro Advanced. Las Utilidades de creador crean una copia de los archivos y enlazan el archivo, o los archivos, de base de datos a una aplicación en tiempo de ejecución con el nombre que especifique.

Para Realizar lo siguiente:

Enlazar bases de datos a aplicaciones en tiempo de ejecución

Seleccione Crear solución de ejecución independiente.

Nota Esta opción se puede combinar con todas las demás, excepto con Las bases de datos deben tener una extensión de archivo de FileMaker.Consulte “Acerca de la creación de soluciones en tiempo de ejecución” en la página 10.

Prohibir permanentemente cualquier acceso administrativo a la solución

Seleccione Eliminar acceso de administrador a los archivos permanentemente.

Importante Una vez eliminado, el acceso administrativo no puede restaurarse en la solución personalizada.

Para obtener más información sobre como eliminar el acceso de administrador a las bases de datos, consulte la Ayuda.

Obligar a las cuentas sin privilegios de acceso total a abrir la solución en modo Quiosco

Seleccione Activar modo Quiosco para cuentas que no sean de administrador.Consulte “Creación de soluciones de quiosco” en la página 17.

Añadir la extensión de FileMaker a los nombres de archivo de los archivos de la base de datos

Seleccione Las bases de datos deben tener una extensión de archivo de FileMaker.Nota Esta opción no está disponible si se selecciona Crear solución de ejecución independiente. Utilice esta función para añadir extensiones a archivos que no tienen extensiones.

Crear un archivo de registro para registrar cualquier error que surja durante el procesamiento

Seleccione Crear registro de error para cualquier error de procesamiento.

Especifique una ubicación y un nombre de archivo para el registro de errores.

Notas1 Si no especifica un nombre de archivo y una ubicación para el registro de errores,

éste se guardará en la carpeta Project con el nombre de archivo Logfile.txt.

1 Si se produce un error durante el procesamiento de las opciones, éste se registra en el registro de errores. Un mensaje de error puede indicar que se han producido errores.

Capítulo 2 | Creación de soluciones de base de datos 11

Las aplicaciones en tiempo de ejecución no poseen todas las funciones y características de FileMaker Pro. Para obtener una lista completa de las diferencias entre la aplicación en tiempo de ejecución y FileMaker Pro, consulte apéndice A, “Comparación de funciones de la aplicación en tiempo de ejecución con FileMaker Pro”.

Puede que necesite enlazar los archivos de base de datos varias veces antes de prepararlos para entregarlos a los usuarios. Cuando haya terminado de desarrollar la solución en tiempo de ejecución y la versión final esté lista para distribuirla a los usuarios, debe probarla exhaustivamente para asegurarse de que se comporta según lo esperado.

Nota Ahora, FileMaker Pro y FileMaker Pro Advanced le permiten incluir tantas tablas de base de datos como necesite en un archivo de base de datos. Esta función elimina una de las razones principales para el uso de varios archivos. Sin embargo, otros elementos, como los guiones y los privilegios de acceso, se almacenan en un nivel de archivo; por lo tanto, algunas soluciones complejas seguirán beneficiándose de la utilización de varios archivos.

Antes de comenzar a crear la solución de base de datos, debe decidir la forma en la que los usuarios interactuarán con ella. La solución de base de datos puede incluir los siguientes componentes:

1 Un archivo de base de datos primario que conecte todos los archivos auxiliares

1 Guiones y botones para abrir y cerrar archivos auxiliares, volver al archivo primario, mostrar una pantalla de presentación al inicio o salir de una aplicación en tiempo de ejecución

1 Elementos comunes y un aspecto coherente para soluciones multiplataforma

1 información sobre herramientas y menús personalizados

1 Un tema de presentación personalizado para su uso en cada archivo de la solución

1 Una presentación "Acerca de" introductoria de la solución (obligatoria)

1 Un sistema de ayuda personalizado que ofrezca sugerencias de uso para la solución

1 Varios conjuntos de privilegios que permitan especificar niveles de acceso a presentaciones, menús, tablas específicas, registros, campos, etc.

1 Cuentas protegidas mediante contraseñas asignadas a conjuntos de privilegios que determinen el nivel de acceso de los usuarios de las cuentas

Para obtener información sobre lo que necesitan los usuarios para utilizar la solución de base de datos en tiempo de ejecución, consulte “Distribución de soluciones en tiempo de ejecución” en la página 13.

Conversión y actualización de soluciones anterioresSi ha desarrollado una solución de base de datos en tiempo de ejecución de FileMaker Pro mediante el Solutions Development Kit (SDK) para FileMaker Pro 3.0 o una versión anterior, la utilidad Binder de FileMaker Pro 4.0 Developer Edition o la herramienta Developer de FileMaker Developer 5.x y 6.0, puede actualizar la solución y ofrecer a los usuarios archivos convertidos. Los archivos enlazados con una aplicación en tiempo de ejecución a través de herramientas anteriores, deben volver a enlazarse por medio de las Utilidades de creador.

Debe convertir los archivos de FileMaker Pro creados con la versión 6.0, o anteriores, al nuevo formato de archivo. Puede convertir un único archivo o varios archivos a la vez. Para obtener más información sobre la conversión de archivos, consulte la Ayuda.


Una vez convertidos los archivos, puede actualizarlos para sacar partido de las nuevas funciones de FileMaker Pro y FileMaker Pro Advanced. Si es necesario, cree guiones para importar los datos existentes de los usuarios de la solución de base de datos en tiempo de ejecución anterior a la nueva solución actualizada. Consulte la Ayuda para obtener más información sobre la importación de datos a soluciones de tiempo de ejecución actualizadas. Utilice las Utilidades de creador para enlazar los archivos de la solución con una solución de base de datos en tiempo de ejecución nueva y actualizada.

Distribuya la nueva base de datos en tiempo de ejecución actualizada y proporcione a los usuarios instrucciones sobre la forma de actualizar los archivos convirtiendo los antiguos archivos en la nueva aplicación en tiempo de ejecución e importando sus datos.

Enlazar la soluciónPara enlazar archivos de base de datos con una solución de base de datos en tiempo de ejecución:

1. Siga los procedimientos descritos en “Uso de las Utilidades de creador” en la página 9.

2. En el cuadro de diálogo Especificar opciones de solución, seleccione Crear solución de ejecución independiente.

3. Para nombrar su aplicación en tiempo de ejecución:

1 En Nombre de runtime, escriba un nombre. El nombre se utiliza como nombre de archivo de la aplicación en tiempo de ejecución y como nombre de la carpeta que contiene los archivos de la solución de base de datos en tiempo de ejecución.

1 Como Extensión, escriba una extensión de nombre de archivo de tres caracteres. La extensión se utiliza para asociar los archivos de la solución a las aplicaciones en tiempo de ejecución.

Para obtener más información sobre cómo nombrar archivos, consulte la Ayuda.

4. Como Tecla de enlace, escriba una clave con una longitud de entre 1 y 24 caracteres.

La Tecla de enlace enlaza la aplicación en tiempo de ejecución con los archivos de base de datos y garantiza que los archivos enlazados sólo se abran en la aplicación en tiempo de ejecución adecuada. Recuerde que distingue entre mayúsculas y minúsculas. Para obtener más información sobre la configuración de la Tecla de enlace, consulte la Ayuda.

Importante Al realizar el enlace, se instalan los archivos de sistema correspondientes a cada plataforma. Si la solución se va a utilizar con Windows, enlácela mediante las Utilidades de creador para Windows. Si la solución se va a utilizar con Mac OS X, enlácela mediante las Utilidades de creador para Mac OS X. Si va a crear una solución que pueda utilizarse tanto en Windows como en Mac OS X, cree dos soluciones en tiempo de ejecución mediante el enlace de los archivos originales de la solución dos veces: en primer lugar mediante las Utilidades de FileMaker Developer para Windows y, a continuación, mediante las Utilidades de FileMaker Developer para Mac OS X. Utilice la misma Tecla de enlace para ambas plataformas.

5. Para añadir un logotipo de empresa u otra imagen personalizada a la pantalla de cierre, haga clic en Especificar, seleccione una imagen de cierre y haga clic en Seleccionar.

La imagen debe tener al menos 32 x 175 píxeles (72 ppp) o más, de lo contrario, se distorsionará al mostrarse. Los formatos de imagen admitidos son JPEG y GIF.

6. En Retraso, establezca el número de segundos que desea que se muestre la pantalla.

Puede obtener una vista previa del efecto que va a tener la pantalla personalizada haciendo clic en el botón Vista previa.

7. Una vez especificadas las opciones, haga clic en Aceptar.


8. Para poder repetir rápidamente el proceso, haga clic en Guardar configuración y seleccione una carpeta y una ubicación para el archivo de configuración.

Para obtener más información sobre cómo guardar y reutilizar las Utilidades de creador, consulte la Ayuda.


Las Utilidades de creador copian todos los archivos en tiempo de ejecución en una nueva carpeta creada dentro de la carpeta Project y con el mismo nombre que la solución en tiempo de ejecución.

Inicio de soluciones de bases de datos en tiempo de ejecución

Importante Para iniciar la solución, los usuarios deben hacer doble clic en el icono de aplicación en tiempo de ejecución, no en el icono de archivo de la solución. Si se hace doble clic en los iconos de los archivos de la solución o auxiliares, se pueden generar errores, en función de la existencia de otras copias de la aplicación en tiempo de ejecución en el disco duro. Si sus usuarios tienen más de una solución en sus ordenadores asociada a la misma extensión de tres caracteres y hacen doble clic en el icono del archivo de la solución, la solución instalada en primer lugar intentará abrir el archivo y es probable que ésta no sea la aplicación correcta para ese archivo en concreto.

Distribución de soluciones en tiempo de ejecuciónLos pasos finales de desarrollo de la solución de base de datos en tiempo de ejecución consisten en incluir todos los archivos necesarios juntos, seleccionar cómo se va a distribuir la solución (por ejemplo, en un CD-ROM o a través de la red) y facilitar a los usuarios la documentación necesaria para instalar la solución. Además, la documentación debe incluir instrucciones para iniciar la aplicación en tiempo de ejecución e indicaciones sobre qué hacer cuando existe un archivo dañado.

Organización de componentes de la soluciónCuando se enlazan los archivos de bases de datos con una solución de base de datos en tiempo de ejecución, las Utilidades de creador permiten crear una nueva carpeta de solución donde se pueden colocar la aplicación en tiempo de ejecución, los archivos de bases de datos auxiliares y primarios enlazados y una carpeta Extensions. Para las soluciones en tiempo de ejecución de Windows, también se requieren archivos Dynamic Link Library (DLL).

Nota Cuando se mueven varios archivos a una carpeta para crear una solución en tiempo de ejecución, tenga en cuenta que puede afectar a los enlaces internos. Por este motivo, cada fuente de datos debe contener una ruta formada simplemente por el nombre de archivo del archivo al que se hace referencia. Aunque la aplicación en tiempo en ejecución comprueba otras fuentes de datos, será capaz de encontrar el archivo en la misma carpeta en la que se encuentra. Puede seguir conservando cualquier ruta absoluta o relativa en la misma referencia de fuente de datos en caso de que los archivos también se utilicen en FileMaker Pro o FileMaker Pro Advanced.

Haga doble clic para iniciar

Icono de archivo de la solución

Icono de la aplicación en tiempo de ejecución


Importante No se debe cambiar el nombre de estos archivos y carpetas.

Para obtener más información sobre el paquete de aplicaciones en tiempo de ejecución de Mac OS X y de la carpeta Extensions y archivos DLL de Windows, consulte la Ayuda.

Si la solución de base de datos en tiempo de ejecución requiere archivos personalizados, se deben facilitar los archivos junto con los de tiempo de ejecución. Los plug-ins se deben almacenar en la carpeta Extensions. Si un creador utiliza una fuente que no se encuentra en el sistema de un usuario, la aplicación en tiempo de ejecución realiza una sustitución. Si se incluye una fuente con el tiempo de ejecución, se deben tomar medidas para su instalación mediante el programa de instalación. Consulte “Uso de un programa de instalación personalizado” más abajo.

Además de los archivos en tiempo de ejecución, es necesario que les proporcione instrucciones de instalación a los usuarios. Para obtener más información sobre la documentación de las soluciones de creador, consulte la Ayuda.

Selección de un método de distribuciónUna vez organizados los archivos incluidos en su solución, es necesario decidir cómo los deben instalar los usuarios. Puede distribuir la solución incluida en un CD-ROM, a través de una red o mediante Internet. Para ejecutar la solución de base de datos en tiempo de ejecución, los usuarios necesitan el mismo equipo y software mínimo que requiere la aplicación FileMaker Pro Advanced. Consulte la Guía de instalación y de nuevas funciones de FileMaker Pro y FileMaker Pro Advanced.

Uso de un programa de instalación personalizado

Debe utilizar un programa de instalación personalizado para empaquetar la solución en tiempo de ejecución para la instalación por parte de los usuarios. La configuración de una aplicación de instalación personalizada para instalar archivos de solución de base de datos en tiempo de ejecución puede requerir más ingeniería que el uso de una utilidad de compresión, aunque ayudará a garantizar que los usuarios no tengan dificultades instalando la solución en tiempo de ejecución.

A continuación, se enumeran algunas aplicaciones de instalación personalizadas que puede utilizar:

1 MindVision Installer VISE

1 InstallShield MultiPlatform

1 MacInstallerBuilder

carpeta de solución de carpeta de solución de Mac OS

Aplicación en tiempo de ejecución

Paquete de aplicación en tiempo de ejecución

Archivos de solución auxiliares y primarios enlazados

Archivos de solución auxiliares y primarios enlazados

Extensions

Dictionaries

DLL generados durante el enlace

Ejemplo de contenido de la solución en Windows y Mac OS X para su distribución

Extensions

Dictionaries

carpetas de recursos de idioma


Uso de una utilidad de compresión

Si la solución de base de datos en tiempo de ejecución no es compleja y confía en la experiencia técnica de los usuarios finales, puede plantearse utilizar una utilidad de compresión en lugar de un programa de instalación personalizado.

Uso compartido de soluciones a través de una red

Los usuarios no pueden compartir la solución de base de datos en tiempo de ejecución a través de una red a menos que tengan acceso a los archivos mediante FileMaker Pro o FileMaker Pro Advanced desde sus equipos. Debe disponer de una contraseña maestra para activar o modificar el acceso de red al archivo. Si desea un rendimiento óptimo, puede incluir los archivos de solución mediante FileMaker Server.

Para obtener información sobre los productos FileMaker Server y FileMaker Pro y sobre ventas de licencias globales, consulte el sitio Web de FileMaker en www.filemaker.com.

Recuperación de archivos dañados

Los fallos en el suministro eléctrico, los problemas de hardware y otros factores pueden dañar un archivo de base de datos de FileMaker. Si la solución de base de datos se daña, los usuarios tendrán que recuperar el archivo dañado. Cuando la aplicación en tiempo de ejecución descubre un archivo dañado, aparece un cuadro de diálogo, donde se le indica al usuario que se ponga en contacto con el creador. Aunque no aparezca el cuadro de diálogo, los archivos se pueden dañar y tener un comportamiento errático.

Para obtener información sobre la recuperación de archivos en tiempo de ejecución, consulte la Ayuda.

Creación de presentaciones "Acerca de"

En las soluciones de base de datos en tiempo de ejecución, la licencia de FileMaker Pro Advanced especifica que se debe crear una presentación que proporcione información para los usuarios acerca de cómo ponerse en contacto si desean asistencia técnica. FileMaker utiliza la presentación para distinguir bases de datos creadas por creadores mediante FileMaker Pro Advanced en lugar de usuarios de FileMaker Pro.

Si desea más información sobre lo que es obligatorio que aparezca en la presentación de soluciones de bases de datos en tiempo de ejecución, consulte “Responsabilidades como creador” en la página 7.

Creación de una presentación de ayuda personalizada

El sistema de ayuda de FileMaker Pro Advanced no está disponible en aplicaciones en tiempo de ejecución.

Cree una presentación de ayuda donde se proporcione información sobre cómo utilizar la solución personalizada y agréguele datos. A continuación, cree un guión en el archivo primario de la solución para mostrarlo en el sistema de ayuda. Utilice la función Menús personalizados para que el guión esté disponible como comando en el menú Ayuda.

Para crear una página Web que documente su solución, coloque un visor Web en su presentación de ayuda que abra la página Web.

Para que el menú Ayuda personalizado aparezca en Mac OS, debe comenzar con un menú vacío. Para obtener más información sobre cómo crear y editar menús personalizados, consulte “Acerca de los menús personalizados” en la página 20.

Prueba anterior y posterior a la creación de la soluciónEs necesario verificar la funcionalidad de la solución de base de datos mediante una prueba exhaustiva antes y después de personalizarla con Utilidades de creador.


Para garantizar la calidad de la solución de base de datos personalizada:

1 Compruebe cada función y opción de la solución. Si desarrolla una solución para las dos plataformas, pruébelas en Windows y Mac OS X.

1 Asegúrese de que la solución de base de datos en tiempo de ejecución no utiliza una función de FileMaker Pro estándar oculta o desactivada en la aplicación en tiempo de ejecución. Consulte apéndice A, “Comparación de funciones de la aplicación en tiempo de ejecución con FileMaker Pro”.

1 Compruebe que todos los guiones y botones funcionan según lo previsto. Esta comprobación es muy importante si se muestra la solución en modo Quiosco. Consulte “Creación de soluciones de quiosco” en la página 17.

1 Compruebe los procedimientos de instalación y pruebe otras instrucciones de la documentación.

1 Compruebe que las presentaciones de la base de datos se muestran correctamente en los monitores, con diferentes colores y resoluciones, y en el monitor más pequeño que pueda utilizar alguno de los usuarios.

1 Pruebe la solución de base de datos en tiempo de ejecución con datos reales. Esto es extremadamente importante si los usuarios están realizando una actualización de versiones anteriores de la aplicación y necesitan importar datos a archivos de la solución nueva.

1 Asegúrese de que todos los archivos auxiliares y los archivos DLL (Windows) están presentes.

1 Muéstreles la solución de base de datos a los usuarios para poner de manifiesto cualquier problema de uso.

1 Instale los archivos de base de datos incluidos en un equipo completamente diferente para verificar que se pueden encontrar todos los archivos asociados con el archivo primario.

1 Si va a asignar contraseñas o retirar privilegios de acceso completo de forma permanente, pruebe todos los niveles de acceso.

1 Asegúrese de que la solución de base de datos contiene una presentación "Acerca de" donde se notifica a los usuarios el nivel de acceso que se les va a proporcionar.

Importante Debe conservar una versión no enlazada de cualquier archivo de solución de base de datos en tiempo de ejecución, especialmente en caso de que haya retirado de forma permanente los privilegios de acceso completo.

Distribución de actualizaciones en soluciones de bases de datos en tiempo de ejecuciónSi realiza mejoras o modificaciones de funciones en el archivo enlazado primario de la solución de base de datos en tiempo de ejecución, se puede distribuir el archivo actualizado para los usuarios sin volver a enlazarlo. Sin embargo, si se modifica el nombre de archivo del archivo primario, será necesario volver a enlazar el archivo y distribuir una nueva versión de la aplicación en tiempo de ejecución junto con el archivo actualizado.

Para distribuir archivos auxiliares nuevos o actualizados para la solución de base de datos en tiempo de ejecución, enlácelos antes de utilizar la clave de enlace original. Si va a distribuir un archivo auxiliar nuevo que requiera nuevas fuentes de datos en el archivo principal o que requiera interactuar con otros archivos, debe actualizar todos los archivos modificados.

Si olvida la clave de enlace original de la solución de base de datos en tiempo de ejecución y desea actualizar o añadir un archivo, tendrá que volver a enlazar todos los archivos de bases de datos con una nueva clave de enlace y volver a distribuir toda la solución.

Para distribuir un archivo primario actualizado:

1. Abra el archivo primario original desde la copia de la solución en tiempo de ejecución en FileMaker Pro Advanced.

2. Realice cambios en el archivo primario.


3. Si es necesario, cree un guión de importación para que los usuarios puedan importar sus datos existentes en el nuevo archivo primario.

Para obtener más información sobre la importación de datos a soluciones de tiempo en ejecución actualizadas, consulte la Ayuda.

4. Envíeles a los usuarios una copia del nuevo archivo primario con instrucciones para reemplazar el archivo primario antiguo en la carpeta de la solución de base de datos en tiempo de ejecución.

Para distribuir un archivo auxiliar nuevo o actualizado:

1. En FileMaker Pro Advanced, cree el nuevo archivo auxiliar o abra el original (antes de que estuviera enlazado) y realice los cambios correspondientes.

2. Si es necesario, cree un guión de importación para que los usuarios puedan importar sus datos existentes en el nuevo archivo.

Para obtener más información sobre la importación de datos a soluciones de tiempo en ejecución actualizadas, consulte la Ayuda.

3. Utilice Utilidades de creador para volver a enlazar todos los archivos de la solución de base de datos en tiempo de ejecución e incluir el archivo auxiliar actualizado o nuevo.

Utilice la misma clave de enlace que utilizó para el archivo primario.

4. Envíeles a los usuarios una copia del archivo auxiliar nuevo o actualizado junto con instrucciones para colocarlo en la carpeta de la solución de base de datos en tiempo de ejecución, sustituyendo el archivo antiguo si corresponde.

Si no se ha modificado la clave de enlace, no será necesario volver a distribuir la aplicación en tiempo de ejecución u otros archivos de solución.

Creación de soluciones de quioscoEl modo Quiosco es una forma de mostrar las soluciones de base de datos o las soluciones de bases de datos en tiempo de ejecución en pantalla completa, sin barras de herramientas ni menús. Como el nombre sugiere, el modo Quiosco se puede utilizar para presentar bases de datos a usuarios en forma de quiosco de información. La base de datos se puede diseñar para su uso en una pantalla táctil.

El modo Quiosco se ignora si la solución la abren cuentas con el conjunto de privilegios Acceso total, un conjunto que permite la gestión de privilegios ampliados o un conjunto que permite la modificación de presentaciones, listas de valores y guiones.

Para que una solución se muestre en modo Quiosco, debe:

1 crear una cuenta con un conjunto de privilegios limitado o una cuenta específica de quiosco.

1 activar el modo Quiosco. Al mismo tiempo que activa el modo Quiosco, puede enlazar la base de datos como solución en tiempo de ejecución.

1 anular la opción predeterminada de iniciar sesión en el archivo con la cuenta Admin.

Para crear una cuenta de quiosco:

1. Asegúrese de que dispone de una cuenta de acceso limitado.

2. Con la solución de base de datos abierta, elija el menú Archivo > Gestionar > Cuentas y privilegios.

3. En el cuadro de diálogo Gestionar cuentas y privilegios, haga clic en Nueva.


4. En el cuadro de diálogo Editar cuenta, escriba el nombre de una cuenta, haga clic en Activa en Estado de la cuenta y seleccione Nuevo conjunto de privilegios en la lista Conjunto de privilegios.

5. En el cuadro de diálogo Editar conjunto de privilegios, asigne un nombre y una descripción al conjunto de privilegios.

6. En Presentación, Listas de valores y Guiones, seleccione Todo de sólo vista o Todos sin acceso.

7. Anule la selección de la casilla de verificación Gestionar privilegios ampliados.

8. Seleccione las opciones que necesite y, a continuación, haga clic en Aceptar.

Para activar el modo Quiosco:

1. Siga los procedimientos en “Uso de las Utilidades de creador” en la página 9.

2. En el cuadro de diálogo Especificar opciones de solución, seleccione Activar modo Quiosco para cuentas no de administrador.

3. Seleccione las opciones que necesite y, a continuación, haga clic en Aceptar.

4. Para poder repetir rápidamente el proceso, haga clic en Guardar configuración y seleccione una carpeta y una ubicación para el archivo de configuración.

Para obtener más información sobre cómo guardar la configuración de la solución, consulte la Ayuda.


Si no ha enlazado los archivos con ninguna aplicación de tiempo de ejecución, las Utilidades de creador copian los archivos de base de datos seleccionados a la carpeta Project. Si no ha enlazado los archivos con ninguna aplicación de tiempo de ejecución, las Utilidades de creador copian todos los archivos de tiempo de ejecución a una carpeta nueva creada en la carpeta Project cuyo nombre coincide con el de la solución en tiempo de ejecución.

Para cambiar la opción predeterminada de iniciar sesión en el archivo con la cuenta Admin:

1. Con la solución de base de datos abierta, elija el menú Archivo > Opciones de archivo.

2. En la pestaña Abrir/Cerrar, anule la selección de Iniciar sesión con.


Si se crea una solución que se vaya a ejecutar en modo Quiosco, hay que proporcionar una forma de desplazarse a la solución y la posibilidad de que los usuarios cierren la solución.

Nota Si tiene una solución de quiosco que mostraba el área de estado, necesitará actualizar su solución. En una solución de quiosco no se puede mostrar la barra de herramientas de estado ni la barra de presentación. Deberá agregar un botón de desplazamiento de registros, estado de guión en pausa y Cancelar y Continuar guión en sus presentaciones.

Para obtener más información acerca del uso de guiones y botones para controlar soluciones de quiosco, consulte la Ayuda.

Capítulo 3 Personalización de las soluciones de base de datos

FileMaker Pro Advanced se puede utilizar para personalizar las soluciones más aún que con FileMaker Pro. Puede:

1 copiar y pegar campos para utilizarlos en el mismo archivo o en otros archivos de base de datos

1 copiar o importar en su archivo de base de datos las tablas existentes

1 crear funciones personalizadas, que se pueden utilizar en cualquier lugar de un archivo

1 crear menús personalizados

1 crear temas de presentación personalizados

Importante Para personalizar los menús, debe tener privilegios de acceso total.


Copiar e importar esquemas de campo y de tablaPuede copiar o importar campos y esquemas de tabla dentro de un archivo o a otros archivos de base de datos.

Con FileMaker Pro Advanced se pueden consolidar tablas de una solución de múltiples archivos en un solo archivo. Hay dos métodos de consolidación de soluciones:

1 Copiar esquemas de tabla: abra los archivos de origen para seleccionar y copiar las tablas que desee. A continuación, pegue los esquemas en el archivo de destino.

1 Importar esquemas de tablas: importe esquemas de tabla directamente en el archivo de destino. Puede importar sólo los esquemas o los datos con un único esquema. (Para importar los datos con un único esquema, elija el menú Archivo > Importar registros > Archivo.)

Para obtener más información sobre cómo copiar e importar campos y tablas, consulte la Ayuda.


Copiar un esquema de campo Elija el menú Archivo > Gestionar > Base de datos > pestaña Campos. Seleccione el campo de la lista y, a continuación, haga clic en Copiar. Los datos no se copian.

Copiar un esquema de tabla Abra el archivo que contiene la tabla que desea copiar. Elija el menú Archivo > Gestionar > Base de datos > pestaña Tablas. Seleccione el menú de la lista y haga clic en Copiar.

Importar un esquema de tabla Abra el archivo al que desea importar una tabla. Elija el menú Archivo> Gestionar > base de datos, > pestaña Tablas. Haga clic en Importar. Seleccione el archivo de origen y la tabla, y haga clic en Aceptar.


Creación de funciones personalizadasLa característica Funciones personalizadas se utiliza para crear funciones personalizadas que se puedan volver a utilizar en cualquier lugar del archivo de base de datos en el que se crean. Una vez escritas las fórmulas para la función, no es necesario volverlas a escribir para aplicarlas a otros campos o para utilizarlas en otros guiones.

Las funciones personalizadas y las fórmulas que contienen se pueden mantener y editar en una ubicación central. Todo cambio que se realice en la función personalizada se copiará en todas las instancias en las que se haya utilizado dicha función.

Para crear una función personalizada:

1. Elija el menú Archivo > Gestionar > Funciones personalizadas.

2. En el cuadro de diálogo Gestionar funciones personalizadas, haga clic en Nueva.

3. En el cuadro de diálogo Editar función personalizada, escriba un nombre para la función y cree una fórmula.


Para obtener más información sobre la creación de funciones personalizadas, consulte la Ayuda.

Acerca de los menús personalizadosCon FileMaker Pro Advanced se pueden crear menús personalizados, elementos de menú y conjuntos de menús para las soluciones de bases de datos. Puede:

1 crear un menú nuevo o editar uno existente

1 duplicar o eliminar un menú

1 añadir, duplicar o eliminar elementos de menú

1 especificar las propiedades de los elementos de menú, como el título de visualización, el acceso directo y la acción

Lista de funciones

Cuadro de fórmula

Lista de parámetros

Sus parámetros personalizados aparecen en este espacio

Lista de vistas (abierta)

Cuadro de diálogo Editar función

Capítulo 3 | Personalización de las soluciones de base de datos 21

Los menús se pueden personalizar:

1 editando una copia de un menú FileMaker estándar. Este método se utiliza para hacer pequeños cambios en los menús existentes; por ejemplo, para modificar las propiedades de unos pocos elementos de menú.

1 partiendo de un menú vacío. Este método se utiliza para hacer cambios importantes en los menús; por ejemplo, para añadir menús y cambiar las propiedades de los elementos de menú.

Ejemplo de menú personalizadoEn el siguiente ejemplo se muestra cómo personalizar el elemento de menú Nuevo registro que aparece en el menú Registros. Puede renombrar el elemento de menú Nuevo registro a Nueva factura y, a continuación, asociar un guión que se ejecute cuando el usuario elija el elemento de menú Nueva factura. Por último, puede cambiar el conjunto de menús predeterminado, para que cuando un usuario abra la base de datos se muestre el nuevo conjunto de menús personalizado.

En este ejemplo se supone que la base de datos contiene un guión llamado Mi factura nueva. Mi factura nueva automatiza varias tareas, como cambiar a la presentación Facturas y crear un registro vacío.

1. Abra la base de datos y elija el menú Archivo > Gestionar > Menús personalizados. Haga doble clic en el menú Registro para editar una copia del menú Registros estándar.

2. Seleccione el elemento de menú Nuevo registro para modificar las propiedades del mismo. Cambie el título del elemento de menú Nuevo registro a Nueva factura.

3. Cambie la acción del elemento de menú para que ejecute el guión Mi factura nueva.

4. Establezca el conjunto de menús predeterminado para el archivo en el valor Conjunto de menús personalizados 1.


Menú

Barra de menús

Conjunto de menús (para esta ventana de archivos)

Elemento de menú

Separador

Submenú

Título de visualización de menús

Terminología de los menús personalizados


Creación de menús personalizadosPara crear un menú personalizado:

1. Elija el menú Archivo > Gestionar > Menús personalizados > pestaña Menús personalizados.


3. En el cuadro de diálogo Crear menú personalizado, realice una de las acciones siguientes y haga clic en OK:

1 Haga clic en Comience con un menú vacío.

1 Haga clic en Comience con un menú FileMaker estándar y seleccione un menú de la lista.

Aparece el cuadro de diálogo Editar menú personalizado.

4. En el cuadro de diálogo Editar menú personalizado, especifique el nombre del menú, el título que desea que se muestre en la barra de menús, la plataforma de menú y los modos en los que se mostrará el menú. Consulte la Ayuda para obtener más información sobre estas opciones.

5. Cree elementos de menú personalizados como se describe a continuación.

Creación de elementos de menú personalizadosUna vez creado el menú, se pueden crear elementos de menú. También se pueden crear o editar elementos de menú que son copias de los menús estándar de Filemaker. Los elementos de menú pueden ser comandos, submenús o separadores. Puede crear un elemento de menú que se base en un comando estándar de FileMaker o uno que inicialmente no tenga un comando asignado.

Si basa un elemento de menú en un comando de FileMaker, dicho elemento hereda todas las propiedades del comando. Para personalizar el elemento de menú, puede omitir propiedades (título, acceso directo o acción).

Si crea un elemento de menú que no tenga ningún comando asignado, aparece un elemento de menú sin título en la lista Elementos de menú del cuadro de diálogo Editar menú personalizado. A continuación, puede personalizar las propiedades del elemento de menú.

Para crear o editar un elemento de menú personalizado:

1. Elija el menú Archivo, >Gestionar> menús personalizados, >pestaña Menús personalizados.

2. En el cuadro de diálogo Gestionar menús personalizados, seleccione el menú de la lista y, a continuación, haga clic en Editar.

Los menús entre corchetes están

bloqueados y no se pueden personalizar


3. En el cuadro de diálogo Editar menú personalizado, especifique qué elementos de menú se incluyen en el menú:

4. Seleccione cada elemento de menú en la lista Elementos de menú y especifique sus propiedades.


Añadir un comando Haga clic en Comando.

En el cuadro de diálogo Especificar comando de FileMaker, realice una de las acciones siguientes y haga clic en Aceptar.1 Haga clic en Ningún comando asignado. FileMaker Pro Advanced añade un elemento de menú Sin título

a la lista de elementos de menú. Debe especificar propiedades para este comando (consulte el Pasopaso 4).

1 Haga clic en Usar un comando FileMaker y seleccione un comando de la lista.

El comando determina la acción o el comportamiento del elemento de menú.

Sugerencia En el cuadro de diálogo Editar menú personalizado, pulse Mayús y haga clic en Comandopara crear un elemento de menú de comando Sin título.

Añadir un submenú Para añadir otros comandos del menú al menú actual, haga clic en Submenú.

En el cuadro de diálogo Especificar submenú, seleccione el menú que desea incluir y haga clic en OK.

Nota Es posible añadir hasta cien menús a la barra de menús. Si añade un menú que se incluya a sí mismo como submenú, puede alcanzar el límite rápidamente.

Añadir una línea separadora

Seleccione en la lista el elemento de menú bajo el que desea que aparezca la línea de separación y haga clic en Separador.

Duplicar un elemento de menú

Seleccione un elemento de menú de la lista y haga clic en el .

Eliminar un elemento de menú

Seleccione un elemento de menú de la lista y haga clic en el .


Cambiar un comando en un elemento de menú

Haga clic en Especificar. En el cuadro de diálogo Especificar comando de FileMaker, seleccione un comando y haga clic en Aceptar.

Elegir una plataforma para un elemento de menú

Seleccione Windows, Macintosh o ambas opciones. El elemento de menú aparecerá en las plataformas que seleccione.

Nota Algunos comandos son válidos solamente en una plataforma.

Cambiar el título de un elemento de menú

Seleccione Título y escriba el texto. Para especificar una clave de acceso (Windows), escriba un carácter ampersand (&) delante del carácter que desee utilizar como clave de acceso. Por ejemplo, escriba &Abrir para mostrar el menú Abrir con la letra “A” como clave de acceso.

Para basar el título del menú en el resultado de un cálculo, haga clic en Especificar y, a continuación, cree una fórmula en el cuadro de diálogo Especificar cálculo.

Nota Los elementos de menú sin título no tienen casilla de verificación.

Definir un acceso directo para un elemento de menú

Seleccione Acceso directo. En el cuadro de diálogo Especificar acceso directo, escriba la combinación de teclas y haga clic en Aceptar.Para obtener más información sobre los accesos directos de teclado, consulte la Ayuda.

Ejecutar un guión o un paso de guión cuando el usuario selecciona un elemento de menú

Seleccione Acción, realice una de las operaciones siguientes y haga clic en Aceptar.1 Seleccione Guión. En el cuadro de diálogo Especificar opciones de guión, seleccione un guión e introduzca

los parámetros opcionales del mismo, cuando sea necesario.

1 Seleccione Paso de guión. En el cuadro de diálogo Especificar paso de guión, seleccione un paso, especifique las opciones necesarias y haga clic en Aceptar.

Nota Los elementos de menú sin título no tienen la casilla de verificación Acción.

Consejo Para que afecte al comportamiento de un guión que se esté ejecutando en ese momento (por ejemplo, para detener, salir, reanudar o poner el guión en pausa), elija Paso de guión y utilice el paso de guión Ejecutar guión.

Para obtener más información sobre los guiones y los pasos de guión, consulte la Ayuda.


Creación de conjuntos de menús personalizadosPuede crear conjuntos personalizados de menús que incluyan los menús que necesite.

Para crear o editar conjuntos de menús:

1. Elija el menú Archivo > Gestionar > Menús personalizados > pestaña Juego de menús.

2. Crear un conjunto de menús, o editar o duplicar un conjunto de menús existente. También se pueden borrar conjuntos de menús que los usuarios no vayan a necesitar.

3. Especifique los menús que desea incluir en el conjunto de menús y haga clic en Aceptar.

Importante La duplicación de un conjunto de menús personalizado crea una copia del conjunto de menús y hace referencia a los mismos menús personalizados que el conjunto de menús original. No duplica los menús personalizados. Si se cambia un elemento de menú, el cambio se produce en todos los conjuntos de menú que incluyan dicho elemento.

Una vez creados los conjuntos de menús, debe especificar las opciones para instalarlos. Puede:

1 especificar un conjunto de menús personalizado predeterminado para un archivo

1 especificar conjuntos de menús para presentaciones individuales

1 crear guiones que cambian los conjuntos de menú

1 especificar menús en el conjunto de menús para que se muestren según el modo

1 cambiar los conjuntos de menús con el menú Herramientas de FileMaker Pro Advanced

Para obtener más información sobre cómo crear, instalar y probar conjuntos de menús personalizados, consulte la Ayuda.

Para cambiar este orden, arrastre la flecha hacia arriba o hacia abajo

Los menús aparecen en la barra de menús en el orden que muestra esta lista


Creación de temas de presentación personalizadosFileMaker Pro y FileMaker Pro Advanced utilizan diversos temas de presentación para describir los colores, los patrones, las fuentes y los bordes de texto, de campos y de las partes de las presentaciones nuevas.

Un tema es un documento en Extensible Markup Language (XML, Lenguaje extensible de marcas) que se puede leer y editar en un editor de texto (como el Bloc de notas en Windows o BBEdit en Mac OS X) o en un editor de XML (como XMLSpy o XMetaL). Puede personalizar un tema existente o crear uno nuevo, y usar el asistente de nueva presentación/informe para aplicar el tema personalizado cuando cree presentaciones para sus bases de datos. Una vez creada la presentación, es posible modificar los atributos definidos por el tema en el modo Presentación. Sin embargo, no es posible aplicar un tema a una presentación existente.

Nota Los temas de FileMaker no son hojas de estilo y no contienen información sobre la posición de los objetos en una presentación.

Importante El código XML para los temas de presentación debe estar bien formado y utilizar la sintaxis adecuada. La omisión de un elemento o atributo necesario, o la no coincidencia de las etiquetas de inicio y de fin pueden dar lugar a que el documento quede inutilizable y FileMaker Pro Advanced no pueda analizar el XML ni mostrar el tema en el asistente Nueva presentación/informe.

Para crear o modificar un tema:

1. Haga una copia de los archivos de temas en la carpeta Themes.

Windows: FileMaker Pro Advanced\Extensions\Spanish\Themes\

o

Mac OS X: FileMaker Pro Advanced/FileMaker Pro Advanced.app/Contents/Resources/Spanish.lproj/Themes/

Importante El número total de archivos de temas está limitado a 50.

2. Renombre la copia e incluya la extensión .fth en el nombre de archivo nuevo.

Conserve el archivo nuevo en la carpeta Themes. Para que el asistente de nueva presentación/informe muestre una opción de tema, el archivo de temas debe estar en la carpeta Themes y debe tener la extensión .fth.

Crear temas para aplicar automáticamente distintos estilos al texto y a los rellenos de fondo de partes de la presentación, campos y etiquetas de campo

Rellenar el color y el patrón de la cabecera

Rellenar el color y el patrón del cuerpo

Rellenar el color y el patrón del pie de página

Etiqueta de campo

Etiqueta de campo Relleno, borde y

efecto sombra del campo

Texto del pie de página

Texto de la cabecera


3. Abra el archivo de temas en un editor de texto.

4. Para cambiar el nombre de un tema, sustituya el valor del elemento THEMENAME por otro nombre.

<THEMENAME VALUE="Pantalla morada y blanca" />

Importante Si el valor de THEMENAME contiene caracteres ASCII superiores, utilice el atributo HINT para asegurarse de que el nombre del tema va a aparecer en plataformas tanto Windows como Mac OS X.

5. Cambie los valores de otros elementos y atributos.

Por ejemplo, para cambiar el color de relleno de fondo del cuerpo en una presentación a morado claro, cambie el valor hexadecimal del color a #9933CC:

<BODYPART><FILL COLOR = “#9933CC” PATTERN = “2” />

6. Quite los elementos que no desee especificar.

Asegúrese de quitar todo el elemento de una y de varias líneas, incluidas las etiquetas de inicio y de fin.

7. Desplácese hacia abajo hasta el siguiente elemento FMTHEME y repita estos pasos para cambiar el valor de THEMENAME y otros elementos.

8. Guarde el archivo en formato texto con la extensión de nombre de archivo. fth en la carpeta Themes.

Los nuevos valores de THEMENAME aparecerán en el asistente de nueva presentación/informe como opción de Tema de presentación.

9. En FileMaker Pro Advanced, elija el menú Presentación> Nueva presentación/informe para utilizar el tema.

Siga las instrucciones del asistente de nueva presentación/informe. Los nombres de los temas personalizados aparecen como opciones. El tercer panel presenta una lista de temas entre los que elegir.

Si los temas nuevos no aparecen en el asistente de nueva presentación/informe, es posible que haya cometido un error de sintaxis.

Elemento de varias

líneas

Elemento de una línea

Atributos


Requisitos para los archivos de temasTodos los archivos de temas deben comenzar con una instrucción de procesamiento del documento XML que lo declara como un documento XML mediante la especificación XML 1.0. Además, los documentos XML para los temas de presentación deben contener las etiquetas de inicio y de fin <FMTHEMES> y </FMTHEMES> para el archivo. El elemento raíz FMTHEMES puede contener uno o más elementos FMTHEME.

Para obtener más información sobre los elementos de los temas y sus atributos, consulte la Ayuda.

Número mínimo de elementos necesarios para un archivo de temas

Capítulo 4 Depurar y analizar archivos

Las funciones de FileMaker Pro Advanced que se explican en este capítulo son:

1 El depurador de guiones para las pruebas y depuraciones sistemáticas de guiones de FileMaker.

1 La función Desactivar pasos de guión, para probar partes de los guiones.

1 La función Informe de diseño de base de datos, para publicar una completa documentación sobre los esquemas y las opciones de la base de datos

1 El Visor de datos, para supervisar campos, variables y cálculos.

Nota Consulte la Ayuda para obtener información completa y pormenorizada y procedimientos detallados para usar FileMaker Pro Advanced.

Depuración de guionesCon FileMaker Pro Advanced, puede usar el Depurador de guiones para:

1 depurar guiones de arranque (el menú Depurador de guiones está activado incluso cuando no hay archivos abiertos)

1 depurar un guión activado por un activador de guión

1 desplazarse por los guiones paso a paso

1 ver y hacer un seguimiento de los subguiones

1 supervisar campos, variables y cálculos

1 desactivar pasos de guión

1 depurar guiones de acceso restringido

1 pausar un guión cuando se encuentran errores de guión

1 haga clic en un número de error de guión para abrir el tema de Ayuda

Para ejecutar guiones en modo de depuración:

1. Seleccione el menú Herramientas, >Depurador de guiones.

Se abre el cuadro de diálogo Depurador de guiones.

2. Ejecute el guión.


Puede visualizar subguiones al desplazarse por los guiones en el depurador de guiones. Por ejemplo, si el Guión A llama al Guión B, que a su vez llama al Guión C, se pueden ver los pasos de los tres guiones.

El depurador de guiones reconoce los privilegios asociados a cada guión. En el depurador de guiones sólo aparecerán aquellos guiones cuyos privilegios haya editado y cuyos privilegios de acceso estén establecidos en Modificable. Puede hacer clic en Autenticar/Anular la autenticación del guión para iniciar sesión y editar pasos de guión en guiones de acceso restringido.

En la ventana Depurador de guiones puede seleccionar más de un paso de la lista, que le permitirá colocar varios puntos de interrupción simultáneamente en los pasos. Si se seleccionan varios pasos, se desactivará el botón Configurar paso siguiente.

Nota Cuando usa el depurador de guiones para revisar paso a paso guiones activados por un activador de guión, no puede interactuar con las ventanas del documento, moverse entre campos o registros, cambiar los datos, cerrar la ventana ni salir. Este bloqueo de la interacción solo se produce cuando el guión se activa mediante alguna acción. Cuando depura un guión que no está activado por un activador de guión, puede interactuar de manera habitual con las ventanas de los documentos, los campos y los registros. Para obtener información acerca del uso de activadores de guiones, consulte la Ayuda.

Consejo Para activar el depurador de guiones desde el cuadro de diálogo Gestionar guiones, pulse Mayús y haga clic en Ejecutar el botón de flecha. Para desactivar el Depurador de guiones, pulse Ctrl (Windows) o Comando (MacOS) y haga clic en el botón Ejecutar.

Desactivación de pasos de guiónEs posible desactivar y activar pasos de guión para probar las distintas partes de los guiones. Cuando se ejecuta un guión, los pasos de guión desactivados se omiten.

Para desactivar pasos de guión:

1. Seleccione el menú Guiones > Gestionar guiones.

O bien, elija el menú Archivo > Definir > Guiones.

2. En el cuadro de diálogo Gestionar guiones, haga doble clic en el nombre de guión.

O bien, haga clic en el botón Editar en el cuadro de diálogo Depurador de guiones.

3. En el cuadro de diálogo Editar Guión, seleccione uno o varios pasos de guión y haga clic en Desactivar o Activar.

Para obtener más información sobre las depuración de guiones, consulte la Ayuda.

Uso del Visor de datosEl Visor de datos se puede utilizar para supervisar expresiones como valores de campo, variables locales y globales, y cálculos. Puede supervisar estas expresiones mientras se ejecutan guiones o cuando se prueben en el depurador de guiones. También se pueden supervisar los valores de campo y las variables del archivo de base de datos.

La pestaña Actual muestra los campos y variables del guión que está en ejecución, los campos a los que se hace referencia en los cálculos usados en el guión y las variables globales. La pestaña Control supervisa expresiones seleccionadas hasta que se quiten de la lista.

Capítulo 4 | Depurar y analizar archivos 31

Para supervisar campos, variables y cálculos:

1. Elija el menú Herramientas, >Visor de datos o haga clic en el botón Abrir/Cerrar visor de datos en la ventana Depurador de guiones.

2. En la pestaña Actual, haga doble clic en una función para que aparezca un cuadro de diálogo en el que puede:

1 Ver, editar y copiar variables locales y globales.

1 Ver (pero no editar) valores de campos.

3. Para ordenar las expresiones, haga clic en una cabecera de columna. Las expresiones se ordenan de forma individual en este orden: campos, variables globales, variables locales.

4. Para añadir una expresión a la pestaña Observar, haga clic en Añadir a observador.

La expresión se copia en la pestaña Observar y ésta última se abre.

5. Para ver o editar guiones de acceso restringido, haga clic en el , a continuación inicie sesión en una cuenta con privilegios de acceso completo.

Nota Si inicia sesión para editar guiones de acceso restringido en el Depurador de guiones, sus privilegios de acceso también se aplican al Visor de datos. Si inicia sesión desde el Visor de datos, sus privilegios de acceso también se aplican al Depurador de guiones. En los dos casos, sus privilegios de edición durarán hasta que cierre el Depurador de guiones o el Visor de datos.

6. Haga clic en la pestaña Observar.

7. Seleccione una de las opciones siguientes:


Añadir una expresión Haga clic en .

Editar una expresión Seleccione una expresión y, a continuación, haga clic en el o haga doble clic en la expresión.

Duplicar una expresión Seleccione una o varias expresiones y haga clic en .

Eliminar una expresión Seleccione una o varias expresiones y haga clic en .

Haga clic para ver expresiones de acceso restringido

Haga clic en una cabecera de columna para ordenar

Para cambiar este orden, arrastre la flecha

hacia arriba o hacia abajo


8. En el cuadro de diálogo Editar expresión, seleccione el archivo de base de datos que contenga la expresión y, a continuación, cree o edite la expresión que desea supervisar.

9. Haga clic en Evaluar ahora para mostrar el resultado de una expresión o haga clic en Supervisar para añadir la expresión a la lista de control en el Visor de datos.

10. En el Visor de datos, haga clic en Actualizar valores para actualizar los cálculos de la lista.

Para obtener más información acerca del uso del Visor de datos, consulte la Ayuda.

Usar el informe de diseño de base de datosUtilice la función Informe de diseño de base de datos (DDR) para documentar el esquema de su base de datos y publicarlo en un archivo HTML o XML. Puede elegir los elementos y tablas de base de datos que desea incluir en el informe. La versión en HTML del informe contiene hipervínculos y se puede ver o imprimir en un navegador Web habilitado para Javascript.

Con la función de informe de diseño de base de datos, puede:

1 examinar una representación textual de su esquema de base de datos

1 recopilar estadísticas sobre la estructura de su base de datos

1 usar la información del informe para recrear la estructura de la base de datos si pierde los archivos de base de datos originales

1 solucionar referencias perdidas, relaciones rotas, cálculos, y más

Para crear un informe de diseño de base de datos:

1. Abra todos los archivos de base de datos de los que desee generar un informe de diseño de base de datos.

Debe tener privilegios de acceso completo en todos los archivos de los que desee generar un informe de diseño de base de datos y el archivo se debe abrir en FileMaker Pro Advanced. Los informes de diseño de base de datos se pueden ejecutar en archivos locales o remotos.

Selecciones los operadores de texto y los matemáticos.

Elija las referencias de campo.

Cuadro de fórmula

Seleccione los operadores lógicos y de comparación.

Elija la forma en que se muestran las funciones en el cuadro de diálogo.

Seleccione funciones

Evaluar el contenido de la expresión

Añadir la expresión al Visor de datos

Resultado de la

expresión

Nombre de archivo

Capítulo 4 | Depurar y analizar archivos 33

2. Elija el menú Herramientas > Informe de diseño de base de datos.

3. En la lista Archivos disponibles, borre los archivos que desee excluir del informe, para lo que debe desactivar la casilla de verificación asociada con el archivo.

4. Si alguno de los archivos contiene tablas que desee excluir del informe, selecciónelo en la lista Archivos disponibles.

Las tablas del archivo aparecen en la lista Incluir campos de tablas en el archivo seleccionado. En dicha lista puede anular la selección de cualquier tabla.

De forma predeterminada, se generan informes de todas las tablas de todos los archivos seleccionados.

5. Borre los elementos que desee excluir del informe.

De forma predeterminada, se generan informes de todos los elementos de todos los archivos seleccionados. Si están presentes, se generarán informes de todos los elementos seleccionados para todos los archivos seleccionados.

6. Si prefiere publicar el informe en formato XML en lugar del HTML predeterminado, seleccione XML en la sección Formato de informe.

7. Si no desea que el informe se abra automáticamente cuando se haya realizado, desactive la casilla de verificación de esta opción en la sección Gestión de archivos.


Para obtener más información acerca del uso del Informe de diseño de base de datos, consulte la Ayuda.

Capítulo 5 Desarrollo de plug-ins de FileMaker por parte

de otros fabricantes

Si usted es un programador en C o C++ y tiene conocimientos de cálculos de FileMaker Pro y FileMaker Pro Advanced, puede crear plug-ins de funciones externas que amplíen el conjunto de funciones de la aplicación. Los plug-ins pueden aprovechar la recursividad y los bucles o colgarse en otras interfaces de programación. Los usuarios pueden activar los plug-ins en FileMaker Pro, FileMaker Pro Advanced y FileMaker Server, y utilizar las funciones externas en sus campos y guiones de cálculos.

Puede utilizar FileMaker Server para asegurarse de que los clientes de FileMaker Pro tienen el plug-in más actual instalado en sus ordenadores. Consulte la Guide to Updating Plug-Ins de FileMaker Server, que encontrará en www.filemaker.com/downloads.


Acerca de las funciones externasFileMaker Pro Advanced incluye un proyecto de creación de un plug-in de ejemplo que puede modificar para crear sus propias funciones externas. Los usuarios pueden acceder a sus plug-ins a través del cuadro de diálogo Especificar cálculo.

Siga estos pasos generales para preparar plug-ins personalizados:

1. Edite los archivos con plug-ins de ejemplo para añadir su código de programación personalizado.

2. Compile y pruebe el plug-in personalizado.

3. Instale el archivo con el plug-in compilado para sus usuarios.

Para acceder a las funciones externas, los usuarios:

1. Activan el plug-in en el cuadro de diálogo Preferencias.

2. Configuran el plug-in, si fuera necesario.

3. Definen o editan un campo de cálculo.

4. En el cuadro de diálogo Especificar cálculo, eligen Function_Name(parameter 1 ...) como fórmula del cálculo.

Para ver todas las funciones externas, seleccionan Funciones externas en la lista desplegable Vista.

Acerca del plug-in de ejemploEl proyecto de plug-in de ejemplo se ha diseñado para ilustrar cómo es un plug-in completo. Puede compilar los archivos del proyecto de ejemplo para crear un plug-in con varias funciones externas a las que los usuarios pueden acceder a través del cuadro de diálogo Especificar cálculo. El código fuente de los archivos de ejemplo se puede examinar y modificar en cualquier editor de texto.

El ejemplo de plug-in incluye varias funciones externas. Consulte “Descripción de las funciones externas del plug-in FMExample” en la página 38.


Los archivos del plug-in de ejemplo incluyen todo el código fuente necesario para compilar el plug-in para plataformas Windows y Mac OS X. Además del código fuente de plug-in, FileMaker Pro Advanced incluye archivos de proyecto para Microsoft Visual Studio 2005 y Apple Xcode 3.0.

Los archivos del plug-in de ejemplo se encuentran en la carpeta Extras español\Ejemplos\FMExample del CD de FileMaker Pro Advanced o la descarga electrónica. Los archivos con el código fuente del plug-in de ejemplo se encuentran en la carpeta de plug-ins FMExample. Las siguientes tablas describen algunas de las carpetas y archivos.

Contenido de la carpeta FMExample

Contenido de la carpeta Example

Contenido de la carpeta Support

Carpeta Descripción

Carpeta Example Contiene todos los archivos que forman parte del FMExample.

Carpeta Headers Contiene archivos de definición de función para la API de FileMaker. No los distribuya a los usuarios que no tengan licencia de FileMaker Pro Advanced.

Carpeta Libraries Contiene archivos de biblioteca para la API de FileMaker. No los distribuya a los usuarios que no tengan licencia de FileMaker Pro Advanced.

Archivo/carpeta Descripción

FMPluginExample.cpp Contiene código para la implementación de FMExample.

MacExample.fmplugin Plug-in compilado para Mac OS X.

MacExample.xcodeproj Archivo de proyecto de Apple Xcode.

WinExample.sln Archivo de proyecto de Microsoft Visual Studio .NET.

WinExample.vcproj Archivo de proyecto de Microsoft Visual C++, lo utiliza WinExample.sln.

WinExample.fmx Plug-in compilado para Microsoft Windows.

Carpeta Support Contiene todos los recursos adicionales y el código utilizado por FMPluginExample.cpp.

Archivo/carpeta Descripción

FMPluginExample.rc Contiene los recursos para la plataforma Windows.

FMPluginExample.nib Contiene los recursos para la plataforma Mac OS X.

FMPluginExample.strings Contiene las cadenas para la plataforma Mac OS X.

FMPluginFunctions.cpp Contiene código para la implementación de funciones externas en FMExample.

FMPluginFunctions.h Contiene las definiciones de las funciones externas, incluidos sus ID.

FMPluginGlobalDefines.h Contiene las constantes que utiliza FMExample, incluso las directivas del compilador para controlar la compilación del código.

FMPluginPrefs.cpp Contiene código para la implementación de un cuadro de diálogo de configuración en FMExample.

FMPluginPrefs.h Contiene las definiciones del cuadro de diálogo de configuración.

info.plist Contiene información variada para la salida de Apple Xcode.

MacExample.plc Contiene información variada para la plataforma Mac.

Resource.h Contiene las definiciones del archivo de recursos.

Capítulo 5 | Desarrollo de plug-ins de FileMaker por parte de otros fabricantes 37

Instalación, activación y configuración del plug-in de ejemploLos archivos de plug-ins de funciones externas se deben instalar en la carpeta adecuada y se deben activar en FileMaker Pro, FileMaker Pro Advanced o FileMaker Server para poder utilizarlos. Algunos plug-ins también debe configurarlos el usuario.

Algunos plug-ins (y las bibliotecas a las que hacen referencia) se cargan solamente cuando el proceso lo ejecuta un usuario que ha iniciado una sesión en el sistema; FileMaker Server se ejecuta como un servicio, no como un proceso del usuario. En consecuencia, para que funcionen con FileMaker Server es necesario escribir los plug-ins de forma diferente. Los usuarios necesitarán ver la documentación de su sistema operativo para encontrar las bibliotecas que suelen estar disponibles.

Para obtener más información sobre la instalación de plug-ins de publicación Web, consulte la Ayuda de FileMaker Server.

Para instalar un plug-in, arrastre el archivo a la carpeta Extensions de FileMaker del usuario de la siguiente manera:

En Windows, la extensión del plug-in debe ser .fmx. En Mac OS X, la extensión del plug-in debe ser .fmplugin.

Para activar un plug-in:

1. Abra el cuadro de diálogo Preferencias.

Windows: Elija el menú Edición > Preferencias.

Mac OS X: elija el menú de aplicación FileMaker Pro Advanced, >Preferencias.

2. Haga clic en la pestaña Plug-ins.

3. Seleccione el plug-in en la lista.

En la lista aparecerá un plug-in, si éste se ha instalado en la carpeta correcta de FileMaker. Al iniciarse, FileMaker Pro primero carga los plug-ins guardados en la carpeta Extensions actual de FileMaker del usuario. Si en esa carpeta no encuentra un plug-in en particular, FileMaker Pro lo busca en la carpeta Extensions de la aplicación FileMaker Pro.

En este sistema operativo: Guarde el plug-in en esta carpeta:

Windows XP C:\Documents and Settings\nombre_usuario\Configuración local\Datos de programa\FileMaker\Extensions

Windows Vista C:\usuarios\nombre_usuario\AppData\Local\FileMaker\Extensions\

Mac OS X Macintosh HD/Usuarios/nombre_usuario/Librería/Application Support/FileMaker/Extensions

Seleccione un plug-in para activarlo

El texto con la descripción del plug-in se define en una cadena de recursos


Para configurar un plug-in:

1. Seleccione el plug-in en el cuadro de diálogo Preferencias.

2. Haga clic en Configurar.

El botón Configurar sólo está disponible cuando el sexto carácter de la cadena de opciones del plug-in seleccionado es "Y". Consulte “Sintaxis de la cadena de opciones” en la página 41.

3. Para configurar el plug-in, siga las instrucciones del cuadro de diálogo de configuración.


Descripción de las funciones externas del plug-in FMExampleEl plug-in FMExample que se incluye en los proyectos de ejemplo de Microsoft Visual C++ y Apple Xcode añade las siguientes funciones externas a FileMaker Pro, FileMaker Pro Advanced, FileMaker Server y FileMaker Server Advanced.

Nombre y parámetro de la función Descripción de la función externa

XMpl_Add(number1; number2) Añade number1 y number2 a la vez y devuelve el resultado. La función es la misma que la del operador más (+) en el sistema de cálculo.

XMpl_Append(textToAppend ...) Toma una lista múltiple de parámetros, los concatena y devuelve el resultado. La función es la misma que la del operador ampersand (&) en el sistema de cálculo.

XMpl_Evaluate(calcToEvaluate) Toma un cálculo simple o complejo, lo evalúa y devuelve el resultado. Todos los cálculos compatibles con FileMaker se pueden asignar a esta función. La función es idéntica a la función Evaluate del sistema de cálculo.

XMpl_NumToWords(number) Devuelve un número en formato de cheque bancario. Por ejemplo, 44,345 devuelve 44 euros y 34 céntimos. Tanto los dígitos a partir del segundo decimal como los caracteres alfabéticos se ignoran.

XMpl_StartScript(filename; scriptname) Ejecuta el guión especificado por el parámetro scriptname en el archivo especificado por el parámetro filename.

XMpl_Version Devuelve la versión del plug-in y no tiene ningún parámetro.

Nota Para cada plug-in de FileMaker Pro es necesario contar con una función de versión similar a la que se incluye en el plug-in del ejemplo.

XMpl_UserFormatNumber (textOrNumber)

Devuelve el parámetro como una cadena de texto con el formato especificado en el cuadro de diálogo de configuración. Esta función se utiliza para dar formato a texto o a números, como números de teléfono, códigos postales, etc.

El formato se realiza de derecha a izquierda. Todos los símbolos # de la cadena de formato se reemplazan por el siguiente carácter de la cadena de parámetros. Los símbolos # restantes se reemplazan por ceros.

Esta función muestra tanto la funcionalidad sólo con clientes y el cuadro de diálogo de configuración del plug-in.

XMpl_FormatNumber(formatString; textOrNumber)

Igual que XMpl_UserFormatNumber, salvo que formatString se incluye como parámetro. Esta función muestra una función que se puede ver en el cuadro de diálogo Especificar cálculo de Entrada automática y también admite llamadas de FileMaker Server y Publicación en la Web al instante.


Uso del plug-in de ejemploPara acceder a las funciones externas:

1. Abra un archivo.

2. Abra el cuadro de diálogo Preferencias.

Windows: Elija el menú Edición > Preferencias.

Mac OS X: elija el menú de aplicación FileMaker Pro Advanced, >Preferencias.

3. Haga clic en la pestaña Plug-ins.

4. Seleccione FMExample.

Como el plug-in de ejemplo incluye una función que requiere configuración, el botón Configurar está activo.

5. Haga clic en Configurar.

El cuadro de diálogo de configuración que aparece depende de la forma en que se haya escrito el código fuente del plug-in. La función XMpl_UserFormatNumber del plug-in FMExample muestra el siguiente cuadro de diálogo de configuración.

6. Haga clic en Aceptar para utilizar el formato predeterminado, o bien escriba un formato nuevo.

Los símbolos "#" se sustituyen por números. El resto del texto de la cadena de formato se mantiene igual.

7. Haga clic en Aceptar para cerrar el cuadro de diálogo Preferencias.

8. Con el archivo abierto, en FileMaker Pro Advanced, elija el menú Gestionar> base de datos, pestaña> Campos.

9. Cree de un campo de cálculo.

10. En el cuadro de diálogo Especificar cálculo, elija Funciones externas en el menú desplegable Vista.

11. Para añadir una función externa al cuadro de fórmulas, haga doble clic en ella.

Todas las llamadas a funciones externas requieren el nombre de la función externa a la que se llama y el valor del parámetro de la misma, aunque dicho valor sea nulo.

12. Reemplace el marcador del parámetro por el parámetro o parámetros obligatorios para la función.

13. Siga construyendo la fórmula y cuando termine, haga clic en Aceptar.

14. Haga clic en Aceptar para cerrar el cuadro de diálogo Gestionar base de datos.

Los plug-ins de Mac OS creados para PowerPC necesitan recompilarse como binarios universales a fin de que se ejecuten de forma nativa cuando FileMaker Pro se ejecute en equipos Macintosh basados en Intel. Los binarios universales permiten que las aplicaciones se ejecuten tanto en PowerPC como en Macintosh basados en Intel.

Para compilar FMExample o los plug-ins personalizados en Mac OS X, realice una instalación personalizada de XCode y seleccione la opción de desarrollo cruzado.


Personalización del plug-in de ejemploEl plug-in de ejemplo de FileMaker Pro Advanced está pensado para poderse modificar con facilidad y que de esta forma pueda añadir sus propias funciones personalizadas. Tiene que modificar los siguientes elementos:

1 la información de la versión en FMPluginExample.strings y FMPluginExample.rc

1 los nombres del plug-in y de las funciones en FMPluginExample.strings y FMPluginExample.rc

1 la función de configuración en FMPluginPrefs.cpp

1 definiciones y codificación de funciones externas en FMPluginFunctions.cpp

Personalización de los recursos de ejemploPara crear un plug-in con funciones externas, debe realizar las siguientes modificaciones a los archivos de recursos del plug-in:

1 Modificar las variables y cadenas de la versión para que se ajusten a sus necesidades.

1 Revisar el cuadro de diálogo de configuración para que se ajuste a sus necesidades.

1 Especificar los valores correctos de la cadena de opciones.

1 Editar los nombres y la descripción del plug-in.

1 Definir los nombres y prototipos de las funciones.

Personalización de FMPluginExample.cppRealice sus modificaciones del archivo FMPluginExample.cpp en las funciones que se enumeran en la siguiente tabla.

Personalización de FMPluginPrefs.cppEste archivo contiene la función Do_PluginPrefs para la implementación del cuadro de diálogo de configuración. Revise o quite este código si es necesario.

Personalización de FMPluginFunctions.cppRevise o quite las funciones proporcionadas en el archivo FMPluginFunctions.cpp y defina las suyas propias. Do_PluginInit hace referencia a estas funciones al evaluar las funciones externas en los cálculos.

Requisitos para escribir plug-ins con funciones externasLos plug-ins de FileMaker son muy útiles cuando contienen una sola función o un conjunto de funciones con características similares. Al diseñar un plug-in, tenga en cuenta que es posible que los desarrolladores que lo utilicen no conozcan las convenciones de programación que usted da por conocidas. El usuario medio debe conocer el formato del parámetro de cada función.

Si va a crear un plug-in de FileMaker con funciones que no necesitan parámetros, asegúrese de que el "prototipo" de función registrado para dicha función no incluye paréntesis. Por ejemplo, hay que registrar "DoThis" en lugar de "DoThis( )" como prototipo de función.

Nombre de función Personalización

Do_PluginInit Proporcione su propio ID exclusivo de plug-in en "pluginID". Registre todas las funciones proporcionando su nombre, descripción y función que se va a utilizar. Para registrar funciones, llame a fmx::ExprEnv::RegisterExternalFunction.

Do_PluginIdle Añada todos los procesos en espera que necesite su plug-in.

Do_PluginShutdown Revise las llamadas UnRegisterExternalFunction para invertir el registro realizado en Do_PlugInit. Para anular el registro de funciones, llame a fmx::ExprEnv::UnRegisterExternalFunction.


Archivos de código APIEn la carpeta Headers hay diez archivos de código API: FMXExtern.h, FMXCalcEngine.h, FMXBinaryData.h, FMXDateTime.h, FMXTextStyle.h FMXTypes.h, FMXFixPt.h, FMXClient.h, FMXText.h y FMXData.h. Estos archivos no se pueden redistribuir en forma de código fuente (ni en forma legible), no se pueden modificar y sólo se proporcionan para que los usuarios con licencia de FileMaker Pro Advanced compilen plug-ins que se van a utilizar con productos FileMaker. No todos los archivos son necesarios para crear todos los tipos de plug-ins.

FMXExtern.h es imprescindible. FMXExtern.h define el bloque de parámetros (la estructura de datos compartidos que utilizan su plug-in y FileMaker Pro, FileMaker Pro Advanced o FileMaker Server) y algunas llamadas a funciones compartidas. Las llamadas a funciones se utilizan para manipular los identificadores de parámetros y de resultados en el bloque de parámetros.

El archivo FMXExtern.h define las funciones de llamada en las operaciones de compatibilidad con versiones anteriores y los distintos tipos de eventos del plug-in (mensajes de FileMaker Pro, FileMaker Pro Advanced o FileMaker Server) que se envían al plug-in en una definición de FMExternCallSwitch.

FMExternCallStruct define la estructura del bloque de parámetros. FMExternCallPtr es un puntero a esa estructura y gFMExternCallPtr es una variable global que se debe definir en el código.

El archivo FMXCalcEngine.h contiene las funciones para registrar y anular registros. Se utilizará en la mayoría de los plug-ins, ya que es muy probable que éstos tengan que registrar funciones.

Las funciones de los restantes archivos de código API se describen en los comentarios que se incluyen en los propios archivos.

Sintaxis de la cadena de opcionesLa cadena de opciones debe tener una longitud de once caracteres en los plug-ins.

Los cuatro primeros caracteres de la cadena de opciones son el ID del plug-in. Dicho ID debe ser único para cada plug-in y no debe comenzar por “F,” “FM” o “Web.” Para Mac OS X, es aconsejable establecer el tipo de creador del plug-in en este mismo valor. El ID sólo puede contener caracteres alfanuméricos ASCII inferiores (como 0-9, A-Z y a-z).

Nota Como resulta muy útil tener un ID único, debe registrar el ID en el sitio Web de Apple Developer Support aunque no vaya a crear ninguna versión para Mac OS X del plug-in. Para registrar los ID del plug-in como códigos de creador, diríjase a las páginas de desarrolladores del sitio Web de Apple Inc. www.apple.com.

El quinto carácter de la cadena de opciones es siempre "1" y el octavo, décimo y undécimo son siempre "n". Los restantes valores de estos indicadores están reservados para el uso exclusivo de FileMaker.

Por ejemplo, “Moc31YnnYnn” es una cadena de opciones para un plug-in cuyo ID es “Moc3” (caracteres 1-4) que requiere configuración (carácter 6 = “Y”), utiliza las nuevas llamadas de funciones y de registro de estilo (carácter 7 = “n”) y requiere un tiempo de espera especial (carácter 9 = “Y”).

Caracteres de la cadena de opciones Descripción de los caracteres

1-4 Los caracteres 1-4 son el ID del plug-in. Registre el ID como código de creador en el sitio Web de Apple Developer Support, www.apple.com.

5 El carácter 5 es siempre "1".

6 Configure el sexto carácter de la cadena de opciones para que sea "Y", si desea activar el botón Configurar para plug-ins en el cuadro de diálogo Preferencias. Utilice "n" si no es necesario configurar el plug-in. Si el indicador está establecido en "Y", asegúrese de encargarse del mensaje de kFMXT_DoAppPreferences. Para obtener más información, consulte “Mensajes de FileMaker enviados al plug-in” en la página 42.


Especificaciones de nombres de archivos para funciones externasEl prefijo de nombre de función para todas las funciones externas del plug-in debe ser un valor único que contenga cuatro o cinco caracteres y no debe empezar por los caracteres “FM” o “Web”. FileMaker se reserva los prefijos de cuatro caracteres. Por ejemplo, el prefijo del nombre de las funciones del plug-in FMPluginExample es "XMpl".

Mensajes de FileMaker enviados al plug-inHay seis posibles llamadas que FileMaker Pro, FileMaker Pro Advanced o FileMaker Server pueden solicitar a un plug-in. Los mensajes que se envían a los plug-ins se suministran en el campo whichCall del bloque de parámetros, FMExternCallStruct, definido en el archivo FMXExtern.h.

1 kFMXT_Init: el mensaje de Inicialización

1 kFMXT_Shutdown: el mensaje de Apagado

1 kFMXT_Idle: el mensaje de En espera

1 kFMXT_DoAppPreferences: el mensaje de Preferencias

1 kFMXT_External: el mensaje de Función externa que reciben los plug-ins heredados que asignan el valor “Y” al carácter 7 de la cadena de opciones y que registran sus funciones de la forma externa anterior

1 kFMXT_GetString: el mensaje de GetString que reciben los plug-ins que usan el nuevo estilo de registro cuando los plug-ins proporcionan la cadena de opciones y el nombre y descripción del plug-in

Mensaje de InicializaciónEl mensaje de Inicialización, kFMXT_Init, se envía al plug-in siempre que se activa en FileMaker Pro, FileMaker Pro Advanced o FileMaker Server. Puede corresponder, o no, con el inicio de la aplicación, según si el plug-in está activado en el cuadro de diálogo Preferencias.

El resultado tiene dos valores posibles que el plug-in debe devolver en respuesta al mensaje de Inicialización:

1 Se debe devolver kBadExtnVersion si el número de versión asignado es menor que el valor de kMinExtnVersion o mayor que el valor de kMaxExtnVersion. Esto impide al plug-in ejecutarse en una API que no sea compatible con la API con la que se compiló.

1 kCurrentExtnVersion es el único otro valor que se debería devolver. Esto hace que se active el plug-in.

7 Establézcalo en "n" para utilizar las nuevas llamadas a funciones y el nuevo registro de plug-ins que se muestra en FMExample. Establézcalo en "Y" solamente si el plug-in necesita la lista heredada de cadenas de funciones y llamadas externas individuales.

8 El carácter es siempre "n".

9 Establezca el noveno carácter de la cadena de opciones en "Y" si se requiere el mensaje de kFMXT_Idle. Para las funciones externas simples es posible que no sea necesario y se puede desactivar estableciendo el carácter en "n".

10 El carácter 10 es siempre “n.”

11 El carácter 11 es siempre “n.”

Caracteres de la cadena de opciones Descripción de los caracteres


En el plug-in FMPluginExample, se llama a la función Do_PluginInit cuando se recibe el mensaje de Inicialización. La función Do_PluginInit comprueba en primer lugar la versión de la API con la que se ha compilado el plug-in para verificar que es compatible con la versión de FileMaker Pro, FileMaker Pro Advanced o FileMaker Server. A continuación, la función comprueba las preferencias y las configura si existen. Si no existen preferencias, las creará con valores predeterminados.

En Windows, estas preferencias se almacenan como entradas del Registro. En Mac OS X, se almacenan en un archivo de la carpeta Preferencias de la Carpeta del sistema. Dadas las diferencias entre la forma en que esta información se almacena en las dos plataformas, la función Do_PluginInit utiliza instrucciones de preprocesador para elegir el código correcto durante la compilación.

Si las preferencias se configuran correctamente y la versión del API es correcta, la función Do_PluginInit del plug-in FMPluginExample devolverá kCurrentExtnVersion.Tras configurar las preferencias, registre las funciones externas introduciendo su nombre, descripción y la función que se va a utilizar. Para registrar funciones, utilice fmx::ExprEnv::RegisterExternalFunction.

Mensaje de ApagadoEl mensaje de Apagado, kFMXT_Shutdown, se envía al plug-in siempre que se activa en FileMaker Pro, FileMaker Pro Advanced o FileMaker Server. Puede corresponder, o no, con el cierre de la aplicación, según si el plug-in está desactivado en el cuadro de diálogo Preferencias.

El plug-in FMPluginExample plug-in no asigna memoria duradera a la pila y, por consiguiente, no hace nada cuando recibe el mensaje de Apagado. Sin embargo, para anular la asignación de todo lo que tenga en la pila y salir de todos los servicios del sistema operativo que pueda estar utilizando, debe implementar una función de limpieza en el plug-in. Los plug-ins se pueden activar y desactivar varias veces durante una sesión, por lo que es importante para el plug-in que se limpie la memoria.

Anule el registro de todas las funciones externas registradas durante el mensaje de Inicialización utilizando fmx::ExprEnv::UnRegisterExternalFunction.

Mensaje de En esperaEl mensaje de En espera, kFMXT_Idle, sólo se envía al plug-in en tiempo de espera si el indicador de la función en espera se estableció en "Y" en la cadena de opciones y el plug-in está activado actualmente.

La aplicación FileMaker llama a este mensaje cinco veces.

Si el parámetro idleLevel no es cero, la rutina se ha llamado mientras la aplicación está ejecutando un guión o la está controlando el usuario. Se ha enviado uno de los cuatro mensajes siguientes:

No ejecute ningún proceso largo, de interfaz de usuario ni de eventos cuando el parámetro idleLevel no sea cero.

El mensaje de En espera también se enviará si la aplicación detecta tiempo libre y realiza su gestión interna del tiempo de espera.

Mensaje Significado

kFMXT_UserNotIdle = 1 El usuario ha hecho algo en los últimos 30 segundos.

kFMXT_ScriptPaused = 2 El usuario está ejecutando un guión que se ha puesto en modo pausa.

kFMXT_ScriptRunning = 3 El usuario está ejecutando un guión.

kFMXT_Unsafe = 4 Igual que si se selecciona el valor true en el parámetro unsafeCalls.

Mensaje Significado

kFMXT_UserIdle = 0 El usuario no ha hecho nada en los últimos 30 segundos o más.


Mensaje de PreferenciasEl mensaje de Preferencias, kFMXT_DoAppPreferences, se envía en respuesta a la pulsación, por parte del usuario, del botón Configurar del plug-in seleccionado en el cuadro de diálogo Preferencias.

El plug-in debe mostrar un cuadro de diálogo que permitirá al usuario definir cualquier dato de configuración concreto que requiera el plug-in. Si el plug-in requiere preferencias que pueda definir el usuario, debe implementar aquí su interfaz de usuario. El botón Configurar sólo se activará si el sexto carácter de la cadena de opciones es establece en "Y". Para obtener más información, consulte “Sintaxis de la cadena de opciones” en la página 41.

Todas las opciones que necesitan guardarse se deben colocar en su propia entrada del Registro (Windows) o en su propio archivo de preferencias (Mac OS X).

El plug-in FMExample necesita implementar un cuadro de diálogo de configuración para la función XMpl_UserFormatNumber, por lo que el indicador se ha definido en la cadena de opciones (Xmpl1Ynnnnn) y la función Do_PluginPrefs recibe la llamada cuando se recibe el mensaje de Preferencias.

Mensaje de Función externaEl mensaje de Función externa, kFMXT_External, es un mensaje heredado de los plug-ins del estilo anterior. Ya no es necesario para los plug-ins que se registran con el estilo nuevo.

Mensaje de GetStringEl mensaje de GetString, kFMXT_GetString, se envía al plug-in cuando FileMaker Pro, FileMaker Pro Advanced o FileMaker Server desean recuperar una de las siguientes cadenas del plug-in. El desarrollador del plug-in puede decidir dónde almacenar las cadenas.

Evitación de posibles conflictos de recursos en Mac OS XEn las máquinas con Mac OS X pueden surgir problemas si el recurso de un plug-in tiene el mismo ID que FileMaker Pro, FileMaker Pro Advanced, FileMaker Server o que otro plug-in para el mismo tipo de recurso.

Para evitar posibles conflictos de ID de recursos entre un plug-in y otras aplicaciones o plug-ins, siga estas directrices:

1 Utilice números de ID entre el 23.000 y el 24.999

Utilice ID fijos de este rango para los cuadros de diálogo, sonidos, iconos y otros recursos, con el fin de evitar conflictos con recursos de FileMaker Pro, FileMaker Pro Advanced o FileMaker Server. FileMaker no utiliza ningún ID de este rango para los recursos de las aplicaciones.

1 Configure el archivo de recursos actual en su plug-in

Para evitar conflictos con otros plug-ins que usen los mismos ID de recursos, utilice la llamada a la caja de herramientas de Mac OS X del Resource Manager para configurar el archivo de recursos actual en el plug-in antes de obtener ningún objeto de recursos del archivo de recursos.

Incluya la siguiente línea delante de todas las líneas que hagan referencia o que usen un recurso:

UseResFile (pb -> resourceID) ;Cuando FileMaker Pro, FileMaker Pro Advanced o FileMaker Server carga el plug-in, la aplicación asigna el ID del recurso. Éste se encuentra en el bloque de parámetros cerca de las variables param2 y param3 del archivo FMExtern.h. Para obtener más información, consulte “Archivos de código API” en la página 41.

Cadena Significado

kFMXT_OptionsStr = 131 La cadena de opciones

kFMXT_NameStr = 12 El nombre del plug-in

kFMXT_AppConfigStr = 129 El texto de ayuda que se muestra en el cuadro de diálogo Preferencias


Inclusión de documentación en su plug-inIncluya un archivo de base de datos de ejemplo con algunos campos especiales y los guiones necesarios para mostrar el uso de las funciones externas del mismo. Además, debe incluir documentación que describa todas las funciones externas y sus parámetros.

Apéndice A Comparación de funciones de la aplicación en

tiempo de ejecución con FileMaker Pro

Al hacer doble clic en el icono de la aplicación FileMaker Pro para iniciar la aplicación, se abre el cuadro de diálogo Nueva base de datos, en el que puede elegir un archivo de base de datos. Al iniciar una aplicación en tiempo de ejecución de FileMaker Pro, el archivo de base de datos enlazado primario se abre automáticamente.

Otras diferencias importantes entre la aplicación en tiempo de ejecución y FileMaker Pro son:

1 En la aplicación en tiempo de ejecución se han quitado u ocultado todas las funciones de diseño de la base de datos.

Esto incluye el modo Presentación y los comandos en el submenú Gestionar.

1 Las funciones y menús personalizados creados con FileMaker Pro Advanced funcionarán en la aplicación en tiempo de ejecución, aunque los usuarios de ésta no pueden modificar ni crear funciones o menús personalizados nuevos.

1 Se han quitado algunos otros comandos de menú de la aplicación en tiempo de ejecución.

Por ejemplo, la aplicación en tiempo de ejecución no se puede utilizar para crear, abrir ni cerrar ninguna base de datos. (Los archivos de base de datos en tiempo de ejecución deben contener un botón o guión personalizado para abrir o cerrar otros archivos. En las ventanas de las bases de datos en tiempo de ejecución no hay comando para cerrar.).

1 La ayuda de FileMaker Pro no está disponible en la aplicación en tiempo de ejecución. No obstante, puede usar la función de menús personalizados para mostrar la Ayuda personalizada que haya creado.

1 Los plug-ins de funciones externas se pueden activar el cuadro de diálogo Preferencias.

1 Auque el filtro Datos XML aparece como una opción en el paso de guión Convertir archivo, en las aplicaciones en tiempo de ejecución no es posible convertir archivos XML con este paso de guión.

1 En FileMaker Pro, el uso compartido de archivos, el servicio de una base de datos en la Web o la comunicación con un applet de Java requiere FileMaker Pro o FileMaker Pro Advanced. Sin embargo, puede utilizar una versión compatible de FileMaker Server para servir archivos de soluciones en tiempo de ejecución.

1 Se admiten los eventos Apple, pero la automatización OLE no se admite en la aplicación en tiempo de ejecución en equipos Windows.

1 Las aplicaciones en tiempo de ejecución no se pueden compartir en red.

1 Las aplicaciones en tiempo de ejecución no incluyen la capacidad de Guardar/enviar registros como archivos PDF de Adobe.

1 Las funciones de FileMaker Pro Advanced no están disponibles en la aplicación en tiempo de ejecución.

No obstante, es posible abrir una base de datos tanto en FileMaker Pro como en FileMaker Pro Advanced. Se activan todas las funciones de estas aplicaciones, a no ser que se hayan eliminado los privilegios de acceso total.

1 Las aplicaciones en tiempo de ejecución no admiten fuentes de datos SQL externas (ESS), importación de ODBC o el paso de guión Ejecutar SQL.


Preferencias de aplicaciones y documentosEn la aplicación en tiempo de ejecución, algunas opciones no están disponibles en la pestaña General del cuadro de diálogo Preferencias.

La pestaña Presentación se cambia por la pestaña Color en el cuadro de diálogo Preferencias de la aplicación en tiempo de ejecución.

El cuadro de diálogo Opciones de archivo en la aplicación en tiempo de ejecución muestra sólo la pestaña Ortografía.

Preferencias generales en las aplicaciones en tiempo de ejecución (Mac OS X)

Preferencias generales en las aplicaciones en tiempo de ejecución (Windows)

Cuadro de diálogo Opciones de archivo de una aplicación en tiempo de ejecución

Apéndice A | Comparación de funciones de la aplicación en tiempo de ejecución con FileMaker Pro 49

Comparación de comandos de menúLas siguientes tablas muestran los comandos de menú que están disponibles en FileMaker Pro (Pro) y en la aplicación en tiempo de ejecución (TE).

Nota Se pueden añadir elementos de menú que equivalgan a los comandos de menú Abrir, Cerrar y Recuperar a una aplicación en tiempo de ejecución que utilice menús personalizados basados en un guión o paso de guión. Para obtener más información, consulte “Creación de menús personalizados” en la página 22.

Windows Mac OS X

Comando del menú Archivo Pro TE Pro TE

Nueva base de datos 1 1Abrir... 1 1Abrir remoto 1 1Abrir reciente 1 1Cerrar 1 1Gestionar 1 1Compartir 1 1Opciones de archivo 1 1 1 1Cambiar contraseña 1 1 1 1Configurar impresión 1 1Ajustar página 1 1Imprimir 1 1 1 1Importar registros 1 1 1 1Exportar registros 1 1 1 1Guardar/enviar registros como 1 1

1. No puede Guardar/Enviar registros en PDF.

1 1

Enviar correo 1 1 1 1Enviar vínculo 1 1Guardar una copia como 1 1 1 1Recuperar 1 2

2. Pulse Ctrl+Mayús

1 3

3. Pulse Opción+3

Salir 1 1


Windows Mac OS X

Comando del menú Edición Pro TE Pro TE

No se puede deshacer 1 1 1 1No se puede rehacer 1 1 1 1Cortar 1 1 1 1Copiar 1 1 1 1Pegar 1 1 1 1Pegado especial 1 1Borrar 1 1 1 1Duplicar 1 1Seleccionar todo 1 1 1 1Buscar/reemplazar 1 1 1 1Ortografía 1 1 1 1Objeto 1 1Exportar contenido del campo 1 1 1 1Preferencias 1 1

Windows Mac OS X

Comando del menú Vista Pro TE Pro TE

Modo Visualizar 1 1 1 1Modo Buscar 1 1 1 1Modo Presentación 1 1Modo Vista previa 1 1 1 1Ir a la presentación 1 1 1 1Ver como formulario 1 1 1 1Ver como lista 1 1 1 1Ver como tabla 1 1 1 1Barra de herramientas de estado 1 1 1 1Personalizar barra de herramientas de estado 1 1 1 1Barra Formato de texto 1 1 1 1Regla de texto 1 1 1 1Ampliar 1 1 1 1Reducir 1 1 1 1


Windows Mac OS X

Comando del menú Insertar Pro TE Pro TE

Imagen 1 1 1 1QuickTime 1 1 1 1Sonido 1 1 1 1Archivo 1 1 1 1Objeto 1 1Fecha actual 1 1 1 1Hora actual 1 1 1 1Nombre de usuario actual 1 1 1 1Desde índice 1 1 1 1Desde último registro visitado 1 1 1 1

Windows Mac OS X

Comando del menú Formato Pro TE Pro TE

Fuente 1 1 1 1Cuerpo 1 1 1 1Estilo 1 1 1 1Alinear texto 1 1 1 1Interlineado 1 1 1 1Color de texto 1 1 1 1Texto 1 1 1 1

Windows Mac OS X

Comando del menú Registros Pro TE Pro TE

Nuevo registro 1 1 1 1Duplicar registro 1 1 1 1Eliminar registro 1 1 1 1Eliminar todos los registros 1 1 1 1Ir al registro 1 1 1 1Refrescar ventana 1 1 1 1Mostrar todos los registros 1 1 1 1Mostrar sólo omitidos 1 1 1 1Omitir registro 1 1 1 1Omitir múltiples 1 1 1 1Cambiar búsqueda anterior 1 1 1 1Búsquedas guardadas 1 1 1 1


Nota Los comandos de menú Guardar guión, Guardar todos los guiones y Restablecer guión sólo aparecen cuando está activo el cuadro de diálogo Gestionar guiones o Editar guiones.

Ordenar registros 1 1 1 1Desordenar 1 1 1 1Reemplazar contenido del campo 1 1 1 1Volver a buscar contenido de campo 1 1 1 1Restablecer registro 1 1 1 1

Comando del menú Peticiones Windows Mac OS X

(Modo Buscar) Pro TE Pro TE

Añadir nueva petición 1 1 1 1Duplicar petición 1 1 1 1Eliminar petición 1 1 1 1Ir a la petición 1 1 1 1Mostrar todos los registros 1 1 1 1Ejecutar búsqueda 1 1 1 1Restringir conjunto encontrado 1 1 1 1Ampliar conjunto encontrado 1 1 1 1Restablecer petición 1 1 1 1

Windows Mac OS X

Comando del menú Guiones Pro TE Pro TE

Gestionar guiones 1 1Guardar guión 1 1Guardar todos los guiones 1 1Restablecer guión 1 1<Nombres de guión> 1 1 1 1

Windows Mac OS X

Comando del menú Ventana Pro TE Pro TE

Ventana nueva 1 1 1 1Mostrar ventana 1 1 1 1Ocultar ventana 1 1 1 1Minimizar ventana 1 1 1 1

Windows Mac OS X

Comando del menú Registros Pro TE Pro TE


1 Consulte la tabla de comandos del menú Aplicación

Mosaico horizontal 1 1 1 1Mosaico vertical 1 1 1 1Ventanas en cascada 1 1 1 1Organizar iconos 1 1Desplazar todo al frente 1 1<Nombres de archivos abiertos> 1 1 1 1

Windows Mac OS X

Comando del menú Ayuda Pro TE Pro TE

Ayuda de FileMaker Pro 1 1Accesos directos de teclado 1 1Centro de recursos 1 1Documentación del producto 1 1Descargas y actualizaciones 1 1Registrar ahora 1 1Activar/Desactivar

(Se muestra cuando el usuario no ha activado/Se muestra cuando el usuario ha activado)

1 1

Enviar comentarios 1 1Visite nuestro foro 1 1Acerca de FileMaker Pro (o Acerca de FileMaker Pro Advanced) 1 1

Acerca de FileMaker Pro Runtime (se muestra si no se especifica ningún guión Acerca de personalizado)

1 1

Acerca de la <solución Runtime> (se muestra si se especifica un guión Acerca de personalizado)

1 1

<Nombre del guión Ayuda de la solución Runtime> (se muestra si se especifica un guión Ayuda personalizado)

1 1

Windows Mac OS X

Comando del menú Ventana Pro TE Pro TE


Pasos de guión ignoradosComo se han quietado algunas funciones de la aplicación en tiempo de ejecución, ésta ignora los siguientes pasos de guión:

1 Abrir Gestionar base de datos

1 Abrir Gestionar lista de valores

1 Abrir Gestionar fuentes de datos

1 Abrir Gestionar guiones

1 Abrir Compartir

1 Abrir Ayuda

1 Establecer multiusuario

1 Nuevo archivo

1 Abrir Opciones de archivo (disponible parcialmente; se abrirá la pestaña Ortografía)

1 Abrir remoto

1 Ejecutar SQL

1 Guardar registros como PDF

Nota Abrir archivo devuelve un error si el archivo especificado no se ha enlazado a la aplicación en tiempo de ejecución. La aplicación en tiempo de ejecución sólo puede ejecutar un guión externo si el archivo externo está enlazado con la aplicación en tiempo de ejecución.

Comando del menú Aplicación (solo Mac OS X) Pro TE

Acerca de FileMaker Pro 1Acerca de FileMaker Pro Runtime (se muestra si no se especifica ningún guión Acerca de personalizado)

1

Acerca de la <solución Runtime> (se muestra si se especifica un guión Acerca de personalizado)

1

Preferencias 1 1Servicios 1 1Ocultar FileMaker Pro 1Ocultar <solución Runtime> 1Ocultar otros 1 1Mostrar todos 1 1Salir de FileMaker Pro 1Salir de <solución Runtime> 1


Configuración o preferencias almacenadas del registro

Configuración del registro de Windows

FileMaker Pro almacena la configuración del registro en

HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\.0

FileMaker Pro Advanced almacena la configuración del registro en

HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\.0A

La aplicación en tiempo de ejecución almacena su configuración del registro en

HKEY_CURRENT_USER\Software\FileMaker\<nombre de solución>\0,0

Nota La extensión de nombre de archivo del archivo de base de datos en tiempo de ejecución está registrada en HKEY_CLASSES_ROOT.

Preferencias de Mac OS X

FileMaker Pro almacena sus preferencias en el archivo Prefs de FileMaker Pro 0,0, dentro de la carpeta Preferencias de FileMaker.

FileMaker Pro Advanced almacena sus preferencias en el archivo Prefs de FileMaker Pro 0,0A, dentro de la carpeta Preferencias de FileMaker. La aplicación en tiempo de ejecución almacena sus preferencias en el archivo Prefs de <Nombre de solución>, dentro de la carpeta Preferencias de FileMaker.

Índice

A

Abrir archivo, paso de guión 54

abrir archivos de aplicaciones en tiempo de ejecución 47

Abrir paso de guión Definir referencias de archivo. Consulte Abrir paso de guión Gestionar base de datosAbrir paso de guión Gestionar base de datos 54

Abrir paso de guión Gestionar guiones 54

Abrir paso de guión Gestionar lista de valores 54

Abrir remoto, paso de guión 54

Acceso de administradoreliminar de archivos 10quitar de las soluciones de quiosco 18

accesos directos de teclado en elementos de menú personalizados 23

accesos directos, teclado Consulte Accesos directos de tecladoactivadores de guión, depuración 30

actualizacionesde las soluciones de tiempo de ejecución 16plug-ins 35

actualizar de bases de datos en tiempo de ejecución 11

aplicaciones en tiempo de ejecuciónactivar plug-ins en 47comandos de menú disponibles 49comparadas con FileMaker Pro 47configuración almacenada del registro de

Windows 55icono 13pasos de guión ignorados 54preferencias de MacOSX almacenadas 55

Apple Xcode 36

archivo de configuración 10

archivo de la soluciónicono 13problemas con el icono de doble clic 13

archivo primarioactualizar 16conexión de archivos auxiliares 11especificar 9

archivosactualizar 10convertir 11eliminar Acceso de administrador 10renombrar 9tiempo de ejecución de compresión 15

archivos auxiliaresactualizar 17

problemas con el icono de doble clic 13

asistente de nueva presentación/informe 25, 26

atributos de los temas de presentación 25

autenticar guiones 30

automatización OLE en aplicaciones en tiempo de ejecución 47

Ayudacomandos de menú disponibles en aplicaciones en

tiempo de ejecución 53

C

C/C++ 35

cálculosavanzado 31uso de funciones externas 35

camposcopiar esquema 19supervisión 31

Caracteres ASCII en ID de plug-ins 42

Carpeta Extensions, usuarioubicación de los plug-ins 37

Carpeta Project 9, 13

clave de enlaceacerca de 12actualizar soluciones de bases de datos en tiempo

de ejecución 16

claves de acceso, menús personalizados 23

códigos de error, ver desde el Depurador de guiones 29

colores, temas de presentación 25

comandos de menúdisponibles en aplicaciones en tiempo de

ejecución 49

comandos del menú Archivo disponibles en las aplicaciones en tiempo de ejecución 49

comandos del menú Editar disponibles en las aplicaciones en tiempo de ejecución 50

comandos del menú Formato disponibles en las aplicaciones en tiempo de ejecución 51

comandos del menú Insertar disponibles en las aplicaciones en tiempo de ejecución 51

comandos del menú Peticiones disponibles en las aplicaciones en tiempo de ejecución 52

comandos del menú Registros disponibles en las aplicaciones en tiempo de ejecución 51

comandos del menú Ventana disponibles en las aplicaciones en tiempo de ejecución 52

comandos del menú Vista disponibles en las


aplicaciones en tiempo de ejecución 50

comandos del modo Presentaciónno disponibles en aplicaciones en tiempo de

ejecución 47

comandos, menúdisponibles en aplicaciones en tiempo de

ejecución 49

configurar plug-ins 38, 42

conjuntos de menús, creación 24

contraseñas, advertencia requerida en la presentación "Acerca de" 7contrato de licencia 6convertir archivos de versiones anteriores 11

copiar esquemas de campo o de tabla 19

copias de seguridad 16

crear documentosinformes de diseño de base de datos 33soluciones en tiempo de ejecución 15

cuentas y privilegios 7, 19eliminar Acceso de administrador 10para el modo Quiosco 17

D

DDR. Consulte informes de diseño de base de datosde temas Consulte temas de presentaciónDepurador de guiones 29

con activadores de guión 30

depurar guiones 29

desactivar pasos de guión 30

desbloquear guiones 30

distribuir soluciones de bases de datos en tiempo de ejecución

acerca de 13distribuir actualizaciones 16términos y condiciones 6

documentación electrónica 6Documentación en PDF 6Dynamic Link Library (DLL) 13

E

editores de texto 25

elementos de temas de presentación 27

enlazar soluciones en tiempo de ejecución 12

esquemas de base de datos 33copiar o importar 19

esquemas, base de datoscopiar o importar 19crear documentos 33

estadísticas de base de datos 33

estadísticas, base de datos 33

estructura de base de datos, recrear 33

estructura de carpetasplug-in de ejemplo 36solución 13

estructura, base de datos 33

eventos Apple en aplicaciones en tiempo de ejecución 47

expresiones, supervisar 31

Extensible Markup Language (XML, Lenguaje extensible de marcas). Consulte XMLextensión de nombre de archivo .fth 25

extensión fmplugin 37

extensión fmx 37

extensiones de nombres de archivopara archivos de base de datospara soluciones en tiempo de ejecución 12plug-ins 37temas de presentación 25

extensiones, nombre de archivo. Consulte extensiones de nombres de archivo

F

FileMaker Developer. Consulte FileMaker Pro AdvancedFileMaker Pro Advanced

actualización desde versiones anteriores 11contrato de licencia 6FileMaker Pro Advanced 5

FileMaker Pro, menús disponibles 49

FileMaker Server 15, 35, 47

formato HTML para informes de diseño de base de datos 33

fórmulaspara funciones personalizadas 20supervisión 31

fuentesNo se encuentra en el sistema del usuario 14temas de presentación 25

fuentes de datosactualización automática 10actualizar 16

función Do_PluginInit 43

funcionesexternas 35personalizar 20supervisar en fórmulas 32

funciones externas 35

funciones personalizadas, crear 20

G

Gestionar guiones 30

guiones

| Índice 59

autenticación 30depurar 29desactivar pasos de guión 30desbloqueo 30pasos ignorados por las aplicaciones en tiempo de

ejecución 54

I

iconos de soluciones en tiempo de ejecución 13

informes de diseño de base de datos 33

informes, base de datos 33

iniciar soluciones en tiempo de ejecución 13

InstallShield 14

instrucciones de instalación 5interacción de los usuarios con la solución de base de datos 11

Internetaplicaciones en tiempo de ejecución en 47bases de datos en 6

J

JDBC, FileMaker como fuente de datos 6

L

Logfile.txt 10

logotipo, añadir a la solución en tiempo de ejecución 12

M

Mac OS Xconflictos de recursos 45paquete de aplicación en tiempo de ejecución 14preferencias almacenadas 55

MacInstallerBuilder 14

mensaje de Apagado enviado a los plug-ins 43

mensaje de En espera enviado a los plug-ins 44

mensaje de Función externa enviado a los plug-ins 44

mensaje de GetString enviado a los plug-ins 45

mensaje de Inicialización enviado a los plug-ins 43

mensaje de Preferencias enviado a los plug-ins 44

mensajesenviados a plug-ins de funciones externas 42registro de errores 10

menú Guionescomandos disponibles en aplicaciones en tiempo

de ejecución 52

menús personalizadosaccesos directos de teclado 23acerca de 20conjuntos de menús 24

crear 22ejemplo 21elementos de menú 22

Microsoft Visual Studio 36

Microsoft Windowsconfiguración del registro almacenada 55

MindVision Installer VISE 14

N

nombrar soluciones de base de datos en tiempo de ejecución 12

nuevas funciones 5

O

ODBC, FileMaker como fuente de datos 6Opciones de archivo disponibles en aplicaciones en tiempo de ejecución 48

P

pantalla de presentación en soluciones de tiempo de ejecución

cerrar 12inicio 11

pantalla táctil 17

Paso de guión Abrir Ayuda 54

Paso de guión Abrir Compartir 54

Paso de guión Abrir Opciones de archivo 54

Paso de guión Ejecutar SQL 54

Paso de guión Establecer multiusuario 54

Paso de guión Guardar registros como PDF 54

Paso de guión Nuevo archivo 54

patrones, temas de presentación 25

plug-in FMExample 38

plug-insconfigurar 38, 42, 44conflictos de ID de recursos (Mac OS X) 45en aplicaciones en tiempo de ejecución 47ID 42instalar 37instalar plug-ins de publicación en la Web 37prefijo de nombres de funciones 42preparar 35proyecto de ejemplo 35registrar en Apple 42sintaxis obligatoria de la cadena de opciones 42

plug-ins de funciones externas 35activar 37en aplicaciones en tiempo de ejecución 47ID de plug-in 42mensajes enviados por FileMaker Pro 42

preferencias disponibles en la aplicación en tiempo


de ejecución 48

Presentación "Acerca de" 6contenido requerido de 7

Presentación de ayuda 15

privilegios de acceso 7, 19

probarguiones 29soluciones de bases de datos 15

programas de instalación de bases de datos en tiempo de ejecución 14

R

recuperar archivos dañados en tiempo de ejecución 15

redescompartir soluciones en 15

referencias de archivo Consulte fuentes de datosregistrar plug-in de ID 42

registro de errores 10

registro, configuración almacenada 55

renombrar archivos 9requisitos legales 6resolución de problemas

cálculos 31campos 31Depurador de guiones 29usar informes de diseño de base de datos 33variables 31

retraso, pantalla 12

S

separadores de menú 23

separadores, elemento de menú 23

sintaxis de la cadena de opciones de los plug-ins 42

soluciones de bases de datos en tiempo de ejecuciónactualizar 11, 16convertir 11crear 9, 10crear documentos 13enlazar archivos 12iniciar 13preparar archivos 10recuperar archivos dañados 15requisitos de presentaciones "Acerca de" 7, 15

soluciones de bases de datos en tiempo de ejecución, documentación 14

Soluciones de quiosco, creación 17

soluciones multiplataforma 12

Submenú Gestionar,no disponibles en aplicaciones en tiempo de

ejecución 47

T

tablas, base de datoscopiar o importar esquema 19excluir del informe de diseño de base de datos 33varias por archivos 11

temas de presentación, creación 25

tutorial, FileMaker Pro 6

U

usuarios de navegadores Web 6utilidades de compresión para bases de datos en tiempo de ejecución 15

Utilidades de Creadoracerca de 9creación de soluciones en tiempo de ejecución 10

V

variables, supervisar 31

varias tablas por archivo de base de datos 11

Visor de datos 31Pestaña Actual 31Pestaña Control 31

visor Web 15

W

Windowspaquete de aplicación en tiempo de ejecución 14

X

XMLdocumentos para temas de presentación 25editores 25especificación XML 1.0 27formato para informes de diseño de base de

datos 33gramática de salida para DDR 6instrucción de procesamiento del documento

XML 27