Related Github Documents
Document Properties
Last Modified22-Apr-2020
Added to KB29-Apr-2020
Public AccessEveryone
Doc TypeGuidelines, Concepts & Cookbooks
ProductIntershop Progressive Web App

Guide - Intershop Progressive Web App - Data Handling with Mappers

Data Handling with Mappers

The data models for server-side and client-side have to be separated, because the data sent by the server may change over iterations or may not be in the right format, while the client side shop data handling should be stable for a long time.
Therefore, each service communicating with the Intershop REST API should only respond with mapped PWA models.

The format of raw data from the server is defined by an interface (.interface.ts) and mapped to a type used in the Angular application (.model.ts).
Both files have to be close together so they share a parent directory in src/core/models.
Next to them is a .mapper.ts to map the raw type to the other.


export interface CategoryData {
  id: string;
  name: string;
  raw: string;


export class Category {
  id: string;
  name: string;
  transformed: number;


@Injectable({ providedIn: 'root' })
export class CategoryMapper {
  fromData(categoryData: CategoryData): Category {
    const category: Category = {
      transformed: CategoryHelper.transform(categoryData.raw),
    return category;

  fromObject(category: Category): CategoryData {
    const categoryData: CategoryData = {
      raw: CategoryHelper.raw(categoryData.transformed),
    return categoryData;

A .helper.ts can be introduced to provide utility functions for the model.


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources