应用程序商店

从管理员向您开放的目录中，把小程序（applet）安装到您自己的登录账户上。每一次安装都只针对一个登录账户，从不针对整个租户；私有目录之所以出现在这里，只是因为 Tenant Admin 把您关联到了它。这里没有任何东西是购买或付费的：商店里没有价格、方案或订单，付费小程序在商店之外另行安排。

概述

Applet Store 是一个平台画面，已登录的用户在这里浏览其登录账户获准访问的小程序目录，并把小程序安装到自己的账户上。本网站上每一条"安装某某小程序"的说明，指向的都是这个画面。

它有两点决定了本页几乎所有其他内容。第一，安装是按用户，而不是按租户：每次安装写入一行，把您的登录账户与某一个目录中的某一个小程序关联起来，后端会拒绝为其他任何人的登录账户提交的安装。第二，您能看到什么是在别处决定的 —— 目录分为公开或私有，私有目录之所以能到达您这里，只是因为管理员在 Tenant Admin Applet 中把您的登录账户关联到了它。

它在注册表中的行是 appletStore，名称 Applet Store，类型为 ROOT-USER，状态 ACTIVE。它没有自己的设置（见配置）。

所处位置

画面和菜单

所有内容都挂载在 applets/bigledger/akaun-platform/applet-store 之下。没有侧边栏：导航是列表画面顶部由三个链接组成的栏。

使用条款关卡

商店中的每一个画面之前都会运行一个守卫（guard）。它读取已登录用户的个人资料扩展，查找代码中含有 APPLET_STORE_TNC 且数值为真的参数。如果有，您会直接通过，再也不会看到这个对话框。如果没有，就会打开一个全高、无法关闭的对话框，显示 Akaun.com Marketplace Terms of Use、一个 I have read the terms and conditions 复选框，以及 Accept / Decline 按钮。勾选复选框之前，Accept 处于禁用状态。接受会把接受记录写入您的用户资料（见生命周期和影响）；拒绝会把您弹回启动台。

接受是按登录账户记录的，而不是按租户或公司。即使企业中其他所有人都已接受，一位新同事第一次访问时也会看到这个对话框。

列表画面

三个列表画面都渲染同一个组件，所以看起来很相似：

• 一个写着 Catalog 的标题栏，带有 Public、Private 和 My Applets 链接。
• 一个 Search for applets 搜索框。它筛选的是已经加载到浏览器中的行 —— 不会重新查询服务器。在 Public 和 My Applets 标签页上，它匹配小程序名称；在 Private 标签页上，它在短暂的输入停顿之后匹配小程序名称或目录名称。
• 一个小程序卡片网格。
• 仅在 Public 和 Private 标签页上，有一个 Install All 按钮。当画面上的每个小程序都已安装或被阻止安装时，它会变灰。

Public 标签页在一次请求中加载所有公开目录，并把小程序显示为一个平铺网格，每张卡片带有其目录的名称。由同一个租户、以同一个等级（rank）提供的同一个小程序，即使位于两个目录中，也只显示一次。

Private 标签页每次请求加载一个目录。滚动到底部 —— 或按网格下方的 Load More 按钮 —— 会获取下一个，所以拥有许多私有目录的用户是一页一页地看到它们，而不是一次全部看到。

My Applets 显示标题 My Installed Applets，列出您的登录账户已安装的内容。它没有 Install All 按钮，也没有卸载控件；卸载在小程序的详情画面中进行。

视口宽度低于 500 px 时，列表会自动切换为深色主题；高于此宽度时为浅色。这是宽度测试，不是操作系统偏好测试。

小程序详情画面

点击任何卡片都会打开详情画面，其布局类似消费类应用商店的商品页：

• 主视区 —— 图标（可点击，打开原尺寸）、名称，以及最多四项统计：Rating（平均分，或"No ratings"）、Rank、Tenant、Status（Installed / Not installed）。
• Documentation 按钮 —— 在新标签页中打开小程序的文档 URL。当该小程序的注册表行没有文档 URL 时，它处于禁用状态。
• Share 按钮 —— 在有原生分享面板的浏览器中使用它，否则把当前页面 URL 复制到剪贴板，并用一条提示消息确认。
• Install，或者 —— 安装之后 —— Uninstall 和 Open。
• Preview —— 小程序截图的横向滚动图库，按其序号排序。小程序没有图片时，整个部分会被隐藏。
• About this app —— 描述，以及注册表中有记录时的 Version 和 Updated on。没有描述时，它显示 No description is available for this applet yet.
• Rate this applet / My review —— 一排五颗星，以及一个 Write a review / Edit your review 链接，打开一个带星级和评论框的对话框，评论上限为 500 个字符。
• Ratings and reviews —— 平均分、一星到五星数量的五条柱状图、总数，以及其他用户的评论。您自己的评论会从该列表中提出来，放到上面的部分。

