Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@sap-ux/ui5-middleware-fe-mockserver

Package Overview
Dependencies
Maintainers
3
Versions
214
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@sap-ux/ui5-middleware-fe-mockserver

SAP Fiori tools - UI5 middleware for the Fiori elements mock server

  • 2.2.32
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
23K
decreased by-15.9%
Maintainers
3
Weekly downloads
 
Created
Source

@sap-ux/ui5-middleware-fe-mockserver

Features

The SAP Fiori - UI5 middleware for the Fiori elements mock server is a middleware extension for the UI5 Tooling. As an alternative to proxying OData requests to a live backend, it supports loading mock data for OData v2/v4 requests for supported Fiori elements templates. As the mock server runs locally without requiring a network connection to a backend system, it is useful for development and test scenarios.

Installation

npm npm install --save-dev @sap-ux/ui5-middleware-fe-mockserver

yarn yarn add @sap-ux/ui5-middleware-fe-mockserver --dev

pnpm pnpm add @sap-ux/ui5-middleware-fe-mockserver --dev

Usage

In order to use the mock server, the npm module @sap-ux/ui5-middleware-fe-mockserver needs to be added as devDependency and ui5.dependencies to package.json, and a valid ui5.yaml configuration needs to be provided. Entries in package.json

[..]

"devDependencies": {
    "@sap-ux/ui5-middleware-fe-mockserver": "^2"
},
"ui5": {
    "dependencies": [
        "@sap-ux/ui5-middleware-fe-mockserver"
    ]
}

[..]

Example for a yaml configuration file


specVersion: '2.0'
metadata:
  name: <NAME>
type: application
server:
  customMiddleware:
    - name: sap-fe-mockserver
      mountPath: /
      afterMiddleware: compression
      configuration:
        annotations:
          - localPath: './webapp/localService/myServiceAnnotation.xml'
            urlPath: '/sap/opu/odata/IWFND/CATALOGSERVICE;v=2/Annotations*'
        services:
          - urlPath: '/sap/opu/odata/sap/<SERVICE_NAME>'
            metadataPath: './webapp/localService/metadata.xml'
            mockdataPath: './webapp/localService/data'
          - urlPath: '/sap/opu/odata/sap/<OTHER_SERVICE_NAME>'
            metadataPath: './webapp/localService/other_metadata.xml'
            mockdataPath: './webapp/localService/data'

Special case within karma

If you are running the mockserver embedded in karma you need to change the configuration to use

beforeMiddleware: csp instead of afterMiddleware: compression

Service Configuration

Each service must provide at least two things

  • urlPath : where will your service be accessible from
  • metadataPath : local path to your metadata file

On top of that you can specify one of the following option

  • mockdataPath : the path to the folder containing the mockdata files
  • generateMockData : whether or not you want to use automatically generated mockdata
  • forceNullableValuesToNull: determine if nullable properties should be generated as null or with a default value (defaults to false)

Additional option are available either per service of for all services if defined globally

  • debug : toggle the debug mode
  • watch : toggle the watch mode, the mockserver will restart the service where data or metadata have changed
  • noETag : disable ETag support on metadata
  • strictKeyMode : disable the default "loose" mode for the key matching, you can try this if the mockserver returns too much data
  • contextBasedIsolation : enable the support of "tenants", by adding /tenant-xxx at the very start of your service call you will be able to work on tenant isolated data.

You can also define static annotation file using the annotations entry, each annotation must provide

  • urlPath : where will your annotation be accessible from
  • localPath : local path to your annotation file

Documentation

You can find more details on how to influence the mockserver behavior for mockdata by checking the documentation under Defining Mockdata

We also have samples available in the samples folder

Sample application

See the usage in demo apps SAP Fiori sample apps

Support

Join the SAP Fiori tools Community. Ask Questions, Read the Latest Blogs, Explore Content. Please assign tag: SAP Fiori tools

To log an issue with SAP Fiori tools, please see Contact SAP Support.

Keywords

Mockserver, Middleware

FAQs

Package last updated on 13 Mar 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc