该 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”。

有关详细信息，请参见设计画布页面。