Sunteți pe pagina 1din 60

FileMaker Pro 10 Advanced

Gua 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 pases. Mac y el logotipo de Mac son propiedad de Apple Inc. registradas en EE.UU. y otros pases. Las dems marcas comerciales pertenecen a sus respectivos propietarios. La documentacin de FileMaker est protegida por derechos de autor. Se prohbe la realizacin de copias o la distribucin de esta documentacin sin el consentimiento por escrito de FileMaker. Esta documentacin slo puede utilizarse con una copia del software de FileMaker que tenga una licencia vlida. Las personas y compaas, direcciones de correo electrnico y direcciones URL mencionadas en los ejemplos son puramente ficticios, y cualquier parecido con personas, compaas, direcciones de correo electrnico y direcciones URL reales es mera coincidencia. Los crditos aparecen en los documentos Agradecimientos que acompaan a este software. La mencin de productos y direcciones URL de terceros es meramente informativa y no representa ningn tipo de garanta ni recomendacin. FileMaker, Inc. no asume ninguna responsabilidad respecto al rendimiento de estos productos. Para ms informacin, visite nuestra pgina Web en www.filemaker.com. Edicin: 01

ndice
Captulo 1 Introduccin a FileMaker Pro Advanced
Acerca de esta gua Uso de la documentacin de FileMaker Pro Advanced Dnde encontrar documentacin en PDF Cumplimiento del contrato de licencia para soluciones en tiempo de ejecucin Responsabilidades como creador 5 5 6 6 7

Captulo 2 Creacin de soluciones de base de datos


Uso de las Utilidades de creador Acerca de la creacin de soluciones en tiempo de ejecucin Conversin y actualizacin de soluciones anteriores Enlazar la solucin Inicio de soluciones de bases de datos en tiempo de ejecucin Distribucin de soluciones en tiempo de ejecucin Organizacin de componentes de la solucin Seleccin de un mtodo de distribucin Prueba anterior y posterior a la creacin de la solucin Distribucin de actualizaciones en soluciones de bases de datos en tiempo de ejecucin Creacin de soluciones de quiosco 9 10 11 12 13 13 13 14 15 16 17

Captulo 3 Personalizacin de las soluciones de base de datos


Copiar e importar esquemas de campo y de tabla Creacin de funciones personalizadas Acerca de los mens personalizados Ejemplo de men personalizado Creacin de mens personalizados Creacin de elementos de men personalizados Creacin de conjuntos de mens personalizados Creacin de temas de presentacin personalizados Requisitos para los archivos de temas 19 20 20 21 22 22 24 25 27

Captulo 4 Depurar y analizar archivos


Depuracin de guiones Desactivacin de pasos de guin Uso del Visor de datos Usar el informe de diseo de base de datos 29 30 31 33

Gua de desarrollo de FileMaker Pro Advanced

Captulo 5 Desarrollo de plug-ins de FileMaker por parte de otros fabricantes


Acerca de las funciones externas Acerca del plug-in de ejemplo Contenido de la carpeta FMExample Contenido de la carpeta Example Contenido de la carpeta Support Instalacin, activacin y configuracin del plug-in de ejemplo Descripcin de las funciones externas del plug-in FMExample Uso del plug-in de ejemplo Personalizacin del plug-in de ejemplo Personalizacin de los recursos de ejemplo Personalizacin de FMPluginExample.cpp Personalizacin de FMPluginPrefs.cpp Personalizacin de FMPluginFunctions.cpp Requisitos para escribir plug-ins con funciones externas Archivos de cdigo API Sintaxis de la cadena de opciones Especificaciones de nombres de archivos para funciones externas Mensajes de FileMaker enviados al plug-in Mensaje de Inicializacin Mensaje de Apagado Mensaje de En espera Mensaje de Preferencias Mensaje de Funcin externa Mensaje de GetString Evitacin de posibles conflictos de recursos en Mac OS X Inclusin de documentacin en su plug-in 35 35 36 36 36 37 38 39 40 40 40 41 41 41 41 42 42 42 43 43 44 44 44 45 45 45

Apndice A Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro


Preferencias de aplicaciones y documentos Comparacin de comandos de men Pasos de guin ignorados Configuracin o preferencias almacenadas del registro 48 49 54 55 57

ndice

Captulo 1 Introduccin a FileMaker Pro Advanced


Bienvenido a FileMakerPro Advanced. Este producto incluye herramientas avanzadas de desarrollo y personalizacin diseadas 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. Adems 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 ejecucin

1 La funcin de informe de diseo de base de datos, para publicar una completa documentacin sobre
las estructuras o los esquemas de las bases de datos

1 Depurador de guiones, para las pruebas y depuraciones sistemticas de guiones de FileMaker 1 Visor de datos, para supervisar campos, variables y clculos 1 Funcin de copia, para copiar campos o tablas. Tambin puede importar el esquema de tabla para
utilizarlo en el mismo archivo o en archivos distintos

1 Funcin de mens personalizados, para crear mens personalizados para la solucin 1 Prestacin Funciones personalizadas, para crear funciones personalizadas y utilizarlas en cualquier
parte de la solucin

Acerca de esta gua


Esta Gua de desarrollo incluye informacin sobre las funciones disponibles en FileMaker Pro Advanced. Adems, esta gua proporciona una visin general de cmo crear temas de presentacin personalizados y plug-ins de funciones externas. Consulte la Ayuda de FileMaker Pro para obtener informacin detallada sobre las funcionalidades del producto. Si desea enviar informacin acerca de esta gua, visite www.filemaker.com/company/ documentation_feedback.html.

Uso de la documentacin de FileMaker Pro Advanced


Esta Gua 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 slo estn disponibles en PDF. FileMaker Pro Advanced tambin incluye un sistema de ayuda en lnea que proporciona ms informacin sobre las funcionalidades de FileMaker Pro. Esta gua asume que el usuario ya conoce FileMaker Pro o FileMaker Pro Advanced y que ha creado una solucin 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 Gua del usuario de FileMaker Pro. Se incluyen los siguientes manuales:

1 Gua de desarrollo de FileMaker Pro Advanced (este manual): describe cmo se utilizan las funciones
de FileMaker Pro Advanced

1 Gua de instalacin y de nuevas funciones de FileMaker Pro y FileMaker Pro Advanced: contiene
instrucciones de instalacin y una lista de nuevas funciones de la versin actual.

Gua de desarrollo de FileMaker Pro Advanced

1 Gua del usuario de FileMaker Pro: contiene conceptos clave y procedimientos bsicos. 1 Tutorial de FileMaker Pro: contiene indicaciones paso a paso para ensearle a crear y usar bases de datos
de FileMaker Pro.

1 Manual FileMaker Pro Advanced Database Design Report XML Output Grammar: describe la gramtica
de salida del informe de diseo 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 Gua para la publicacin en la Web al instante: describe cmo poner bases de datos de FileMaker Pro
y FileMaker Pro Advanced a disposicin de los usuarios de un navegador Web a travs de una Intranet o de Internet.

1 Gua de ODBC y JDBC de FileMaker: describe cmo compartir datos de FileMaker con otras
aplicaciones mediante ODBC y JDBC.

Dnde encontrar documentacin en PDF


Para acceder a los archivos PDF de la documentacin de FileMaker:

1 en FileMaker Pro Advanced, elija men Ayuda> Documentacin del producto 1 haga clic en el botn Ms informacin en la pantalla de Inicio rpido 1 visite www.filemaker.es/downloads para obtener documentacin adicional
La mayora 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


espaol\Documentacin electrnica

1 Mac OS: Macintosh HD/Aplicaciones/FileMaker Pro Advanced/Extras espaol/Documentacin


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

Cumplimiento del contrato de licencia para soluciones en tiempo de ejecucin


El contrato de licencia de FileMaker Pro Advanced permite la distribucin sin derechos de autor de un nmero ilimitado de soluciones de base de datos en tiempo de ejecucin de FileMaker Pro. Sin embargo, en el contrato de licencia hay varios trminos y condiciones que se deben cumplir, entre los que se incluyen los siguientes:

1 Debe proporcionar toda la asistencia tcnica al usuario final. 1 Debe proporcionar una presentacin "Acerca de" que incluya su nombre, direccin y el nmero
de telfono para obtener asistencia tcnica. Para obtener ms informacin sobre cmo crear una presentacin "Acerca de", consulte la seccin siguiente. Nota Debe leer y aceptar los trminos y condiciones del contrato de licencia de FileMaker Pro Advanced, que se encuentran en el programa de instalacin de FileMaker Pro Advanced, antes de utilizar el software.

Captulo 1

Introduccin a FileMaker Pro Advanced

Responsabilidades como creador


FileMaker ha establecido procedimientos de reparacin de archivos. Si un cliente sigue estos procedimientos, FileMaker puede proporcionarle un archivo reparado. Si distribuye archivos de bases de datos con contraseas 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 solucin de base de datos contiene contraseas o datos que slo usted puede proporcionar. 2. Todos los archivos de la solucin de base de datos en tiempo de ejecucin deben contener una presentacin accesible desde cualquier presentacin de la base de datos. 3. El nombre de la presentacin debe comenzar con la palabras "Acerca de". 4. La presentacin "Acerca de" debe contener estos elementos:

1 nombre de la solucin 1 nombre de su empresa y su informacin de contacto 1 su poltica de asistencia tcnica (por ejemplo, cmo y cundo est disponible para realizarla)
5. La presentacin "Acerca de" debe contener esta advertencia exacta: ADVERTENCIA PARA USUARIOS: Esta solucin de base de datos contiene contrasea(s) que slo puede proporcionar el creador identificado ms arriba. Para obtener ms informacin sobre cmo crear una presentacin "Acerca de", consulte la Ayuda. 6. Si se han retirado de forma permanente los privilegios de acceso completo a la solucin de base de datos mediante la seleccin de la opcin Eliminar acceso de administrador a los archivos permanentemente en Utilidades de creador, la presentacin "Acerca de" debe contener esta advertencia exacta: ADVERTENCIA PARA USUARIOS: Este archivo no se puede personalizar. Pngase en contacto con el creador denominado anteriormente si desea informacin sobre la personalizacin de esta solucin de base de datos. La proteccin 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 contrasea 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 asesora sin confiar nicamente en el procedimiento de contrasea. Para obtener ms informacin sobre cuentas y privilegios, consulte la Ayuda. Si tiene una disputa con un cliente, debe resolverla directamente con l. FileMaker no puede en ningn caso resolver dichas disputas.

Gua de desarrollo de FileMaker Pro Advanced

Captulo 2 Creacin 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 automticamente los enlaces
internos a guiones y archivos relacionados;

1 enlazar archivos de base de datos en una solucin de base de datos en tiempo de ejecucin 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 diseo de la base de datos;

1 mostrar los archivos de base de datos en modo Quiosco; 1 aadir a los archivos la extensin de nombre de archivo de FileMaker Pro.
Nota Consulte la Ayuda para obtener informacin completa y pormenorizada y procedimientos detallados sobre el uso de FileMaker Pro Advanced.

Uso de las Utilidades de creador


Para personalizar sus archivos de base de datos o enlazarlos a una solucin en tiempo de ejecucin: 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 solucin de base de datos anteriormente y ha guardado la configuracin, haga clic en Cargar configuracin. Se abre un cuadro de dilogo que le permite examinar y localizar el archivo de configuracin. 4. Haga clic en Aadir para encontrar los archivos que desea personalizar. 5. Si va a enlazar varios archivos en una solucin en tiempo de ejecucin, haga doble clic en un archivo de la lista para especificar el archivo primario. 6. Para cambiar el nombre de un archivo, seleccinelo en la lista, escriba el nuevo nombre en el cuadro Renombrar archivo y haga clic en Cambiar. 7. Para quitar un archivo, seleccinelo en la lista y haga clic en Quitar. 8. En la carpeta Project, haga clic en Especificar para elegir la ubicacin en la que se guardar la copia de la solucin de base de datos. 9. Si no desea que los nuevos archivos sobrescriban las versiones anteriores, desactive la opcin Sobrescribir archivos coincidentes dentro de la carpeta Project. Importante Si se selecciona la opcin 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

Gua de desarrollo de FileMaker Pro Advanced

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 automtica enlaces internos a archivos y guiones relacionados.

1 Si desea continuar la personalizacin o el enlace de sus archivos de base de datos, en Opciones


