Message API/docs/installer/web-viewer

Canvas

The Canvas viewer interface served by IIS.

What Gets Installed

The Canvas is the primary web interface. The installer creates an IIS website to host it.

  • Installation path: C:\Program Files\ViewsoftCanvas
  • IIS Site name: Viewsoft Canvas
  • Default binding: http://localhost:4203
  • Includes web.config for Angular routing (no URL Rewrite module needed)

Built-in web.config

The Canvas bundle includes a web.config file that handles application routing.

This means you do NOT need to install the URL Rewrite module for the Canvas. URL Rewrite is only needed if you set up a reverse proxy to the backend.

Configuration: rxconfig.js

To link your Canvas to the required services, you must update the service discovery URLs in the main configuration file.

Path: `C:\Program Files\ViewsoftCanvas\www\assets\scripts\rxconfig.js`

  • baseURL: The fully qualified URL of the Backend Engine service (must include trailing slash).
  • apiBaseURL: The URL of your Viewsoft Backend (must include trailing slash, omit the /api suffix).
javascript
// C:\Program Files\ViewsoftCanvas\www\assets\scripts\rxconfig.js
var RxConfig = (function() {
    'use strict';
    // 1. Engine Connectivity
    baseURL: 'https://your-engine-domain.com/',
    
    // 2. Backend Connectivity 
    apiBaseURL: 'https://your-backend-domain.com/',
    
    // ... other settings
};
Configuration: rxconfig.js

Verify Installation

Confirm the Canvas is running correctly.

  • Browse to http://localhost:4203/
  • Check IIS Manager -> Sites -> Viewsoft Canvas
  • Verify the site is Started and the binding is correct

Common Issues

If the site does not load, check these common problems.

  • Port 4203 in use - Change the binding in IIS or stop the conflicting application
  • IIS not installed - Enable IIS with Static Content feature
  • Site not started - Start the site in IIS Manager