Inicio > Referencia > Referencia de funciones > Funciones Get

Funciones Get

Utilice las funciones Get en guiones para la comprobación y prevención de errores o para capturar información sobre el estado de un archivo de base de datos, de los elementos que contiene o de una acción que se está llevando a cabo.

Muchas funciones Obtener devuelven información que se modifica regularmente. Por ejemplo, cuando la función Obtener ( CurrentTime ) se sitúa en un campo de cálculo almacenado, la hora sólo se actualizará cuando se cree un registro nuevo. Si el cálculo tiene otros campos, pero el resultado del cálculo sigue devolviendo la hora actual, el resultado del cálculo almacenado sólo se actualizará cuando los demás campos citados se hayan modificado en el registro actual. Si alguno de estos cálculos permanece sin almacenar, la hora se actualizará según corresponda. Por motivos de rendimiento, no siempre es buena idea hacer que un campo de cálculo permanezca sin almacenar. Las funciones Obtener se utilizan mejor en un guión donde la información de estado de una función Obtener se actualiza en el momento de ejecutar el cálculo.

Para acceder a la lista de funciones Obtener, en el cuadro de diálogo Especificar cálculo, elija en el menú emergente Vista: todas las funciones por tipo o Funciones Obtener. Cuando elige Vista: todas las funciones por nombre, sólo verá Get ( indicador ).

Nota  Para obtener información sobre cómo se evalúan de forma diferente las funciones en el equipo anfitrión y el cliente, busque en la Knowledge Base de FileMaker, que está disponible en http://filemaker-es.custhelp.com.

Haga clic en un nombre de función para obtener más información.

 

Esta función	Devuelve
Get ( AccountExtendedPrivileges )	Una lista de palabras clave para los privilegios ampliados activados, separadas por retornos de carro. La lista devuelta se basa en la cuenta utilizada para abrir el archivo de la base de datos.
Get ( AccountName )	El nombre de cuenta autenticado que se está utilizando para el archivo de base de datos activo.
Get ( AccountPrivilegeSetName )	Nombre del conjunto de privilegios que está utilizando la cuenta que se ha empleado para abrir el archivo de base de datos.
Get ( ActiveFieldContents )	El contenido del campo que tiene el centro de atención.
Get ( ActiveFieldName )	El nombre del campo que tiene el centro de atención.
Get ( ActiveFieldTableName )	El nombre de la tabla que contiene el campo activo (el campo que tiene el centro de atención).
Get ( ActiveLayoutObjectName )	El nombre del objeto de presentación activo en la ventana activa de cálculo.
Get ( ActiveModifierKeys )	Un número que representa las teclas modificadoras del teclado (como Mayús) que se están pulsando.
Get ( ActivePortalRowNumber )	El número de la fila del portal que tiene el centro de atención.
Get ( ActiveRepetitionNumber )	Un número que representa la repetición activa de un campo repetido (la repetición que tiene el centro de atención).
Get ( ActiveSelectionSize )	Un número que representa el número de caracteres seleccionados.
Get ( ActiveSelectionStart )	Un número que representa el carácter inicial del texto seleccionado.
Get ( AllowAbortState )	Un valor booleano que representa el estado actual del paso de guión Permitir cancelación del usuario.
Get ( AllowFormattingBarState )	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 aplicación (por ejemplo, español).
Get ( ApplicationVersion )	Texto que representa la versión de la aplicación FileMaker.
Get ( CalculationRepetitionNumber )	Un número que representa la repetición del campo de cálculo que se está calculando actualmente.
Get ( ConnectionState )	Un número que representa el estado de seguridad de la conexión de red para el archivo actual.
Get ( CurrentDate )	La fecha actual de acuerdo con el calendario del sistema.
Get ( CurrentExtendedPrivileges )	Una lista de las palabras clave para los privilegios ampliados que estén activados de la cuenta que se esté empleado para evaluar el cálculo.
Get ( CurrentHostTimestamp )	La fecha y hora actuales (al segundo más próximo) del host de acuerdo con el reloj del sistema.
Get ( PrivilegeSetName )	Nombre del conjunto de privilegios que se está utilizando para evaluar este cálculo en la base de datos.
Get (CurrentTime )	La fecha actual (al segundo más próximo) de acuerdo con el reloj del sistema.
Get ( CurrentTimestamp )	La fecha y hora actuales (al segundo más próximo) de acuerdo con el reloj del sistema.
Get ( CustomMenuSetName )	El nombre del conjunto de menús 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 función Get (DocumentsPath).
Get ( ErrorCaptureState )	Un valor booleano que representa el estado del paso de guión Captura de errores.
Get ( FileMakerPath )	La ruta a la carpeta de la copia de FileMaker Pro en ejecución actualmente.
Get ( FileName )	El nombre del archivo de base de datos activo actualmente.
Get ( FilePath )	La ruta completa que indica la ubicación del archivo.
Get ( FileSize )	El tamaño (en bytes) del archivo de base de datos activo actualmente.
Get ( FoundCount )	Un número que representa el número 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 diálogo Opciones de accesibilidad del sistema operativo Windows.
Get ( HighContrastState )	Un valor booleano que representa el estado de la casilla de verificación Utilizar contraste alto en el cuadro de diálogo Opciones de accesibilidad.
Get ( HostApplicationVersion )	La versión de FileMaker Pro o FileMaker Server que se está ejecutando en el equipo que aloja la base de datos actual.
Get ( HostIPAddress )	La dirección IP del equipo host para la base de datos actual.
Get ( HostName )	El nombre registrado del ordenador host del archivo de base de datos.
Get ( InstalledFMPlugins )	El número de versión (si se encuentra disponible) y el estado de activación de los plug-ins instalados.
Get ( LastError )	Un número que representa el error, si existe, en la ejecución del último paso de guión ejecutado.
Get ( LastMessageChoice )	Un número correspondiente al botón pulsado en un mensaje de alerta mostrado por el paso de guión Mostrar cuadro de diálogo personalizado.
Get ( LastODBCError )	Una cadena que muestra el estado del error publicado por estándares ODBC, basado en estándares ISO/IEF.
Get ( LayoutAccess )	Un número que corresponde a los privilegios de acceso de la presentación asignados a través del cuadro de diálogo Gestionar seguridad.
Get ( LayoutCount )	El número total de presentaciones en el archivo de base de datos.
Get ( LayoutName )	El nombre de la presentación mostrada actualmente.
Get ( LayoutNumber )	El número de la presentación mostrada actualmente, de acuerdo con la lista del cuadro de diálogo Gestionar presentaciones.
Get ( LayoutTableName )	El nombre de la tabla desde la cual muestra registros la presentación.
Get ( LayoutViewState )	Información sobre cómo se ve el archivo de base de datos.
Get ( MultiUserState )	Número 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 )	Número que representa la página actual que se está imprimiendo o de la que se está obteniendo una vista previa.
Get ( PersistentID )	El texto que representa el identificador exclusivo del ordenador o dispositivo en el que se ejecuta FileMaker.
Get ( PreferencesPath )	La ruta a la carpeta de preferencias del usuario actual.
Get ( PrinterName )	Una cadena que identifica el nombre de la impresora predeterminada.
Get ( QuickFindText )	El texto escrito en el cuadro de Búsqueda rápida.
Get ( RecordAccess )	Un número que indica los privilegios de acceso del registro actual.
Get ( RecordID )	El número ID exclusivo del registro actual.
Get ( RecordModificationCount )	El número total de veces que se han realizado cambios en el registro actual.
Get ( RecordNumber )	El número del registro actual en el conjunto encontrado actual.
Get ( RecordOpenCount )	El número total de registros abiertos en el conjunto encontrado actual que no se han guardado aún.
Get ( RecordOpenState )	Un número que representa el estado del registro actual.
Get ( RequestCount )	El número total de peticiones de búsqueda definidas actualmente para la tabla actual.
Get ( RequestOmitState )	Un valor booleano que representa el estado de la casilla de verificación Omitir en modo Buscar.
Get ( ScreenDepth )	El número de bits necesarios para representar el color o sombra de grises de un píxel en la pantalla principal.
Get ( ScreenHeight )	El número de píxeles mostrados verticalmente en la pantalla en la que está abierta la ventana del archivo actual.
Get ( ScreenWidth )	El número de píxeles mostrados horizontalmente en la pantalla en la que está abierta la ventana del archivo actual.
Get ( ScriptName )	El nombre del guión que se está ejecutando (o está en pausa) actualmente.
Get ( ScriptParameter )	El parámetro de guión llevado al guión actual.
Get ( ScriptResult )	El resultado de guión de un subíndice ejecutado.
Get ( SortState )	Un número booleano que representa el estado de ordenamiento actual.
Get ( StatusAreaState )	Un número 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 ejecución 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 número que indica la plataforma actual.
Get ( SystemVersion )	La versión del sistema operativo del equipo en el que se ejecuta la función.
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 número total de registros de la tabla actual.
Get ( TriggerCurrentTabPanel )	El número de índice y el nombre del objeto del panel de pestañas desde el que se va a cambiar cuando se habilite el activador de guión OnTabSwitch.
Get ( TriggerKeystroke )	Una cadena que contiene los caracteres que activaron un activador de guión OnObjectKeystroke o OnLayoutKeystroke.
Get ( TriggerModifierKeys )	El estado de las teclas modificadoras del teclado tal y como estaban cuando se activó el activador de guión.
Get ( TriggerTargetTabPanel )	El número de índice y el nombre del objeto del panel de pestañas al que se va a cambiar cuando se habilite el activador de guión OnTabSwitch.
Get ( UserCount )	El número de usuarios que están accediendo al archivo actualmente.
Get ( UserName )	El nombre del usuario de FileMaker Pro, como se especifica en la pestaña General del cuadro de diálogo Preferencias.
Get ( UseSystemFormatsState )	Un valor booleano que representa el estado del comando de menú Usar formato del sistema.
Get ( UUID )	Texto que representa un identificador universalmente único (UUID).
Get ( WindowContentHeight )	Un número que representa la altura, en píxeles, del área de contenido.
Get ( WindowContentWidth )	Un número que representa la anchura, en píxeles, del área de contenido.
Get ( WindowDesktopHeight )	Un número que representa la altura, en píxeles, del espacio de escritorio.
Get ( WindowDesktopWidth )	Un número que representa la anchura, en píxeles, del espacio de escritorio.
Get ( WindowHeight )	Un número que representa la altura, en píxeles, de la ventana actual del archivo en el que se define el cálculo.
Get ( WindowLeft )	Un número que representa la distancia horizontal, en píxeles, del borde exterior de la ventana actual en relación con el borde izquierdo de la pantalla.
Get ( WindowMode )	Un número que representa si FileMaker Pro se encuentra en modo Visualizar, modo Buscar, modo Vista Previa o imprimiendo cuando se evalúa la función.
Get ( WindowName )	El nombre de la ventana actual del archivo en que se define el cálculo.
Get ( WindowStyle )	Un número que indica si la ventana abierta ubicada en la parte superior es una ventana de documento, una ventana flotante de documento o una ventana de diálogo.
Get ( WindowTop )	Un número que representa la distancia vertical, en píxeles, del borde exterior de la ventana actual en relación con el borde inferior de la barra de menús.
Get ( WindowVisible )	Un valor booleano que representa si la ventana actual está visible o no.
Get ( WindowWidth )	Un número que representa la anchura, en píxeles, de la ventana actual del archivo en el que se define el cálculo.
Get ( WindowZoomLevel )	El nivel de ampliación de la ventana actual.

Ejemplo de funciones Obtener

Este guión utiliza la función Get ( CurrentDate ) para comprobar cada registro del conjunto encontrado y ver si una cuenta ha vencido. Si una cuenta ha vencido, el guión muestra un mensaje e indica al usuario que haga clic en un botón con las etiquetas Ignorar, Enviar carta o Enviar correo (configurados mediante el paso de guión Mostrar cuadro de diálogo personalizado). El guión captura la respuesta del usuario mediante Get ( LastMessageChoice ). A continuación, basándose en la respuesta del usuario, el guión ejecuta una acción: cancela el resto del guión, imprime una carta de "pago retrasado" o envía un correo electrónico a la cuenta asociada.

 

Ir a la presentación ["NombrePresentación"]

Ir al registro/petición/página [Primero]

Loop

  If [NombreBaseDeDatos::Fecha < Obtener ( CurrentDate )-30]

    Mostrar cuadro de diálogo personalizado ["30 o más días tarde"]

    If [Get (LastMessageChoice) = 1]

      Detener guión

    Else If [Get ( LastMessageChoice ) = 2]

      Ir a la presentación ["Aviso de retraso"]

      Imprimir []

    Else

      Enviar correo [Para: DatabaseName::Client; Subject: "Aviso de retraso"; Message: "La cuenta ha vencido."]

    End If

  End If

  Ir al registro/petición/página [Salir después del último, Siguiente]

End Loop

Ir a la presentación [presentación original]