概念指南

什么是可追踪?

可追踪是一种可移动的物品标识,可以随着时间的推移积累基于地点的旅程历史记录。可追踪将物理对象或外部识别的项目连接到公共页面、基于所有权的代码流、评论和旅程地图。

标识符:格式参考和示例

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 仍然禁止使用自带代码。

访问一次可见与所有人始终可见

可追踪更容易解释为“一旦访问即可可见”与“所有人始终可见”。每个人始终可见的可追踪对象具有可共享的公共路线。访问一次可见的可跟踪仍然具有正常页面,但只有登录的所有者、团队范围或已通过秘密访问流链接的人员可以继续打开它。

短密码和QR流程是第一次证明拥有权的方式。登录帐户成功使用“访问一次可见”流程后,LocationNotes 可以继续将该可跟踪链接到该帐户,以便将来登录的设备不再需要该密钥即可重新打开、关注或评论该项目。 保存的访问权限成为可追踪信息稍后与自有旅程和团队旅程一起显示在登录的“我的旅程”页面上的方式之一。

可跟踪项和浏览器会话

输入密码或扫描有效的私人 QR 可以在当前浏览器上创建活动的可跟踪会话。这种记住的状态让人们可以继续学习流程,稍后登录,并从笔记页面附加可跟踪的内容,而无需每次都重新输入密码。

此活动浏览器会话与永久所有权不同,也与身份验证不同。它只是记住当前设备上的拥有上下文,直到用户停用它或会话过期。当查看者登录时,相同的“访问一次可见”访问权限也可以保存到帐户中,以供以后登录的设备使用。

评论和公共页面

可跟踪页面注释属于可跟踪本身,并且与注释页面注释分开。公共可跟踪页面是规范的旅程视图。私人资料页面、私人团队页面和仅在访问后可见的可跟踪页面是路由级别限制,而不是与项目相关的每个标签的全局保密。

该网站的公共可跟踪列表和公共可跟踪组列表保持多语言状态,因此当编写语言不同时,旅程、库存和物流数据不会消失。

当您想要围绕相同的公共可跟踪数据进行本地化 Chrome 时,请切换网站语言。

导出、恢复和删除

可追踪信息与简单的个人记录不同,它可以在删除后保存下来,因为随着时间的推移,它们可以承载许多人的共享历史记录。系统尝试删除已删除用户的可删除个人活动,而不破坏其他用户或团队的剩余历史记录。

相关指南