Frontend installation

Create a project

In Gitlab, fork the latest version of https://gitlab.com/theconfigteam/tctm/releases/ewm/tctm_ewm_ui_base.

Select the proper customer URL (have it created if it doesn’t exist).

Create a clean workspace

You can clone the repository anywhere, but it’s recommended to use a consistent structure.

• On your C: drive, create a folder:

• C:\Customers

• Inside it, create a folder for your customer/project, for example:

• C:\Customers\Customer1

Final example path: C:\Customers\Customer1

Clone the repository

• Open PowerShell or Terminal.

• Navigate to your customer folder: cd C:\Customers\Customer1

• Clone the repository: Change the highlighted to match the actual git customer folder name

git clone https://gitlab.config.team/theconfigteam/tctm/releases/git customer folder name/tctm_ewm_ui_base.git

After cloning, you should have a folder like: C:\Customers\Customer1\tctm_ewm_ui_base

Open the project in VS Code

• Open Visual Studio Code.

• Click Open Folder.

• Select: C:\Customers\Customer1\tctm_ewm_ui_base

Install dependencies (npm install)

• In VS Code, go to Terminal → New Terminal.

• Confirm you’re in the project root (you should see something like ...\tctm_ewm_ui_base> in the terminal).

• Run: npm install

Configure deployment settings (deploy.conf)

Rename the template config file. In the project, go to the deploy folder and rename the template file:

• From: deploy.conf.tmpl

• To: deploy.conf

Update settings (project name + presentation device)

• Open: deploy/deploy.conf

Update these fields to match your customer/project

• projectName="Customer1"

• presentationDevice="ZV01"

Update login settings

Example

• startURL="https://mysapsystem.com/tctm_ewm"

• system="DE1"

• client="100"

• sso=false

Set:

• startURL=Full path where the app will be accessed

• system=System ID label

• client=SAP client

• sso=Only set sso=true if you’ve been explicitly told to enable SSO Otherwise keep sso=false

Enable/extend language options (optional)

By default, the language array may be commented out like this:

• # languages=[

• # { key = "EN", text = "EN - English" },

• # { key = "DE", text = "DE - German" }

To enable it:

• Remove the leading #.

• Add/remove languages as needed.

Example enabled:

• languages=[

• { key = "EN", text = "EN - English" },

• { key = "DE", text = "DE - German" }

Plugin Activation

In the deploy.conf file, manually activate the plugins by changing the value of the buildPlugin to "true"

Build and deploy

PreBilt Standalone Edition

Neptune

Build distribution folder

• Open the terminal and run:

• npm run deploy -- platform=fiori