获取函数
Get 函数监视脚本中的错误,或捕获有关文件状态或要执行的操作的信息。
许多 Get 函数都返回定期更改的信息。例如,将 Get (当前时间) 函数放在已存储的计算字段时,只有当创建新记录时才会更新时间。如果计算包含其他字段,而计算结果仍返回当前时间,那么只有在当前记录中修改那些其他字段时,才会更新已存储的计算结果。如果未存储两个计算结果中的任意一个,那么将根据需要更新时间。出于性能方面的考虑,不存储计算字段未必总是一种最佳方法。Get 函数最好用于脚本,这样即可在运行计算时实时更新 Get 函数提供的状态信息。
此函数 |
返回 |
返回已启用的扩展权限的关键字列表(基于用于打开文件的帐户)。 |
|
返回当前帐户的组名称。 |
|
返回文件当前用户所使用的经验证的帐户名。 |
|
返回由用于打开文件的帐户所使用的权限集名称。 |
|
返回当前帐户的验证类型。 |
|
返回具有焦点的字段的内容。 |
|
返回具有焦点的字段的名称。 |
|
返回包含具有焦点的字段的表摹本的名称。 |
|
返回在计算的当前窗口中具有焦点的布局对象的名称。 |
|
返回一个数字,表示按下的键盘辅助键。 |
|
返回具有焦点的入口行号。 |
|
返回一个数字,表示当前搜索结果中具有焦点的记录。 |
|
返回一个数字,表示在重复字段中具有焦点的重复项。 |
|
返回一个数字,表示选定的字符个数。 |
|
返回一个数字,表示所选文本的开始字符。 |
|
如果“允许用户异常中断”脚本步骤已打开,则返回“1”(真);否则返回“0”(假)。 |
|
如果允许格式栏可见,则返回“1”(真);否则返回“0”(假)。 |
|
返回当前应用程序架构。 |
|
返回表示当前应用程序语言的文本。 |
|
返回 FileMaker 客户端的产品名和版本。 |
|
返回一个数字,表示要计算的计算字段的重复项。 |
|
返回当前文件的主机名和颁发用于安全链接的 SSL 证书机构的名称。 |
|
返回一个数字,表示当前文件的网络连接的安全状态。 |
|
返回当前日期,取决于系统日历。 |
|
返回已启用的扩展权限的关键字列表(基于用于解析此计算的帐户)。 |
|
返回主机的当前日期和时间(精确到秒),取决于系统时钟。 |
|
返回文件中要用于解析此计算的权限集的名称。 |
|
返回当前时间(精确到秒),取决于系统时钟。 |
|
返回当前日期和时间(精确到秒),取决于系统时钟。 |
|
以世界通用时间 (UTC) 返回当前时间,精确到毫秒。 |
|
返回活动自定义菜单集的名称。 |
|
返回当前用户的桌面文件夹路径。 |
|
返回一个数值,表示当前运行 FileMaker 产品的电脑或移动设备的类型。 |
|
返回当前用户的 Documents 文件夹路径。 |
|
返回 Get (文档路径) 函数返回的 Documents 文件夹中的所有文件和文件夹的列表。 |
|
返回一个值,表示文件的当前加密状态。 |
|
如果“设置错误捕获”脚本步骤已打开,则返回“1”(真);否则返回“0”(假)。 |
|
Get (文件区域设置元素) | 返回包含当前文件区域设置相关信息的 JSON 对象。 |
返回当前运行的 FileMaker 产品副本所在的文件夹路径。 |
|
返回当前活动文件的名称(不包括文件扩展名)。 |
|
返回当前活动文件位置的完整路径。 |
|
返回当前活动文件的大小(以字节为单位)。 |
|
返回当前搜索结果中的记录数。 |
|
如果高对比度可用且处于活动状态,则返回“1”(真);否则返回“0”(假)。 |
|
返回 FileMaker 主机的产品名和版本。 |
|
返回当前文件的主机 IP 地址。 |
|
返回当前主机的名称。 |
|
返回已安装的插件的名称、版本号和启用状态。 |
|
Get ( 安装的 FM 插件为 JSON ) | 返回具有已安装插件属性的 JSON 对象。 |
返回一个数字,表示在最近执行的脚本步骤的执行中出现的错误。 |
|
返回由 Get(上一个错误) 返回的有关错误的文本。 |
|
返回由 Get(上一个错误) 返回的有关错误的脚本名称、步骤名称和所在行号。 |
|
返回一个数字,对应于在“显示自定义对话框”脚本步骤显示的警报信息中所点击的按钮。 |
|
返回一个数字,该数字基于在当前布局中可用的记录访问权限。 |
|
返回文件中的布局总数。 |
|
返回当前显示的布局的名称。 |
|
返回当前显示的布局的编号(在“管理布局”对话框中指定)。 |
|
返回在当前布局中显示记录的表摹本的名称。 |
|
返回一个数字,表示当前活动的文件视图。 |
|
|
|
返回已在当前表的当前记录中修改的字段列表。 |
|
返回一个数字,表示使用 FileMaker 网络的文件的共享级别。 |
|
返回 FileMaker 客户端在此机器上使用的网络协议 (TCP/IP) 的名称。 |
|
在 FileMaker Go 中,返回一个数字,表示正用于访问当前文件的网络类型。 |
|
返回文件 ID 和每个已打开数据文件的路径。 |
|
打印时返回当前打印作业的总页数。 |
|
返回一个数字,表示正在打印或预览的当前页面。 |
|
返回运行 FileMaker 客户端的计算机或设备的唯一标识符的文本。 |
|
返回当前用户的首选项和默认选项文件夹的路径。 |
|
返回标识默认打印机名称的文本。 |
|
返回在“快速查找”框中存储的文本。 |
|
返回一个数字,表示通过“自定义记录权限”对话框指定的当前记录的访问权限。 |
|
返回当前记录的唯一 ID 号。 |
|
返回已提交的、对当前记录所做更改的总次数。 |
|
返回一个数字,表示当前搜索结果中记录的位置。 |
|
返回在尚未保存的当前搜索结果中已打开的记录的总数。 |
|
返回一个数字,表示当前记录的状态。 |
|
返回一些事件,这些事件引发“配置区域监视脚本”脚本步骤中指定的脚本运行。 |
|
返回为当前表定义的查找请求的总数 |
|
如果在当前查找请求中选择了“省略”,则返回“1”(真);否则返回“0”(假)。 |
|
返回显示主屏幕像素颜色或灰度所需的位数。 |
|
返回在其中打开了当前文件窗口的屏幕的高度(以磅为单位)。 |
|
返回在其中打开当前文件的屏幕的缩放系数。 |
|
返回在其中打开了当前文件窗口的屏幕的宽度(以磅为单位)。 |
|
如果为当前脚本启用了动画,则返回“1”(真);否则返回“0”(假)。 |
|
返回当前运行或暂停的脚本的名称。 |
|
返回传递到当前脚本的脚本参数。 |
|
返回来自已执行子脚本的脚本结果。 |
|
返回“设置会话标识”脚本步骤所设置的值。 |
|
返回一个值,表示当前排序状态。 |
|
返回一个数字,表示当前状态工具栏的状态。 |
|
返回当前操作系统外观的名称。 |
|
返回正在运行的操作系统所在的驱动器号(对于 Windows)或卷名称(对于 macOS)。 |
|
返回连接到活动 NIC(网络接口控制器)卡的所有计算机的 IP 地址列表。 |
|
返回当前系统上设置的语言。 |
|
Get (系统区域设置元素) | 返回包含客户端系统区域设置相关信息的 JSON 对象。 |
返回连接到计算机的所有 NIC(网络接口控制器)卡的硬件地址。 |
|
返回一个数字,表示当前平台。 |
|
返回当前操作系统的版本。 |
|
返回当前 FileMaker 临时文件夹的路径。 |
|
如果显示文本标尺,则返回“1”(真);否则返回“0”(假)。 |
|
返回当前表中的记录总数。 |
|
如果触控键盘设置为按需要自动显示,则返回“1”(真);否则返回“0”(假)。 |
|
如果事务打开,则返回“1”(真);否则返回“0”(假)。 |
|
返回在激活 OnPanelSwitch 脚本触发器时自其进行切换的面板的索引和对象名称。 |
|
在 FileMaker Go 中,返回一个数字,表示激活 OnExternalCommandReceived 脚本触发器的事件。 |
|
返回有关激活 OnGestureTap 脚本触发器的手势的详细信息。 |
|
返回激活 OnObjectKeystroke 或 OnLayoutKeystroke 脚本触发器的字符。 |
|
返回激活 OnObjectKeystroke 或 OnLayoutKeystroke 脚本触发器时键盘辅助键的状态。 |
|
返回在激活 OnPanelSwitch 脚本触发器时切换到的面板的索引和对象名称。 |
|
返回当前正在访问文件的客户端个数。 |
|
返回 FileMaker 用户的名称,取决于“首选项”对话框的“常规”选项卡中指定的结果。 |
|
如果“格式”菜单中的“使用系统格式”已打开,则返回“1”(真);否则返回“0”(假)。 |
|
返回表示通用唯一标识符 (UUID) 的文本。 |
|
返回表示通用唯一标识符 (UUID) 值的数字。 |
|
返回窗口内容区域的高度(以磅为单位)。 |
|
返回窗口内容区域的宽度(以磅为单位)。 |
|
返回桌面空间的高度(以磅为单位)。 |
|
返回桌面空间的宽度(以磅为单位)。 |
|
返回正在操作脚本的窗口的高度(以磅为单位)。 |
|
返回正在操作脚本的窗口的外部边缘相对于屏幕最左边缘的水平距离(以磅为单位)。 |
|
返回一个数字,表示在解析函数时 FileMaker 产品的模式。 |
|
返回正在操作脚本的窗口的名称。 |
|
返回一个值,表示正在操作脚本的窗口的方向。 |
|
返回正在操作脚本的窗口的样式。 |
|
返回正在操作脚本的窗口的外部边缘相对于菜单栏底部边缘 (macOS) 或屏幕顶部边缘 (Windows) 的垂直距离(以磅为单位)。 |
|
如果窗口可见,则返回“1”(真);如果使用“隐藏窗口”隐藏了窗口,则返回“0”(假)。 |
|
返回正在操作脚本的窗口的宽度(以磅为单位)。 |
|
返回当前窗口的缩放百分比。 |
示例 1
此脚本使用 Get(当前日期)
函数检查搜索结果中的每条记录以确定是否存在过期的帐户。如果某个帐户已经过期,则该脚本显示一条消息并提示用户单击标有“省略”、“发送信函”或“发送邮件”(通过“显示自定义对话框”脚本步骤进行设置)的按钮。该脚本使用 Get(上次选择信息)
函数捕获用户的响应。然后,根据用户的响应,脚本执行操作:取消脚本的其余部分、打印“付费已晚”信函或向关联帐户发送电子邮件。
转到布局 ["布局名称"]
转到记录/请求/页面 [第一个]
Loop
If [数据库名称::日期 < Get(当前日期) - 30]
显示自定义对话框 ["最近 30 天或更多天"]
If [Get(上次选择信息) = 1]
中断脚本
Else If [Get(上次选择信息) = 2]
转到布局 ["过期提醒"]
打印 []
Else
发送邮件 [通过电子邮件客户端发送; 包括对话框:关闭; 收件人:数据库名称::客户; 主题:"过期提醒"; 消息:"您的帐户已过期。"]
End If
End If
转到记录/请求/页面 [下一步; 最后一步后退出:打开]
End Loop
转到布局 [原始布局]