该 URL 将针对用户正在查看的任何镜头进行动态更新。
有三个字段与当前登录到 Shotgun 的用户相关,这些字段也可用于 URL 字符串:
{current_user.login}
{current_user.id}
{current_user.fullname}
要查找字段代码,请转到“字段”(Fields)页面下的“设置”(Settings)菜单,然后查看“字段代码”(Field Code)列。
专业提示:请尝试向实体添加一个文本字段,其中包含要加载到每个实体页面上的 URL。例如,您可以在资产实体上创建一个名为“Wiki”的字段,以便填充每个资产的 URL。然后,可以在您的页面上将该字段代码插入 URL 字段并括在括号内:{sg_wiki}
。这样只会插入文本字段中的 URL 并加载到页面中。
使用自定义 URL 来加载用于创建新实体的整页表单
您可以设置书签或创建一个 URL,用来打开可创建新实体(资产、镜头、任务等)的表单。如果您希望为“新建注释”(New Note)页面设置书签以便快速访问,此方法十分有用。
开发人员还可以添加指向其工具和应用程序的链接,将人员进一步链接到预先填充了正确数据的表单。例如,您可以构建一个工具,让正在查看版本的主管能够转到预先填好信息的注释表单。注释表单可以包含一个链接,该链接指向主管正在查看的版本,还可用来找到创建该版本的美工人员。此外,您也可以将新注释表单嵌入到 QT 应用程序中。
URL 的工作原理
基础站点 URL 依次附加了“new/”和实体名称。新注释的 URL 如下所示:
https://example.shotgunstudio.com/new/Note
结果页面如下所示:
在 URL 中使用系统实体名称
有关这些名称的完整列表,请参见站点偏好设置页面的实体部分。请注意,这些名称与显示名称不同。例如,人员实际上是 HumanUser。下面是几个其他示例:
新资产表单
https://{your shotgun base url}/new/Asset
新用户表单
https://{your shotgun base url}/new/HumanUser
新发票表单(自定义实体 1)
https://{your shotgun base url}/new/CustomEntity01
将值传递到表单
您可以通过 URL 将更多信息传递到表单。下面是几个示例:
指定项目
您可以将项目名称传递到 URL 以便自动填充项目下拉列表。如果存在重复的项目名称,则该下拉列表将忽略此查询字符串参数。
?project=Demo
指定其他默认字段值
使用系统字段名称来填充其他表单字段,即与 API 使用相同的 {"name": value} 表示法。例如:
?defaults={"content":"testing","sg_status_list":"ip"}
含有空格的项目名称
包含空格的项目名称(即“Demo Project X”)应该将空格 URL 编码并替换为 %20。例如:
https://{your shotgun base url}/new/Asset?project=Demo%20Project%20X&defaults={"content":"testing","sg_status_list":"ip"}
使用默认值的新注释表单 URL
您可以将文本传递到 URL 来填充实际注释。例如:
https://example.shotgunstudio.com/new/Note?project=Demo Project&defaults={"content": "This is a test note subject with a\nline break.","sg_status_list":"ip"}
多实体字段值
对于接受多个值的多实体字段(如 Ticket.addressings_cc),语法如下所示:
https://example.shotgunstudio.com/new/Ticket?project=Demo%20Project&defaults={"addressings_cc":[{"type":"HumanUser","name":"John%20Magoo"}]}
专业提示:您也可以创建一个页面或控件,在其中保存一个包含所有这些值的过滤器。例如,如果您有一个镜头控件,过滤器为“镜头序列”(Sequence)“是”(is)“Seq_001”,只要从该控件创建镜头,“镜头序列”(Sequence)字段便会填入“Seq_001”。
有关详细信息,请参见设计画布页面。