Trabajar con frmulas y funciones

Una frmula calcula un nico valor, basndose en las constantes (como 1,07 u hola), los operadores (como + o >) y las referencias de campos (como Subtotal o TotalFactura) que introduzca. Por ejemplo, si el impuesto sobre las ventas correspondiente es del 7% y tiene un campo llamado Subtotal, puede crear un campo llamado TotalFactura que obtenga el valor de la frmula Subtotal * 1,07. Para las frmulas utilizadas con mayor frecuencia, FileMaker Pro les asigna un nombre y define exactamente cmo se deben utilizar. Una frmula predefinida y con nombre se llama funcin. Por ejemplo, si desea obtener la media de algunas calificaciones, podra introducir su propia frmula para sumarlas todas y dividirlas por el nmero total de calificaciones. Sin embargo, un mtodo ms sencillo es emplear la funcin denominada Average y seguir las reglas definidas para su uso. Notas acerca de las funciones Una funcin es una frmula predefinida y con nombre que ejecuta un clculo especfico y devuelve un valor nico y especfico. La mayora de las funciones tienen tres partes bsicas: la funcin un conjunto de parntesis, si la funcin usa parmetros los parmetros requeridos por la funcin Cada funcin devuelve un resultado del tipo de campo texto, numrico, fecha, hora, timestamp o contenedor. Parmetros Los parmetros de las funciones pueden ser constantes (como 1,07 u hola), referencias de campos (como TotalFactura), expresiones (como 1 + 12) y otras funciones (como la funcin NPV). Puede utilizar espacios antes o despus de los parntesis de los parmetros, pero no son necesarios. Si una funcin requiere ms de un parmetro, separe cada parmetro con un separador de listas, como un punto y coma. Importante Para obtener ms informacin sobre los parmetros de texto literales, consulte Funciones de diseo. Los parmetros opcionales se escriben entre llaves ({ }) (por ejemplo, la funcin Case y la funcin Choose). Los puntos suspensivos (...) significan que puede aadir ms parmetros, separados por punto y coma (por ejemplo, en funciones de agregacin). Las comillas dobles (" ") indican cadenas de texto. Esta tabla muestra ejemplos de algunas funciones de FileMaker Pro. Esta funcin Length(John) Round(ImpuestoVentas,2) Position(Nombre, Devuelve 4, el nmero de caracteres del texto John Importe del impuesto sobre las ventas redondeado con dos decimales Un nmero que representa la posicin inicial de una cadena de

Mc,1,1)

texto dentro de otra, en este caso indicando la posicin de la primera aparicin de Mc en el campo Nombre Get ( LastError ) Un nmero que representa al error (si hubiera alguno) en el paso de guin ejecutado ms recientemente en el guin que se est ejecutando en esos momentos Sum(PrecioAmpliado) Total de todos los valores del campo repetido PrecioAmpliado Para obtener ms informacin acerca de dnde se pueden utilizar las funciones, consulte Notas acerca de las frmulas.

Notas acerca de las frmulas Las frmulas ejecutan operaciones especficas sobre uno o varios valores de un archivo de base de datos y devuelven un resultado nico. Las frmulas se pueden usar para definir: un campo de clculo. Consulte Definir campos de clculo. un valor calculado para una entrada automtica en un campo. Consulte Definir la entrada de datos automtica. un clculo que se evale en verdadero o falso para la validacin de datos. Consulte Definir la validacin de campos. un valor calculado que se puede usar para reemplazar los valores de un campo (usando el comando Reemplazar contenido del campo en el men Registros o en un paso de men). Consulte Reemplazar el contenido de un campo. clculos en algunos pasos de guin de FileMaker, como los pasos de guin If, ExitLoopIf, Establecer campo, Insertar resultado calculado y Reemplazar contenido del campo. Consulte Crear guiones para automatizar tareas. ttulos de mens personalizados y elementos de men en FileMaker Pro Advanced. Consulte Definir mens personalizados (FileMaker Pro Advanced). Las frmulas pueden contener: constantes: nmeros, texto o valores de fecha o de hora que no cambian. operadores: smbolos que indican cmo combinar o comparar dos o ms valores. funciones: frmulas con nombre y predefinidas que ejecutan clculos especficos y que devuelven valores nicos y especficos para cada repeticin. referencias de campos: campos de la misma tabla o de tablas relacionadas. La sintaxis de un campo relacionado referenciado en un clculo es nombreTabla::campo relacionado. Consulte Trabajar con tablas y archivos relacionados. Ejemplos de frmulas Nombre & & Apellido devuelve el nombre y el apellido separados por un espacio. Por ejemplo, Michelle Cannon. Subtotal * ,08 devuelve el valor del campo Subtotal multiplicado por ,08. Usar operadores en frmulas Un operador es un smbolo o una instruccin que manipula las expresiones de una frmula. Por ejemplo, el operador ms (+) indica a FileMaker Pro que sume una expresin a otra. FileMaker Pro tiene cuatro tipos de operadores:

Operadores matemticos: (, ), +, -, /, *, ^ Operadores de comparacin: =, , >, < , , Tambin puede utilizar <> para No igual a (), >= para Mayor o igual que () y <= para Menor o igual que (). Operadores lgicos: AND, OR, NOT, XOR Operadores de texto: &, " ", \, , /* */, //, ${ } Nota Para obtener ms informacin sobre el uso de variables en frmulas, consulte Usar variables.

Identificar constantes de texto y caracteres especiales en frmulas Use las comillas de apertura y de cierre para indicar el comienzo y el fin de las constantes de texto. Las comillas sin texto entre ellas indican un valor vaco (sin texto). Utilice barras invertidas para mantener los caracteres de operador espaciales, como las dobles comillas o los caracteres de retorno de carro, simplemente como caracteres dentro de una cadena (en lugar de usarse como operadores). Ejemplo "\"Fred " & "y Jane\"" devuelve Fred y Jane.

