Release Information for TUA Spartacus Libraries

Note: Spartacus 4.x is no longer maintained. Please upgrade to the latest version.

Note: Spartacus 4.x was tested with SAP Commerce Cloud versions 1905 to 2205. Spartacus 4.x has not been verified to work with (and is not guaranteed to work with) SAP Commerce Cloud 2211 or later releases.

Last updated April 1, 2022 by Deborah Cholmeley-Jones, Solution Owner, TUA Spartacus

Table of Contents

Introduction

This document describes what is included in all Spartacus libraries since the initial 1.0 release, up to 3.2.

Disclaimer - Forward-Looking Statements

This document contains or may contain forward-looking statements. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions. Any information is subject to change for any reason without notice. The information in this document is not a commitment, promise or legal obligation to deliver any material, code or functionality. This document is provided without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. This document is for informational purposes and may not be incorporated into a contract. SAP assumes no responsibility for errors or omissions in this document, except if such damages were caused by SAP’s intentional or gross negligence.

The various documentation links provided point to SAP Commerce Cloud or Accelerator documentation or third-party external links. These links are included for information purposes only and may not reflect exactly what is implemented in Spartacus.

Release 4.1

Release 4.1 libraries published April 1, 2022

Release 4.1 uses Angular 12, and the following feature is introduced:

Release 4.0

Release 4.0 libraries published March 15, 2022

As release 4.0 is a new major version, it contains breaking changes. To migrate to 4.0 from 3.0, please see the following documentation:

You can refer to the core Release Information for All Versions of Spartacus Libraries for all versions of Spartacus Libraries documentation for updates on the Spartacus framework including the upgrade to Angular 12 and related dependencies.

Note: For information on core commerce Spartacus, see Updating to Version 4.0.

Release 3.2

Release 3.2 libraries published January 13, 2022

The 3.2 libraries for the accelerator provides a new B2B Telco Spartacus storefront along with sample data. Angular 10 is used in this release. B2B functionality supported includes:

Release 3.1

Release 3.1 libraries published September 1, 2021

The 3.1 libraries for the accelerator provides a new Media Spartacus storefront along with sample data. With 3.1, the TUA libraries support three storefronts: Telco, Utilities, and Media. Angular 10 is used in release 3.1.

Following feature is introduced in release 3.1:

Release 3.0

Release 3.0 libraries published April 7, 2021

As release 3.0 is a new major version, it contains breaking changes. To migrate to 3.0 from 2.x, please see the following documentation:

Following features are introduced in release 3.0:

You can refer to the core Release Information for all versions of Spartacus Libraries documentation for updates on the Spartacus framework including the upgrade to Angular 10 and related dependencies.

Note: For information on core commerce Spartacus, see Updating to Version 3.0.

We welcome your feedback. If you have technical questions, you can get in touch with us on Stack Overflow. For non-technical questions, you can reach us on our Slack workspace.

Release 2.0

Release 2.0 libraries published December 15, 2020

As release 2.0 is a new major version, it contains breaking changes. To migrate to 2.0 from 1.x, please see the following documentation:

Please refer to core Release Information for All Versions of Spartacus Libraries documentation for updates on the Spartacus framework including the upgrade to Angular 9 and related dependencies.

Pricing

It is important to note that Spartacus 2.0 for TUA completely leverages the new composite pricing framework introduced with TUA release 2007. This means that the Spartacus 2.0 for TUA no longer supports Subscription Rate Plan pricing.

What’s new?

Pricing complex services for telcos, utilities, or other industries, require a pricing mechanism that can handle multiple types of charges (recurring charges, one-time charges, and usage-based charges) that may also have multiple of each type of charge, as well as tiered pricing. Composite pricing is now supported in the TUA Sparatacus storefront and provides the visibility of all pricing information that a customer needs to make an informed purchasing decision. For more information, see Composite Pricing in the TUA Help portal.

Customers are always interested in getting the best deal for products and services. With price alteration discounts, customers are able to see the discounted price of the product offerings before adding the item to the shopping basket. For more information, see Pricing - Price Alteration Discounts in the TUA Help portal.

Appointment scheduling is important as it ensures that you make the best use of your time and the providers time so that they can provide remarkable service. This goes without saying for customers purchasing multiple services, and having a single service appointment to service the multiple services ordered. For more information, see Journey Management - Appointment Scheduling in the TUA Help Portal.

Release 1.3

Release 1.3.0 libraries published November 11, 2020

What’s new?

While it can be hard to pinpoint precisely how much your electric and water bill will cost each month, the Cost Estimation feature helps provide an indication as to the average monthly bill for a given product offering based on the anticipated consumption provided by a customer. Leveraging the anticipated usage provided by a customer, the estimated monthly and annual cost for applicable product offerings can be presented to the customer.

Customers interested in acquiring product offerings, such as commodity items (for example, electricity or gas) need to have an availability check of the premise details. As an example, the premise address and meter id is needed to conduct a serviceability check for a commodity product offering. For more information, see Serviceability example in the TUA Help portal.

Release 1.2

Release 1.2.0 libraries published October 28, 2020

What’s new?

Journey Management facilitates real-time personalized customer journeys enabling online customers to successfully place an order. With the MSISDN checklist action in place, customers who wish to purchase a simple product offering that requires an MSISDN selection, will be required to select their new telephone number as part of the ordering process. For more information, see Journey Management in the TUA Help portal.

Release 1.1

Release 1.1.0 libraries published October 7, 2020

Increase NPS with the Customer Product Inventory. This features helps companies understand their customers by having a complete view of the “recurring” relationships or assets, their customers have with them. The Customer Product Inventory is used to dynamically determine user journeys: what the customer is interested in, what they are willing to pay, and what products, services, and prices they are entitled to. For more information, see Customer Product Inventory (CPI) in the TUA Help portal.

Maximize customer retention by understanding the consumption of services by customers. Not all customers are created equal. Some subscribers are more valuable than others. With consumption data available, companies are able to analyze the data and provide customers with some highly engaging content, upgrades, or promotional offers to keep subscribers engaged. On the flip side, with consumption data visible, customers are able to see for themselves how much of the services they are actually consuming, which helps them maximize their investment and make more informative decision. For more information, see Create Average Service Usage for Subscribed Product in the TUA Help portal.

Release 1.0

Release 1.0.0 libraries published September 9, 2020

The commercial product catalog for service industries is different and the distinction between product offerings and products is important to understand. Simple product offerings are different than retail products and represents what is externally presented to the market. For more information, see Simple Product Offerings in the TUA Help portal.

To support the commercial product catalog of product offerings, changes were required in the way “searches” are technically conducted to search for and find simple product offerings. Changes were made in the areas of free text search, facets, and top level category menu navigation. For more information, see Product Offering Search in the TUA Help portal.

To support product offerings and the complex pricing structure they have for one time charges, recurring charges and usage charges, changes to the cart were necessary. For more information, see Cart in the TUA Help portal.

To support product offerings and the complex pricing structure, they have for one time charges, recurring charges, and usage charges, changes to the order were necessary. For more information, see Order in the TUA Help portal.

To support product offerings and the complex pricing structure they have for one time charges, recurring charges and usage charges, changes to the checkout process were necessary. For more information, see in the TUA Help portal. For more information, see Checkout in the TUA Help portal.

Improves the user experience by simplifying the purchase process for complex bundled product offerings. Configurable Guided Selling (CGS) is the process in which a customer is taken through a step-by-step guided selling journey to purchase a complex product bundle. For more information, see Configurable Guided Selling in the TUA Help portal.

Provide greater customer experiences by providing product offerings to customers with specific pricing that they are eligible for. Pricing for product offerings is extremely complex and includes one time charges, recurring charges and usage based charges. For more information, see Pricing in the TUA Help Portal.

About Spartacus for TUA Releases

  • Libraries that are “released” are new, official, tested TUA Spartacus libraries available to the public (hosted on npmjs.com)
  • We usually publish new libraries every 2 weeks
  • Similar to Spartacus: A change in minor means we added new features, but they are configured to be off by default, so as not to cause compatibility issues. A new minor also means inclusion of changes or bug fixes that may affect compatibility, but these are also controlled by feature flags. So all significant changes are “opt-in”. See feature flag documentation for more information.
  • We will normally publish pre-release libraries labelled ‘next’ a few weeks before a new minor release. The goal is to provide early access to new features and get feedback from the community.
  • If you choose not to use a new feature, you should have no problems upgrading to a new Major.# with features flag set to a previous Major.#. If you do see a problem, please report a bug and we’ll assess and fix it. We encourage you to upgrade to latest libraries frequently during development in order to take advantage of bug fixes and new features.
  • Please visit our Spartacus for TUA Compatibility Matrix to understand requirements. For more information, see Feature Compatibility Matrix.
  • To use all functionality in Spartacus 2.*, release 2005 of SAP Commerce Cloud and 2007 of Telco & Utilities Accelerator is required.
  • The latest patch release is required or at least strongly recommended, as it usually contains bug fixes that affect Spartacus

Upgrading TUA Spartacus Libraries to a New Minor Version

You can upgrade your TUA Spartacus libraries to a new minor version, as follows:

  1. In package.json, set your @spartacus libraries to “~2.#.0", where # is replaced with the release version number you wish to upgrade to.

    If you are upgrading from 1.x to the latest 1.3 release in order to then upgrade to 2.x, in package.json, set your @spartacus libraries to “~1.3.3".

  2. Make sure other entries in package.json match with below configuration. (If not available add below entries)

    "@angular/localize":"^9.1.0",    
 "@angular/service-worker": "~9.1.0",
 "@ng-bootstrap/ng-bootstrap": "6.0.0",
 "@ng-select/ng-select": "^4.0.0",
 "@ngrx/effects": "~9.0.0",
 "@ngrx/router-store": "~9.0.0",
 "@ngrx/store": "~9.0.0",
 "bootstrap": "^4.2.1",
 "chart.js": "^2.9.3",
 "express": "^4.15.2",
 "i18next": "^19.3.4",
 "i18next-xhr-backend": "^3.2.2",
 "material-design-icons": "^3.0.1",
 "ng2-charts": "^2.3.2",
 "ngx-infinite-scroll": "^8.0.0",
 "ngx-spinner": "^9.0.1",
 "jquery": "^3.5.1"
  3. Inspect the mystore/src/app/app.module.ts file for any changes you want to make for your setup.
    • Remove the premiseLookup entry from the backend section if present.
    • Remove saveForLater: false from features section if present.
    • Remove the utilitiesspa entry from the baseSite list under the section context.
    • Update level under features section to 2.0.0.
    • Add the following import /mystore/src/polyfills.ts in the file:
     import '@angular/localize/init';    
 import 'zone.js/dist/zone';

  4. Add the following entry /mystore/tsconfig.json in the mystore/src/app/app.module.ts file if not already available:

     “enableIvy”: false
  5. Delete your node_modules folder.
  6. Run yarn install.

Feature Releases

For more information, see Roadmap for TUA Spartacus.