获取函数

Get 函数监视脚本中的错误,或捕获有关文件状态或要执行的操作的信息。

许多 Get 函数都返回定期更改的信息。例如,将 Get (当前时间) 函数放在已存储的计算字段时,只有当创建新记录时才会更新时间。如果计算包含其他字段,而计算结果仍返回当前时间,那么只有在当前记录中修改那些其他字段时,才会更新已存储的计算结果。如果未存储两个计算结果中的任意一个,那么将根据需要更新时间。出于性能方面的考虑,不存储计算字段未必总是一种最佳方法。Get 函数最好用于脚本,这样即可在运行计算时实时更新 Get 函数提供的状态信息。

此函数

返回

Get (帐户扩展权限)

返回已启用的扩展权限的关键字列表(基于用于打开文件的帐户)。

Get (帐户组名称)

返回当前帐户的组名称。

Get (帐户名)

返回文件当前用户所使用的经验证的帐户名。

Get (帐户权限集名称)

返回由用于打开文件的帐户所使用的权限集名称。

Get (帐户类型)

返回当前帐户的验证类型。

Get (活动字段内容)

返回具有焦点的字段的内容。

Get (活动字段名)

返回具有焦点的字段的名称。

Get (活动字段表名称)

返回包含具有焦点的字段的表摹本的名称。

Get (活动布局对象名称)

返回在计算的当前窗口中具有焦点的布局对象的名称。

Get (活动的辅助键)

返回一个数字,表示按下的键盘辅助键。

Get (活动入口行号)

返回具有焦点的入口行号。

Get (活动记录编号)

返回一个数字,表示当前搜索结果中具有焦点的记录。

Get (活动记录数)

返回一个数字,表示在重复字段中具有焦点的重复项。

Get (选择字符数目)

返回一个数字,表示选定的字符个数。

Get (所选文本的开始字符位置)

返回一个数字,表示所选文本的开始字符。

Get (允许终止状态)

如果“允许用户异常中断”脚本步骤已打开,则返回“1”(真);否则返回“0”(假)。

Get (允许格式栏状态)

如果允许格式栏可见,则返回“1”(真);否则返回“0”(假)。

Get (应用程序架构)

返回当前应用程序架构。

Get (应用程序语言)

返回表示当前应用程序语言的文本。

Get (应用程序版本)

返回 FileMaker 客户端的产品名和版本。

Get (参与计算的复合字段值序号)

返回一个数字,表示要计算的计算字段的重复项。

Get (连接属性)

返回当前文件的主机名和颁发用于安全链接的 SSL 证书机构的名称。

Get (连接状态)

返回一个数字,表示当前文件的网络连接的安全状态。

Get (当前日期)

返回当前日期,取决于系统日历。

Get (当前扩展权限)

返回已启用的扩展权限的关键字列表(基于用于解析此计算的帐户)。

Get (当前主机时间戳)

返回主机的当前日期和时间(精确到秒),取决于系统时钟。

Get (当前权限集名称)

返回文件中要用于解析此计算的权限集的名称。

Get (当前时间)

返回当前时间(精确到秒),取决于系统时钟。

Get (当前系统时间)

返回当前日期和时间(精确到秒),取决于系统时钟。

Get (当前时间UTC毫秒)

以世界通用时间 (UTC) 返回当前时间,精确到毫秒。

Get (自定义菜单集名称)

返回活动自定义菜单集的名称。

Get (桌面路径)

返回当前用户的桌面文件夹路径。

Get (设备)

返回一个数值,表示当前运行 FileMaker 产品的电脑或移动设备的类型。

Get (文档路径)

返回当前用户的 Documents 文件夹路径。

Get (文档路径列表)

返回 Get (文档路径) 函数返回的 Documents 文件夹中的所有文件和文件夹的列表。

Get (加密状态)

返回一个值,表示文件的当前加密状态。

Get (错误捕获状态)

如果“设置错误捕获”脚本步骤已打开,则返回“1”(真);否则返回“0”(假)。

Get (文件区域设置元素) 返回包含当前文件区域设置相关信息的 JSON 对象。

Get (FileMaker 路径)

返回当前运行的 FileMaker 产品副本所在的文件夹路径。

Get (文件名)

返回当前活动文件的名称(不包括文件扩展名)。

Get (文件路径)

返回当前活动文件位置的完整路径。

Get (文件大小)

返回当前活动文件的大小(以字节为单位)。

Get (查找个数)

返回当前搜索结果中的记录数。

Get (高对比度状态)

如果高对比度可用且处于活动状态,则返回“1”(真);否则返回“0”(假)。

Get (主机应用程序版本)

返回 FileMaker 主机的产品名和版本。