Aadir una nueva lnea a los resultados de una frmula Puede formatear los resultados de una frmula insertando un retorno de carro en el clculo. Para aadir una nueva lnea a los resultados de una frmula: 1.Con la base de datos abierta, seleccione el men Archivo > Gestionar > Base de datos. 2.En el cuadro de dilogo Gestionar base de datos, haga clic en la pestaa Campos. 3.Si la base de datos contiene varias tablas, seleccione la adecuada en la lista Tabla. En la pestaa Campos del cuadro de dilogo Gestionar base de datos, seleccione el campo 4.de clculo y haga clic en Opciones. En el cuadro de dilogo Especificar clculo, haga clic para insertar el cursor en el lugar 5.donde desee que se aada una lnea. 6.Haga clic en el botn (operador de retorno de carro) para insertar un salto de lnea. Para obtener informacin sobre el cuadro de dilogo, consulte Definir campos de clculo. 7.Haga clic en Aceptar. Nota Escriba \ (barra invertida seguida de un operador de retorno de carro) para introducir un smbolo de retorno de carro (prrafo) en lugar de un salto de lnea. Ejemplos Campo1 & & Campo2 devuelve: Fred Jane si Campo1 contiene Fred y Campo2 contiene Jane. "Fred Jane" devuelve: Fred Jane

Aadir comentarios a una frmula En el caso de las frmulas ms complejas o utilizadas con menor frecuencia, puede aadir comentarios para explicar los detalles. Utilice comentarios con el estilo de C o de C++, que puede introducir en cualquier lugar de la frmula. Los comentarios con el estilo de C comienzan con los caracteres /* y acaban con la primera aparicin de los caracteres */. El texto explicativo aparece entre los dos caracteres de asterisco. Los comentarios pueden comenzar en una lnea y finalizar varias lneas despus. Puede anidar comentarios con el estilo de C. Los comentarios con el estilo de C++ comienzan con los caracteres // y acaban al final de la lnea. Para aadir comentarios a una frmula: 1.Con la base de datos abierta, seleccione el men Archivo > Gestionar > Base de datos. 2.En el cuadro de dilogo Gestionar base de datos, haga clic en la pestaa Campos. 3.Si la base de datos contiene varias tablas, seleccione la adecuada en la lista Tabla. En la pestaa Campos del cuadro de dilogo Gestionar base de datos, seleccione el campo 4.de clculo y haga clic en Opciones. 5.En el cuadro de dilogo Especificar clculo, introduzca los comentarios. Para obtener informacin sobre el cuadro de dilogo, consulte Definir campos de clculo. 6.Haga clic en Aceptar. Ejemplo con el estilo de C Todo lo que se muestra a continuacin se puede introducir en una frmula: /* ste es un clculo con el estilo de C anidado y comentarios en varias lneas /*----- Devuelve el tratamiento si existe en un nombre -----*/ */ Case( PatternCount("SrSraSrta", LeftWords(Nombre, 1)), /* devuelve verdadero si la primera palabra del campo Nombre coincide con cualquiera de los tratamientos Sr., Sra. o Srta.*/ LeftWords(Nombre, 1) /*extrae el tratamiento */ ) Ejemplo con el estilo de C++ "" & Saludo & "!!" // devuelve Hola!! si el campo Saludo contiene la cadena "Hola"

Uso de palabras reservadas o smbolos en nombres de campo o tabla FileMaker Pro se reserva el uso de las siguientes palabras y smbolos: Los nombres de las funciones que no tienen argumentos como Pi o Random. Los parmetros predefinidos de algunas funciones como los guiones de fuente Roman y Greek para la funcin TextFont. Algunas palabras claves y smbolos. Consulte Asignar nombres a los campos para conocer algunas directrices. Evite utilizar estas palabras y estos smbolos en los nombres de campos y tablas, porque resulta complicado referirse a esos nombres en los clculos.

Si uno de los nombres de campos o tablas es una palabra reservada o contiene un smbolo reservado, debe escribir el nombre dentro de los caracteres ${ } cuando aparece en una funcin. Consejo Cuando haga doble clic para elegir un campo para un clculo, FileMaker Pro escribir automticamente los nombres de los campos que sean palabras reservadas o que contengan smbolos reservados dentro de los caracteres ${ }. Ejemplos ${A + B} devuelve el contenido de un campo llamado A + B. ${.123} devuelve el contenido de un campo llamado .123. ${Pi} devuelve el contenido de un campo llamado Pi. Nota Durante la conversin de archivos, FileMaker Pro utiliza los caracteres ${ } para escribir dentro de ellos los nombres de campos que entren en conflicto con palabras reservadas y smbolos.

Obtener el contenido de una repeticin en un campo repetido Para buscar el contenido de una determinada repeticin en un campo repetido, use la funcin GetRepetition (consulte funcin GetRepetition) o use los corchetes [ ] como operadores de matriz (consulte ms abajo). Formato campoRepetido[nmero] Parmetros campoRepetido: cualquier campo repetido. nmero: el nmero de repeticin del campo Tipo de datos devuelto texto, nmero, fecha, hora, timestamp, contenedor Descripcin Devuelve el contenido del campo repetido especificado por nmero. Ejemplos OfertasParcelas es un campo definido para repetirse con diez valores y contiene los valores 2500, 1200 y 1500. OfertasParcelas[2] devuelve 1200. OfertasParcelas[5] no devuelve nada.

Referencia de funciones (lista de categoras)

Funciones de agregacin
Las funciones de agregacin realizan anlisis estadsticos sobre nmeros (y tambin sobre fechas u horas para algunas funciones) en: varioscampos de un registro. campos relacionados tanto si se muestran en un portal como si no. campos repetidos. Por ejemplo, puede utilizar la funcin Sum para sumar los valores que aparecen en un portal, como alternativa a la creacin de un informe con datos agrupados y subtotales. Los valores del parmetro pueden incluir una constante numrica (por ejemplo, 10) o cualquier expresin vlida. Un parmetro constante en una frmula para un campo repetido afecta al resultado de cada repeticin. Si los parmetros de campo repetido (campo1; campo2;...) incluyen un campo no repetido, dicho valor se utiliza en el resultado slo para la primera repeticin a menos que utilice la funcin Extend. Los valores en repeticiones que superen el nmero de repeticiones del campo calculado se ignoran. Por ejemplo, un campo calculado con tres repeticiones slo guarda tres resultados, aunque un campo referenciado en el clculo tuviera cinco repeticiones. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Average Count List Max

Devuelve La media de todos los valores vlidos y que no estn en blanco del campo especificado. El nmero de valores vlidos y que no estn en blanco del campo especificado. La concatenacin de todos los valores que no estn en blanco en un formulario de lista, separados por retornos de carro. El valor vlido ms alto de uno o varios campos.

Min

El valor vlido y que no est en blanco ms bajo de uno o varios campos.

StDev StDevP

La desviacin tpica de una serie de valores vlidos que no estn en blanco de uno o varios campos. La desviacin tpica de una poblacin representada por una serie de valores vlidos que no estn en blanco de uno o varios campos.

Sum Variance VarianceP

El total de todos los valores vlidos que no estn en blanco de los campos especificados. La varianza de una serie de valores vlidos que no estn en blanco de uno o varios campos. La varianza de una poblacin de una serie de valores vlidos que no estn en blanco de uno o varios campos.

Funciones de fecha Las funciones de fecha calculan fechas y manipulan informaciones de fechas. Importante Para evitar errores al usar fechas, utilice siempre el formato de cuatro dgitos para los aos. Si desea obtener ms informacin sobre cmo maneja FileMaker Pro las fechas de dos dgitos, consulte Conversin de fechas con aos de dos dgitos. Nota Los formatos de sistema afectan al modo en que se muestran las fechas. Consulte Abrir archivos con formatos ajenos al sistema. Consejo Puede utilizar cero (0) y nmeros negativos como argumentos de funcin de Date. Por ejemplo, la siguiente frmula devuelve 31/5/2010: Date (6; 0; 2010 ) Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Date Day DayName DayNameJ DayOfWeek DayOfYear Devuelve La fecha de calendario para el mes, da y ao especificados. Nmero comprendido entre 1 y 31 que representa el da del mes para una fecha especificada. Cadena de texto que es el nombre completo del da de la semana de la fecha especificada. Cadena de texto que es el nombre completo del da de la semana de la fecha especificada en japons. Nmero que representa el da de la semana en que cae la fecha especificada. Nmero igual al nmero de das desde el principio del ao de la fecha especificada.

Month

Nmero comprendido entre 1 y 12 que representa el nmero del mes del ao de la fecha especificada. MonthName Nombre del mes para la fecha especificada. MonthNameJ Nombre del mes en japons para la fecha especificada. WeekOfYear Nmero de semanas despus del 1 de enero del ao de la fecha especificada. WeekOfYearFiscal Nmero comprendido entre 1 y 53 que representa la semana que contiene a una fecha especificada, en funcin del da inicial especificado. Year Nmero que representa el ao de la fecha especificada. YearName Nombre del ao en japons de la fecha especificada, proporcionado en el formato especificado. Funciones de diseo Las funciones de diseo devuelven informacin sobre la estructura de archivos de bases de datos abiertos. Por ejemplo, puede determinar los nombres de todas las presentaciones o los campos de un archivo de base de datos abierto. Nota FileMaker Pro limita la informacin devuelta por las funciones de diseo, en funcin del conjunto de privilegios en vigor cuando la funcin evala un archivo de base de datos. Consulte Crear y gestionar conjuntos de privilegios para obtener ms informacin sobre la concesin de acceso a archivos de bases de datos. Los parmetros de las funciones de diseo pueden ser los siguientes: nombres de archivo como "Cliente" o texto literal como "Jack" presentaciones como nombrePresentacin otras funciones como Left ( texto ; nmeroDeCaracteres ) Importante Los parmetros de texto literales como nombres de archivos y nombres de presentaciones deben ir entre comillas. Utilice las comillas en los nombres de campos para indicar que la cadena literal es el parmetro (omita las comillas para indicar que el valor almacenado en el campo es el parmetro). Puede utilizar espacios antes o despus de los parntesis de los parmetros, pero no son necesarios. Utilice un punto y coma entre los parmetros si una funcin precisa ms de uno. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin DatabaseNames Devuelve Una lista de los nombres de todos los archivos de base de datos abiertos en el ordenador (incluidos los archivos abiertos como cliente), separados por retornos de carro. La ubicacin de cada lado del campo especificado y su rotacin en grados. El comentario del campo especificado. Una lista de todos los ID de campo del archivo de base de datos y la presentacin especificados, separados por retornos de carro.

FieldBounds FieldComment FieldIDs

FieldNames