de solucin, haga clic en Especificar. 11. Seleccione una o varias opciones en el cuadro de dilogo Especificar opciones de solucin:
Para Enlazar bases de datos a aplicaciones en tiempo de ejecucin Realizar lo siguiente: Seleccione Crear solucin de ejecucin independiente. Nota Esta opcin se puede combinar con todas las dems, excepto con Las bases de datos deben tener una extensin de archivo de FileMaker. Consulte Acerca de la creacin de soluciones en tiempo de ejecucin en la pgina 10. Seleccione Eliminar acceso de administrador a los archivos permanentemente. Importante Una vez eliminado, el acceso administrativo no puede restaurarse en la solucin personalizada. Para obtener ms informacin sobre como eliminar el acceso de administrador a las bases de datos, consulte la Ayuda. Seleccione Activar modo Quiosco para cuentas que no sean de administrador. Consulte Creacin de soluciones de quiosco en la pgina 17.

Prohibir permanentemente cualquier acceso administrativo a la solucin

Obligar a las cuentas sin privilegios de acceso total a abrir la solucin en modo Quiosco

Aadir la extensin de FileMaker a los Seleccione Las bases de datos deben tener una extensin de archivo de FileMaker. nombres de archivo de los archivos de Nota Esta opcin no est disponible si se selecciona Crear solucin de ejecucin la base de datos independiente. Utilice esta funcin para aadir 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 ubicacin y un nombre de archivo para el registro de errores. Notas 1 Si no especifica un nombre de archivo y una ubicacin 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.

12. Haga clic en Aceptar. 13. Para poder repetir rpidamente el proceso, haga clic en Guardar configuracin y seleccione una carpeta y una ubicacin para el archivo de configuracin. Para obtener ms informacin sobre cmo guardar la configuracin de la solucin, consulte la Ayuda. 14. Haga clic en Crear.

Acerca de la creacin de soluciones en tiempo de ejecucin


Utilice las Utilidades de creador para crear una solucin de base de datos en tiempo de ejecucin 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 aplicacin en tiempo de ejecucin con el nombre que especifique.

Captulo 2

Creacin de soluciones de base de datos

11

Las aplicaciones en tiempo de ejecucin no poseen todas las funciones y caractersticas de FileMaker Pro. Para obtener una lista completa de las diferencias entre la aplicacin en tiempo de ejecucin y FileMaker Pro, consulte apndice A, Comparacin de funciones de la aplicacin en tiempo de ejecucin 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 solucin en tiempo de ejecucin y la versin final est lista para distribuirla a los usuarios, debe probarla exhaustivamente para asegurarse de que se comporta segn 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 funcin 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 seguirn beneficindose de la utilizacin de varios archivos. Antes de comenzar a crear la solucin de base de datos, debe decidir la forma en la que los usuarios interactuarn con ella. La solucin 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 presentacin al inicio o salir de una aplicacin en tiempo de ejecucin

1 1 1 1 1 1

Elementos comunes y un aspecto coherente para soluciones multiplataforma informacin sobre herramientas y mens personalizados Un tema de presentacin personalizado para su uso en cada archivo de la solucin Una presentacin "Acerca de" introductoria de la solucin (obligatoria) Un sistema de ayuda personalizado que ofrezca sugerencias de uso para la solucin Varios conjuntos de privilegios que permitan especificar niveles de acceso a presentaciones, mens, tablas especficas, registros, campos, etc. de acceso de los usuarios de las cuentas

1 Cuentas protegidas mediante contraseas asignadas a conjuntos de privilegios que determinen el nivel

Para obtener informacin sobre lo que necesitan los usuarios para utilizar la solucin de base de datos en tiempo de ejecucin, consulte Distribucin de soluciones en tiempo de ejecucin en la pgina 13.

Conversin y actualizacin de soluciones anteriores


Si ha desarrollado una solucin de base de datos en tiempo de ejecucin de FileMaker Pro mediante el Solutions Development Kit (SDK) para FileMaker Pro 3.0 o una versin 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 solucin y ofrecer a los usuarios archivos convertidos. Los archivos enlazados con una aplicacin en tiempo de ejecucin a travs de herramientas anteriores, deben volver a enlazarse por medio de las Utilidades de creador. Debe convertir los archivos de FileMaker Pro creados con la versin 6.0, o anteriores, al nuevo formato de archivo. Puede convertir un nico archivo o varios archivos a la vez. Para obtener ms informacin sobre la conversin de archivos, consulte la Ayuda.

12

Gua de desarrollo de FileMaker Pro Advanced

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 solucin de base de datos en tiempo de ejecucin anterior a la nueva solucin actualizada. Consulte la Ayuda para obtener ms informacin sobre la importacin de datos a soluciones de tiempo de ejecucin actualizadas. Utilice las Utilidades de creador para enlazar los archivos de la solucin con una solucin de base de datos en tiempo de ejecucin nueva y actualizada. Distribuya la nueva base de datos en tiempo de ejecucin actualizada y proporcione a los usuarios instrucciones sobre la forma de actualizar los archivos convirtiendo los antiguos archivos en la nueva aplicacin en tiempo de ejecucin e importando sus datos.

Enlazar la solucin
Para enlazar archivos de base de datos con una solucin de base de datos en tiempo de ejecucin: 1. Siga los procedimientos descritos en Uso de las Utilidades de creador en la pgina 9. 2. En el cuadro de dilogo Especificar opciones de solucin, seleccione Crear solucin de ejecucin independiente. 3. Para nombrar su aplicacin en tiempo de ejecucin:

1 En Nombre de runtime, escriba un nombre. El nombre se utiliza como nombre de archivo


de la aplicacin en tiempo de ejecucin y como nombre de la carpeta que contiene los archivos de la solucin de base de datos en tiempo de ejecucin.

1 Como Extensin, escriba una extensin de nombre de archivo de tres caracteres. La extensin
se utiliza para asociar los archivos de la solucin a las aplicaciones en tiempo de ejecucin. Para obtener ms informacin sobre cmo 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 aplicacin en tiempo de ejecucin con los archivos de base de datos y garantiza que los archivos enlazados slo se abran en la aplicacin en tiempo de ejecucin adecuada. Recuerde que distingue entre maysculas y minsculas. Para obtener ms informacin sobre la configuracin 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 solucin se va a utilizar con Windows, enlcela mediante las Utilidades de creador para Windows. Si la solucin se va a utilizar con Mac OS X, enlcela mediante las Utilidades de creador para Mac OS X. Si va a crear una solucin que pueda utilizarse tanto en Windows como en Mac OS X, cree dos soluciones en tiempo de ejecucin mediante el enlace de los archivos originales de la solucin dos veces: en primer lugar mediante las Utilidades de FileMaker Developer para Windows y, a continuacin, mediante las Utilidades de FileMaker Developer para Mac OS X. Utilice la misma Tecla de enlace para ambas plataformas. 5. Para aadir 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 pxeles (72 ppp) o ms, de lo contrario, se distorsionar al mostrarse. Los formatos de imagen admitidos son JPEG y GIF. 6. En Retraso, establezca el nmero 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 botn Vista previa. 7. Una vez especificadas las opciones, haga clic en Aceptar.

Captulo 2

Creacin de soluciones de base de datos

13

8. Para poder repetir rpidamente el proceso, haga clic en Guardar configuracin y seleccione una carpeta y una ubicacin para el archivo de configuracin. Para obtener ms informacin sobre cmo guardar y reutilizar las Utilidades de creador, consulte la Ayuda. 9. Haga clic en Crear. Las Utilidades de creador copian todos los archivos en tiempo de ejecucin en una nueva carpeta creada dentro de la carpeta Project y con el mismo nombre que la solucin en tiempo de ejecucin.

Inicio de soluciones de bases de datos en tiempo de ejecucin


Haga doble clic para iniciar Icono de la aplicacin en tiempo de ejecucin Icono de archivo de la solucin

Importante Para iniciar la solucin, los usuarios deben hacer doble clic en el icono de aplicacin en tiempo de ejecucin, no en el icono de archivo de la solucin. Si se hace doble clic en los iconos de los archivos de la solucin o auxiliares, se pueden generar errores, en funcin de la existencia de otras copias de la aplicacin en tiempo de ejecucin en el disco duro. Si sus usuarios tienen ms de una solucin en sus ordenadores asociada a la misma extensin de tres caracteres y hacen doble clic en el icono del archivo de la solucin, la solucin instalada en primer lugar intentar abrir el archivo y es probable que sta no sea la aplicacin correcta para ese archivo en concreto.

Distribucin de soluciones en tiempo de ejecucin


Los pasos finales de desarrollo de la solucin de base de datos en tiempo de ejecucin consisten en incluir todos los archivos necesarios juntos, seleccionar cmo se va a distribuir la solucin (por ejemplo, en un CD-ROM o a travs de la red) y facilitar a los usuarios la documentacin necesaria para instalar la solucin. Adems, la documentacin debe incluir instrucciones para iniciar la aplicacin en tiempo de ejecucin e indicaciones sobre qu hacer cuando existe un archivo daado.

Organizacin de componentes de la solucin


Cuando se enlazan los archivos de bases de datos con una solucin de base de datos en tiempo de ejecucin, las Utilidades de creador permiten crear una nueva carpeta de solucin donde se pueden colocar la aplicacin en tiempo de ejecucin, los archivos de bases de datos auxiliares y primarios enlazados y una carpeta Extensions. Para las soluciones en tiempo de ejecucin de Windows, tambin se requieren archivos Dynamic Link Library (DLL). Nota Cuando se mueven varios archivos a una carpeta para crear una solucin en tiempo de ejecucin, 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 aplicacin en tiempo en ejecucin 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 tambin se utilicen en FileMaker Pro o FileMaker Pro Advanced.

14

Gua de desarrollo de FileMaker Pro Advanced

carpeta de solucin de Aplicacin en tiempo de ejecucin Archivos de solucin auxiliares y primarios enlazados DLL generados durante el enlace Extensions Dictionaries carpetas de recursos de idioma

carpeta de solucin de Mac OS Paquete de aplicacin en tiempo de ejecucin Archivos de solucin auxiliares y primarios enlazados Extensions Dictionaries

Ejemplo de contenido de la solucin en Windows y Mac OS X para su distribucin

Importante No se debe cambiar el nombre de estos archivos y carpetas. Para obtener ms informacin sobre el paquete de aplicaciones en tiempo de ejecucin de Mac OS X y de la carpeta Extensions y archivos DLL de Windows, consulte la Ayuda. Si la solucin de base de datos en tiempo de ejecucin requiere archivos personalizados, se deben facilitar los archivos junto con los de tiempo de ejecucin. 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 aplicacin en tiempo de ejecucin realiza una sustitucin. Si se incluye una fuente con el tiempo de ejecucin, se deben tomar medidas para su instalacin mediante el programa de instalacin. Consulte Uso de un programa de instalacin personalizado ms abajo. Adems de los archivos en tiempo de ejecucin, es necesario que les proporcione instrucciones de instalacin a los usuarios. Para obtener ms informacin sobre la documentacin de las soluciones de creador, consulte la Ayuda.

Seleccin de un mtodo de distribucin


Una vez organizados los archivos incluidos en su solucin, es necesario decidir cmo los deben instalar los usuarios. Puede distribuir la solucin incluida en un CD-ROM, a travs de una red o mediante Internet. Para ejecutar la solucin de base de datos en tiempo de ejecucin, los usuarios necesitan el mismo equipo y software mnimo que requiere la aplicacin FileMaker Pro Advanced. Consulte la Gua de instalacin y de nuevas funciones de FileMaker Pro y FileMaker Pro Advanced. Uso de un programa de instalacin personalizado Debe utilizar un programa de instalacin personalizado para empaquetar la solucin en tiempo de ejecucin para la instalacin por parte de los usuarios. La configuracin de una aplicacin de instalacin personalizada para instalar archivos de solucin de base de datos en tiempo de ejecucin puede requerir ms ingeniera que el uso de una utilidad de compresin, aunque ayudar a garantizar que los usuarios no tengan dificultades instalando la solucin en tiempo de ejecucin. A continuacin, se enumeran algunas aplicaciones de instalacin personalizadas que puede utilizar:

1 MindVision Installer VISE 1 InstallShield MultiPlatform 1 MacInstallerBuilder

Captulo 2

Creacin de soluciones de base de datos

15