Get (主机 IP 地址)

返回当前文件的主机 IP 地址。

Get (主机名)

返回当前主机的名称。

Get (安装的 FM 插件)

返回已安装的插件的名称、版本号和启用状态。

Get ( 安装的 FM 插件为 JSON ) 返回具有已安装插件属性的 JSON 对象。

Get (上一个错误)

返回一个数字,表示在最近执行的脚本步骤的执行中出现的错误。

Get (上一个错误详情)

返回由 Get(上一个错误) 返回的有关错误的文本。

Get (上一个错误位置)

返回由 Get(上一个错误) 返回的有关错误的脚本名称、步骤名称和所在行号。

Get (上次选择信息)

返回一个数字,对应于在“显示自定义对话框”脚本步骤显示的警报信息中所点击的按钮。

Get (布局访问权限)

返回一个数字,该数字基于在当前布局中可用的记录访问权限。

Get (布局个数)

返回文件中的布局总数。

Get (布局名称)

返回当前显示的布局的名称。

Get (布局编号)

返回当前显示的布局的编号(在“管理布局”对话框中指定)。

Get (布局表名称)

返回在当前布局中显示记录的表摹本的名称。

Get (布局浏览模式)

返回一个数字,表示当前活动的文件视图。

Get (菜单栏状态)

返回一个数字,表示当前菜单栏状态。

Get (修改的字段)

返回已在当前表的当前记录中修改的字段列表。

Get (多用户状态)

返回一个数字,表示使用 FileMaker 网络的文件的共享级别。

Get (网络协议)

返回 FileMaker 客户端在此机器上使用的网络协议 (TCP/IP) 的名称。

Get (网络类型)

在 FileMaker Go 中,返回一个数字,表示正用于访问当前文件的网络类型。

Get (打开数据文件信息)

返回文件 ID 和每个已打开数据文件的路径。

Get (页数)

打印时返回当前打印作业的总页数。

Get (页码)

返回一个数字,表示正在打印或预览的当前页面。

Get (固定 ID)

返回运行 FileMaker 客户端的计算机或设备的唯一标识符的文本。

Get (参数路径)

返回当前用户的首选项和默认选项文件夹的路径。

Get (打印机名称)

返回标识默认打印机名称的文本。

Get (快速查找文本)

返回在“快速查找”框中存储的文本。

Get (记录访问权限)

返回一个数字,表示通过“自定义记录权限”对话框指定的当前记录的访问权限。

Get (记录 ID)

返回当前记录的唯一 ID 号。

Get (记录修改次数)

返回已提交的、对当前记录所做更改的总次数。

Get (记录编号)

返回一个数字,表示当前搜索结果中记录的位置。

Get (打开记录的个数)

返回在尚未保存的当前搜索结果中已打开的记录的总数。

Get (打开记录的状态)

返回一个数字,表示当前记录的状态。

Get (区域监视事件)

返回一些事件,这些事件引发“配置区域监视脚本”脚本步骤中指定的脚本运行。

Get (请求个数)

返回为当前表定义的查找请求的总数

Get (请求忽略状态)

如果在当前查找请求中选择了“省略”,则返回“1”(真);否则返回“0”(假)。

Get (屏幕色度)

返回显示主屏幕像素颜色或灰度所需的位数。

Get (屏幕高度)

返回在其中打开了当前文件窗口的屏幕的高度(以磅为单位)。

Get (屏幕缩放系数)

返回在其中打开当前文件的屏幕的缩放系数。

Get (屏幕宽度)

返回在其中打开了当前文件窗口的屏幕的宽度(以磅为单位)。

Get (脚本动画状态)

如果为当前脚本启用了动画,则返回“1”(真);否则返回“0”(假)。

Get (脚本名称)

返回当前运行或暂停的脚本的名称。

Get (脚本参数)

返回传递到当前脚本的脚本参数。

Get (脚本结果)

返回来自已执行子脚本的脚本结果。

Get (会话标识)

返回“设置会话标识”脚本步骤所设置的值。

Get (排序状态)

返回一个值,表示当前排序状态。

Get (状态区域状态)

返回一个数字,表示当前状态工具栏的状态。

Get (系统外观)

返回当前操作系统外观的名称。

Get (系统驱动器)

返回正在运行的操作系统所在的驱动器号(对于 Windows)或卷名称(对于 macOS)。

Get (系统 IP 地址)

返回连接到活动 NIC(网络接口控制器)卡的所有计算机的 IP 地址列表。

Get (系统语言)

返回当前系统上设置的语言。

Get (系统区域设置元素) 返回包含客户端系统区域设置相关信息的 JSON 对象。

Get (系统网络硬件地址)