Una lista de los nombres de todos los campos de la presentacin especificada, separados por retornos de carro. FieldRepetitions El nmero de repeticiones del campo especificado tal como se formate en la presentacin especificada (que puede ser diferente del nmero de repeticiones especificado cuando se defini el campo) y la orientacin de las repeticiones de campos (horizontal o vertical) en la presentacin. FieldStyle El formato aplicado al campo especificado de la presentacin especificada. FieldType Informacin sobre el campo especificado. GetNextSerialValue El siguiente nmero de serie para el campo especificado del archivo de base de datos especificado. LayoutIDs Una lista de todos los ID de presentacin del archivo de base de datos especificado, separados por retornos de carro. LayoutNames Una lista de los nombres de todas las presentaciones del archivo de base de datos especificado, separados por retornos de carro. LayoutObjectNames Una lista de los nombres de todos los objetos con nombre de la presentacin, separados por retornos de carro. RelationInfo Una lista de cuatro valores para cada relacin directamente relacionada con la tabla especificada. ScriptIDs Una lista de todos los ID de guin del archivo de base de datos especificado, separados por retornos de carro. ScriptNames Una lista de los nombres de todos los guiones del archivo de base de datos especificado, separados por retornos de carro. TableIDs Una lista de todos los ID de tabla del archivo de base de datos especificado, separados por retornos de carro. TableNames Una lista de los nombres de todas las tablas definidas en el archivo de base de datos especificado, separados por retornos de carro. ValueListIDs Una lista de todos los ID de la lista de valores del archivo de base de datos especificado, separados por retornos de carro. ValueListItems Una lista de los valores de la lista de valores especificada, separados por retornos de carro. ValueListNames Una lista de los nombres de todas las listas de valores del archivo de base de datos especificado, separados por retornos de carro. WindowNames Una lista de los nombres de las ventanas abiertas en el archivo de base de datos especificado. Funciones externas Utilice las funciones externas para acceder a los plug-ins de FileMaker Pro. Los plug-ins aaden funciones a FileMaker Pro. Para obtener ms informacin, consulte Configurar preferencias de plug-ins.

Las funciones externas slo estn disponibles si los plug-ins de FileMaker Pro estn instalados y activados en su equipo. Si no est instalado ningn plug-in de FileMaker Pro, slo ver la definicin de funcin externa genrica en el cuadro de dilogo Especificar clculo: External (nombreDeFuncin; parmetro) Plug-in escritos para la versin 7.0 y posterior Cada plug-in define sus propias funciones y parmetros. Consulte la documentacin suministrada con el plug-in para conocer el uso de cada funcin. Plug-in escritos para la versin 6.0 y anteriores Estos plug-in siguen siendo compatibles y siguen utilizando la funcin External para acceder a las funciones del plug-in. El primer parmetro es el nombre de la funcin del plug-in que se va a ejecutar y el segundo es un parmetro que se transfiere a dicha funcin. Consulte la documentacin suministrada con el plug-in para conocer el uso de cada funcin. Esta funcin External

Hace lo siguiente Activa el acceso a los plug-in de FileMaker Pro escritos para versiones de FileMaker Pro anteriores a la 7.0. Para obtener ms informacin, consulte Actualizar plug-ins.

Funciones financieras Las funciones financieras calculan informacin financiera como, por ejemplo, el valor neto presente y pagos. Por ejemplo, puede calcular los pagos mensuales requeridos para comprar un coche a una determinada tasa de inters utilizando la funcin PMT. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin FV NPV PMT PV

Devuelve El valor futuro de una inversin inicial, basado en una tasa de inters y una cantidad de pago constantes durante el nmero de perodos en meses. El valor neto presente de una serie de pagos desiguales realizados a intervalos regulares, asumiendo una tasa de inters fija en cada intervalo. El pago requerido exigido por el plazo, la tasa de inters y el principal. El valor presente de una serie de pagos iguales realizados a intervalos regulares (perodos), asumiendo una tasa de inters fija en cada intervalo.

Funciones obtener

Utilice las funciones obtener en guiones para la comprobacin y prevencin de errores o para capturar informacin sobre el estado de un archivo de base de datos, de los elementos que contiene o de una accin que se est llevando a cabo. Muchas funciones Obtener devuelven informacin que se modifica regularmente. Por ejemplo, cuando la funcin Get( CurrentTime ) se sita en un campo de clculo almacenado, la hora slo se actualizar cuando se cree un registro nuevo. Si el clculo tiene otros campos, pero el resultado del clculo sigue devolviendo la hora actual, el resultado del clculo almacenado slo se actualizar cuando los dems campos citados se hayan modificado en el registro actual. Si alguno de estos clculos permanece sin almacenar, la hora se actualizar segn corresponda. Por motivos de rendimiento, no siempre es buena idea hacer que un campo de clculo permanezca sin almacenar. Las funciones Obtener se utilizan mejor en un guin donde la informacin de estado de una funcin Obtener se actualiza en el momento de ejecutar el clculo. Para acceder a la lista de funciones Obtener, en el cuadro de dilogo Especificar clculo, elija en el men emergente Vista: todas las funciones por tipo o Funciones Obtener. Cuando elige Vista: todas las funciones por nombre, slo ver Get (indicador). Nota Para obtener informacin sobre cmo se evalan de forma diferente las funciones en el equipo anfitrin y el cliente, busque en la Knowledge Base de FileMaker que est disponible en www.filemaker.com/kb. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Devuelve Get ( Una lista de palabras clave para los privilegios ampliados AccountExtendedPrivileges ) activados, separadas por retornos de carro. La lista se devuelve de acuerdo con la cuenta que se utiliz para abrir el archivo de base de datos. Get ( AccountName ) El nombre de cuenta autenticado que se est utilizando para el archivo de base de datos activo. Get ( Nombre del conjunto de privilegios que est utilizando la AccountPrivilegeSetName ) cuenta que se ha empleado para abrir el archivo de base de datos. Get ( ActiveFieldContents ) El contenido del campo que tiene el centro de atencin. Get ( ActiveFieldName ) El nombre del campo que tiene el centro de atencin. Get ( ActiveFieldTableName ) El nombre de la tabla que contiene el campo activo (el campo que tiene el centro de atencin). Get ( El nombre del objeto de presentacin activo en la ventana activa de clculo. ActiveLayoutObjectName ) Get ( ActiveModifierKeys ) Un nmero que representa las teclas modificadoras del teclado (como Mays) que se estn pulsando. Get ( El nmero de la fila del portal que tiene el centro de atencin. ActivePortalRowNumber ) Get ( Un nmero que representa la repeticin activa de un ActiveRepetitionNumber ) campo repetido (la repeticin que tiene el centro de atencin).

Get ( ActiveSelectionSize )