配置

使用之前

小程序设置

商店没有任何类型的设置。它写入的唯一按用户状态，是您对使用条款的接受。

其他小程序中控制本小程序的设置

功能可见性和权限

Applet Store 没有客户端权限。商店中没有任何东西会因权限集而隐藏或显示。权限是在服务器上按端点执行的：

一行已安装记录实际为您带来什么

已安装的关联不是装饰，但也不是完整的答案。如果您正在决定谁可以打开什么，这两半都很重要。

它是一道真实的关卡，只有一次。 小程序不能用您普通的登录令牌与平台通信。启动时，它会把该令牌换成一个小程序令牌（applet token），而服务器只有在确认该小程序已在该租户中为您的登录账户安装之后才会签发；没有安装，交换会被拒绝，信息为 One or more Applet/Tenant Code combination does not exist。所以"卸载它，他们就用不了"是真的。

越过这道关卡之后，API 并不是按小程序组织的。 服务器端的权限代码是以它们保护的资源命名的 —— 一个客户、一张单据、一次导出 —— 从不以小程序命名，而令牌中携带的小程序身份几乎只被用来标记审计记录。整个平台上只有两个端点要求小程序令牌。对访问模型的实际影响是：少安装小程序会整理一个人通过画面能到达的地方；它并不限制他们的登录账户通过 API 能做什么。 对一个执意的人仍然有效的限制，是权限集，而不是小程序列表。

而一次安装可能会悄无声息地让某人进入一个租户。 授予一个小程序，也会确保该登录账户存在于该小程序的租户中，而授予落入的租户取自小程序与目录的关联行，而不是取自您正在邀请对方加入的那个租户。因此，一个其中各行指向不止一个租户的目录，会在一次邀请中让这个人进入所有这些租户。请审慎地组成目录，并在把一个目录用作邀请对象之前检查每一行上的租户 —— 这就是"不要分发一个您没有看过里面内容的目录"这条建议背后的具体原因。

字段

商店没有创建或编辑表单。以下是它显示的字段，以及它接受的唯一一个字段。

小程序卡片（全部三个列表）

在 Public 和 Private 标签页上，卡片的标题是注册表中小程序的名称，每次加载都重新读取；目录不能给小程序改名，所以在 Developer SysAdmin Applet 中的改名会立即反映到这些卡片上。

小程序详情画面

评论对话框

生命周期和影响

Applet Store 是一个工具类小程序。它不过账日记账，不移动库存，也不向任何租户分类账写入任何东西。它改变的一切都位于平台（master）数据库中。

值得知道的三个后果：

• 卸载是可逆的，不会销毁任何东西。 它删除的是您的登录账户与小程序之间的关联。从同一个目录条目重新安装，就能把小程序找回来；小程序在租户中保存的数据无论哪种情况都不受影响。
• Install All 在不同目录之间不是幂等的。 它会跳过任何已安装和被阻止的内容，所以按两次是安全的，但它只安装画面上的内容 —— 在 Private 标签页上，那是到目前为止已加载的目录，而不是全部目录。
• 已经从一个目录安装的小程序，不能再从另一个目录安装。 列表会把这样的卡片标记为被阻止并拒绝点击，提示文字为 This applet has been installed in another catalog!

这个小程序中没有需要管理的状态。已安装的关联要么存在且为 ACTIVE，要么不存在。

相关小程序

• Developer SysAdmin Applet —— 注册小程序以及商店显示的关于它的一切。如果某个列表看起来不对，它背后的记录是在那里编辑的。
• Tenant Admin Applet —— 建立目录，决定谁能看到私有目录，并为租户中的其他用户批量安装小程序。它是这个面向用户的画面在管理员一侧的对应物。

故障排除

相关文档

以下页面目前只有英文版。