專案範例和使用案例 > 使用案例:3D-Guided Service Instructions > 3D-導件服務指示 303:使用 ThingWorx 建立持續購物車 > 將 cartThing 匯入到 ThingWorx Composer
  
將 cartThing 匯入到 ThingWorx Composer
與您在 3D-Guided Service Instructions 302 中新增 shoppingThing 一樣,您會新增名為 cartThing 的新「資料表格物件」。cartThing 由 8 個服務組成:
addToCart
checkCart
clearCart
getCart
getCartTotal
getOrder
getOrders
orderCart
這些服務每個提供不同的功能,但全部都可以用來在 ThingWorx 中建立持續購物車。
1. 下載 metaShoppingEntities.twx 檔案。
2. 請遵循將檔案匯入與匯出ThingWorx Composer 的指示。
3. 匯入 cartThingThingWorx 後立即將其開啟。
4. 「一般資訊」標籤包含「物件」的一般相關資訊。在本案例中,會包含「物件」的 NameDescriptionTagsThingTemplate。使用 Tags 對 ThingWorx 實體進行分組或分類,而 ThingTemplates 則是用來根據通用基礎與函數建立新物件。
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. 接著您會新增 cartThing 至 Vuforia Studio