返回连接到计算机的所有 NIC(网络接口控制器)卡的硬件地址。

Get (系统平台)

返回一个数字,表示当前平台。

Get (系统版本)

返回当前操作系统的版本。

Get (临时路径)

返回当前 FileMaker 临时文件夹的路径。

Get (标尺可见状态)

如果显示文本标尺,则返回“1”(真);否则返回“0”(假)。

Get (总记录数)

返回当前表中的记录总数。

Get (触控键盘状态)

如果触控键盘设置为按需要自动显示,则返回“1”(真);否则返回“0”(假)。

Get (事务打开状态)

如果事务打开,则返回“1”(真);否则返回“0”(假)。

Get (触发当前面板)

返回在激活 OnPanelSwitch 脚本触发器时自其进行切换的面板的索引和对象名称。

Get (触发外部事件)

在 FileMaker Go 中,返回一个数字,表示激活 OnExternalCommandReceived 脚本触发器的事件。

Get (触发手势信息)

返回有关激活 OnGestureTap 脚本触发器的手势的详细信息。

Get (触发击键)

返回激活 OnObjectKeystroke 或 OnLayoutKeystroke 脚本触发器的字符。

Get (触发辅助键)

返回激活 OnObjectKeystroke 或 OnLayoutKeystroke 脚本触发器时键盘辅助键的状态。

Get (触发目标面板)

返回在激活 OnPanelSwitch 脚本触发器时切换到的面板的索引和对象名称。

Get (用户个数)

返回当前正在访问文件的客户端个数。

Get (用户名)

返回 FileMaker 用户的名称,取决于“首选项”对话框的“常规”选项卡中指定的结果。

Get (系统格式状态)

如果“格式”菜单中的“使用系统格式”已打开,则返回“1”(真);否则返回“0”(假)。

Get (UUID)

返回表示通用唯一标识符 (UUID) 的文本。

Get (UUID 号)

返回表示通用唯一标识符 (UUID) 值的数字。

Get (工作区高度)

返回窗口内容区域的高度(以磅为单位)。

Get (工作区宽度)

返回窗口内容区域的宽度(以磅为单位)。

Get (窗口桌面高度)

返回桌面空间的高度(以磅为单位)。

Get (窗口桌面宽度)

返回桌面空间的宽度(以磅为单位)。

Get (窗口高度)

返回正在操作脚本的窗口的高度(以磅为单位)。

Get (窗口左边距)

返回正在操作脚本的窗口的外部边缘相对于屏幕最左边缘的水平距离(以磅为单位)。

Get (窗口模式)

返回一个数字,表示在解析函数时 FileMaker 产品的模式。

Get (窗口名称)

返回正在操作脚本的窗口的名称。

Get (窗口方向)

返回一个值,表示正在操作脚本的窗口的方向。

Get (窗口样式)

返回正在操作脚本的窗口的样式。

Get (窗口上边距)

返回正在操作脚本的窗口的外部边缘相对于菜单栏底部边缘 (macOS) 或屏幕顶部边缘 (Windows) 的垂直距离(以磅为单位)。

Get (窗口是否可见)

如果窗口可见,则返回“1”(真);如果使用“隐藏窗口”隐藏了窗口,则返回“0”(假)。

Get (窗口宽度)

返回正在操作脚本的窗口的宽度(以磅为单位)。

Get (窗口缩放级别)

返回当前窗口的缩放百分比。

示例 1 

此脚本使用 Get(当前日期) 函数检查搜索结果中的每条记录以确定是否存在过期的帐户。如果某个帐户已经过期,则该脚本显示一条消息并提示用户单击标有“省略”、“发送信函”或“发送邮件”(通过“显示自定义对话框”脚本步骤进行设置)的按钮。该脚本使用 Get(上次选择信息) 函数捕获用户的响应。然后,根据用户的响应,脚本执行操作:取消脚本的其余部分、打印“付费已晚”信函或向关联帐户发送电子邮件。

复制
转到布局 ["布局名称"]
转到记录/请求/页面 [第一个]
Loop
  If [数据库名称::日期 < Get(当前日期) - 30]
    显示自定义对话框 ["最近 30 天或更多天"]
    If [Get(上次选择信息) = 1]
      中断脚本
    Else If [Get(上次选择信息) = 2]
      转到布局 ["过期提醒"]
      打印 []
    Else
      发送邮件 [通过电子邮件客户端发送; 包括对话框:关闭; 收件人:数据库名称::客户; 主题:"过期提醒"; 消息:"您的帐户已过期。"]
    End If
  End If
  转到记录/请求/页面 [下一步; 最后一步后退出:打开]
End Loop
转到布局 [原始布局]