Uso de una utilidad de compresin Si la solucin de base de datos en tiempo de ejecucin no es compleja y confa en la experiencia tcnica de los usuarios finales, puede plantearse utilizar una utilidad de compresin en lugar de un programa de instalacin personalizado. Uso compartido de soluciones a travs de una red Los usuarios no pueden compartir la solucin de base de datos en tiempo de ejecucin a travs 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 contrasea maestra para activar o modificar el acceso de red al archivo. Si desea un rendimiento ptimo, puede incluir los archivos de solucin mediante FileMaker Server. Para obtener informacin sobre los productos FileMaker Server y FileMaker Pro y sobre ventas de licencias globales, consulte el sitio Web de FileMaker en www.filemaker.com. Recuperacin de archivos daados Los fallos en el suministro elctrico, los problemas de hardware y otros factores pueden daar un archivo de base de datos de FileMaker. Si la solucin de base de datos se daa, los usuarios tendrn que recuperar el archivo daado. Cuando la aplicacin en tiempo de ejecucin descubre un archivo daado, aparece un cuadro de dilogo, donde se le indica al usuario que se ponga en contacto con el creador. Aunque no aparezca el cuadro de dilogo, los archivos se pueden daar y tener un comportamiento errtico. Para obtener informacin sobre la recuperacin de archivos en tiempo de ejecucin, consulte la Ayuda. Creacin de presentaciones "Acerca de" En las soluciones de base de datos en tiempo de ejecucin, la licencia de FileMaker Pro Advanced especifica que se debe crear una presentacin que proporcione informacin para los usuarios acerca de cmo ponerse en contacto si desean asistencia tcnica. FileMaker utiliza la presentacin para distinguir bases de datos creadas por creadores mediante FileMaker Pro Advanced en lugar de usuarios de FileMaker Pro. Si desea ms informacin sobre lo que es obligatorio que aparezca en la presentacin de soluciones de bases de datos en tiempo de ejecucin, consulte Responsabilidades como creador en la pgina 7. Creacin de una presentacin de ayuda personalizada El sistema de ayuda de FileMaker Pro Advanced no est disponible en aplicaciones en tiempo de ejecucin. Cree una presentacin de ayuda donde se proporcione informacin sobre cmo utilizar la solucin personalizada y agrguele datos. A continuacin, cree un guin en el archivo primario de la solucin para mostrarlo en el sistema de ayuda. Utilice la funcin Mens personalizados para que el guin est disponible como comando en el men Ayuda. Para crear una pgina Web que documente su solucin, coloque un visor Web en su presentacin de ayuda que abra la pgina Web. Para que el men Ayuda personalizado aparezca en Mac OS, debe comenzar con un men vaco. Para obtener ms informacin sobre cmo crear y editar mens personalizados, consulte Acerca de los mens personalizados en la pgina 20.

Prueba anterior y posterior a la creacin de la solucin


Es necesario verificar la funcionalidad de la solucin de base de datos mediante una prueba exhaustiva antes y despus de personalizarla con Utilidades de creador.

16

Gua de desarrollo de FileMaker Pro Advanced

Para garantizar la calidad de la solucin de base de datos personalizada:

1 Compruebe cada funcin y opcin de la solucin. Si desarrolla una solucin para las dos plataformas,
prubelas en Windows y Mac OS X.

1 Asegrese de que la solucin de base de datos en tiempo de ejecucin no utiliza una funcin de FileMaker
Pro estndar oculta o desactivada en la aplicacin en tiempo de ejecucin. Consulte apndice A, Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro.

1 Compruebe que todos los guiones y botones funcionan segn lo previsto. Esta comprobacin es muy
importante si se muestra la solucin en modo Quiosco. Consulte Creacin de soluciones de quiosco en la pgina 17.

1 Compruebe los procedimientos de instalacin y pruebe otras instrucciones de la documentacin. 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 ms pequeo que pueda utilizar alguno de los usuarios.

1 Pruebe la solucin de base de datos en tiempo de ejecucin con datos reales. Esto es extremadamente
importante si los usuarios estn realizando una actualizacin de versiones anteriores de la aplicacin y necesitan importar datos a archivos de la solucin nueva.

1 Asegrese de que todos los archivos auxiliares y los archivos DLL (Windows) estn presentes. 1 Mustreles la solucin 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 contraseas o retirar privilegios de acceso completo de forma permanente, pruebe todos
los niveles de acceso.

1 Asegrese de que la solucin de base de datos contiene una presentacin "Acerca de" donde se notifica
a los usuarios el nivel de acceso que se les va a proporcionar. Importante Debe conservar una versin no enlazada de cualquier archivo de solucin de base de datos en tiempo de ejecucin, especialmente en caso de que haya retirado de forma permanente los privilegios de acceso completo.

Distribucin de actualizaciones en soluciones de bases de datos en tiempo de ejecucin


Si realiza mejoras o modificaciones de funciones en el archivo enlazado primario de la solucin de base de datos en tiempo de ejecucin, 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 versin de la aplicacin en tiempo de ejecucin junto con el archivo actualizado. Para distribuir archivos auxiliares nuevos o actualizados para la solucin de base de datos en tiempo de ejecucin, enlcelos 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 solucin de base de datos en tiempo de ejecucin y desea actualizar o aadir 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 solucin. Para distribuir un archivo primario actualizado: 1. Abra el archivo primario original desde la copia de la solucin en tiempo de ejecucin en FileMaker Pro Advanced. 2. Realice cambios en el archivo primario.

Captulo 2

Creacin de soluciones de base de datos

17

3. Si es necesario, cree un guin de importacin para que los usuarios puedan importar sus datos existentes en el nuevo archivo primario. Para obtener ms informacin sobre la importacin de datos a soluciones de tiempo en ejecucin actualizadas, consulte la Ayuda. 4. Enveles a los usuarios una copia del nuevo archivo primario con instrucciones para reemplazar el archivo primario antiguo en la carpeta de la solucin de base de datos en tiempo de ejecucin. 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 guin de importacin para que los usuarios puedan importar sus datos existentes en el nuevo archivo. Para obtener ms informacin sobre la importacin de datos a soluciones de tiempo en ejecucin actualizadas, consulte la Ayuda. 3. Utilice Utilidades de creador para volver a enlazar todos los archivos de la solucin de base de datos en tiempo de ejecucin e incluir el archivo auxiliar actualizado o nuevo. Utilice la misma clave de enlace que utiliz para el archivo primario. 4. Enveles a los usuarios una copia del archivo auxiliar nuevo o actualizado junto con instrucciones para colocarlo en la carpeta de la solucin de base de datos en tiempo de ejecucin, sustituyendo el archivo antiguo si corresponde. Si no se ha modificado la clave de enlace, no ser necesario volver a distribuir la aplicacin en tiempo de ejecucin u otros archivos de solucin.

Creacin de soluciones de quiosco


El modo Quiosco es una forma de mostrar las soluciones de base de datos o las soluciones de bases de datos en tiempo de ejecucin en pantalla completa, sin barras de herramientas ni mens. Como el nombre sugiere, el modo Quiosco se puede utilizar para presentar bases de datos a usuarios en forma de quiosco de informacin. La base de datos se puede disear para su uso en una pantalla tctil. El modo Quiosco se ignora si la solucin la abren cuentas con el conjunto de privilegios Acceso total, un conjunto que permite la gestin de privilegios ampliados o un conjunto que permite la modificacin de presentaciones, listas de valores y guiones. Para que una solucin se muestre en modo Quiosco, debe:

1 crear una cuenta con un conjunto de privilegios limitado o una cuenta especfica de quiosco. 1 activar el modo Quiosco. Al mismo tiempo que activa el modo Quiosco, puede enlazar la base de datos
como solucin en tiempo de ejecucin.

1 anular la opcin predeterminada de iniciar sesin en el archivo con la cuenta Admin.


Para crear una cuenta de quiosco: 1. Asegrese de que dispone de una cuenta de acceso limitado. 2. Con la solucin de base de datos abierta, elija el men Archivo > Gestionar > Cuentas y privilegios. 3. En el cuadro de dilogo Gestionar cuentas y privilegios, haga clic en Nueva.

18

Gua de desarrollo de FileMaker Pro Advanced

4. En el cuadro de dilogo 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 dilogo Editar conjunto de privilegios, asigne un nombre y una descripcin al conjunto de privilegios. 6. En Presentacin, Listas de valores y Guiones, seleccione Todo de slo vista o Todos sin acceso. 7. Anule la seleccin de la casilla de verificacin Gestionar privilegios ampliados. 8. Seleccione las opciones que necesite y, a continuacin, haga clic en Aceptar. Para activar el modo Quiosco: 1. Siga los procedimientos en Uso de las Utilidades de creador en la pgina 9. 2. En el cuadro de dilogo Especificar opciones de solucin, seleccione Activar modo Quiosco para cuentas no de administrador. 3. Seleccione las opciones que necesite y, a continuacin, haga clic en Aceptar. 4. Para poder repetir rpidamente el proceso, haga clic en Guardar configuracin y seleccione una carpeta y una ubicacin para el archivo de configuracin. Para obtener ms informacin sobre cmo guardar la configuracin de la solucin, consulte la Ayuda. 5. Haga clic en Crear. Si no ha enlazado los archivos con ninguna aplicacin de tiempo de ejecucin, las Utilidades de creador copian los archivos de base de datos seleccionados a la carpeta Project. Si no ha enlazado los archivos con ninguna aplicacin de tiempo de ejecucin, las Utilidades de creador copian todos los archivos de tiempo de ejecucin a una carpeta nueva creada en la carpeta Project cuyo nombre coincide con el de la solucin en tiempo de ejecucin. Para cambiar la opcin predeterminada de iniciar sesin en el archivo con la cuenta Admin: 1. Con la solucin de base de datos abierta, elija el men Archivo > Opciones de archivo. 2. En la pestaa Abrir/Cerrar, anule la seleccin de Iniciar sesin con. 3. Haga clic en Aceptar. Si se crea una solucin que se vaya a ejecutar en modo Quiosco, hay que proporcionar una forma de desplazarse a la solucin y la posibilidad de que los usuarios cierren la solucin. Nota Si tiene una solucin de quiosco que mostraba el rea de estado, necesitar actualizar su solucin. En una solucin de quiosco no se puede mostrar la barra de herramientas de estado ni la barra de presentacin. Deber agregar un botn de desplazamiento de registros, estado de guin en pausa y Cancelar y Continuar guin en sus presentaciones. Para obtener ms informacin acerca del uso de guiones y botones para controlar soluciones de quiosco, consulte la Ayuda.

Captulo 3 Personalizacin de las soluciones de base de datos


FileMaker Pro Advanced se puede utilizar para personalizar las soluciones ms an que con FileMaker Pro. Puede:

1 1 1 1 1

copiar y pegar campos para utilizarlos en el mismo archivo o en otros archivos de base de datos copiar o importar en su archivo de base de datos las tablas existentes crear funciones personalizadas, que se pueden utilizar en cualquier lugar de un archivo crear mens personalizados crear temas de presentacin personalizados

Importante Para personalizar los mens, debe tener privilegios de acceso total. Nota Consulte la Ayuda para obtener informacin completa y pormenorizada y procedimientos detallados sobre el uso de FileMaker Pro Advanced.

Copiar e importar esquemas de campo y de tabla


Puede 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 solucin de mltiples archivos en un solo archivo. Hay dos mtodos de consolidacin de soluciones:

1 Copiar esquemas de tabla: abra los archivos de origen para seleccionar y copiar las tablas que desee.
A continuacin, 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 slo 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 Realizar lo siguiente:

Copiar un esquema de campo Elija el men Archivo > Gestionar > Base de datos > pestaa Campos. Seleccione el campo de la lista y, a continuacin, 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 > pestaa 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, > pestaa Tablas. Haga clic en Importar. Seleccione el archivo de origen y la tabla, y haga clic en Aceptar.

Para obtener ms informacin sobre cmo copiar e importar campos y tablas, consulte la Ayuda.

20

Gua de desarrollo de FileMaker Pro Advanced

Creacin de funciones personalizadas


La caracterstica 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 frmulas para la funcin, no es necesario volverlas a escribir para aplicarlas a otros campos o para utilizarlas en otros guiones. Las funciones personalizadas y las frmulas que contienen se pueden mantener y editar en una ubicacin central. Todo cambio que se realice en la funcin personalizada se copiar en todas las instancias en las que se haya utilizado dicha funcin. Para crear una funcin personalizada: 1. Elija el men Archivo > Gestionar > Funciones personalizadas. 2. En el cuadro de dilogo Gestionar funciones personalizadas, haga clic en Nueva.
Lista de vistas (abierta)

Lista de parmetros

Lista de funciones

Cuadro de frmula

Cuadro de dilogo Editar funcin

Sus parmetros personalizados aparecen en este espacio

3. En el cuadro de dilogo Editar funcin personalizada, escriba un nombre para la funcin y cree una frmula. 4. Haga clic en Aceptar. Para obtener ms informacin sobre la creacin de funciones personalizadas, consulte la Ayuda.