Un nmero que representa el nmero de caracteres seleccionados. Get ( ActiveSelectionStart ) Un nmero que representa el carcter inicial del texto seleccionado. Get ( AllowAbortState ) Un valor booleano que representa el estado actual del paso de guin Permitir cancelacin del usuario. Get ( AllowToolbarState ) Un valor booleano que representa si se permite que las barras de herramientas sean visibles. Get ( ApplicationLanguage ) Texto que representa el idioma actual de la aplicacin (por ejemplo, espaol). Get ( ApplicationVersion ) Texto que representa la versin de la aplicacin FileMaker Pro. Get ( Un nmero que representa la repeticin del campo de CalculationRepetitionNumber clculo que se est calculando actualmente. ) Get ( CurrentDate ) La fecha actual de acuerdo con el calendario del sistema. Get ( Una lista de las palabras clave para los privilegios CurrentExtendedPrivileges ) ampliados que estn activados de la cuenta que se est empleado para evaluar el clculo. Get ( CurrentHostTimestamp ) La fecha y hora actuales (al segundo ms prximo) del anfitrin de acuerdo con el reloj del sistema. Get ( Nombre del conjunto de privilegios que se est utilizando para evaluar este clculo en la base de datos. CurrentPrivilegeSetName ) Get ( CurrentTime ) La fecha actual (al segundo ms prximo) de acuerdo con el reloj del sistema. Get ( CurrentTimestamp ) La fecha y hora actuales (al segundo ms prximo) de acuerdo con el reloj del sistema. Get ( CustomMenuSetName ) El nombre del conjunto de mens personalizados activo. Get ( DesktopPath ) La ruta a la carpeta de escritorio del usuario actual. Get ( DocumentsPath ) La ruta a la carpeta Documentos del usuario actual. Get ( DocumentsPathListing ) Una lista de todos los archivos y carpetas de la carpeta Documentos devuelta por la funcin Get (DocumentsPath). Get ( ErrorCaptureState ) Un valor booleano que representa el estado del paso de guin Captura de errores. Get ( FileMakerPath ) La ruta a la carpeta de la copia de FileMaker Pro en ejecucin actualmente. Get ( FileName ) El nombre del archivo de base de datos activo actualmente. Get ( FilePath ) La ruta completa que indica la ubicacin del archivo. Get ( FileSize ) El tamao (en bytes) del archivo de base de datos activo actualmente.

Get ( FoundCount )

Un nmero que representa el nmero de registros en el conjunto encontrado actual. Get ( HighContrastColor ) El nombre del esquema de colores predeterminado de alto contraste actual si est seleccionado Utilizar contraste alto en el cuadro de dilogo Opciones de accesibilidad del sistema operativo Windows. Get ( HighContrastState ) Un valor booleano que representa el estado de la casilla de verificacin Utilizar contraste alto en el cuadro de dilogo Opciones de accesibilidad. Get ( HostApplicationVersion La versin de FileMaker Pro o FileMaker Server que se ) est ejecutando en el equipo que aloja la base de datos actual. Get ( HostIPAddress ) La direccin IP del equipo anfitrin para la base de datos actual. Get ( HostName ) El nombre registrado del ordenador anfitrin del archivo de base de datos. Get ( LastError ) Un nmero que representa el error, si existe, en la ejecucin del ltimo paso de guin ejecutado. Get ( LastMessageChoice ) Un nmero correspondiente al botn pulsado en un mensaje de alerta mostrado por el paso de guin Mostrar cuadro de dilogo personalizado. Get ( LastODBCError ) Una cadena que muestra el estado del error publicado por estndares ODBC, basado en estndares ISO/IEF. Get ( LayoutAccess ) Un nmero que corresponde a los privilegios de acceso de la presentacin asignados a travs del cuadro de dilogo Gestionar seguridad. Get ( LayoutCount ) El nmero total de presentaciones en el archivo de base de datos. Get ( LayoutName ) El nombre de la presentacin mostrada actualmente. Get ( LayoutNumber ) El nmero de la presentacin mostrada actualmente, de acuerdo con la lista del cuadro de dilogo Gestionar presentaciones. Get ( LayoutTableName ) El nombre de la tabla desde la cual muestra registros la presentacin. Get ( LayoutViewState ) Informacin sobre cmo se ve el archivo de base de datos. Get ( MultiUserState ) Nmero que representa el estado actual multiusuario del archivo de base de datos. Get ( NetworkProtocol ) El nombre del protocolo de red que utiliza FileMaker Pro en este equipo. Get ( PageNumber ) Nmero que representa la pgina actual que se est imprimiendo o de la que se est obteniendo una vista previa.

Get ( PreferencesPath ) Get ( PrinterName )

La ruta a la carpeta de preferencias del usuario actual. Una cadena que identifica el nombre de la impresora predeterminada. Get ( QuickFindText ) El texto escrito en el cuadro de Bsqueda rpida. Get ( RecordAccess ) Un nmero que indica los privilegios de acceso del registro actual. Get ( RecordID ) El nmero ID exclusivo del registro actual. Get ( El nmero total de veces que se han realizado cambios en RecordModificationCount ) el registro actual. Get ( RecordNumber ) El nmero del registro actual en el conjunto encontrado actual. Get ( RecordOpenCount ) El nmero total de registros abiertos en el conjunto encontrado actual que no se han guardado an. Get ( RecordOpenState ) Un nmero que representa el estado del registro actual. Get ( RequestCount ) El nmero total de peticiones de bsqueda definidas actualmente para la tabla actual. Get ( RequestOmitState ) Un valor booleano que representa el estado de la casilla de verificacin Omitir en modo Buscar. Get ( ScreenDepth ) El nmero de bits necesarios para representar el color o sombra de grises de un pxel en la pantalla principal. Get ( ScreenHeight ) El nmero de pxeles mostrados verticalmente en la pantalla en la que est abierta la ventana del archivo actual. Get ( ScreenWidth ) El nmero de pxeles mostrados horizontalmente en la pantalla en la que est abierta la ventana del archivo actual. Get ( ScriptName ) El nombre del guin que se est ejecutando (o est en pausa) actualmente. Get ( ScriptParameter ) El parmetro de guin llevado al guin actual. Get ( ScriptResult ) El resultado de guin de un subndice ejecutado. Get ( SortState ) Un nmero booleano que representa el estado de ordenamiento actual. Get ( StatusAreaState ) Un nmero que representa si la barra de herramientas de estado est oculta, visible, visible y bloqueada u oculta y bloqueada.

Get ( SystemDrive )

La letra de unidad (Windows) o el nombre del volumen (Mac OS) en que est ubicado el sistema operativo en ejecucin actualmente.

Get ( SystemIPAddress )

Las direcciones IP de todos los equipos conectados a una tarjeta NIC (Controlador de interfaz de red). Get ( SystemLanguage ) El idioma establecido actualmente en el sistema actual. Get ( SystemNICAddress ) Las direcciones de hardware de todas las tarjetas controladoras de interfaz de red conectadas al equipo. Get ( SystemPlatform ) Un nmero que indica la plataforma actual. Get ( SystemVersion ) La versin del sistema operativo del equipo en el que se ejecuta la funcin. Get ( TemporaryPath ) La ruta a la carpeta temporal del usuario actual utilizada por FileMaker Pro. Get ( TextRulerVisible ) Un valor booleano que representa si la regla de texto es visible o no. Get ( TotalRecordCount ) El nmero total de registros de la tabla actual. Get ( TriggerKeystroke ) Una cadena que contiene los caracteres que activaron un activador de guin OnObjectKeystrokeoOnLayoutKeystroke. Get ( TriggerModifierKeys ) El estado de las teclas modificadoras del teclado tal y como estaban cuando se activ el activador de guin. Get ( UserCount ) El nmero de usuarios que estn accediendo al archivo actualmente. Get ( UserName ) El nombre del usuario de FileMaker Pro, como se especifica en la pestaa General del cuadro de dilogo Preferencias. Get ( UseSystemFormatsState Un valor booleano que representa el estado del comando ) de men Usar formato del sistema. Get ( WindowContentHeight ) Un nmero que representa la altura, en pxeles, del rea de contenido. Get ( WindowContentWidth ) Un nmero que representa la anchura, en pxeles, del rea de contenido. Get ( WindowDesktopHeight Un nmero que representa la altura, en pxeles, del ) espacio de escritorio. Get ( WindowDesktopWidth ) Un nmero que representa la anchura, en pxeles, del espacio de escritorio. Get ( WindowHeight ) Un nmero que representa la altura, en pxeles, de la ventana actual del archivo en el que se define el clculo. Get ( WindowLeft ) Un nmero que representa la distancia horizontal, en pxeles, del borde exterior de la ventana actual en relacin con el borde izquierdo de la pantalla. Get ( WindowMode ) Un nmero que representa si FileMaker Pro se encuentra en modo Visualizar, modo Buscar, modo Vista Previa o imprimiendo cuando se evala la funcin.

Get ( WindowName ) Get ( WindowTop )

Get ( WindowVisible ) Get ( WindowWidth )

Get ( WindowZoomLevel ) Ejemplo de funciones Obtener Este guin utiliza la funcin Get( CurrentDate ) para comprobar cada registro del conjunto encontrado y ver si una cuenta ha vencido. Si una cuenta ha vencido, el guin muestra un mensaje e indica al usuario que haga clic en un botn con las etiquetas Ignorar, Enviar carta o Enviar correo (configurados mediante el paso de guin Mostrar cuadro de dilogo personalizado). El guin captura la respuesta del usuario mediante Get( LastMessageChoice ). A continuacin, basndose en la respuesta del usuario, el guin ejecuta una accin: cancela el resto del guin, imprime una carta de "pago retrasado" o enva un correo electrnico a la cuenta asociada. Ir a la presentacin ["NombrePresentacin"] Ir al registro/peticin/pgina [Primero] Loop If [NombreBaseDeDatos::Fecha<Get ( CurrentDate )-30] Mostrar cuadro de dilogo personalizado ["30 o ms das tarde"] If [Get (LastMessageChoice) = 1] Detenerguin Else If [Get ( LastMessageChoice ) = 2] Ir a la presentacin ["Aviso de retraso"] Imprimir [] Else Enviar correo [Para: DatabaseName::Client; Subject: "Aviso de retraso"; Message: "La cuenta ha vencido."] EndIf EndIf Ir al registro/peticin/pgina [Salir despus del ltimo, Siguiente] EndLoop Ir a la presentacin [presentacin original]

El nombre de la ventana actual del archivo en que se define el clculo. Un nmero que representa la distancia vertical, en pxeles, del borde exterior de la ventana actual en relacin con el borde inferior de la barra de mens. Un valor booleano que representa si la ventana actual est visible o no. Un nmero que representa la anchura, en pxeles, de la ventana actual del archivo en el que se define el clculo. El nivel de ampliacin de la ventana actual.

Funciones lgicas Las funciones lgicas prueban una condicin para evaluarla como verdadera o falsa. Se conocen como valores booleanos. Si la condicin es verdadera, FileMaker Pro devuelve 1;

si la condicin es falsa, FileMaker Pro devuelve 0. Puede utilizar las palabras clave True y False con funciones y operadores lgicos si se necesita un valor booleano. La palabra clave True devuelve 1 y la palabra clave False devuelve 0. Las funciones lgicas tambin pueden evaluar parmetros como texto u operaciones aritmticas que no constituyen secuencias verdaderas o falsas, o en el caso de la funcin GetField, devuelven el contenido de otro campo. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Case Devuelve Uno de varios resultados posibles en funcin de una serie de pruebas. Choose Un valor de resultado, de acuerdo con el valor entero de una prueba especificada. Evaluate Evala la expresin especificada como un clculo. EvaluationError Un cdigo de error, si lo hay, de la expresin especificada. GetAsBoolean 1 si los datos se convierten en un valor numrico distinto de cero; 0 si los datos especficos tienen un valor de 0 o estn vacos. GetField El contenido del campo referenciado. GetFieldName El nombre totalmente calificado de una referencia de campo. GetLayoutObjectAttribute Los atributos del objeto de presentacin solicitado de la ventana activa de clculo. GetNthRecord El contenido del campo de referencia desde el nmero de registro solicitado. If Un resultado de dos posibles, dependiendo del valor de la prueba especificada. IsEmpty 1 si el campo especificado est vaco, si falta un campo relacionado, una tabla relacionada, una relacin o un archivo o si se produce algn otro error. En caso contrario, devuelve 0. IsValid 0 si un registro contiene un valor no vlido porque no coincide un tipo de campo (texto en un campo de fecha, por ejemplo). IsValidExpression 1 si la sintaxis de la expresin especificada es correcta. Let Establece la variable en el resultado del valor mientras dure la expresin especificada. Lookup El valor especificado en el parmetro campoFuente utilizando las relaciones del grfico de relaciones. LookupNext El valor especificado en el parmetro campoFuente utilizando las relaciones del grfico de relaciones. Self El contenido del objeto en el que se ha definido el clculo; en caso contrario, devuelve una cadena vaca.

Funciones numricas Las funciones numricas se utilizan para manipular datos numricos. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Abs Ceiling Combination Div Exp Factorial Floor Int Lg Ln Log Mod Random Round SetPrecision Devuelve El valor absoluto (un nmero positivo) de un nmero. Un nmero redondeado hacia arriba hasta el siguiente entero. El nmero de veces para elegir de forma nica un nmero especificado de elementos desde un conjunto de un tamao especificado. Un entero del nmero especificado dividido por el divisor. El valor de la constante e (la base del logaritmo natural, igual a 2,7182818) elevado a la potencia de un nmero especificado. El factorial de un nmero especificado terminando en 1 o tras un nmero de factores especificado. Un nmero redondeado hacia abajo hasta el siguiente entero inferior. La parte numrica entera del valor que especifique, sin redondeo. El logaritmo en base 2 del nmero especificado, que puede ser cualquier valor positivo. El logaritmo en base e (natural) del nmero especificado. El logaritmo natural (en base 10) del nmero especificado, que puede ser cualquier valor positivo. El resto despus de dividir un nmero especificado por un divisor. Un nmero aleatorio entre cero y uno. Un nmero redondeado con la precisin especificada (nmero de decimales). Cualquier funcin matemtica contenida dentro de la expresin especificada hasta los dgitos de precisin especificados, si la funcin matemtica admite la precisin extendida. Un valor de tres posibles: -1 si el nmero especificado es negativo, 0 si es cero y 1 si es positivo. La raz cuadrada de un nmero. Un nmero truncado hasta la precisin especificada (nmero de decimales), sin tener en cuenta el valor de los dgitos eliminados.

Sign Sqrt Truncate

Funciones de repeticin Las funciones de repeticin realizan clculos sobre campos repetidos. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Extend Devuelve En un clculo que implica tanto campos repetidos como no repetidos,

permite que un valor de un campo no repetido se utilice con cada repeticin de un campo repetido. GetRepetition El contenido de la repeticin especificada de un campo repetido. Last El ltimo valor vlido y que no est en blanco del campo especificado.

Funciones de sumario Las funciones de sumario producen un sumario de todos los registros del conjunto encontrado o valores de subsumario para los registros de grupos diferentes. Las frmulas pueden contener ms de una funcin de sumario. Las funciones de sumario se calculan ms lentamente que otras funciones, pues generan valores para un rango de registros. Una forma alternativa de generar resultados calculados similares es utilizar funciones de agregacin para resumir datos de registros relacionados (tanto si aparecen en un portal como si no). Consulte Funciones de agregacin y la informacin sobre el resumen de datos en portales. Haga clic en el nombre de la funcin para obtener ms informacin. Esta funcin Devuelve GetSummary El valor del campo de sumario para el rango actual de registros cuando el archivo de base de datos est ordenado segn el campo de interrupcin. Funciones de texto Las funciones de texto se pueden utilizar para analizar, reorganizar, extraer y crear cadenas de texto. Por ejemplo, puede utilizar la funcin MiddleWords para extraer determinadas palabras del texto proporcionado. Las funciones de texto operan sobre estos parmetros: campos de tipo texto constantes de texto (entre comillas) expresiones con un resultado de texto Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Char Code Exact Filter Devuelve Devuelve los caracteres para los puntos del cdigo de Unicode nmero. Devuelve los caracteres para los puntos del cdigo de Unicode texto. Si en el texto hay cero caracteres, devuelve 0. 1 (Verdadero) para una coincidencia exacta o 0 (Falso) si coinciden dos cadenas de texto o campos contenedor. Slo los caracteres especificados, en el orden en el que introdujeron originalmente en el texto.

del del no se

FilterValues

