Exemples de projets et de cas d'emploi > Cas d'utilisation : 3D-Guided Service Instructions > 3D-Guided Service Instructions 303 - Création d'un panier persistant à l'aide de ThingWorx > Importation de cartThing dans ThingWorx Composer
  
Importation de cartThing dans ThingWorx Composer
A l'instar de la façon dont vous avez ajouté le shoppingThing dans la section 3D-Guided Service Instructions 302, vous allez ajouter un nouvel objet de table de données nommé cartThing. cartThing comprend huit services :
addToCart
checkCart
clearCart
getCart
getCartTotal
getOrder
getOrders
orderCart
Chacun de ces services joue le rôle d'une fonctionnalité différente, mais tous sont réunis pour créer un panier persistant dans ThingWorx.
1. Téléchargez le fichier metaShoppingEntities.twx.
2. Suivez les instructions pour l'importation et l'exportation de fichiers dans ThingWorx Composer.
3. Ouvrez cartThing une fois qu'il a été importé dans ThingWorx.
4. L'onglet Informations générales inclut des informations générales sur l'objet. Dans ce cas, le Nom, la Description, les Tags et le ThingTemplate de l'objet sont inclus. Les tags permettent de regrouper ou de catégoriser des entités ThingWorx et les modèles d'objet sont utilisés pour créer un nouvel objet reposant sur une base et une fonctionnalité communes.
5. Sous Informations générales, cliquez sur Services pour afficher tous les services associés à cartThing.
Service
Description
addToCart
Le service addToCart fonctionne de la même manière que la fonction addToCart que vous avez créée dans Vuforia Studio. Le service addToCart admet le numéro de pièce (pid), la quantité (qty) et le prix (price) de la pièce sélectionnée. En utilisant les informations d'entrée, ainsi que les informations utilisateur de ThingWorx, un ID d'utilisateur est créé pour désigner la personne utilisant le service. Cet ID d'utilisateur (uid) est un identificateur unique pour chaque commande et est nécessaire pour la persistance, car il différencie un utilisateur et ses sessions individuelles des autres. Lorsqu'une pièce est ajoutée au panier, ses informations sont stockées dans une entrée de table de données, qui est ensuite envoyée à la table d'informations utilisée pour stocker le panier.
getCart
Une fois qu'un panier a été créé, le service getCart est utilisé pour obtenir les entrées du panier. Il prend les informations qui ont été ajoutées au panier et les sort sous forme de table d'informations. Cela sert à mettre à jour le panier lorsque des modifications lui seront apportées dans l'expérience Vuforia Studio.
getCartTotal
Le service getCartTotal fonctionne comme getCart, mais au lieu de renvoyer une table d'informations complète, sa seule sortie correspond au prix total des éléments du panier.
checkCart
Lorsque des valeurs sont entrées dans addToCart, des erreurs peuvent être présentes. Par exemple, dans le cas d'un devis au prix incorrect pour un client, le service checkCart est utilisé pour valider toutes les informations produit entrées dans addToCart. Si des informations sont incorrectes, checkCart corrigera ces informations dans le panier.
clearCart
clearCart efface tous les éléments du panier.
orderCart
Une fois invoqué, le service orderCart place une commande pour toutes les pièces qui se trouvent dans le panier. Avant que le service orderCart ne termine, vous avez la possibilité de valider les informations du panier à l'aide de checkCart.
Une fois le service invoqué, un ID de transaction (tid) est créé avec le nom de l'utilisateur et le numéro de commande, et la propriété purchased de table d'informations est remplacée par true pour signifier que la pièce dans le panier a été achetée.
getOrder
Le service getOrder vous permet de saisir un ID de transaction (tid) et de recevoir toutes les informations sur cet commande spécifique dans un tableau.
getOrders
getOrders ignore l'entrée tid et affiche toutes les commandes qui ont été créées à partir du panier dans une table.
6. Sous Permissions, cliquez sur Temps d'exécution et assurez-vous que vos instances ThingWorx et Vuforia Studio disposent des droits d'accès complets pour cartThing. Cela permettra d'appeler le service dans Vuforia Studio.
7. Ensuite, vous allez ajouter le cartThing à Vuforia Studio.