Acerca de los mens personalizados


Con FileMaker Pro Advanced se pueden crear mens personalizados, elementos de men y conjuntos de mens para las soluciones de bases de datos. Puede:

1 1 1 1

crear un men nuevo o editar uno existente duplicar o eliminar un men aadir, duplicar o eliminar elementos de men especificar las propiedades de los elementos de men, como el ttulo de visualizacin, el acceso directo y la accin

Captulo 3

Personalizacin de las soluciones de base de datos

21

Ttulo de visualizacin de mens

Barra de mens

Conjunto de mens (para esta ventana de archivos) Submen Men Separador

Elemento de men

Terminologa de los mens personalizados

Los mens se pueden personalizar:

1 editando una copia de un men FileMaker estndar. Este mtodo se utiliza para hacer pequeos cambios
en los mens existentes; por ejemplo, para modificar las propiedades de unos pocos elementos de men.

1 partiendo de un men vaco. Este mtodo se utiliza para hacer cambios importantes en los mens; por
ejemplo, para aadir mens y cambiar las propiedades de los elementos de men.

Ejemplo de men personalizado


En el siguiente ejemplo se muestra cmo 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 continuacin, asociar un guin que se ejecute cuando el usuario elija el elemento de men Nueva factura. Por ltimo, puede cambiar el conjunto de mens predeterminado, para que cuando un usuario abra la base de datos se muestre el nuevo conjunto de mens personalizado. En este ejemplo se supone que la base de datos contiene un guin llamado Mi factura nueva. Mi factura nueva automatiza varias tareas, como cambiar a la presentacin Facturas y crear un registro vaco. 1. Abra la base de datos y elija el men Archivo > Gestionar > Mens personalizados. Haga doble clic en el men Registro para editar una copia del men Registros estndar. 2. Seleccione el elemento de men Nuevo registro para modificar las propiedades del mismo. Cambie el ttulo del elemento de men Nuevo registro a Nueva factura. 3. Cambie la accin del elemento de men para que ejecute el guin Mi factura nueva. 4. Establezca el conjunto de mens predeterminado para el archivo en el valor Conjunto de mens personalizados 1. 5. Haga clic en Aceptar.

22

Gua de desarrollo de FileMaker Pro Advanced

Creacin de mens personalizados


Para crear un men personalizado: 1. Elija el men Archivo > Gestionar > Mens personalizados > pestaa Mens personalizados.

Los mens entre corchetes estn bloqueados y no se pueden personalizar

2. Haga clic en Crear. 3. En el cuadro de dilogo Crear men personalizado, realice una de las acciones siguientes y haga clic en OK:

1 Haga clic en Comience con un men vaco. 1 Haga clic en Comience con un men FileMaker estndar y seleccione un men de la lista.
Aparece el cuadro de dilogo Editar men personalizado. 4. En el cuadro de dilogo Editar men personalizado, especifique el nombre del men, el ttulo que desea que se muestre en la barra de mens, la plataforma de men y los modos en los que se mostrar el men. Consulte la Ayuda para obtener ms informacin sobre estas opciones. 5. Cree elementos de men personalizados como se describe a continuacin.

Creacin de elementos de men personalizados


Una vez creado el men, se pueden crear elementos de men. Tambin se pueden crear o editar elementos de men que son copias de los mens estndar de Filemaker. Los elementos de men pueden ser comandos, submens o separadores. Puede crear un elemento de men que se base en un comando estndar 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 (ttulo, acceso directo o accin). Si crea un elemento de men que no tenga ningn comando asignado, aparece un elemento de men sin ttulo en la lista Elementos de men del cuadro de dilogo Editar men personalizado. A continuacin, puede personalizar las propiedades del elemento de men. Para crear o editar un elemento de men personalizado: 1. Elija el men Archivo, >Gestionar> mens personalizados, >pestaa Mens personalizados. 2. En el cuadro de dilogo Gestionar mens personalizados, seleccione el men de la lista y, a continuacin, haga clic en Editar.

Captulo 3

Personalizacin de las soluciones de base de datos

23

3. En el cuadro de dilogo Editar men personalizado, especifique qu elementos de men se incluyen en el men:
Para Realizar lo siguiente: Aadir un comando Haga clic en Comando. En el cuadro de dilogo Especificar comando de FileMaker, realice una de las acciones siguientes y haga clic en Aceptar. 1 Haga clic en Ningn comando asignado. FileMaker Pro Advanced aade un elemento de men Sin ttulo 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 accin o el comportamiento del elemento de men. Sugerencia En el cuadro de dilogo Editar men personalizado, pulse Mays y haga clic en Comandopara crear un elemento de men de comando Sin ttulo. Aadir un submen Para aadir otros comandos del men al men actual, haga clic en Submen. En el cuadro de dilogo Especificar submen, seleccione el men que desea incluir y haga clic en OK. Nota Es posible aadir hasta cien mens a la barra de mens. Si aade un men que se incluya a s mismo como submen, puede alcanzar el lmite rpidamente. Aadir una lnea separadora Seleccione en la lista el elemento de men bajo el que desea que aparezca la lnea de separacin y haga clic en Separador. . .

Duplicar un elemento Seleccione un elemento de men de la lista y haga clic en el de men Eliminar un elemento Seleccione un elemento de men de la lista y haga clic en el de men

4. Seleccione cada elemento de men en la lista Elementos de men y especifique sus propiedades.
Para Cambiar un comando en un elemento de men Elegir una plataforma para un elemento de men Cambiar el ttulo de un elemento de men Realizar lo siguiente: Haga clic en Especificar. En el cuadro de dilogo Especificar comando de FileMaker, seleccione un comando y haga clic en Aceptar.

Seleccione Windows, Macintosh o ambas opciones. El elemento de men aparecer en las plataformas que seleccione. Nota Algunos comandos son vlidos solamente en una plataforma. Seleccione Ttulo y escriba el texto. Para especificar una clave de acceso (Windows), escriba un carcter ampersand (&) delante del carcter 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 ttulo del men en el resultado de un clculo, haga clic en Especificar y, a continuacin, cree una frmula en el cuadro de dilogo Especificar clculo. Nota Los elementos de men sin ttulo no tienen casilla de verificacin. Seleccione Acceso directo. En el cuadro de dilogo Especificar acceso directo, escriba la combinacin de teclas y haga clic en Aceptar. Para obtener ms informacin sobre los accesos directos de teclado, consulte la Ayuda. Seleccione Accin, realice una de las operaciones siguientes y haga clic en Aceptar. 1 Seleccione Guin. En el cuadro de dilogo Especificar opciones de guin, seleccione un guin e introduzca los parmetros opcionales del mismo, cuando sea necesario.

Definir un acceso directo para un elemento de men Ejecutar un guin o un paso de guin cuando el usuario selecciona un elemento de men

1 Seleccione Paso de guin. En el cuadro de dilogo Especificar paso de guin, seleccione un paso,
especifique las opciones necesarias y haga clic en Aceptar. Nota Los elementos de men sin ttulo no tienen la casilla de verificacin Accin. Consejo Para que afecte al comportamiento de un guin que se est ejecutando en ese momento (por ejemplo, para detener, salir, reanudar o poner el guin en pausa), elija Paso de guin y utilice el paso de guin Ejecutar guin. Para obtener ms informacin sobre los guiones y los pasos de guin, consulte la Ayuda.

24

Gua de desarrollo de FileMaker Pro Advanced

Creacin de conjuntos de mens personalizados


Puede crear conjuntos personalizados de mens que incluyan los mens que necesite. Para crear o editar conjuntos de mens: 1. Elija el men Archivo > Gestionar > Mens personalizados > pestaa Juego de mens. 2. Crear un conjunto de mens, o editar o duplicar un conjunto de mens existente. Tambin se pueden borrar conjuntos de mens que los usuarios no vayan a necesitar. 3. Especifique los mens que desea incluir en el conjunto de mens y haga clic en Aceptar.

Los mens aparecen en la barra de mens en el orden que muestra esta lista

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

Importante La duplicacin de un conjunto de mens personalizado crea una copia del conjunto de mens y hace referencia a los mismos mens personalizados que el conjunto de mens original. No duplica los mens 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 mens, debe especificar las opciones para instalarlos. Puede:

1 1 1 1 1

especificar un conjunto de mens personalizado predeterminado para un archivo especificar conjuntos de mens para presentaciones individuales crear guiones que cambian los conjuntos de men especificar mens en el conjunto de mens para que se muestren segn el modo cambiar los conjuntos de mens con el men Herramientas de FileMaker Pro Advanced

Para obtener ms informacin sobre cmo crear, instalar y probar conjuntos de mens personalizados, consulte la Ayuda.

Captulo 3

Personalizacin de las soluciones de base de datos

25

Creacin de temas de presentacin personalizados


FileMaker Pro y FileMaker Pro Advanced utilizan diversos temas de presentacin 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 presentacin/informe para aplicar el tema personalizado cuando cree presentaciones para sus bases de datos. Una vez creada la presentacin, es posible modificar los atributos definidos por el tema en el modo Presentacin. Sin embargo, no es posible aplicar un tema a una presentacin existente.

Rellenar el color y el patrn de la cabecera Etiqueta de campo

Texto de la cabecera Rellenar el color y el patrn del cuerpo

Etiqueta de campo

Relleno, borde y efecto sombra del campo

Texto del pie de pgina Crear temas para aplicar automticamente distintos estilos al texto y a los rellenos de fondo de partes de la presentacin, campos y etiquetas de campo

Rellenar el color y el patrn del pie de pgina

Nota Los temas de FileMaker no son hojas de estilo y no contienen informacin sobre la posicin de los objetos en una presentacin. Importante El cdigo XML para los temas de presentacin debe estar bien formado y utilizar la sintaxis adecuada. La omisin 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 presentacin/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 nmero total de archivos de temas est limitado a 50. 2. Renombre la copia e incluya la extensin .fth en el nombre de archivo nuevo. Conserve el archivo nuevo en la carpeta Themes. Para que el asistente de nueva presentacin/informe muestre una opcin de tema, el archivo de temas debe estar en la carpeta Themes y debe tener la extensin .fth.

26

Gua de desarrollo de FileMaker Pro Advanced

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

Elemento de una lnea

Elemento de varias lneas Atributos

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 presentacin 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. Asegrese de quitar todo el elemento de una y de varias lneas, incluidas las etiquetas de inicio y de fin. 7. Desplcese 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 extensin de nombre de archivo. fth en la carpeta Themes. Los nuevos valores de THEMENAME aparecern en el asistente de nueva presentacin/informe como opcin de Tema de presentacin. 9. En FileMaker Pro Advanced, elija el men Presentacin> Nueva presentacin/informe para utilizar el tema. Siga las instrucciones del asistente de nueva presentacin/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 presentacin/informe, es posible que haya cometido un error de sintaxis.

Captulo 3

Personalizacin de las soluciones de base de datos

27

Requisitos para los archivos de temas


Todos los archivos de temas deben comenzar con una instruccin de procesamiento del documento XML que lo declara como un documento XML mediante la especificacin XML 1.0. Adems, los documentos XML para los temas de presentacin deben contener las etiquetas de inicio y de fin <FMTHEMES> y </FMTHEMES> para el archivo. El elemento raz FMTHEMES puede contener uno o ms elementos FMTHEME.

Nmero mnimo de elementos necesarios para un archivo de temas

Para obtener ms informacin sobre los elementos de los temas y sus atributos, consulte la Ayuda.

28

Gua de desarrollo de FileMaker Pro Advanced

Captulo 4 Depurar y analizar archivos


Las funciones de FileMaker Pro Advanced que se explican en este captulo son:

1 El depurador de guiones para las pruebas y depuraciones sistemticas de guiones de FileMaker. 1 La funcin Desactivar pasos de guin, para probar partes de los guiones. 1 La funcin Informe de diseo de base de datos, para publicar una completa documentacin sobre
los esquemas y las opciones de la base de datos

1 El Visor de datos, para supervisar campos, variables y clculos.


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

Depuracin de guiones
Con 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 1 1 1 1 1 1 1

depurar un guin activado por un activador de guin desplazarse por los guiones paso a paso ver y hacer un seguimiento de los subguiones supervisar campos, variables y clculos desactivar pasos de guin depurar guiones de acceso restringido pausar un guin cuando se encuentran errores de guin haga clic en un nmero de error de guin para abrir el tema de Ayuda