Slo los valores especificados, en el orden en el que se introdujeron originalmente en el texto. GetAsCSS El texto especificado, convertido al formato CSS (Hojas de estilo en cascada). GetAsDate Las fechas del texto especificado como tipo de campofecha, para su uso en frmulas que impliquen fechas o funciones de fecha. GetAsNumber Nmeros del texto especificado como tipo de campo nmero, para su uso con frmulas que impliquen nmeros o funciones numricas. GetAsSVG El texto especificado, convertido al formato SVG (Grficos vectoriales escalables). GetAsText El nmero, fecha, hora o timestamp especificados como tipo de campo texto, para su uso en frmulas que impliquen texto o funciones de texto. GetAsTime Horas o marcas de fecha y hora del texto especificado como tipo de campo hora, para su uso con frmulas que impliquen la hora o funciones de fecha y hora. GetAsTimestamp Los datos especificados como tipo de campo fecha y hora, para su uso con frmulas que impliquen marcas de fecha y hora. GetAsURLEncoded El texto especificado, convertido con codificacin URL (UniformResourceLocators, localizador uniforme de recursos). GetValue Un valor especfico de una lista de valores. Hiragana Hiragana convertido desde Katakana (Hankaku y Zenkaku). KanaHankaku Hankaku Katakana convertido desde Zenkaku Katakana. KanaZenkaku Zenkaku Katakana convertido desde Hankaku Katakana. KanjiNumeral Numerales Kanji convertidos desde numerales arbigos. Katakana Zenkaku Katakana convertido desde Hiragana. Left El nmero especificado de caracteres del texto, contando desde la izquierda. LeftValues El nmero especificado de valores del texto, contando desde la izquierda. LeftWords El nmero especificado de palabras del texto, contando desde la izquierda. Length El nmero de caracteres del texto especificado, incluidos todos los espacios, nmeros y caracteres especiales. Lower Todas las letras del texto especificado en minsculas. Middle El nmero especificado de caracteres del texto, comenzando desde una posicin especificada. MiddleValues El nmero especificado de valores del texto, comenzando desde un valor especificado. MiddleWords El nmero especificado de palabras del texto, comenzando desde una palabra especificada.

NumToJText PatternCount Position Proper Quote Replace Right RightValues RightWords RomanHankaku RomanZenkaku SerialIncrement Substitute

Trim TrimAll Upper ValueCount WordCount

Nmeros Roman convertidos desde texto en japons. El nmero de ocurrencias de una cadena de texto en el texto especificado. La aparicin especificada de una cadena de bsqueda, comenzando desde una posicin especificada. La primera letra de cada palabra del texto especificado en maysculas y todas las dems en minsculas. El texto especificado rodeado por comillas ( ). Una nueva cadena de caracteres que consta del texto especificado segn lo modifica el texto de reemplazo tambin especificado. El nmero especificado de caracteres del texto, contando desde la derecha. El nmero especificado de valores del texto, contando desde la derecha. El nmero especificado de palabras del texto, contando desde la derecha. Hankaku (alfanumrico y smbolos) convertido desde Zenkaku (alfanumrico y smbolos). Zenkaku (alfanumrico y smbolos) convertido desde Hankaku (alfanumrico y smbolos). La combinacin de texto y nmeros de un valor especificado, con los nmeros incrementados en la cantidad especificada. Una cadena de texto en la que cada aparicin de una cadena de bsqueda especificada se ha sustituido por una cadena de reemplazo tambin especificada. Texto al que se han eliminado todos los espacios anteriores y posteriores. Texto al que se han eliminado todos los espacios de anchura completa entre caracteres no Roman y Roman. Todas las letras del texto especificado en maysculas. Recuento del nmero total de valores del texto especificado. Recuento del nmero total de palabras del texto especificado.

Funciones de formato de texto Las funciones de formato de texto se pueden utilizar para cambiar el color, la fuente, el tamao y el estilo del texto especificado. Por ejemplo, podra utilizar la funcin TextFont para cambiar la fuente del texto especificado de Arial a Courier. Puede utilizar estas funciones juntas para cambiar la apariencia del texto en sus presentaciones. Las funciones de formato de texto operan sobre estos parmetros: campos de tipo texto

constantes de texto (entre comillas) expresiones con un resultado de texto Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin RGB Devuelve Un nmero obtenido al combinar los valores rojo, verde y azul para representar un color. TextColor El color del texto al color especificado por la funcin RGB. TextColorRemove Texto con los colores de fuente restablecidos al color de fuente predeterminado del campo. TextFont Texto en la fuente y el conjunto de caracteres especificado. TextFontRemove Texto con fuentes restablecidas a la fuente predeterminada del campo. TextFormatRemove Texto con el formato restablecido al formato de texto predeterminado del campo. TextSize Texto en el tamao de fuente especificado. TextSizeRemove Texto con los tamaos de fuente restablecidos al tamao de fuente predeterminado del campo. TextStyleAdd Texto con los estilos especificados aadidos en una nica accin. TextStyleRemove Texto con los estilos especificados eliminados en una nica accin.

Funciones de hora Las funciones de hora calculan horas y manipulan la informacin horaria. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Hour Minute Seconds Time

Devuelve Un nmero que representa el nmero de horas de un valor de hora. Un nmero que representa el nmero de minutos de un valor de hora. Un nmero que representa el nmero de segundos de un valor de hora. Un resultado de hora con el nmero especificado de horas, minutos y segundos.

Funciones de fecha y hora Las marcas de fecha y hora se utilizan para muchas finalidades de sincronizacin, como marcar la fecha y hora exactas en la que se ha producido un determinado evento.

Esta funcin Timestamp

Devuelve Una marca de fecha y hora que contiene una fecha del calendario y una hora del da.

Funciones trigonomtricas Las funciones trigonomtricas se utilizan para calcular grados, ngulos y otros datos geomtricos. Nota Todas las funciones trigonomtricas utilizan radianes como unidad de medida. Una vez que tenga un resultado, puede convertir los radianes en grados mediante la funcin Degrees. Haga clic en un nombre de funcin para obtener ms informacin. Esta funcin Acos Asin Atan Cos Degrees Pi Radians Sin Tan Devuelve El arcoseno o coseno invertido de un nmero. El arcoseno o seno invertido de un nmero. El arcotangente trigonomtrico o tangente inversa de un nmero. El coseno del ngulo especificado. Grados, convertidos desde los radianes especificados. El valor de la constante Pi, que es aproximadamente 3,14159. Radianes, convertidos desde los grados especificados. El seno del ngulo especificado. La tangente del ngulo especificado.