Funciones Get

Las funciones Get supervisan los errores en los guiones o capturan información sobre el estado del archivo o las acciones que se están realizando.

Muchas funciones Get devuelven información que se modifica frecuentemente. Por ejemplo, cuando la función Get ( 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 solo 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 Get se utilizan mejor en un guión donde la información de estado de una función Get se actualiza en el momento de ejecutar el cálculo.

Esta función

Devuelve

Get ( AccountExtendedPrivileges )

Devuelve una lista de palabras clave en función de la cuenta utilizada para abrir el archivo para los privilegios ampliados habilitados.

Get ( AccountGroupName )

Devuelve el nombre de grupo de la cuenta actual.

Get ( AccountName )

Devuelve el nombre de la cuenta autenticada que está utilizando el usuario actual del archivo.

Get ( AccountPrivilegeSetName )

Devuelve el nombre del conjunto de privilegios que está utilizando la cuenta usada para abrir el archivo.

Get ( AccountType )

Devuelve el tipo de autenticación de la cuenta actual.

Get ( ActiveFieldContents )

Devuelve el contenido del campo que tiene el centro de atención.

Get ( ActiveFieldName )

Devuelve el nombre del campo que tiene el centro de atención.

Get ( ActiveFieldTableName )

Devuelve el nombre de la ocurrencia de la tabla que contiene el campo que tiene el centro de atención.

Get ( ActiveLayoutObjectName )

Devuelve el nombre del objeto de presentación que tiene el centro de atención en la ventana actual del cálculo.

Get ( ActiveModifierKeys )

Devuelve un número para las teclas del modificador de teclado que se están utilizando.

Get ( ActivePortalRowNumber )

Devuelve un número que representa la fila del portal que tiene el centro de atención.

Get ( ActiveRecordNumber )

Devuelve un número que representa el registro que tiene el centro de atención en el conjunto encontrado actual.

Get ( ActiveRepetitionNumber )

Devuelve un número que representa la repetición que tiene el centro de atención en un campo repetido.

Get ( ActiveSelectionSize )

Devuelve un número que representa el número de caracteres seleccionados.

Get ( ActiveSelectionStart )

Devuelve un número que representa el carácter inicial del texto seleccionado.

Get ( AllowAbortState )

Devuelve el valor 1 (true) si está activado el paso de guión Permitir cancelación del usuario; de lo contrario, devuelve el valor 0 (false).

Get ( AllowFormattingBarState )

Devuelve el valor 1 (true) si se permite la visibilidad de la barra de formato; de lo contrario, devuelve el valor 0 (false).

Get ( ApplicationArchitecture )

Devuelve la arquitectura de la aplicación actual.

Get ( ApplicationLanguage )

Devuelve texto que representa el idioma actual de la aplicación.

Get ( ApplicationVersion )

Devuelve el nombre y la versión del producto FileMaker del cliente.

Get ( CalculationRepetitionNumber )

Devuelve un número que representa la repetición del campo de cálculo que se está calculando.

Get ( ConnectionAttributes )

Devuelve el nombre del anfitrión del archivo actual y el nombre de la entidad emisora que emitió el certificado SSL que se utilizaron para garantizar la conexión.

Get ( ConnectionState )

Devuelve un número que representa el estado de seguridad de la conexión de red del archivo actual.

Get ( CurrentDate )

Devuelve la fecha actual de acuerdo con el calendario del sistema.

Get ( CurrentExtendedPrivileges )

Devuelve una lista de palabras clave en función de la cuenta utilizada para evaluar este cálculo para los privilegios ampliados habilitados.

Get ( CurrentHostTimestamp )

Devuelve la fecha y hora actuales (al segundo más próximo) de acuerdo con el reloj del sistema.

Get ( CurrentPrivilegeSetName )

Devuelve el nombre del conjunto de privilegios que se está utilizando para evaluar este cálculo en el archivo.

Get ( CurrentTime )

Devuelve la hora actual (al segundo más próximo) de acuerdo con el reloj del sistema.

Get ( CurrentTimestamp )

Devuelve la fecha y hora actuales (al segundo más próximo) de acuerdo con el reloj del sistema.

Get ( CurrentTimeUTCMilliseconds )

Devuelve la hora actual en Tiempo Universal Coordinado (UTC) con el milisegundo más próximo.

Get ( CustomMenuSetName )

Devuelve el nombre del conjunto de menús personalizados activo.

Get ( DesktopPath )

Devuelve la ruta a la carpeta de escritorio del usuario actual.

Get ( Device )

Devuelve un número que representa el tipo de equipo o dispositivo móvil que ejecuta actualmente el producto de FileMaker.

Get ( DocumentsPath )

Devuelve la ruta a la carpeta Documentos del usuario actual.

Get ( DocumentsPathListing )

Devuelve una lista de todos los archivos y las carpetas de la carpeta Documentos devuelta por la función Get ( DocumentsPath ).

Get ( EncryptionState )

Devuelve un valor que representa el estado de cifrado actual.

Get ( ErrorCaptureState )

Devuelve el valor 1 (true) si está activado el paso de guión Establecer captura de errores; de lo contrario, devuelve el valor 0 (false).

Get ( FileLocaleElements ) Devuelve un objeto JSON con información sobre la configuración regional del archivo actual.

Get ( FileMakerPath )

Devuelve la ruta a la carpeta de la copia de FileMaker en ejecución actualmente.

Get ( FileName )

Devuelve el nombre del archivo actualmente activo, sin la extensión de nombre de archivo.

Get ( FilePath )

Devuelve la ruta completa de la ubicación del archivo activo.

Get ( FileSize )

Devuelve el tamaño, en bytes, del archivo activo.

Get ( FoundCount )

Devuelve el número de registros del conjunto encontrado actual.

Get ( HighContrastState )

Devuelve el valor 1 (true) si está disponible la función de alto contraste; de lo contrario, devuelve el valor 0 (false).

Get ( HostApplicationVersion )

Devuelve el nombre y la versión del producto FileMaker del anfitrión.

Get ( HostIPAddress )

Devuelve la dirección IP del equipo anfitrión del archivo actual.

Get ( HostName )

Devuelve el nombre del anfitrión actual.

Get ( InstalledFMPlugins )

Devuelve el nombre, el número de versión y el estado de activación de los plug-ins instalados.

Get ( InstalledFMPluginsAsJSON ) Devuelve un objeto JSON con los atributos de los plug-ins instalados.

Get ( LastError )

Devuelve un número para el error que se ha producido al ejecutar el último paso de guión ejecutado.

Get ( LastErrorDetail )

Devuelve un texto con los errores que ha devuelto la función Get ( LastError ).

Get ( LastErrorLocation )

Devuelve el nombre del guión, el nombre del paso y el número de línea de los errores devueltos por Get ( LastError ).

Get ( LastMessageChoice )

Devuelve 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 ( LayoutAccess )

Devuelve un número en función de los privilegios de acceso de registro disponibles a través de la presentación actual.

Get ( LayoutCount )

Devuelve el número total de presentaciones del archivo.

Get ( LayoutName )

Devuelve el nombre de la presentación mostrada actualmente.

Get ( LayoutNumber )

Devuelve el número de la presentación (especificada en el cuadro de diálogo Gestionar presentaciones) mostrada actualmente.

Get ( LayoutTableName )

Devuelve el nombre de la ocurrencia de la tabla que muestra registros en la presentación actual.

Get ( LayoutViewState )

Devuelve un número que indica la vista de archivo activa.

Get ( MenubarState )

Devuelve un número que representa el estado actual de la barra de menús.

Get ( ModifiedFields )

Devuelve una lista de campos que se han modificado en el registro actual de la tabla actual.

Get ( MultiUserState )

Devuelve un número que representa el nivel de uso compartido del archivo mediante la red FileMaker.

Get ( NetworkProtocol )

Devuelve el nombre del protocolo de red (TCP/IP) que utiliza un cliente FileMaker en este equipo.

Get ( NetworkType )

En FileMaker Go, devuelve un número que representa el tipo de red que se está utilizando para acceder al archivo actual.

Get ( OpenDataFileInfo )

Devuelve el ID y la ruta de cada archivo de datos abierto.

Get ( PageCount )

Devuelve un número que representa el número total de páginas del trabajo de impresión actual durante la impresión.

Get ( PageNumber )

Devuelve un número que representa la página actual que se está imprimiendo o de la que se está obteniendo una vista previa.

Get ( PersistentID )

Devuelve el texto que representa el identificador exclusivo del equipo o el dispositivo en el que se ejecuta un cliente de FileMaker.

Get ( PreferencesPath )

Devuelve la ruta a la carpeta de opciones predeterminadas y preferencias del usuario actual.

Get ( PrinterName )

Devuelve el texto que identifica el nombre de la impresora predeterminada.

Get ( QuickFindText )

Devuelve el texto almacenado en el cuadro de búsqueda rápida.

Get ( RecordAccess )

Devuelve un número que representa los privilegios de acceso del registro actual, asignados a través del cuadro de diálogo Privilegios de registro personalizados.

Get ( RecordID )

Devuelve el número de ID exclusivo del registro actual.

Get ( RecordModificationCount )

Devuelve el número total de veces que se han consignado cambios realizados en el registro actual.

Get ( RecordNumber )

Devuelve un número que representa la posición de un registro en el conjunto encontrado actual.

Get ( RecordOpenCount )

Devuelve el número total de registros abiertos del conjunto encontrado actual que no se han guardado.

Get ( RecordOpenState )

Devuelve un número que representa el estado del registro actual.

Get ( RegionMonitorEvents )

Devuelve los eventos que provocaron que se ejecutase el guión especificado en el paso de guión Configurar Guión Supervisor de Región.

Get ( RequestCount )

Devuelve el número total de peticiones de búsqueda definidas para la tabla actual.

Get ( RequestOmitState )

Devuelve el valor 1 (true) si se ha seleccionado Omitir en la petición de búsqueda actual; de lo contrario, devuelve el valor 0 (false).

Get ( ScreenDepth )

Devuelve el número de bits necesarios para representar el color o el tono de gris de un píxel en la pantalla principal.

Get ( ScreenHeight )

Devuelve la altura (en puntos) de la pantalla en la que está abierta la ventana del archivo actual.

Get ( ScreenScaleFactor )

Devuelve el factor de escala de la pantalla en la que está abierta el archivo actual.

Get ( ScreenWidth )

Devuelve la anchura (en puntos) de la pantalla en la que está abierta la ventana del archivo actual.

Get ( ScriptAnimationState )

Devuelve el valor 1 (true) si se han activado las animaciones para el guión actual; de lo contrario, devuelve el valor 0 (false).

Get ( ScriptName )

Devuelve el nombre del guión que se está ejecutando (o está en pausa) actualmente.

Get ( ScriptParameter )

Devuelve el parámetro de guión transferido al guión actual.

Get ( ScriptResult )

Devuelve el resultado de guión de un subguión ejecutado.

Get ( SessionIdentifier )

Devuelve el valor establecido por el paso de guión Establecer identificador de sesión.

Get ( SortState )

Devuelve un valor que representa el estado de ordenación actual.

Get ( StatusAreaState )

Devuelve un número que representa el estado actual de la barra de estado.

Get ( SystemAppearance )

Devuelve el nombre de la apariencia actual del sistema operativo.

Get ( SystemDrive )

Devuelve la letra de unidad (Windows) o el nombre del volumen (macOS) en que está ubicado el sistema operativo en ejecución.

Get ( SystemIPAddress )

Devuelve una lista de todas las direcciones IP de todos los equipos conectados a una tarjeta NIC (Controlador de interfaz de red) activa.

Get ( SystemLanguage )

Devuelve el idioma establecido actualmente en el sistema actual.

Get ( SystemLocaleElements ) Devuelve un objeto JSON con información sobre la configuración regional del sistema de cliente.

Get ( SystemNICAddress )

Devuelve las direcciones de hardware de todas las tarjetas NIC (controlador de interfaz de red) conectadas al equipo.

Get ( SystemPlatform )

Devuelve un número que representa la plataforma actual.

Get ( SystemVersion )

Devuelve la versión del sistema operativo actual.

Get ( TemporaryPath )

Devuelve la ruta a la carpeta temporal de FileMaker actual.

Get ( TextRulerVisible )

Devuelve el valor 1 (true) si se muestra la regla de texto; de lo contrario, devuelve el valor 0 (false).

Get ( TotalRecordCount )

Devuelve el número total de registros de la tabla actual.

Get ( TouchKeyboardState )

Devuelve el valor 1 (true) si el teclado táctil se ha configurado para que se muestre automáticamente cuando sea necesario; de lo contrario, devuelve el valor 0 (false).

Get ( TransactionOpenState )

Devuelve 1 (true) si la transacción está abierta; de lo contrario, devuelve 0 (false).

Get ( TriggerCurrentPanel )

Devuelve el índice y el nombre de objeto del panel de pestañas desde el que se va a cambiar cuando se habilite el activador de guión OnPanelSwitch.

Get ( TriggerExternalEvent )

En FileMaker Go, devuelve un número que representa el evento que ha habilitado el activador de guión OnExternalCommandReceived.

Get ( TriggerGestureInfo )

Devuelve información sobre el gesto que habilitó el activador de guión OnGestureTap.

Get ( TriggerKeystroke )

Devuelve los caracteres que han habilitado el activador de guión OnObjectKeystroke u OnLayoutKeystroke.

Get ( TriggerModifierKeys )

Devuelve el estado de las teclas modificadoras del teclado si se ha habilitado el activador de guión OnObjectKeystroke u OnLayoutKeystroke.

Get ( TriggerTargetPanel )

Devuelve el índice y el nombre de objeto del panel de pestañas al que se va a cambiar cuando se habilite el activador de guión OnPanelSwitch.

Get ( UserCount )

Devuelve el número de clientes que está accediendo al archivo.

Get ( UserName )

Devuelve el nombre del usuario de FileMaker, como se especifica en la pestaña General del cuadro de diálogo Preferencias.

Get ( UseSystemFormatsState )

Devuelve el valor 1 (true) si se ha activado la opción Usar formato del sistema del menú Formato; de lo contrario, devuelve el valor 0 (false).

Get ( UUID )

Devuelve el texto que representa el identificador exclusivo universalmente (UUID).

Get ( UUIDNumber )

Devuelve un número que representa un valor grande de identificador exclusivo universalmente (UUID).

Get ( WindowContentHeight )

Devuelve la altura, en puntos, del área de contenido de la ventana.

Get ( WindowContentWidth )

Devuelve la anchura, en puntos, del área de contenido de la ventana.

Get ( WindowDesktopHeight )

Devuelve la altura, en puntos, del espacio de escritorio.

Get ( WindowDesktopWidth )

Devuelve la anchura, en puntos, del espacio de escritorio.

Get ( WindowHeight )

Devuelve la altura, en puntos, de la ventana en la que actúa el guión.

Get ( WindowLeft )

Devuelve la distancia horizontal, en puntos, del borde exterior de la ventana sobre la cual actúa el guión en relación con el borde izquierdo de la pantalla.

Get ( WindowMode )

Devuelve un número que representa el modo en el que se encuentra FileMaker en el momento en que se evalúa la función.

Get ( WindowName )

Devuelve el nombre de la ventana en la que actúa el guión.

Get ( WindowOrientation )

Devuelve un valor que representa la orientación de la ventana en la que actúa el guión.

Get ( WindowStyle )

Devuelve el estilo de la ventana en la que actúa el guión.

Get ( WindowTop )

Devuelve la distancia vertical, en puntos, del borde exterior de la ventana en la que actúa el guión, en relación con el borde superior de la pantalla en Windows o el borde inferior de la barra de menús en macOS.

Get ( WindowVisible )

Devuelve el valor 1 (true) si la ventana está visible; devuelve el valor 0 (false) si la ventana está oculta mediante la opción Ocultar ventana.

Get ( WindowWidth )

Devuelve la anchura, en puntos, de la ventana en la que actúa el guión.

Get ( WindowZoomLevel )

Devuelve el porcentaje de zoom de la ventana actual.

Ejemplo 1 

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, según la respuesta del usuario, el guión ejecuta una acción: cancela el resto del guión, imprime una carta de tipo "el pago se ha retrasado" o envía un correo electrónico a la cuenta asociada.

Copiar
Ir a la presentación ["NombrePresentación"]
Ir al registro/petición/página [Primero]
Loop
  If [NombreBaseDeDatos::Fecha < Get ( 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 [Enviar vía cliente de correo electrónico; Con diálogo: Inactivo; Para: DatabaseName::Client; Subject: "Aviso de retraso"; Message: "La cuenta ha vencido."]
    End If
  End If
  Ir al registro/petición/página [Siguiente; Salir después del último: Activo]
End Loop
Ir a la presentación [presentación original]