Para ejecutar guiones en modo de depuracin: 1. Seleccione el men Herramientas, >Depurador de guiones. Se abre el cuadro de dilogo Depurador de guiones. 2. Ejecute el guin.

30

Gua de desarrollo de FileMaker Pro Advanced

Puede visualizar subguiones al desplazarse por los guiones en el depurador de guiones. Por ejemplo, si el Guin A llama al Guin B, que a su vez llama al Guin C, se pueden ver los pasos de los tres guiones. El depurador de guiones reconoce los privilegios asociados a cada guin. En el depurador de guiones slo aparecern aquellos guiones cuyos privilegios haya editado y cuyos privilegios de acceso estn establecidos en Modificable. Puede hacer clic en Autenticar/Anular la autenticacin del guin para iniciar sesin y editar pasos de guin en guiones de acceso restringido. En la ventana Depurador de guiones puede seleccionar ms de un paso de la lista, que le permitir colocar varios puntos de interrupcin simultneamente en los pasos. Si se seleccionan varios pasos, se desactivar el botn Configurar paso siguiente. Nota Cuando usa el depurador de guiones para revisar paso a paso guiones activados por un activador de guin, 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 interaccin solo se produce cuando el guin se activa mediante alguna accin. Cuando depura un guin que no est activado por un activador de guin, puede interactuar de manera habitual con las ventanas de los documentos, los campos y los registros. Para obtener informacin acerca del uso de activadores de guiones, consulte la Ayuda. Consejo Para activar el depurador de guiones desde el cuadro de dilogo Gestionar guiones, pulse Mays y haga clic en Ejecutar el botn de flecha. Para desactivar el Depurador de guiones, pulse Ctrl (Windows) o Comando (MacOS) y haga clic en el botn Ejecutar.

Desactivacin de pasos de guin


Es posible desactivar y activar pasos de guin para probar las distintas partes de los guiones. Cuando se ejecuta un guin, los pasos de guin desactivados se omiten. Para desactivar pasos de guin: 1. Seleccione el men Guiones > Gestionar guiones. O bien, elija el men Archivo > Definir > Guiones. 2. En el cuadro de dilogo Gestionar guiones, haga doble clic en el nombre de guin. O bien, haga clic en el botn Editar en el cuadro de dilogo Depurador de guiones.

3. En el cuadro de dilogo Editar Guin, seleccione uno o varios pasos de guin y haga clic en Desactivar o Activar. Para obtener ms informacin sobre las depuracin de guiones, consulte la Ayuda.

Uso del Visor de datos


El Visor de datos se puede utilizar para supervisar expresiones como valores de campo, variables locales y globales, y clculos. Puede supervisar estas expresiones mientras se ejecutan guiones o cuando se prueben en el depurador de guiones. Tambin se pueden supervisar los valores de campo y las variables del archivo de base de datos. La pestaa Actual muestra los campos y variables del guin que est en ejecucin, los campos a los que se hace referencia en los clculos usados en el guin y las variables globales. La pestaa Control supervisa expresiones seleccionadas hasta que se quiten de la lista.

Captulo 4

Depurar y analizar archivos

31

Para supervisar campos, variables y clculos: 1. Elija el men Herramientas, >Visor de datos o haga clic en el botn Abrir/Cerrar visor de datos en la ventana Depurador de guiones.
Haga clic para ver expresiones de acceso restringido Haga clic en una cabecera de columna para ordenar

2. En la pestaa Actual, haga doble clic en una funcin para que aparezca un cuadro de dilogo 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 aadir una expresin a la pestaa Observar, haga clic en Aadir a observador. La expresin se copia en la pestaa Observar y sta ltima se abre. 5. Para ver o editar guiones de acceso restringido, haga clic en el cuenta con privilegios de acceso completo. , a continuacin inicie sesin en una

Nota Si inicia sesin para editar guiones de acceso restringido en el Depurador de guiones, sus privilegios de acceso tambin se aplican al Visor de datos. Si inicia sesin desde el Visor de datos, sus privilegios de acceso tambin se aplican al Depurador de guiones. En los dos casos, sus privilegios de edicin durarn hasta que cierre el Depurador de guiones o el Visor de datos. 6. Haga clic en la pestaa Observar.

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

7. Seleccione una de las opciones siguientes:


Para Aadir una expresin Editar una expresin Duplicar una expresin Eliminar una expresin Realizar lo siguiente: Haga clic en . o haga doble clic Seleccione una expresin y, a continuacin, haga clic en el en la expresin. Seleccione una o varias expresiones y haga clic en Seleccione una o varias expresiones y haga clic en . .

32

Gua de desarrollo de FileMaker Pro Advanced

8. En el cuadro de dilogo Editar expresin, seleccione el archivo de base de datos que contenga la expresin y, a continuacin, cree o edite la expresin que desea supervisar.
Selecciones los operadores de texto y los matemticos. Seleccione los operadores lgicos y de comparacin. Elija la forma en que se muestran las funciones en el cuadro de dilogo. Seleccione funciones

Nombre de archivo Elija las referencias de campo.

Cuadro de frmula

Resultado de la expresin Evaluar el contenido de la expresin Aadir la expresin al Visor de datos

9. Haga clic en Evaluar ahora para mostrar el resultado de una expresin o haga clic en Supervisar para aadir la expresin a la lista de control en el Visor de datos. 10. En el Visor de datos, haga clic en Actualizar valores para actualizar los clculos de la lista. Para obtener ms informacin acerca del uso del Visor de datos, consulte la Ayuda.

Usar el informe de diseo de base de datos


Utilice la funcin Informe de diseo 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 versin en HTML del informe contiene hipervnculos y se puede ver o imprimir en un navegador Web habilitado para Javascript. Con la funcin de informe de diseo de base de datos, puede:

1 examinar una representacin textual de su esquema de base de datos 1 recopilar estadsticas sobre la estructura de su base de datos 1 usar la informacin 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, clculos, y ms


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

Captulo 4

Depurar y analizar archivos

33

2. Elija el men Herramientas > Informe de diseo 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 verificacin asociada con el archivo. 4. Si alguno de los archivos contiene tablas que desee excluir del informe, seleccinelo 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 seleccin 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 estn presentes, se generarn 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 seccin Formato de informe. 7. Si no desea que el informe se abra automticamente cuando se haya realizado, desactive la casilla de verificacin de esta opcin en la seccin Gestin de archivos. 8. Haga clic en Crear. Para obtener ms informacin acerca del uso del Informe de diseo de base de datos, consulte la Ayuda.

34

Gua de desarrollo de FileMaker Pro Advanced

Captulo 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 clculos de FileMaker Pro y FileMaker Pro Advanced, puede crear plug-ins de funciones externas que amplen el conjunto de funciones de la aplicacin. Los plug-ins pueden aprovechar la recursividad y los bucles o colgarse en otras interfaces de programacin. 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 clculos. Puede utilizar FileMaker Server para asegurarse de que los clientes de FileMaker Pro tienen el plug-in ms actual instalado en sus ordenadores. Consulte la Guide to Updating Plug-Ins de FileMaker Server, que encontrar en www.filemaker.com/downloads. Nota Consulte la Ayuda para obtener informacin completa y pormenorizada y procedimientos detallados sobre el uso de FileMaker Pro Advanced.

Acerca de las funciones externas


FileMaker Pro Advanced incluye un proyecto de creacin de un plug-in de ejemplo que puede modificar para crear sus propias funciones externas. Los usuarios pueden acceder a sus plug-ins a travs del cuadro de dilogo Especificar clculo. Siga estos pasos generales para preparar plug-ins personalizados: 1. Edite los archivos con plug-ins de ejemplo para aadir su cdigo de programacin 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 dilogo Preferencias. 2. Configuran el plug-in, si fuera necesario. 3. Definen o editan un campo de clculo. 4. En el cuadro de dilogo Especificar clculo, eligen Function_Name(parameter 1 ...) como frmula del clculo. Para ver todas las funciones externas, seleccionan Funciones externas en la lista desplegable Vista.

Acerca del plug-in de ejemplo


El proyecto de plug-in de ejemplo se ha diseado para ilustrar cmo 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 travs del cuadro de dilogo Especificar clculo. El cdigo 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 Descripcin de las funciones externas del plug-in FMExample en la pgina 38.

36

Gua de desarrollo de FileMaker Pro Advanced

Los archivos del plug-in de ejemplo incluyen todo el cdigo fuente necesario para compilar el plug-in para plataformas Windows y Mac OS X. Adems del cdigo 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 espaol\Ejemplos\FMExample del CD de FileMaker Pro Advanced o la descarga electrnica. Los archivos con el cdigo 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


Carpeta Carpeta Example Carpeta Headers Carpeta Libraries Descripcin Contiene todos los archivos que forman parte del FMExample. Contiene archivos de definicin de funcin para la API de FileMaker. No los distribuya a los usuarios que no tengan licencia de FileMaker Pro Advanced. Contiene archivos de biblioteca para la API de FileMaker. No los distribuya a los usuarios que no tengan licencia de FileMaker Pro Advanced.

Contenido de la carpeta Example


Archivo/carpeta FMPluginExample.cpp MacExample.fmplugin MacExample.xcodeproj WinExample.sln WinExample.vcproj WinExample.fmx Carpeta Support Descripcin Contiene cdigo para la implementacin de FMExample. Plug-in compilado para Mac OS X. Archivo de proyecto de Apple Xcode. Archivo de proyecto de Microsoft Visual Studio .NET. Archivo de proyecto de Microsoft Visual C++, lo utiliza WinExample.sln. Plug-in compilado para Microsoft Windows. Contiene todos los recursos adicionales y el cdigo utilizado por FMPluginExample.cpp.

Contenido de la carpeta Support


Archivo/carpeta FMPluginExample.rc FMPluginExample.nib FMPluginExample.strings FMPluginFunctions.cpp FMPluginFunctions.h FMPluginGlobalDefines.h FMPluginPrefs.cpp FMPluginPrefs.h info.plist MacExample.plc Resource.h Descripcin Contiene los recursos para la plataforma Windows. Contiene los recursos para la plataforma Mac OS X. Contiene las cadenas para la plataforma Mac OS X. Contiene cdigo para la implementacin de funciones externas en FMExample. Contiene las definiciones de las funciones externas, incluidos sus ID. Contiene las constantes que utiliza FMExample, incluso las directivas del compilador para controlar la compilacin del cdigo. Contiene cdigo para la implementacin de un cuadro de dilogo de configuracin en FMExample. Contiene las definiciones del cuadro de dilogo de configuracin. Contiene informacin variada para la salida de Apple Xcode. Contiene informacin variada para la plataforma Mac. Contiene las definiciones del archivo de recursos.

Captulo 5

Desarrollo de plug-ins de FileMaker por parte de otros fabricantes

37

Instalacin, activacin y configuracin del plug-in de ejemplo


Los 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 tambin 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 sesin 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 necesitarn ver la documentacin de su sistema operativo para encontrar las bibliotecas que suelen estar disponibles. Para obtener ms informacin sobre la instalacin de plug-ins de publicacin 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 este sistema operativo: Guarde el plug-in en esta carpeta:

Windows XP Windows Vista Mac OS X

C:\Documents and Settings\nombre_usuario\Configuracin local\Datos de programa\FileMaker\Extensions C:\usuarios\nombre_usuario\AppData\Local\FileMaker\Extensions\ Macintosh HD/Usuarios/nombre_usuario/Librera/Application Support/FileMaker/ Extensions

En Windows, la extensin del plug-in debe ser .fmx. En Mac OS X, la extensin del plug-in debe ser .fmplugin. Para activar un plug-in: 1. Abra el cuadro de dilogo Preferencias. Windows: Elija el men Edicin > Preferencias. Mac OS X: elija el men de aplicacin FileMaker Pro Advanced, >Preferencias. 2. Haga clic en la pestaa 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 aplicacin FileMaker Pro.

El texto con la descripcin del plug-in se define en una cadena de recursos Seleccione un plug-in para activarlo

38

Gua de desarrollo de FileMaker Pro Advanced

Para configurar un plug-in: 1. Seleccione el plug-in en el cuadro de dilogo Preferencias. 2. Haga clic en Configurar. El botn Configurar slo est disponible cuando el sexto carcter de la cadena de opciones del plug-in seleccionado es "Y". Consulte Sintaxis de la cadena de opciones en la pgina 41. 3. Para configurar el plug-in, siga las instrucciones del cuadro de dilogo de configuracin. 4. Haga clic en Aceptar.

Descripcin de las funciones externas del plug-in FMExample


El plug-in FMExample que se incluye en los proyectos de ejemplo de Microsoft Visual C++ y Apple Xcode aade las siguientes funciones externas a FileMaker Pro, FileMaker Pro Advanced, FileMaker Server y FileMaker Server Advanced.
Nombre y parmetro de la funcin XMpl_Add(number1; number2) XMpl_Append(textToAppend ...) XMpl_Evaluate(calcToEvaluate) Descripcin de la funcin externa Aade number1 y number2 a la vez y devuelve el resultado. La funcin es la misma que la del operador ms (+) en el sistema de clculo. Toma una lista mltiple de parmetros, los concatena y devuelve el resultado. La funcin es la misma que la del operador ampersand (&) en el sistema de clculo. Toma un clculo simple o complejo, lo evala y devuelve el resultado. Todos los clculos compatibles con FileMaker se pueden asignar a esta funcin. La funcin es idntica a la funcin Evaluate del sistema de clculo. Devuelve un nmero en formato de cheque bancario. Por ejemplo, 44,345 devuelve 44 euros y 34 cntimos. Tanto los dgitos a partir del segundo decimal como los caracteres alfabticos se ignoran.

XMpl_NumToWords(number)

XMpl_StartScript(filename; scriptname) Ejecuta el guin especificado por el parmetro scriptname en el archivo especificado por el parmetro filename. XMpl_Version Devuelve la versin del plug-in y no tiene ningn parmetro. Nota Para cada plug-in de FileMaker Pro es necesario contar con una funcin de versin similar a la que se incluye en el plug-in del ejemplo. Devuelve el parmetro como una cadena de texto con el formato especificado en el cuadro de dilogo de configuracin. Esta funcin se utiliza para dar formato a texto o a nmeros, como nmeros de telfono, cdigos postales, etc. El formato se realiza de derecha a izquierda. Todos los smbolos # de la cadena de formato se reemplazan por el siguiente carcter de la cadena de parmetros. Los smbolos # restantes se reemplazan por ceros. Esta funcin muestra tanto la funcionalidad slo con clientes y el cuadro de dilogo de configuracin del plug-in. Igual que XMpl_UserFormatNumber, salvo que formatString se incluye como parmetro. Esta funcin muestra una funcin que se puede ver en el cuadro de dilogo Especificar clculo de Entrada automtica y tambin admite llamadas de FileMaker Server y Publicacin en la Web al instante.

XMpl_UserFormatNumber (textOrNumber)

XMpl_FormatNumber(formatString; textOrNumber)

Captulo 5

Desarrollo de plug-ins de FileMaker por parte de otros fabricantes

39

Uso del plug-in de ejemplo


Para acceder a las funciones externas: 1. Abra un archivo. 2. Abra el cuadro de dilogo Preferencias. Windows: Elija el men Edicin > Preferencias. Mac OS X: elija el men de aplicacin FileMaker Pro Advanced, >Preferencias. 3. Haga clic en la pestaa Plug-ins. 4. Seleccione FMExample. Como el plug-in de ejemplo incluye una funcin que requiere configuracin, el botn Configurar est activo. 5. Haga clic en Configurar. El cuadro de dilogo de configuracin que aparece depende de la forma en que se haya escrito el cdigo fuente del plug-in. La funcin XMpl_UserFormatNumber del plug-in FMExample muestra el siguiente cuadro de dilogo de configuracin.

6. Haga clic en Aceptar para utilizar el formato predeterminado, o bien escriba un formato nuevo. Los smbolos "#" se sustituyen por nmeros. El resto del texto de la cadena de formato se mantiene igual. 7. Haga clic en Aceptar para cerrar el cuadro de dilogo Preferencias. 8. Con el archivo abierto, en FileMaker Pro Advanced, elija el men Gestionar> base de datos, pestaa> Campos. 9. Cree de un campo de clculo. 10. En el cuadro de dilogo Especificar clculo, elija Funciones externas en el men desplegable Vista. 11. Para aadir una funcin externa al cuadro de frmulas, haga doble clic en ella. Todas las llamadas a funciones externas requieren el nombre de la funcin externa a la que se llama y el valor del parmetro de la misma, aunque dicho valor sea nulo. 12. Reemplace el marcador del parmetro por el parmetro o parmetros obligatorios para la funcin. 13. Siga construyendo la frmula y cuando termine, haga clic en Aceptar. 14. Haga clic en Aceptar para cerrar el cuadro de dilogo 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 instalacin personalizada de XCode y seleccione la opcin de desarrollo cruzado.

40

Gua de desarrollo de FileMaker Pro Advanced

Personalizacin del plug-in de ejemplo


El plug-in de ejemplo de FileMaker Pro Advanced est pensado para poderse modificar con facilidad y que de esta forma pueda aadir sus propias funciones personalizadas. Tiene que modificar los siguientes elementos:

1 1 1 1

la informacin de la versin en FMPluginExample.strings y FMPluginExample.rc los nombres del plug-in y de las funciones en FMPluginExample.strings y FMPluginExample.rc la funcin de configuracin en FMPluginPrefs.cpp definiciones y codificacin de funciones externas en FMPluginFunctions.cpp

Personalizacin de los recursos de ejemplo


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

1 1 1 1 1

Modificar las variables y cadenas de la versin para que se ajusten a sus necesidades. Revisar el cuadro de dilogo de configuracin para que se ajuste a sus necesidades. Especificar los valores correctos de la cadena de opciones. Editar los nombres y la descripcin del plug-in. Definir los nombres y prototipos de las funciones.

Personalizacin de FMPluginExample.cpp
Realice sus modificaciones del archivo FMPluginExample.cpp en las funciones que se enumeran en la siguiente tabla.
Nombre de funcin Do_PluginInit Personalizacin Proporcione su propio ID exclusivo de plug-in en "pluginID". Registre todas las funciones proporcionando su nombre, descripcin y funcin que se va a utilizar. Para registrar funciones, llame a fmx::ExprEnv::RegisterExternalFunction. Aada todos los procesos en espera que necesite su plug-in. Revise las llamadas UnRegisterExternalFunction para invertir el registro realizado en Do_PlugInit. Para anular el registro de funciones, llame a fmx::ExprEnv::UnRegisterExternalFunction.

Do_PluginIdle Do_PluginShutdown

Personalizacin de FMPluginPrefs.cpp
Este archivo contiene la funcin Do_PluginPrefs para la implementacin del cuadro de dilogo de configuracin. Revise o quite este cdigo si es necesario.

Personalizacin de FMPluginFunctions.cpp
Revise 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 clculos.

Requisitos para escribir plug-ins con funciones externas


Los plug-ins de FileMaker son muy tiles cuando contienen una sola funcin o un conjunto de funciones con caractersticas similares. Al disear un plug-in, tenga en cuenta que es posible que los desarrolladores que lo utilicen no conozcan las convenciones de programacin que usted da por conocidas. El usuario medio debe conocer el formato del parmetro de cada funcin. Si va a crear un plug-in de FileMaker con funciones que no necesitan parmetros, asegrese de que el "prototipo" de funcin registrado para dicha funcin no incluye parntesis. Por ejemplo, hay que registrar "DoThis" en lugar de "DoThis( )" como prototipo de funcin.

Captulo 5

Desarrollo de plug-ins de FileMaker por parte de otros fabricantes

41

Archivos de cdigo API


En la carpeta Headers hay diez archivos de cdigo 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 cdigo fuente (ni en forma legible), no se pueden modificar y slo 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 parmetros (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 parmetros y de resultados en el bloque de parmetros. 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 envan al plug-in en una definicin de FMExternCallSwitch. FMExternCallStruct define la estructura del bloque de parmetros. FMExternCallPtr es un puntero a esa estructura y gFMExternCallPtr es una variable global que se debe definir en el cdigo. El archivo FMXCalcEngine.h contiene las funciones para registrar y anular registros. Se utilizar en la mayora de los plug-ins, ya que es muy probable que stos tengan que registrar funciones. Las funciones de los restantes archivos de cdigo API se describen en los comentarios que se incluyen en los propios archivos.

Sintaxis de la cadena de opciones


La 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 slo puede contener caracteres alfanumricos 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 versin para Mac OS X del plug-in. Para registrar los ID del plug-in como cdigos de creador, dirjase a las pginas de desarrolladores del sitio Web de Apple Inc. www.apple.com. El quinto carcter de la cadena de opciones es siempre "1" y el octavo, dcimo y undcimo son siempre "n". Los restantes valores de estos indicadores estn 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 configuracin (carcter 6 = Y), utiliza las nuevas llamadas de funciones y de registro de estilo (carcter 7 = n) y requiere un tiempo de espera especial (carcter 9 = Y).
Caracteres de la cadena de opciones Descripcin de los caracteres 1-4 5 6 Los caracteres 1-4 son el ID del plug-in. Registre el ID como cdigo de creador en el sitio Web de Apple Developer Support, www.apple.com. El carcter 5 es siempre "1". Configure el sexto carcter de la cadena de opciones para que sea "Y", si desea activar el botn Configurar para plug-ins en el cuadro de dilogo Preferencias. Utilice "n" si no es necesario configurar el plug-in. Si el indicador est establecido en "Y", asegrese de encargarse del mensaje de kFMXT_DoAppPreferences. Para obtener ms informacin, consulte Mensajes de FileMaker enviados al plug-in en la pgina 42.

42

Gua de desarrollo de FileMaker Pro Advanced

Caracteres de la cadena de opciones Descripcin de los caracteres 7 Establzcalo en "n" para utilizar las nuevas llamadas a funciones y el nuevo registro de plug-ins que se muestra en FMExample. Establzcalo en "Y" solamente si el plug-in necesita la lista heredada de cadenas de funciones y llamadas externas individuales. El carcter es siempre "n". Establezca el noveno carcter 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 carcter en "n". El carcter 10 es siempre n. El carcter 11 es siempre n.

8 9

10 11

Especificaciones de nombres de archivos para funciones externas


El prefijo de nombre de funcin 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-in


Hay seis posibles llamadas que FileMaker Pro, FileMaker Pro Advanced o FileMaker Server pueden solicitar a un plug-in. Los mensajes que se envan a los plug-ins se suministran en el campo whichCall del bloque de parmetros, FMExternCallStruct, definido en el archivo FMXExtern.h.

1 1 1 1 1

kFMXT_Init: el mensaje de Inicializacin kFMXT_Shutdown: el mensaje de Apagado kFMXT_Idle: el mensaje de En espera kFMXT_DoAppPreferences: el mensaje de Preferencias kFMXT_External: el mensaje de Funcin externa que reciben los plug-ins heredados que asignan el valor Y al carcter 7 de la cadena de opciones y que registran sus funciones de la forma externa anterior cuando los plug-ins proporcionan la cadena de opciones y el nombre y descripcin del plug-in

1 kFMXT_GetString: el mensaje de GetString que reciben los plug-ins que usan el nuevo estilo de registro

Mensaje de Inicializacin
El mensaje de Inicializacin, kFMXT_Init, se enva 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 aplicacin, segn si el plug-in est activado en el cuadro de dilogo Preferencias. El resultado tiene dos valores posibles que el plug-in debe devolver en respuesta al mensaje de Inicializacin:

1 Se debe devolver kBadExtnVersion si el nmero de versin 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 debera devolver. Esto hace que se active el plug-in.

Captulo 5

Desarrollo de plug-ins de FileMaker por parte de otros fabricantes

43

En el plug-in FMPluginExample, se llama a la funcin Do_PluginInit cuando se recibe el mensaje de Inicializacin. La funcin Do_PluginInit comprueba en primer lugar la versin de la API con la que se ha compilado el plug-in para verificar que es compatible con la versin de FileMaker Pro, FileMaker Pro Advanced o FileMaker Server. A continuacin, la funcin 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 informacin se almacena en las dos plataformas, la funcin Do_PluginInit utiliza instrucciones de preprocesador para elegir el cdigo correcto durante la compilacin. Si las preferencias se configuran correctamente y la versin del API es correcta, la funcin Do_PluginInit del plug-in FMPluginExample devolver kCurrentExtnVersion. Tras configurar las preferencias, registre las funciones externas introduciendo su nombre, descripcin y la funcin que se va a utilizar. Para registrar funciones, utilice fmx::ExprEnv::RegisterExternalFunction.

Mensaje de Apagado
El mensaje de Apagado, kFMXT_Shutdown, se enva 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 aplicacin, segn si el plug-in est desactivado en el cuadro de dilogo 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 asignacin de todo lo que tenga en la pila y salir de todos los servicios del sistema operativo que pueda estar utilizando, debe implementar una funcin de limpieza en el plug-in. Los plug-ins se pueden activar y desactivar varias veces durante una sesin, 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 Inicializacin utilizando fmx::ExprEnv::UnRegisterExternalFunction.

Mensaje de En espera
El mensaje de En espera, kFMXT_Idle, slo se enva al plug-in en tiempo de espera si el indicador de la funcin en espera se estableci en "Y" en la cadena de opciones y el plug-in est activado actualmente. La aplicacin FileMaker llama a este mensaje cinco veces. Si el parmetro idleLevel no es cero, la rutina se ha llamado mientras la aplicacin est ejecutando un guin o la est controlando el usuario. Se ha enviado uno de los cuatro mensajes siguientes:
Mensaje kFMXT_UserNotIdle = 1 kFMXT_ScriptPaused = 2 kFMXT_ScriptRunning = 3 kFMXT_Unsafe = 4 Significado El usuario ha hecho algo en los ltimos 30 segundos. El usuario est ejecutando un guin que se ha puesto en modo pausa. El usuario est ejecutando un guin. Igual que si se selecciona el valor true en el parmetro unsafeCalls.

No ejecute ningn proceso largo, de interfaz de usuario ni de eventos cuando el parmetro idleLevel no sea cero. El mensaje de En espera tambin se enviar si la aplicacin detecta tiempo libre y realiza su gestin interna del tiempo de espera.
Mensaje kFMXT_UserIdle = 0 Significado El usuario no ha hecho nada en los ltimos 30 segundos o ms.

44

Gua de desarrollo de FileMaker Pro Advanced

Mensaje de Preferencias
El mensaje de Preferencias, kFMXT_DoAppPreferences, se enva en respuesta a la pulsacin, por parte del usuario, del botn Configurar del plug-in seleccionado en el cuadro de dilogo Preferencias. El plug-in debe mostrar un cuadro de dilogo que permitir al usuario definir cualquier dato de configuracin 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 botn Configurar slo se activar si el sexto carcter de la cadena de opciones es establece en "Y". Para obtener ms informacin, consulte Sintaxis de la cadena de opciones en la pgina 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 dilogo de configuracin para la funcin XMpl_UserFormatNumber, por lo que el indicador se ha definido en la cadena de opciones (Xmpl1Ynnnnn) y la funcin Do_PluginPrefs recibe la llamada cuando se recibe el mensaje de Preferencias.

Mensaje de Funcin externa


El mensaje de Funcin 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 GetString
El mensaje de GetString, kFMXT_GetString, se enva 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 dnde almacenar las cadenas.
Cadena kFMXT_OptionsStr = 131 kFMXT_NameStr = 12 kFMXT_AppConfigStr = 129 Significado La cadena de opciones El nombre del plug-in El texto de ayuda que se muestra en el cuadro de dilogo Preferencias

Evitacin de posibles conflictos de recursos en Mac OS X


En las mquinas 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 nmeros de ID entre el 23.000 y el 24.999


Utilice ID fijos de este rango para los cuadros de dilogo, 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 ningn 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 ningn objeto de recursos del archivo de recursos. Incluya la siguiente lnea delante de todas las lneas 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 aplicacin asigna el ID del recurso. ste se encuentra en el bloque de parmetros cerca de las variables param2 y param3 del archivo FMExtern.h. Para obtener ms informacin, consulte Archivos de cdigo API en la pgina 41.

Captulo 5

Desarrollo de plug-ins de FileMaker por parte de otros fabricantes

45

Inclusin de documentacin en su plug-in


Incluya 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. Adems, debe incluir documentacin que describa todas las funciones externas y sus parmetros.

46

Gua de desarrollo de FileMaker Pro Advanced

Apndice A Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro


Al hacer doble clic en el icono de la aplicacin FileMaker Pro para iniciar la aplicacin, se abre el cuadro de dilogo Nueva base de datos, en el que puede elegir un archivo de base de datos. Al iniciar una aplicacin en tiempo de ejecucin de FileMaker Pro, el archivo de base de datos enlazado primario se abre automticamente. Otras diferencias importantes entre la aplicacin en tiempo de ejecucin y FileMaker Pro son:

1 En la aplicacin en tiempo de ejecucin se han quitado u ocultado todas las funciones de diseo
de la base de datos. Esto incluye el modo Presentacin y los comandos en el submen Gestionar.

1 Las funciones y mens personalizados creados con FileMaker Pro Advanced funcionarn en la
aplicacin en tiempo de ejecucin, aunque los usuarios de sta no pueden modificar ni crear funciones o mens personalizados nuevos.

1 Se han quitado algunos otros comandos de men de la aplicacin en tiempo de ejecucin.


Por ejemplo, la aplicacin en tiempo de ejecucin no se puede utilizar para crear, abrir ni cerrar ninguna base de datos. (Los archivos de base de datos en tiempo de ejecucin deben contener un botn o guin personalizado para abrir o cerrar otros archivos. En las ventanas de las bases de datos en tiempo de ejecucin no hay comando para cerrar.).

1 La ayuda de FileMaker Pro no est disponible en la aplicacin en tiempo de ejecucin. No obstante,


puede usar la funcin de mens personalizados para mostrar la Ayuda personalizada que haya creado.

1 Los plug-ins de funciones externas se pueden activar el cuadro de dilogo Preferencias. 1 Auque el filtro Datos XML aparece como una opcin en el paso de guin Convertir archivo, en las
aplicaciones en tiempo de ejecucin no es posible convertir archivos XML con este paso de guin.

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

1 Se admiten los eventos Apple, pero la automatizacin OLE no se admite en la aplicacin en tiempo
de ejecucin en equipos Windows.

1 Las aplicaciones en tiempo de ejecucin no se pueden compartir en red. 1 Las aplicaciones en tiempo de ejecucin no incluyen la capacidad de Guardar/enviar registros como
archivos PDF de Adobe.

1 Las funciones de FileMaker Pro Advanced no estn disponibles en la aplicacin en tiempo de ejecucin.
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 ejecucin no admiten fuentes de datos SQL externas (ESS), importacin
de ODBC o el paso de guin Ejecutar SQL.

48

Gua de desarrollo de FileMaker Pro Advanced

Preferencias de aplicaciones y documentos


En la aplicacin en tiempo de ejecucin, algunas opciones no estn disponibles en la pestaa General del cuadro de dilogo Preferencias.
Preferencias generales en las aplicaciones en tiempo de ejecucin (Mac OS X)

La pestaa Presentacin se cambia por la pestaa Color en el cuadro de dilogo Preferencias de la aplicacin en tiempo de ejecucin.
Preferencias generales en las aplicaciones en tiempo de ejecucin (Windows)

El cuadro de dilogo Opciones de archivo en la aplicacin en tiempo de ejecucin muestra slo la pestaa Ortografa.
Cuadro de dilogo Opciones de archivo de una aplicacin en tiempo de ejecucin

Apndice A

Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro

49

Comparacin de comandos de men


Las siguientes tablas muestran los comandos de men que estn disponibles en FileMaker Pro (Pro) y en la aplicacin en tiempo de ejecucin (TE).
Windows Comando del men Archivo Nueva base de datos Abrir... Abrir remoto Abrir reciente Cerrar Gestionar Compartir Opciones de archivo Cambiar contrasea Configurar impresin Ajustar pgina Imprimir Importar registros Exportar registros Guardar/enviar registros como Enviar correo Enviar vnculo Guardar una copia como Recuperar Salir
1. No puede Guardar/Enviar registros en PDF. 2. Pulse Ctrl+Mays 3. Pulse Opcin+3 Pro TE

Mac OS X Pro
TE

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
2

1 1 1 1 1 1 1 1 1 1 1 1 1 1
1

1 1

1 1 1 1 1 1
1

1 1 1 1 1 1 1 1

1 1
3

Nota Se pueden aadir elementos de men que equivalgan a los comandos de men Abrir, Cerrar y Recuperar a una aplicacin en tiempo de ejecucin que utilice mens personalizados basados en un guin o paso de guin. Para obtener ms informacin, consulte Creacin de mens personalizados en la pgina 22.

50

Gua de desarrollo de FileMaker Pro Advanced

Windows Comando del men Edicin No se puede deshacer No se puede rehacer Cortar Copiar Pegar Pegado especial Borrar Duplicar Seleccionar todo Buscar/reemplazar Ortografa Objeto Exportar contenido del campo Preferencias
Pro TE

Mac OS X
Pro TE

1 1 1 1 1 1 1 1 1 1 1 1 1 1
Windows

1 1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1

Mac OS X
TE Pro TE

Comando del men Vista Modo Visualizar Modo Buscar Modo Presentacin Modo Vista previa Ir a la presentacin Ver como formulario Ver como lista Ver como tabla Barra de herramientas de estado Personalizar barra de herramientas de estado Barra Formato de texto Regla de texto Ampliar Reducir

Pro

1 1 1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1 1

Apndice A

Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro

51

Windows Comando del men Insertar Imagen QuickTime Sonido Archivo Objeto Fecha actual Hora actual Nombre de usuario actual Desde ndice Desde ltimo registro visitado
Pro TE

Mac OS X
Pro TE

1 1 1 1 1 1 1 1 1 1
Windows

1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1
Mac OS X

1 1 1 1 1 1 1 1 1

Comando del men Formato Fuente Cuerpo Estilo Alinear texto Interlineado Color de texto Texto

Pro

TE

Pro

TE

1 1 1 1 1 1 1

1 1 1 1 1 1 1

1 1 1 1 1 1 1

1 1 1 1 1 1 1

Windows Comando del men Registros Nuevo registro Duplicar registro Eliminar registro Eliminar todos los registros Ir al registro Refrescar ventana Mostrar todos los registros Mostrar slo omitidos Omitir registro Omitir mltiples Cambiar bsqueda anterior Bsquedas guardadas
Pro TE

Mac OS X
Pro TE

1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1 1 1 1

52

Gua de desarrollo de FileMaker Pro Advanced

Windows Comando del men Registros Ordenar registros Desordenar Reemplazar contenido del campo Volver a buscar contenido de campo Restablecer registro
Pro TE

Mac OS X
Pro TE

1 1 1 1 1

1 1 1 1 1

1 1 1 1 1

1 1 1 1 1

Comando del men Peticiones (Modo Buscar) Aadir nueva peticin Duplicar peticin Eliminar peticin Ir a la peticin Mostrar todos los registros Ejecutar bsqueda Restringir conjunto encontrado Ampliar conjunto encontrado Restablecer peticin

Windows
Pro TE

Mac OS X
Pro TE

1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1

Windows Comando del men Guiones Gestionar guiones Guardar guin Guardar todos los guiones Restablecer guin <Nombres de guin>
Pro TE

Mac OS X
Pro TE

1 1 1 1 1 1

1 1 1 1 1 1

Nota Los comandos de men Guardar guin, Guardar todos los guiones y Restablecer guin slo aparecen cuando est activo el cuadro de dilogo Gestionar guiones o Editar guiones.

Windows Comando del men Ventana Ventana nueva Mostrar ventana Ocultar ventana Minimizar ventana
Pro TE

Mac OS X
Pro TE

1 1 1 1

1 1 1 1

1 1 1 1

1 1 1 1

Apndice A

Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro

53

Windows Comando del men Ventana Mosaico horizontal Mosaico vertical Ventanas en cascada Organizar iconos Desplazar todo al frente <Nombres de archivos abiertos>
Pro TE

Mac OS X
Pro TE

1 1 1 1 1

1 1 1 1

1 1 1 1

1 1 1 1 1

Windows Comando del men Ayuda Ayuda de FileMaker Pro Accesos directos de teclado Centro de recursos Documentacin del producto Descargas y actualizaciones Registrar ahora Activar/Desactivar (Se muestra cuando el usuario no ha activado/Se muestra cuando el usuario ha activado) Enviar comentarios Visite nuestro foro Acerca de FileMaker Pro (o Acerca de FileMaker Pro Advanced) Acerca de FileMaker Pro Runtime (se muestra si no se especifica ningn guin Acerca de personalizado) Acerca de la <solucin Runtime> (se muestra si se especifica un guin Acerca de personalizado) <Nombre del guin Ayuda de la solucin Runtime> (se muestra si se especifica un guin Ayuda personalizado)
1

Mac OS X
TE Pro TE

Pro

1 1 1 1 1 1 1 1 1 1 1 1 1

1 1 1 1 1 1 1 1 1
1 1

Consulte la tabla de comandos del men Aplicacin

54

Gua de desarrollo de FileMaker Pro Advanced

Comando del men Aplicacin (solo Mac OS X) Acerca de FileMaker Pro Acerca de FileMaker Pro Runtime (se muestra si no se especifica ningn guin Acerca de personalizado) Acerca de la <solucin Runtime> (se muestra si se especifica un guin Acerca de personalizado) Preferencias Servicios Ocultar FileMaker Pro Ocultar <solucin Runtime> Ocultar otros Mostrar todos Salir de FileMaker Pro Salir de <solucin Runtime>

Pro

TE

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1

Pasos de guin ignorados


Como se han quietado algunas funciones de la aplicacin en tiempo de ejecucin, sta ignora los siguientes pasos de guin:

1 1 1 1 1 1 1 1 1 1

Abrir Gestionar base de datos Abrir Gestionar lista de valores Abrir Gestionar fuentes de datos Abrir Gestionar guiones Abrir Compartir Abrir Ayuda Establecer multiusuario Nuevo archivo Abrir Opciones de archivo (disponible parcialmente; se abrir la pestaa Ortografa) 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 aplicacin en tiempo de ejecucin. La aplicacin en tiempo de ejecucin slo puede ejecutar un guin externo si el archivo externo est enlazado con la aplicacin en tiempo de ejecucin.

Apndice A

Comparacin de funciones de la aplicacin en tiempo de ejecucin con FileMaker Pro

55

Configuracin o preferencias almacenadas del registro


Configuracin del registro de Windows FileMaker Pro almacena la configuracin del registro en
HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\.0

FileMaker Pro Advanced almacena la configuracin del registro en


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

La aplicacin en tiempo de ejecucin almacena su configuracin del registro en


HKEY_CURRENT_USER\Software\FileMaker\<nombre de solucin>\0,0

Nota La extensin de nombre de archivo del archivo de base de datos en tiempo de ejecucin 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 aplicacin en tiempo de ejecucin almacena sus preferencias en el archivo Prefs de <Nombre de solucin>, dentro de la carpeta Preferencias de FileMaker.

56

Gua de desarrollo de FileMaker Pro Advanced

ndice
A
Abrir archivo, paso de guin 54 abrir archivos de aplicaciones en tiempo de ejecucin 47 Abrir paso de guin Definir referencias de archivo. Consulte Abrir paso de guin Gestionar base de datos Abrir paso de guin Gestionar base de datos 54 Abrir paso de guin Gestionar guiones 54 Abrir paso de guin Gestionar lista de valores 54 Abrir remoto, paso de guin 54 Acceso de administrador eliminar de archivos 10 quitar de las soluciones de quiosco 18 accesos directos de teclado en elementos de men personalizados 23 accesos directos, teclado Consulte Accesos directos de teclado activadores de guin, depuracin 30 actualizaciones de las soluciones de tiempo de ejecucin 16 plug-ins 35 actualizar de bases de datos en tiempo de ejecucin 11 aplicaciones en tiempo de ejecucin activar plug-ins en 47 comandos de men disponibles 49 comparadas con FileMaker Pro 47 configuracin almacenada del registro de Windows 55 icono 13 pasos de guin ignorados 54 preferencias de MacOSX almacenadas 55 Apple Xcode 36 archivo de configuracin 10 archivo de la solucin icono 13 problemas con el icono de doble clic 13 archivo primario actualizar 16 conexin de archivos auxiliares 11 especificar 9 archivos actualizar 10 convertir 11 eliminar Acceso de administrador 10 renombrar 9 tiempo de ejecucin de compresin 15 archivos auxiliares actualizar 17 problemas con el icono de doble clic 13 asistente de nueva presentacin/informe 25, 26 atributos de los temas de presentacin 25 autenticar guiones 30 automatizacin OLE en aplicaciones en tiempo de ejecucin 47 Ayuda comandos de men disponibles en aplicaciones en tiempo de ejecucin 53

C
C/C++ 35 clculos avanzado 31 uso de funciones externas 35 campos copiar esquema 19 supervisin 31 Caracteres ASCII en ID de plug-ins 42 Carpeta Extensions, usuario ubicacin de los plug-ins 37 Carpeta Project 9, 13 clave de enlace acerca de 12 actualizar soluciones de bases de datos en tiempo de ejecucin 16 claves de acceso, mens personalizados 23 cdigos de error, ver desde el Depurador de guiones 29 colores, temas de presentacin 25 comandos de men disponibles en aplicaciones en tiempo de ejecucin 49 comandos del men Archivo disponibles en las aplicaciones en tiempo de ejecucin 49 comandos del men Editar disponibles en las aplicaciones en tiempo de ejecucin 50 comandos del men Formato disponibles en las aplicaciones en tiempo de ejecucin 51 comandos del men Insertar disponibles en las aplicaciones en tiempo de ejecucin 51 comandos del men Peticiones disponibles en las aplicaciones en tiempo de ejecucin 52 comandos del men Registros disponibles en las aplicaciones en tiempo de ejecucin 51 comandos del men Ventana disponibles en las aplicaciones en tiempo de ejecucin 52 comandos del men Vista disponibles en las

58

Gua de desarrollo de FileMaker Pro Advanced

aplicaciones en tiempo de ejecucin 50 comandos del modo Presentacin no disponibles en aplicaciones en tiempo de ejecucin 47 comandos, men disponibles en aplicaciones en tiempo de ejecucin 49 configurar plug-ins 38, 42 conjuntos de mens, creacin 24 contraseas, advertencia requerida en la presentacin "Acerca de" 7 contrato de licencia 6 convertir archivos de versiones anteriores 11 copiar esquemas de campo o de tabla 19 copias de seguridad 16 crear documentos informes de diseo de base de datos 33 soluciones en tiempo de ejecucin 15 cuentas y privilegios 7, 19 eliminar Acceso de administrador 10 para el modo Quiosco 17

estructura de carpetas plug-in de ejemplo 36 solucin 13 estructura, base de datos 33 eventos Apple en aplicaciones en tiempo de ejecucin 47 expresiones, supervisar 31 Extensible Markup Language (XML, Lenguaje extensible de marcas). Consulte XML extensin de nombre de archivo .fth 25 extensin fmplugin 37 extensin fmx 37 extensiones de nombres de archivo para archivos de base de datos para soluciones en tiempo de ejecucin 12 plug-ins 37 temas de presentacin 25 extensiones, nombre de archivo. Consulte extensiones de nombres de archivo

F
FileMaker Developer. Consulte FileMaker Pro Advanced FileMaker Pro Advanced actualizacin desde versiones anteriores 11 contrato de licencia 6 FileMaker Pro Advanced 5 FileMaker Pro, mens disponibles 49 FileMaker Server 15, 35, 47 formato HTML para informes de diseo de base de datos 33 frmulas para funciones personalizadas 20 supervisin 31 fuentes No se encuentra en el sistema del usuario 14 temas de presentacin 25 fuentes de datos actualizacin automtica 10 actualizar 16 funcin Do_PluginInit 43 funciones externas 35 personalizar 20 supervisar en frmulas 32 funciones externas 35 funciones personalizadas, crear 20

D
DDR. Consulte informes de diseo de base de datos de temas Consulte temas de presentacin Depurador de guiones 29 con activadores de guin 30 depurar guiones 29 desactivar pasos de guin 30 desbloquear guiones 30 distribuir soluciones de bases de datos en tiempo de ejecucin acerca de 13 distribuir actualizaciones 16 trminos y condiciones 6 documentacin electrnica 6 Documentacin en PDF 6 Dynamic Link Library (DLL) 13

E
editores de texto 25 elementos de temas de presentacin 27 enlazar soluciones en tiempo de ejecucin 12 esquemas de base de datos 33 copiar o importar 19 esquemas, base de datos copiar o importar 19 crear documentos 33 estadsticas de base de datos 33 estadsticas, base de datos 33 estructura de base de datos, recrear 33

G
Gestionar guiones 30 guiones

|
autenticacin 30 depurar 29 desactivar pasos de guin 30 desbloqueo 30 pasos ignorados por las aplicaciones en tiempo de ejecucin 54

ndice

59

I
iconos de soluciones en tiempo de ejecucin 13 informes de diseo de base de datos 33 informes, base de datos 33 iniciar soluciones en tiempo de ejecucin 13 InstallShield 14 instrucciones de instalacin 5 interaccin de los usuarios con la solucin de base de datos 11 Internet aplicaciones en tiempo de ejecucin en 47 bases de datos en 6

crear 22 ejemplo 21 elementos de men 22 Microsoft Visual Studio 36 Microsoft Windows configuracin del registro almacenada 55 MindVision Installer VISE 14

N
nombrar soluciones de base de datos en tiempo de ejecucin 12 nuevas funciones 5

O
ODBC, FileMaker como fuente de datos 6 Opciones de archivo disponibles en aplicaciones en tiempo de ejecucin 48

P
pantalla de presentacin en soluciones de tiempo de ejecucin cerrar 12 inicio 11 pantalla tctil 17 Paso de guin Abrir Ayuda 54 Paso de guin Abrir Compartir 54 Paso de guin Abrir Opciones de archivo 54 Paso de guin Ejecutar SQL 54 Paso de guin Establecer multiusuario 54 Paso de guin Guardar registros como PDF 54 Paso de guin Nuevo archivo 54 patrones, temas de presentacin 25 plug-in FMExample 38 plug-ins configurar 38, 42, 44 conflictos de ID de recursos (Mac OS X) 45 en aplicaciones en tiempo de ejecucin 47 ID 42 instalar 37 instalar plug-ins de publicacin en la Web 37 prefijo de nombres de funciones 42 preparar 35 proyecto de ejemplo 35 registrar en Apple 42 sintaxis obligatoria de la cadena de opciones 42 plug-ins de funciones externas 35 activar 37 en aplicaciones en tiempo de ejecucin 47 ID de plug-in 42 mensajes enviados por FileMaker Pro 42 preferencias disponibles en la aplicacin en tiempo

J
JDBC, FileMaker como fuente de datos 6

L
Logfile.txt 10 logotipo, aadir a la solucin en tiempo de ejecucin 12

M
Mac OS X conflictos de recursos 45 paquete de aplicacin en tiempo de ejecucin 14 preferencias 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 Funcin externa enviado a los plugins 44 mensaje de GetString enviado a los plug-ins 45 mensaje de Inicializacin enviado a los plug-ins 43 mensaje de Preferencias enviado a los plug-ins 44 mensajes enviados a plug-ins de funciones externas 42 registro de errores 10 men Guiones comandos disponibles en aplicaciones en tiempo de ejecucin 52 mens personalizados accesos directos de teclado 23 acerca de 20 conjuntos de mens 24

60

Gua de desarrollo de FileMaker Pro Advanced

de ejecucin 48 Presentacin "Acerca de" 6 contenido requerido de 7 Presentacin de ayuda 15 privilegios de acceso 7, 19 probar guiones 29 soluciones de bases de datos 15 programas de instalacin de bases de datos en tiempo de ejecucin 14

T
tablas, base de datos copiar o importar esquema 19 excluir del informe de diseo de base de datos 33 varias por archivos 11 temas de presentacin, creacin 25 tutorial, FileMaker Pro 6

U
usuarios de navegadores Web 6 utilidades de compresin para bases de datos en tiempo de ejecucin 15 Utilidades de Creador acerca de 9 creacin de soluciones en tiempo de ejecucin 10

R
recuperar archivos daados en tiempo de ejecucin 15 redes compartir soluciones en 15 referencias de archivo Consulte fuentes de datos registrar plug-in de ID 42 registro de errores 10 registro, configuracin almacenada 55 renombrar archivos 9 requisitos legales 6 resolucin de problemas clculos 31 campos 31 Depurador de guiones 29 usar informes de diseo de base de datos 33 variables 31 retraso, pantalla 12

V
variables, supervisar 31 varias tablas por archivo de base de datos 11 Visor de datos 31 Pestaa Actual 31 Pestaa Control 31 visor Web 15

W
Windows paquete de aplicacin en tiempo de ejecucin 14

X 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 ejecucin actualizar 11, 16 convertir 11 crear 9, 10 crear documentos 13 enlazar archivos 12 iniciar 13 preparar archivos 10 recuperar archivos daados 15 requisitos de presentaciones "Acerca de" 7, 15 soluciones de bases de datos en tiempo de ejecucin, documentacin 14 Soluciones de quiosco, creacin 17 soluciones multiplataforma 12 Submen Gestionar, no disponibles en aplicaciones en tiempo de ejecucin 47 XML documentos para temas de presentacin 25 editores 25 especificacin XML 1.0 27 formato para informes de diseo de base de datos 33 gramtica de salida para DDR 6 instruccin de procesamiento del documento XML 27