设置会话标识

设置用户当前会话的标识。

选项 

  • 指定会话标识为文本或结果为文本的计算。

兼容性 

产品 是否支持
FileMaker Pro
FileMaker Go
FileMaker WebDirect
FileMaker Server
FileMaker Cloud
FileMaker Data API
自定义 Web 发布

原始版本 

19.4.1

说明 

默认的情况下,会话标识就是 Get (用户名)函数返回的值。您可以使用此脚本步骤更改会话标识,以便向管理员提供附加信息。对于每个连接到指定主机的 FileMaker 客户端,会话标识只有一个值。此值将保持有效,直到在同一会话中同一客户端打开的同一主机上再次执行“设置会话标识”,或者会话结束。

会话标识通过以下方式供管理员使用:

  • FileMaker Server Admin Console 在“数据库”页面显示会话标识。

  • FileMaker Server 的“访问日志”包含一个显示何时此脚本步骤改变会话标识值的条目。

  • FileMaker Admin API 在 FileMaker Server 和 FileMaker Cloud 上使用“列出客户端”调用以 userName 值返回会话标识。

请参阅 FileMaker Server 帮助FileMaker Admin API 指南

最佳实践

  • 如果每个用户使用唯一的帐户登录,您可以通过他们的帐户名来识别他们。在这种情况下,可能没有使用“设置会话标识”的理由。

  • 如果多个用户使用同一帐户或使用 Guest 帐户登录,则其帐户名无法识别他们。如果您有识别这些用户的替代方法,可以使用“设置会话标识”以上述方式向管理员提供这些用户的标识。

  • 在启动脚本(OnFirstWindowOpen 脚本触发器)中执行“设置会话标识”,以便在会话开始时设置会话标识。

  • 如果主机上有多个定制化 App,请合适相同的方法确定每个 App 的启动脚本中的会话标识。否则,标识在同一用户打开不同的 App 时会改变。

  • 如果您的 App 包含可让用户注销后以不同用户再次登录的脚本(例如使用重新登录脚本步骤),则您的脚本也可能需要执行“设置会话标识”以更新会话标识。

注释 

  • 此脚本步骤不会改变 Get (用户名)函数返回的值。

  • 如果当前 App 是本地文件,则此脚本步骤不会返回任何值。

示例 1 

对于学生调查,提示用户输入其学生 ID,使用自定义函数 (IsStudentIDValid) 检查学生 ID 是否有效,然后将会话标识设置为学生 ID。

复制
设置字段[ 调查::学生ID ; "" ]
显示自定义对话框[消息:“输入您的学生证号码。”; 调查::学生ID ]
If [ IsStudentIDValid ( 调查::学生ID ) ]
    设置会话标识 [ 调查::学生ID ] 
Else
    显示自定义对话框 [ "需要有效的学生 ID。" ]
    退出脚本 [ 结果: "未提供有效的学生 ID。" ] 
End If