@sap-devx/feature-toggle-node

feature-toggle-node

A Node.js module for enabling or disabling Node.js-based SAP Business Application Studio features.

Description

This module is used to inquire if an SAP Business Application Studio feature toggle is enabled or disabled.

This module should be used if your SAP Business Application Studio extension is written in Node.js or TypeScript and you want to control the extension features via feature toggle.

Requirements

• ES2017 or higher

Download and Installation

Install the feature-toggle-node as a dependency.

1. Import the extension into your SAP Business Application Studio.

2. Open the command prompt at the root of your extension.

3. Add the feature-toggle-node to the dependency section of your 'package.json' file by entering the following in the command prompt:

   $ npm install @sap-devx/feature-toggle-node --save
   

Configuration

To run the feature-toggle-node locally, you need to provide the following environment variables:

• FT_SERVER_ENDPOINT - Feature toggle server endpoint (mandatory)
• WS_BASE_URL - URL to the SAP Business Application Studio Cloud Foundry (mandatory)
• USER_NAME - Name of the user logged into SAP Business Application Studio (mandatory)
• FT_CLIENT_REFRESH_INTERVAL - Feature toggle client refresh interval (optional, default value: 10s)
• SHOW_LOG - If true, displays console logs (optional)

Environment variables example:

"FT_SERVER_ENDPOINT": "http://unleash.herokuapp.com",
"USER_NAME": "[e-mail]",
"FT_CLIENT_REFRESH_INTERVAL": "6s",
"TENANT_ID" : "b5c05535-9495-4050-9d68-4356d0d34136",
"TENANT_NAME": "cfsubaccount" // subaccount,
"WORKSPACE_ID": "workspaces-ws-x66m6",
"SHOW_LOG": "true",

Usage

Use the feature-toggle-node as follows:

import { isFeatureEnabled } from "@sap-devx/feature-toggle-node";

(async () => {  
  if (await isFeatureEnabled("EXTENSION_NAME", "FEATURE_TOGGLE_NAME")) {
    console.log(`Feature is Enabled`);
  } else {
    console.log(`Feature is Disabled`);
  }
})();

How to obtain support

Open an issue within this GitHub repository.

Changelog

1.0.8 (2021-01-20)

Features

• Retrieving the sub account with the TENANT_NAME environment variable and the workspace with the WORKSPACE_ID environment variable instead of the WS_BASE_URL environment variable

BREAKING CHANGES

• None

<a name="1.0.7"></a>