Chat now with support
Chat with Support

Identity Manager 9.2 - HTML5 Development Guide

Debugging

Running and debugging HTML applications is possible with the Angular CLI toolchain's standard tools.

For example, you can use the ng serve qer-app-portal command to debug the Web Portal HTML application.

To debug an HTML application

  1. Host the API Server locally (see Hosting API Servers locally).

  2. Start a command line program.

  3. Change to the Angular workspace directory.

  4. Run the following command:

    npm run start <HTML application>

    This starts a web server that is accessible by default under http://localhost:4200 and hosts the HTML application.

  5. Start debugging in an appropriate development environment (for example, Visual Studio Code).

Detailed information about this topic

Hosting API Servers locally

To debug and develop an HTML application you need an instance of an API Server for connecting HTML applications. To do this, you can host an API Server locally.

NOTE: HTML applications connect with the API Server through the URL defined in the HTML application's environment.ts file. The default URL that runs under a locally hosted API Server, is http://localhost:8182.

To host an API Server locally

  1. Start a command line program.

  2. Switch to the One Identity Manager installation directory.

  3. Run the following command:

    imxclient.exe run-apiserver -B

Debugging with plug-ins

You can also debug with plug-ins. Debugging with plug-ins only works if the local API Server can find the plug-in.

To debug a static Angular library

  1. Host the API Server locally (see Hosting API Servers locally).

  2. Start a command line program.

  3. Change to the Angular workspace directory.

  4. Run the following command:

    npm run build:watch <Angular library>
  5. Start another command line program.

  6. Change to the Angular workspace directory.

  7. Run the following command:

    npm run start <HTML application>

    This starts a web server that is accessible by default under http://localhost:4200 and hosts the HTML application.

  8. Start debugging in an appropriate development environment (for example, Visual Studio Code).

To debug an Angular plug-in library

  1. Host the API Server locally (see Hosting API Servers locally).

  2. Start a command line program.

  3. Change to the Angular workspace directory.

  4. Run the following command:

    npm run build:watch:dynamic <Angular plug-in library>
  5. Start another command line program.

  6. Change to the Angular workspace directory.

  7. Run the following command:

    npm run start <HTML application>

    This starts a web server that is accessible by default under http://localhost:4200 and hosts the HTML application.

  8. Start debugging in an appropriate development environment (for example, Visual Studio Code).

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating