示例项目和用例 > 用例:3D-Guided Service Instructions > 3D-Guided Service Instructions 303:使用 ThingWorx 创建持久化购物车 > 将 cartThing 导入 ThingWorx Composer
  
将 cartThing 导入 ThingWorx Composer
类似于在 3D-Guided Service Instructions 302 中添加 shoppingThing,您将添加名为 cartThing 的新数据表事物。cartThing 由八个服务组成:
addToCart
checkCart
clearCart
getCart
getCartTotal
getOrder
getOrders
orderCart
这些服务中的每一个都有不同的功能,组合在一起可在 ThingWorx 中创建持久化购物车。
1. 下载 metaShoppingEntities twx 文件。
2. 按照文件导入和导出上的说明进行操作,将该文件导入 ThingWorx Composer。
3. cartThing 导入 ThingWorx 后,将其打开。
4. “常规信息”选项卡包含有关事物的常规信息。此例中包含事物的“名称”“说明”“标记”“事物模板”。标记用于对 ThingWorx 实体进行分组或分类,事物模板则用于根据通用基础及功能创建新事物。
5. “常规信息”下,单击“服务”以查看与 cartThing 关联的所有服务。
服务
说明
addToCart
addToCart 服务的工作原理与您在 Vuforia Studio 中创建的 addToCart 函数非常相似。addToCart 服务使用选定零件的零件号 (pid)、数量 (qty) 和价格 (price) 作为输入参数。结合使用这些输入信息以及 ThingWorx 中的用户信息,系统会创建用户 ID,以此来指定使用此服务的人员。此用户 ID (uid) 是每个订单的唯一标识符,可将用户及其个人会话与他人区分开来,因此对于维持购物车必不可少。将零件添加到购物车时,其零件信息将存储在数据表格中的条目内,然后发送到用于存储购物车的信息表中。
getCart
创建购物车后,getCart 服务将用于获取购物车的条目。该服务将获取添加到购物车中的信息,并将其输出为信息表。Vuforia Studio 体验中的购物车有更改时,该信息表将用于更新购物车。
getCartTotal
getCartTotal 服务的工作原理与 getCart 相似,但该服务不会返回整个信息表,而是仅输出购物车中物品的总价。
checkCart
addToCart 中输入值时,可能会发生错误。举例来说,假如对客户的报价不正确,使用 checkCart 服务可验证输入到 addToCart 中的所有产品信息。如有任何信息不正确,checkCart 将在购物车中更正该信息。
clearCart
clearCart 用于清除购物车中的所有物品。
orderCart
调用 orderCart 服务可为购物车中的所有零件下单。在 orderCart 服务完成之前,您可以选择使用 checkCart 来验证购物车中的信息。
调用服务后,系统将使用用户名和订单号创建事务 ID (tid),并将信息表的 purchased 特性更改为 true 以表示购物车中的零件已购买。
getOrder
getOrder 服务允许您输入事务 ID (tid) 并以一份表格接收有关该特定订单的所有信息。
getOrders
getOrders 跳过 tid 输入,在一份表格中显示从购物车中所下的所有订单。
6. “权限”下,单击“运行时”,并确保您的 ThingWorxVuforia Studio 实例对 cartThing 均都具有全部访问权限。这样您才可在 Vuforia Studio 中调用服务。
7. 接下来,您将Vuforia Studio 添加 cartThing