--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # CartJS: Bereichsbezogen # CartJS: Bereichsbezogen {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer Die CartJS- API stellt Methoden bereit, mit denen Sie auf den Einkaufswagen eines Anwenders zugreifen können. Diese API wird im Namespace `sn_sc ausgeführt`. Für den Zugriff auf die CartJS-API ist das standardmäßig aktivierte Service Catalog Scoped API-Plugin (ID: com.glideapp.servicecatalog.scoped.api) erforderlich. ## CartJS: CartJS(String CartName) {#ariaid-title2} Erstellt eine Instanz der CartJS-Klasse mit dem Namen eines definierten Einkaufswagens für den aktuell angemeldeten Benutzer. {#r_CJSS-CartJS_S__table_zs3_bhy_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | cartName | Zeichenfolge | Optional. Name eines definierten Warenkorbs für den aktuell angemeldeten Benutzer. | [Tabelle : 1. Parameter] {#r_CJSS-CartJS_S__table_zs3_bhy_5z} var cart = new sn_sc.CartJS(cart1); ## CartJS - addToCart(Mapping-Anforderung) {#ariaid-title3} Fügt die Anforderung eines Katalogelements zum aktuellen Einkaufswagen hinzu. {#r_CJSS-addToCart_M__table_ecz_zjy_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Anforderung | Zuordnung | Ein JSON-Objekt, das die Details des Katalogelements enthält, das dem Einkaufswagen hinzugefügt werden soll. Das request-Objekt hat folgende Struktur: { 'sysparm_id': item_id, 'sysparm_quantity': item_quantity, 'variables':{ 'var_name': 'var_value', ... } } * item_id: sys_id des Artikels, der dem Einkaufswagen hinzugefügt werden soll * item_quantity: Anzahl der hinzuzufügenden Elemente. Standardwert ist 1. * var_name: Name der Frage. * var_value: Wert der Antwort (nicht der Anzeigewert). {#r_CJSS-addToCart_M__ul_tdn_1ly_5z} | [Tabelle : 2. Parameter] {#r_CJSS-addToCart_M__table_ecz_zjy_5z} {#r_CJSS-addToCart_M__table_fcz_zjy_5z__entry__2} | Typ | Beschreibung | |-|-| | JSON | Struktur des aktuellen Einkaufswagens. { 'subtotal': value, 'items':[ { itemName:'', quantity:'', price:'', recurring_price:'' } ...] } | [Tabelle : 3. Ergebnisse] {#r_CJSS-addToCart_M__table_fcz_zjy_5z} In diesem Beispiel wird gezeigt, wie Sie dem Einkaufswagen mehrere Artikel hinzufügen können. Beachten Sie, dass `var Cart = new sn_sc.CartJS();` befindet sich in der Schleife. Sie müssen `sn_sc.CartJS()` mehrmals aufrufen, um dem Einkaufswagen mehrere Artikel hinzufügen zu können. for (i = 0; i < 2; i++) { var cart = new sn_sc.CartJS(); var item = { 'sysparm_id': '0d08837237153000158bbfc8bcbe5d02', 'sysparm_quantity': '1', 'variables':{ 'carrier': 'at_and_t_mobility', 'data_plan': '500MB', 'duration': 'eighteen_months', 'color': 'slate', 'storage': 'sixtyfour' }}; var cartDetails = cart.addToCart(item); gs.info(JSON.stringify(cartDetails)); } Ausgabe //The cart after the first item is added { "cart_id": "c0f5828a1b476010593876a61a4bcb71", "subtotal": "$599.99", "items": [ { "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02", "quantity": "1", "localized_price": "$599.99", "price": "$599.99", "recurring_frequency": "Monthly", "localized_recurring_price": "$30.00", "recurring_price": "$29.00", "item_name": "Apple iPhone 5", "cart_item_id": "40f5828a1b476010593876a61a4bcb72" } ] } //The cart after the second item is added { "cart_id": "c0f5828a1b476010593876a61a4bcb71", "subtotal": "$1,199.98", "items": [ { "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02", "quantity": "1", "localized_price": "$599.99", "price": "$599.99", "recurring_frequency": "Monthly", "localized_recurring_price": "$30.00", "recurring_price": "$29.00", "item_name": "Apple iPhone 5", "cart_item_id": "40f5828a1b476010593876a61a4bcb72" }, { "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02", "quantity": "1", "localized_price": "$599.99", "price": "$599.99", "recurring_frequency": "Monthly", "localized_recurring_price": "$30.00", "recurring_price": "$29.00", "item_name": "Apple iPhone 5", "cart_item_id": "98f5828a1b476010593876a61a4bcb75" } ] } ## CartJS -- canViewRF() {#ariaid-title4} Gibt an, ob der aktuelle Benutzer die erforderliche Rolle zum Bearbeiten des Request for-Feldes hat. {#CJSS-canViewRF__table_jy1_pzt_qbb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 4. Parameter] {#CJSS-canViewRF__table_jy1_pzt_qbb} {#CJSS-canViewRF__table_ky1_pzt_qbb__entry__2} | Typ | Beschreibung | |-|-| | Boolean | Kennzeichnung, die angibt, ob der Anwender über die erforderliche Rolle verfügt, um das Feld „Angefordert für" zu bearbeiten. Mögliche Werte: * „wahr": Anwender hat die erforderliche Rolle. * „falsch": Anwender verfügt nicht über die erforderliche Rolle. Datentyp: Boolesch | [Tabelle : 5. Ergebnisse] {#CJSS-canViewRF__table_ky1_pzt_qbb} Dieses Codebeispiel für ein Hintergrundskript zeigt, wie überprüft wird, ob der aktuelle Anwender über die zum Bearbeiten des Felds „Angefordert für" erforderliche Rolle verfügt. gs.log(sn_sc.CartJS.canViewRF()); Antwort: true ## CartJS -- checkoutCart() {#ariaid-title5} Führt den Einkaufswagen-Checkout durch. Wenn der zweistufige Checkout aktiviert ist, wird die Bestellübersicht zurückgegeben. Wenn der zweistufige Checkout deaktiviert ist, wird der Einkaufswagen übermittelt und die Details der generierten Anforderung werden zurückgegeben. {#r_CJSS-checkoutCart__table_vqd_hsd_zz__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 6. Parameter] {#r_CJSS-checkoutCart__table_vqd_hsd_zz} {#r_CJSS-checkoutCart__table_wqd_hsd_zz__entry__2} | Typ | Beschreibung | |-|-| | JSON | Wenn der zweistufige Checkout aktiviert ist, wird die Zusammenfassung der Artikel im Einkaufswagen zurückgegeben. { "subtotal_price":"", "subtotal_recurring_frequency":"", "delivery_address":"", "special_instructions":"", "total_title":"", "requested_for_user":"System Administrator", "requested_for":"6816f79cc0a8016401c5a33be04be441", "daily": ["frequency_subtotal":"", "items":[{}, {}, ...], ...], "monthly":["frequency_subtotal":"", "items":[{}, {}, ...], ...], "annually":["frequency_subtotal":"", "items":[{}, {}, ...], ...], "none":["frequency_subtotal":"", "items":[{}, {}, ...], ...], } Wenn der zweistufige Checkout deaktiviert ist: { 'request_id' : "sys_id of the generated request", "request_number" : "Number of the generated request" } | [Tabelle : 7. Ergebnisse] {#r_CJSS-checkoutCart__table_wqd_hsd_zz} var cart = new sn_sc.CartJS(); var checkoutInfo = cart.checkoutCart(); gs.info(checkoutInfo); Ausgabe If two step checkout enabled: {"subtotal_price":"$2,748.49","subtotal_recurring_frequency":"","delivery_address":"","special_instructions":"","total_title":"Total","requested_for_user":"System Administrator","requested_for":"6816f79cc0a8016401c5a33be04be441","weekly":{"subtotal_price":"$399.50","subtotal_recurring_frequency":"Weekly","subtotal_recurring_price":"$0.00","total_title":"Total","items":[{"catalog_item_id":"e90a0f7237153000158bbfc8bcbe5d7f","variables":{},"quantity":"1","localized_price":"$399.50","price":"$399.50","recurring_frequency":"Weekly","localized_recurring_price":"$0.00","recurring_price":"$0.00","item_name":"Brother Network-Ready Color Laser Printer","cart_item_id":"f3f5c9b3c322320076173b0ac3d3ae00","delivery_time":"2 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"show_subtotal_price":"true","cart_id":"251c0562c326320076173b0ac3d3aeb4","subtotal_recurring_price":"$131.00","monthly":{"subtotal_price":"$849.99","subtotal_recurring_frequency":"Monthly","subtotal_recurring_price":"$31.00","total_title":"Total","items":[{"catalog_item_id":"d82ea08510247200964f77ffeec6c4ee","variables":{"Monthly data allowance":"500MB","Storage":"64GB","Color":"Space Gray","Is this a replacement for a lost or broken iPhone?":"No","What was the original phone number?":""},"quantity":"1","localized_price":"$799.99","price":"$849.99","recurring_frequency":"Monthly","localized_recurring_price":"$30.00","recurring_price":"$31.00","item_name":"Apple iPhone 6s Plus","cart_item_id":"18c509b3c322320076173b0ac3d3aef4","delivery_time":"2 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"yearly":{"subtotal_price":"$1,499.00","subtotal_recurring_frequency":"Annually","subtotal_recurring_price":"$100.00","total_title":"Total","items":[{"catalog_item_id":"774906834fbb4200086eeed18110c737","variables":{"Adobe Photoshop":"false","Adobe Acrobat":"false","Optional Software":"","Additional software requirements":"","Eclipse IDE":"true"},"quantity":"1","localized_price":"$1,499.00","price":"$1,499.00","recurring_frequency":"Annually","localized_recurring_price":"$100.00","recurring_price":"$100.00","item_name":"Developer Laptop (Mac)","cart_item_id":"6306c9b3c322320076173b0ac3d3ae89","delivery_time":"5 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"subtotal_title":"Subtotal"} If two step checkout disabled: {"request_number":"REQ0010001","request_id":"2f2789f3c322320076173b0ac3d3ae62"} ## CartJS -- leer () {#ariaid-title6} Löscht den aktuellen Einkaufswagen. {#r_CJSS-empty__table_pzw_gjy_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 8. Parameter] {#r_CJSS-empty__table_pzw_gjy_5z} {#r_CJSS-empty__table_qzw_gjy_5z__entry__2} | Typ | Beschreibung | |-|-| | void | | [Tabelle : 9. Ergebnisse] {#r_CJSS-empty__table_qzw_gjy_5z} var cart = new sn_sc.CartJS(); cart.empty(); ## CartJS -- getCartDetails() {#ariaid-title7} Gibt die Einkaufswagendetails zurück. {#CJSS-getCartDetails__table_kct_215_qbb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 10. Parameter] {#CJSS-getCartDetails__table_kct_215_qbb} {#CJSS-getCartDetails__table_lct_215_qbb__entry__2} | Typ | Beschreibung | |-|-| | Objekt | Objekt, das auf die aktuellen Einkaufswagendetails zeigt. | [Tabelle : 11. Ergebnisse] {#CJSS-getCartDetails__table_lct_215_qbb} Beispiel: var cart=new sn_sc.CartJS(); console.log (cart.getCartDetails()); Ausgabe: delivery_address : "Brasilia,Brasil" name : "DEFAULT" requested_for : "62826bf03710200044e0bfc8bcbe5df1" requested_for_display_name : "Abel Tuter" special_instructions : "" sys_id : "c2ac090087150300318d05a888cb0bd7" ## CartJS -- getCartID() {#ariaid-title8} Gibt die ID des aktuellen Einkaufswagens zurück. {#r_CJSS-getCartID__table_l4t_j3y_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 12. Parameter] {#r_CJSS-getCartID__table_l4t_j3y_5z} {#r_CJSS-getCartID__table_m4t_j3y_5z__entry__2} | Typ | Beschreibung | |-|-| | Zeichenfolge | Sys_id für den aktuellen Einkaufswagen. | [Tabelle : 13. Ergebnisse] {#r_CJSS-getCartID__table_m4t_j3y_5z} Gibt die sys_id des aktuellen Einkaufswagens zurück. var cart = new sn_sc.CartJS(); var cartId = cart.getCartID(); gs.info(cartId); Ausgabe 039c516237b1300054b6a3549dbe5dfc ## CartJS -- getCartItems() {#ariaid-title9} Gibt ein GlideRecord-Objekt zurück, das Datensätze für Artikel im aktuellen Einkaufswagen enthält. {#r_CJSS-getCartItems__table_c5z_53y_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 14. Parameter] {#r_CJSS-getCartItems__table_c5z_53y_5z} {#r_CJSS-getCartItems__table_d5z_53y_5z__entry__2} | Typ | Beschreibung | |-|-| | GlideRecord | GlideRecord-Objekt mit Datensätzen und Feldern aus der Artikeltabelle \[sc_cart_item\], die einen Artikel im aktuellen Einkaufswagen beschreiben. | [Tabelle : 15. Ergebnisse] {#r_CJSS-getCartItems__table_d5z_53y_5z} Gibt die Feldwerte für Menge und Katalogelement für Artikel im aktuellen Einkaufswagen zurück. var cart = new sn_sc.CartJS(); var cartItems = cart.getCartItems(); while (cartItems.next()) { gs.info(cartItems.getElement('quantity').getDisplayValue() + " x " + cartItems.getElement('cat_item').getDisplayValue()); } Ausgabe 1 x Apple iPhone 6s Plus 1 x Apple iPhone 6s 1 x Apple MacBook Pro 15" ## CartJS -- getDeliveryAddress () {#ariaid-title10} Gibt die Lieferadresse für den aktuellen Einkaufswagen zurück. {#r_CJSS-getDeliveryAddress__table_ns4_cny_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 16. Parameter] {#r_CJSS-getDeliveryAddress__table_ns4_cny_5z} {#r_CJSS-getDeliveryAddress__table_os4_cny_5z__entry__2} | Typ | Beschreibung | |-|-| | Zeichenfolge | Lieferadresse für den aktuellen Einkaufswagen. | [Tabelle : 17. Ergebnisse] {#r_CJSS-getDeliveryAddress__table_os4_cny_5z} Legt die Lieferadresse für den aktuellen Einkaufswagen fest und gibt sie dann zurück. var cart = new sn_sc.CartJS(); cart.setDeliveryAddress("Brasilia, Brasil"); var deliveryAddress = cart.getDeliveryAddress(); gs.info(deliveryAddress); Ausgabe Brasilia, Brasil ## CartJS -- getRequestedFor() {#ariaid-title11} Gibt die sys_id des Anwenders zurück, für den der Einkaufswagen angefordert wird. {#r_CJSS-getRequestedFor__table_wds_4ly_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 18. Parameter] {#r_CJSS-getRequestedFor__table_wds_4ly_5z} {#r_CJSS-getRequestedFor__table_xds_4ly_5z__entry__2} | Typ | Beschreibung | |-|-| | Zeichenfolge | Sys_id des Anwenderdatensatzes, für den der Einkaufswagen angefordert wird; befindet sich in der Tabelle „Benutzer" \[sys_user\]. | [Tabelle : 19. Ergebnisse] {#r_CJSS-getRequestedFor__table_xds_4ly_5z} Gibt die sys_id des Anwenders zurück, die dem Einkaufswagen zugeordnet ist. var cart = new sn_sc.CartJS(); cart.setRequestedFor("039c516237b1300054b6a3549dbe5dfc") var userId = cart.getRequestedFor(); gs.info(userId); Ausgabe 039c516237b1300054b6a3549dbe5dfc ## CartJS -- getRequestedForDisplayName() {#ariaid-title12} Gibt den Namen des Anwenders zurück, für den der aktuelle Einkaufswagen angefordert wird. {#r_CJSS-getRequestedForDisplayName__table_y4j_dmy_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 20. Parameter] {#r_CJSS-getRequestedForDisplayName__table_y4j_dmy_5z} {#r_CJSS-getRequestedForDisplayName__table_z4j_dmy_5z__entry__2} | Typ | Beschreibung | |-|-| | Zeichenfolge | Name des Anwenders, für den der aktuelle Einkaufswagen angefordert wird. befindet sich in der Tabelle „Benutzer" \[sys_user\]. | [Tabelle : 21. Ergebnisse] {#r_CJSS-getRequestedForDisplayName__table_z4j_dmy_5z} Gibt den Namen des Anwenders zurück, der dem Einkaufswagen zugeordnet ist. var cart = new sn_sc.CartJS(); var userName = cart.getRequestedForDisplayName(); gs.info(userName); Ausgabe Abel Tuter ## CartJS -- getSpezielle Anweisungen () {#ariaid-title13} Gibt die Spezialanweisungen für den aktuellen Einkaufswagen zurück. {#r_CJSS-getSpecialInstructions__table_mj2_5my_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 22. Parameter] {#r_CJSS-getSpecialInstructions__table_mj2_5my_5z} {#r_CJSS-getSpecialInstructions__table_nj2_5my_5z__entry__2} | Typ | Beschreibung | |-|-| | Zeichenfolge | Spezielle Anweisungen für den aktuellen Einkaufswagen. | [Tabelle : 23. Ergebnisse] {#r_CJSS-getSpecialInstructions__table_nj2_5my_5z} In diesem Beispiel wird gezeigt, wie die Spezialanweisungen für den aktuellen Einkaufswagen festgelegt und abgerufen werden. var cart = new sn_sc.CartJS(); cart.setSpecialInstructions("Delivery before 8 AM."); var specInstruction = cart.getSpecialInstructions(); gs.info(specInstruction); Ausgabe Delivery before 8 AM. ## CartJS - orderNow (Zuordnungsanforderung) {#ariaid-title14} Bestellt einen einzelnen Artikel. Wenn der zweistufige Checkout aktiviert ist, fügt die Methode den angegebenen Artikel dem Einkaufswagen hinzu und gibt die sys_id des Einkaufswagens zurück. Wenn der zweistufige Checkout deaktiviert ist, schließt die Methode den Kauf des angegebenen Artikels ab und gibt die sys_id der generierten Anforderung zurück. {#r_CJSS-orderNow_M__table_n4w_b4d_zz__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Anforderung | Karte | JSON-Objekt, das Details des zu bestellenden Katalogelements enthält. | | request.delivery_address | Zeichenfolge | Adresse, an die die Artikel geliefert werden sollen. Standard: Adresse des Anwenders | | request.sysparm_id | Zeichenfolge | Erforderlich. Die sys_id des zu kaufenden Artikels. | | Anforderung.besondere_Anweisungen | Zeichenfolge | Anweisungen, die bei der Verarbeitung der Bestellung zu befolgen sind. | | request.sysparm_quantity | Zeichenfolge | Menge des angegebenen Artikels für den Kauf. Standard: 1 | | request.sysparm_requested_for | Zeichenfolge | Die sys_id des Anwenders, für den das Element angefordert wird. Standard: Sitzungsbenutzer | | Anforderung.Variablen | Array | Fragen und Kundenantworten, die dem Element zugeordnet sind. | | Anforderung.Variablen.var_name | Zeichenfolge | Name der Frage | | Anforderung.Variablen.var_Wert | Zeichenfolge | Antwort des Kunden auf die zugehörige Frage. | [Tabelle : 24. Parameter] {#r_CJSS-orderNow_M__table_n4w_b4d_zz} {#r_CJSS-orderNow_M__table_o4w_b4d_zz__entry__2} | Typ | Beschreibung | |-|-| | JSON-Schlüssel-Wert-Paare | Ausgabe, wenn der zweistufige Checkout aktiviert ist: { 'cart_id' : '' } Ausgabe, wenn der zweistufige Checkout deaktiviert ist: { 'request_id' : '', 'request_number' : '' } | [Tabelle : 25. Ergebnisse] {#r_CJSS-orderNow_M__table_o4w_b4d_zz} var cart = new sn_sc.CartJS(); var request = { 'sysparm_id': '0d08837237153000158bbfc8bcbe5d02', 'sysparm_quantity': '1', 'variables':{ 'carrier': 'at_and_t_mobility', 'data_plan': '500MB', 'duration': 'eighteen_months', 'color': 'slate', 'storage': 'sixtyfour' } } var cartDetails = cart.orderNow(request); gs.info(cartDetails); Ausgabe // If two-step checkout is enabled: {"cart_id":"55384df3c322320076173b0ac3d3aec5"} // If two-step checkout is disabled: {"request_id":"4c690137c322320076173b0ac3d3ae03", "request_number": "REQ0010003"} ## CartJS -- setDeliveryAddress(Zeichenfolgenadresse) {#ariaid-title15} Legt die Lieferadresse für den aktuellen Einkaufswagen fest. {#r_CJSS-setDeliveryAddress_S__table_xjn_kny_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | address | Zeichenfolge | Lieferadresse für den aktuellen Einkaufswagen. | [Tabelle : 26. Parameter] {#r_CJSS-setDeliveryAddress_S__table_xjn_kny_5z} {#r_CJSS-setDeliveryAddress_S__table_yjn_kny_5z__entry__2} | Typ | Beschreibung | |-|-| | void | | [Tabelle : 27. Ergebnisse] {#r_CJSS-setDeliveryAddress_S__table_yjn_kny_5z} var cart = new sn_sc.CartJS(); cart.setDeliveryAddress("Brasilia, Brasil"); ## CartJS -- setRequestedFor(String user) {#ariaid-title16} Legt die sys_id im sys_user-Datensatz des Benutzers fest, für den der Einkaufswagen angefordert wird. {#CJSS-setRequestedFor_S__table_rdc_gxt_qbb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Anwender | Zeichenfolge | sys_id, die im sys_user-Datensatz des Benutzers festgelegt werden soll, für den der Einkaufswagen angefordert wird. | [Tabelle : 28. Parameter] {#CJSS-setRequestedFor_S__table_rdc_gxt_qbb} {#CJSS-setRequestedFor_S__table_sdc_gxt_qbb__entry__2} | Typ | Beschreibung | |-|-| | void | | [Tabelle : 29. Ergebnisse] {#CJSS-setRequestedFor_S__table_sdc_gxt_qbb} var cart = new sn_sc.CartJS(); cart.setRequestedFor("039c516237b1300054b6a3549dbe5dfc") ## CartJS - setSpezielleAnweisungen(Zeichenfolge sonderAnweisungen) {#ariaid-title17} Legt die speziellen Anweisungen für den aktuellen Einkaufswagen fest. {#r_CJSS-setSpecialInstructions_S__table_iwt_5ny_5z__entry__3} | Name | Typ | Beschreibung | |-|-|-| | specialInstructions | Zeichenfolge | Spezielle Anweisungen für den aktuellen Einkaufswagen. | [Tabelle : 30. Parameter] {#r_CJSS-setSpecialInstructions_S__table_iwt_5ny_5z} {#r_CJSS-setSpecialInstructions_S__table_jwt_5ny_5z__entry__2} | Typ | Beschreibung | |-|-| | void | | [Tabelle : 31. Ergebnisse] {#r_CJSS-setSpecialInstructions_S__table_jwt_5ny_5z} var cart = new sn_sc.CartJS(); cart.setSpecialInstructions("Delivery before 8 AM."); ## CartJS --submitOrder(Mapping-Anforderung) {#ariaid-title18} Aktualisiert Spezialanweisungen, „Angefordert für" und Lieferadresse aus dem Parameter request und führt den Einkaufswagen-Checkout durch. Verwenden Sie diese API, um die genannten Parameter des Einkaufswagens zu ändern und den Einkaufswagen-Checkout gleichzeitig durchzuführen. Fehlende Parameter im Objekt request haben ihren Standardwert. {#r_CJSS-submitOrder_M__table_ymx_brd_zz__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Anforderung | Zuordnung | Ein JSON-Objekt, das Details zum Einkaufswagen enthält, der gesendet werden soll. { 'special_instructions': "String", 'requested_for': '"String", 'delivery_address': "String" } | | Anforderung.besondere_Anweisungen | Zeichenfolge | Der Bestellung beizufügende Spezialanweisungen. | | request.requested_for | Zeichenfolge | Sys_id des Benutzers, für den der Auftrag angefordert wird. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Standard: Der aktuelle Anwender. | | request.delivery_address | Zeichenfolge | Lieferadresse für die Bestellung. | [Tabelle : 32. Parameter] {#r_CJSS-submitOrder_M__table_ymx_brd_zz} {#r_CJSS-submitOrder_M__table_zmx_brd_zz__entry__2} | Typ | Beschreibung | |-|-| | JSON | Struktur des Einkaufswagens. { 'request_id' : 'sys_id of the generated Request', 'request_number' : 'Number of the generated Request' } | [Tabelle : 33. Ergebnisse] {#r_CJSS-submitOrder_M__table_zmx_brd_zz} Beispiel: var cart = new sn_sc.CartJS(); var request = { 'special_instructions' : 'Delivery only in working hours', 'requested_for' : '62826bf03710200044e0bfc8bcbe5df1', 'delivery_address' : "Brasilia, Brasil", }; var requestDetails = cart.submitOrder(request); gs.info(JSON.stringify(requestDetails)); Ausgabe: {"request_id":"6eed229047801200e0ef563dbb9a71c2", "request_number": "REQ0000001"} ## CartJS - updateItem(Mapping-Anforderung, Zeichenfolge „cart_item_id") {#ariaid-title19} Aktualisiert einen Artikel im Einkaufswagen. {#r_CJSS-updateItem_M_S__table_zvx_npd_zz__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Anforderung | Zuordnung | Ein JSON-Objekt, das Details des zu aktualisierenden Katalogelements enthält. Das request-Objekt hat folgende Struktur: { 'sysparm_quantity' : item_quantity, 'sysparm_requested_for' : requested_for, 'variables' : { 'var_name' : 'var_value', ... } } * item_quantity: Anzahl der hinzuzufügenden Elemente. Standardwert ist 1. * var_name: Name der Frage. * var_value: Wert der Antwort (nicht der Anzeigewert). {#r_CJSS-updateItem_M_S__ul_agy_ypd_zz} | | cart_item_id | Zeichenfolge | sys_id des zu ändernden Artikels im Einkaufswagen. | [Tabelle : 34. Parameter] {#r_CJSS-updateItem_M_S__table_zvx_npd_zz} {#r_CJSS-updateItem_M_S__table_awx_npd_zz__entry__2} | Typ | Beschreibung | |-|-| | JSON | Details zum Einkaufswagen. { 'subtotal': value, 'items':[ { itemName:'', quantity:'', price:'', recurring_price:'' } ...], ... } | [Tabelle : 35. Ergebnisse] {#r_CJSS-updateItem_M_S__table_awx_npd_zz} var cart = new sn_sc.CartJS(); var request = { 'sysparm_quantity': '1', 'variables':{ 'carrier': 'at_and_t_mobility', 'data_plan': '500MB', 'duration': 'eighteen_months', 'color': 'slate', 'storage': 'sixtyfour' } }; var cart_item_id = "4d69b672c322320076173b0ac3d3ae79"; var cartDetails = cart.updateItem(request, cart_item_id); gs.info(cartDetails); Ausgabe { "cart_id":"35ec9e8947a13200e0ef563dbb9a7109", "items":[ { "cart_item_id":"35ec9e8947a13200e0ef563dbb9a710a", "catalog_item_id":"0d08837237153000158bbfc8bcbe5d02", "item_name":"Apple iPhone 5", "localized_price":"$799.99", "localized_recurring_price":"$30.00", "price":"$799.99", "quantity":"1", "recurring_frequency":"Monthly", "recurring_price":"$29.00" } ] "subtotal":"$799.99" }