标识符:格式参考和示例
Trackables 使用多个乍一看相似但服务于不同工作的标识符。短公共代码保持全局唯一,短秘密代码保持全局唯一,并且系统使这两个空间彼此不发生冲突,因此短公共代码永远不会也是其他人的短秘密代码。
| 格式 | 示例 | 目的 | 唯一性规则 |
|---|---|---|---|
| 公共代码令牌 | LN-7K4V9T |
用于公共链接和公共查找的公共安全令牌。 | 在所有可追踪物中具有全球唯一性,并且对于短密码也是唯一的。 |
| 公众进入路线 | https://locationnotes.com/trackable/LN-7K4V9T |
简短的可共享条目URL。浏览器可以对其进行本地化,然后打开位于<code>/{lang}/trackable/{publicCode}</code>的公共页面。 | 该路线保持唯一,因为短公共令牌本身是全球唯一的。 |
| 短秘密路线 | https://locationnotes.com/trackable/LN4C8R2Z |
基于拥有的条目 URL,适用于实际拥有该物品的人。 | 该前缀与站点系列匹配,但没有破折号,因此它与公共代码明显不同。 |
| 系统短密码 | LN4C8R2Z |
用于手动输入和活动会话激活的短期占有凭证。 | 在所有可追踪对象中具有全球唯一性,并且针对公共代码也是唯一的。 |
| 备用系统前缀 | GT8M2Q7V |
使用 GT 前缀的姊妹部署具有相同的短秘密模式。 | 在该部署的所有可跟踪项中都是唯一的。 |
| 带上你自己的密码 | ITEM42X |
已带有自己的标识符的物理项目的高级外部代码。 | 在所有可追踪对象中都是唯一的。它不能以 LN、GT 或 GC 开头。 |
| 私人扫描路线 | https://locationnotes.com/trackable/AB4D5QW2...<100 chars total>... |
长QR条目URL,因此扫描可以激活控球流程,而无需表单字段。 | 在所有可追踪对象中都是唯一的。 |
| 私人扫描令牌 | AB4D5QW2...<100 chars total>... |
仅使用 A-Z 和 1-5 的不透明 QR 令牌。 | 在所有可追踪对象中都是唯一的。 |
当有人手动输入生成的短密码或生成的公共代码令牌时,查找会容忍最常见的污迹。生成的代码查找将 O 视为 0,将 I 或 L 视为 1,将 S 视为 5,将 U 视为 V。对于系统短密代码,该替换逻辑适用于生成的正文,而不适用于 LN、GT 或 GC 等文字前缀。公共代码使用相同的配置前缀加上破折号,因此乍一看它们与短秘密代码在视觉上有所不同。
最重要的实用规则是公共路线可以安全共享,而短密码和私人扫描路线则不然。密码和私人扫描 URLs 在创建过程中仅显示一次。在该显示之后,正常页面和正常 API 读取不会再次显示它们。一个特殊的例外是面向离开的个人导出,其中可以包含严格个人用户拥有的秘密,以便离开的所有者可以恢复它们。
由于短公共代码是全局唯一的,因此主页查找本身可以安全地接受像 LN-7K4V9T 这样的公共令牌,并路由到正确的公共页面,而无需在多个可跟踪之间进行猜测。
公共代码、短密码或长私有扫描令牌的朝外条目 URL 始终从 <code>/trackable/{code}</code> 开始。然后,公共代码访问者会登陆位于 <code>/{lang}/trackable/{publicCode}</code> 的本地化公共页面。所有者范围内的可跟踪网站 URLs 不应存在。
激活和所有权
新创建的可跟踪对象可能会开始激活或未激活。激活始终发生在单个项目级别。激活用户为需要明确激活时身份的项目选择最终标题和描述。
可跟踪的读取模型还带有最后活动时间戳,因此仪表板、详细信息页面和监视列表可以一目了然地显示最近的动作或交互。
- 未激活的可跟踪无法记录新的旅程活动,也无法接收评论。
- 如果激活给某个用户,该用户就成为所有权范围。
- 如果激活到团队,则该团队成为所有权范围。
- 创造者和所有者并不总是同一个人。
组和后备元数据
可跟踪项可以一次创建一个,也可以以最多 100 个为一组。一组可以提供后备项目元数据、显示整个批次的激活进度,并为您提供一个在托管项目页面和公共项目页面之间移动的位置。
- 当某些组创建的项目自己的元数据为空时,可以安全地继承组默认值。
- 其他群组创建的项目需要最终激活者选择自己的标题和描述,而不是永远继承创建者的措辞。
- 完整的后备、编辑和分离优先规则位于专用的 什么是可追踪群组? 指导。
可追踪和注释
可追踪数据通过旅程停靠点成为移动历史。注释可以在该地点附加一个或多个可追踪对象,直接位置报告可以添加停靠点而无需创建注释。旅程保留地点快照,而笔记保留其自己的可编辑记录。
地点、历史和访问保持独立:旅程停靠点保留捕捉的坐标,注释保留其自己的可编辑记录,注释的可见性加上所需的访问范围决定谁可以打开注释内容。
这也是关联可追踪注释可见性变得有意义的地方。注释可以在该可见性模式下启动,并且最初的行为仍然类似于公共注释。然后,第一个链接的可追踪项将笔记翻转为可追踪门控发现,供除所有者、授权团队成员和已解锁其中一个链接可追踪项的查看者之外的所有人使用。
注意附件是故意的。该网站一次要求一个可跟踪代码,该字段需要一个现有的短秘密代码,而公共代码则用于公共可跟踪页面。如果第三方项目尚未注册,请先从可跟踪页面创建它。保留的站点前缀(例如 LN、GT 和 GC 仍然禁止使用自带代码。
- 尚无关联的可跟踪项:该注释的行为类似于公共注释。
- 第一次关联后:该笔记退出匿名公开发现和正常的公共笔记页面访问。
- 已解锁的查看者:已解锁相关可追踪项的人可以打开笔记页面并使用连接的公共笔记页面 API 路线。
- 所有者或授权团队成员:保留正常的笔记访问和管理权限。
- 保存带有附加可跟踪项的注释可以为每个附加项目创建停止快照。
- 登录用户还可以记录简单的直接地图停靠点,而无需先创建注释,然后如果需要更丰富的详细信息,则可以稍后将该停靠点转换为注释。
- 当附加可跟踪时,注释支持的停止点会快照坐标,因此稍后移动注释不会重写旧的可跟踪路径。
- 可追踪的读取模型还可以在该坐标处显示当前可见的笔记,因此即使附近的笔记后来发生变化,路线也可以保持准确。
- 可追踪页面可以预加载完整路线,因为这些旅程预计将保持人性化。
- 当查看者获得许可时,地图图钉和链接的停止列表都会返回到注释页面。
- 私人笔记仍然可以为不允许阅读笔记本身的查看者提供仅坐标旅程点。
访问一次可见与所有人始终可见
可追踪更容易解释为“一旦访问即可可见”与“所有人始终可见”。每个人始终可见的可追踪对象具有可共享的公共路线。访问一次可见的可跟踪仍然具有正常页面,但只有登录的所有者、团队范围或已通过秘密访问流链接的人员可以继续打开它。
短密码和QR流程是第一次证明拥有权的方式。登录帐户成功使用“访问一次可见”流程后,LocationNotes 可以继续将该可跟踪链接到该帐户,以便将来登录的设备不再需要该密钥即可重新打开、关注或评论该项目。 保存的访问权限成为可追踪信息稍后与自有旅程和团队旅程一起显示在登录的“我的旅程”页面上的方式之一。
可跟踪项和浏览器会话
输入密码或扫描有效的私人 QR 可以在当前浏览器上创建活动的可跟踪会话。这种记住的状态让人们可以继续学习流程,稍后登录,并从笔记页面附加可跟踪的内容,而无需每次都重新输入密码。
此活动浏览器会话与永久所有权不同,也与身份验证不同。它只是记住当前设备上的拥有上下文,直到用户停用它或会话过期。当查看者登录时,相同的“访问一次可见”访问权限也可以保存到帐户中,以供以后登录的设备使用。
评论和公共页面
可跟踪页面注释属于可跟踪本身,并且与注释页面注释分开。公共可跟踪页面是规范的旅程视图。私人资料页面、私人团队页面和仅在访问后可见的可跟踪页面是路由级别限制,而不是与项目相关的每个标签的全局保密。
该网站的公共可跟踪列表和公共可跟踪组列表保持多语言状态,因此当编写语言不同时,旅程、库存和物流数据不会消失。
当您想要围绕相同的公共可跟踪数据进行本地化 Chrome 时,请切换网站语言。
- 可追踪的名称、用户名和团队名称仍然可以出现在允许的列表和旅程上下文中。
- 当路线可用时,所有者标签可以显示为链接;当路线不可用时,所有者标签可以显示为带有私人页面悬停文本的纯文本。
- 经过认证的用户可以正常评论。当该浏览器已经具有对该确切可跟踪的主动访问权限或者调用者在写入请求上重新发送其秘密代码或私人扫描访问权限时,还允许匿名可跟踪评论和直接地图报告。
- 匿名可跟踪评论和直接报告的发布者以后无法对其进行编辑,并且只有可跟踪所有者或当前团队管理员才能删除它们。
导出、恢复和删除
可追踪信息与简单的个人记录不同,它可以在删除后保存下来,因为随着时间的推移,它们可以承载许多人的共享历史记录。系统尝试删除已删除用户的可删除个人活动,而不破坏其他用户或团队的剩余历史记录。
- 用户和团队导出现在包括可跟踪的旅程停靠点、注释支持的停靠点历史记录和可跟踪的评论。
- 用户导出可以包括严格个人拥有的秘密凭证。
- 团队导出会排除这些机密,除非用户所有者不可用且团队需要恢复副本。
- 删除用户并不会自动消除对其他人仍然重要的可追踪信息。
- 删除团队可以根据记录的后备规则分离团队所有权并收回控制权。