Web Interface

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search

This document contains information about how to install, configure and run the Web Interface application.

This document is also available as Readme.txt file:

<Installation_DIR>\Commit\WebInterface\Readme.txt

Note: "<Installation_DIR>" refers to the path on the server (drive and directory) where the Commit server files are installed.


General Settings and Configuration

Setting the Port

Commit Web Interface communicates with users/browsers through a port.

In order for the service to use the port, it should be set up in the Web Interface properties file. This port should not be in use by any other application or service.

Commit's default configuration uses Port 4961.

To change the port number, edit the file <Installation_DIR>\Commit\WebInterface\CommitWebInterface.ini and change the port under the token: 'ServerPort'


IMPORTANT NOTE:

If you use a firewall, proxy, etc. it is recommended that you open Port 4961 in order to allow a connection to be established with Commit Web Interface.

If this port is blocked by a firewall, a connection cannot be established.

Setting the Server IP or URL

Commit Web Interface uses a permanent IP address or URL. This IP/URL is the external Internet address of the computer on which Commit Web Interface is running.

You can set up the server IP or URL by editing the file <Installation_DIR>\Commit\WebInterface\CommitWebInterface.ini and changing the token: 'ServerIP' (e.g. ServerIP=212.140.210.143 or ServerIP=www.mydomainname.com).

Note that by default the Web Interface uses IP 127.0.0.1 (localhost), which means you can use the Web Interface on your local computer only.

Activating Commit Web Interface

Install/Uninstall Commit Web Interface

Commit Web Interface runs as a Windows Service on your server.

Install

This part of the installation should be performed on the server or on the computer on which the CommitCRM is installed.

Note: Make sure to run CommitCRM client at least once before installing the Web interface service for the first time.

When logged in to the server with an Administrator account, open a command prompt window and enter the following command:

<Installation_DIR>\Commit\WebInterface\CommitWebInterface.exe -install

Notes:

  1. In case you wish to install and run the Web Interface service on Vista, you should run the command prompt from Start > Accessories > Command Prompt > right-click it and select > Run as administrator.
  2. The <Insallation_Dir> must refer to a LOCAL server path (e.g. c:\ or D:\Software, etc.) and NOT to a shared network name/path.


After installing the service, a pop-up window should be displayed letting you know the service was installed successfully. If this window does not appear, this may be because the user running the command prompt does not have the required rights - make sure you run as administrator (see Note 1 above).

After a successful service installation, a service called CommitWebInterface is now displayed in the system services management window (Control Panel > Administration Tools > Services).

Using the Services Management window, start the service ad make sure that the service is defined to start automatically (Startup type > Automatic) each time the server is restarted.

Uninstall

To Uninstall Commit Web Interface stop the CommitWebInterface service and then type the following command in a command prompt window on the server: <Installation_DIR>\Commit\WebInterface\CommitWebInterface.exe -uninstall


Define Web Users

To test the installation and start using Commit Web Interface, create web users for employees and customers.

Web user management is done within the Commit application. Login to Commit and follow these instructions:

Creating web users for employees

Open the Employees/Accounts window and navigate to the desired employee record. Select the "Employee" tab and click on the "Configure Web User" Button. Set a web username and password and confirm.

Creating web users for customer Accounts

Open the Accounts window and navigate to the desired Account record. Select the "Web Users" page, click on the "Add" button at the bottom of the page and set the web user username, password and other information and confirm.


Notes:

  1. Commit Web Interface will identify the newly created users within several minutes.
  2. All passwords are case sensitive.
  3. Since each username must be unique in the entire system, it may be a good idea to add a common prefix to all the web users of each Account, i.e. BIZ_1_John, BIZ_1_Mary, BIZ_2_John, BIZ_2_Phil etc.


If you set an Account number for each of your accounts (using the Account# field), you can set the system to automatically add the Account# as a prefix for each new web user you create. Use the Options > Web Interface to set this feature.


Login to the Web Interface

In your web browser, enter in the URL: http://127.0.0.1:4961

Note: You should modify this link to reflect your IP/URL address and Port.

A login page will be displayed. Enter the username and password you defined. Click the Login button to log-in.

You can also embed the login page in your web site.

Document Download and Upload Settings

Using the Web Interface, employees can download and upload Commit documents which are located on your server, directly from the browser.

In order to allow file downloads and uploads, you should first enable file download and upload to allow the Web Interface Service to access the documents for downloads and uploads.

To enable uploads and downloads, go to Tools > Options > Web Interface:


File:Commit web interface options download upload flag.gif

In this window an administrator user can determine whether Web Interface users will be able to download and upload documents:

  • Check the Enable file downloads over the Web option to allow files download.
  • Check the Enable file uploads over the Web option to allow files uploads.

In any case, both for download and for upload, the administrator should also take care of folders mapping (see below).


Document Folders Mapping In order to allow file downloads and uploads, you should first map the folder locations for the documents, so that the Web Interface Service will be able to access them for download and uploads. You can also define folders which will deny access, in case you need to protect sensitive information from being accessed via the web interface.

The Commit Document files can be physically stored in various places on your server. The system has a default documents folder (as mapped in Tools > Options > Documents > Default Document Folder), which is usually physically located on the server. Note that the documents UNC path in the Document's properties is stored in the same way the client PCs sees it.

When the Web Interface tries to access a file on the server, this is done via the Web Interface service, running on your server. This means that the paths that are specified in the document properties in Commit will probably not be comprehensible to the Web Interface Service running on your server.

For the service to be able to access these files, you need to 'teach' the server how to access the files locally, when encountering a mapped drive in the file path.


To setup the documents folders mapping settings, go to Tools > Options > Web Interface:

File:Commit web interface options zoom.png

To map the folders, click the Setup folder mappings button to open the download folders settings window:

File:Commit web interface download folders settings.zoom88.png

Allow Folders Settings

In the Allow Web Access To Folders tab, you should map the folders in order for the web interface service to be able to access them from the Web Interface.

File:Commit web interface download folders settings.zoom90.png

In this tab, you can enter the path mappings, which will map the 'network' path to the 'local' server path.


In the edit box, enter the Network Path (as client PCs see it), then an * (asterisk), and then the local server folder.

You should enter one mapping per line. For Example: F:\OfficalFiles\Docs * C:\AllUserOfficeFiles\Docs

Where:
F:\OfficalFiles\Docs - Mapped path as Client PCs see it.
* - Divides between the network and local path of the mapping.
C:\AllUserOfficeFiles Docs - Local path as the server sees it.

Note: You only need to set mappings for root document folders. All files stored under each root folder, including files in subfolders, will become available from the Web Interface automatically.

For example, if you map the folder F:\OfficalFiles\Docs then files stored at F:\OfficalFiles\Docs\your customer\ will be available.

Deny Folders Settings

In the Deny Web Interface Access To Folders tab, you can define the folders for which you want to deny access from the Web Interface.

In this tab, you can deny access to certain folders, in order to protect a document folder from unauthorized downloads and uploads

In the edit box, you should type in the paths you wish to deny access to. It's better to use a server's local path, although network paths are also allowed (they should appear in the same way they appear in the document's properties).

You should enter one folder path per line. For Example:
C:\OfficeFiles\Private
D:\ITDocs\Passwords

Note: The system will automatically block access to files stored under each specified folder, including files in subfolders.
For example, if you block the folder D:\ITDocs\Passwords, files stored at D:\ITDocs\Passwords\RDP\ will be blocked too.

Default Filing Folder Settings

When files are uploaded via the Web Interface, they are automatically saved in the account's “Docs Dir” folder (which can be defined in the account window, under the Details tab). However under certain circumstances the Docs Dir folder cannot be accessed over the Web Interface, such as when no Docs Dir folder has been created for an account, or when it has been placed in the Deny Folders list.


For this reason, users should define an “Uploads Default Folder.” When a file cannot be uploaded to the account’s Docs Dir folder, it will be automatically uploaded to this default folder. To define the Uploads Default Folder, go to Tools > Options > Web Interface > Setup Folder Mapping button > Folder Mapping Settings window > Uploads Setting tab > Define default uploads field:

File:Commit web interface options upload folder.gif

Setting Customer Privileges

Using the Web Interface, customers can create new tickets; view their open and closed tickets; view contract information, charges, assets, and Knowledge Base articles; download files; and more.

All customers are given the privilege of viewing tickets and adding new tickets via the Web Interface. Other types of data can be allowed or denied to customers via the Options window. By default, all possible customer privileges are made available to customers. A system administrator can then allow or deny specific privileges.

To define customer privileges, go to Tools > Options > Web Interface:

File:Commit web interface options privileges.gif

By selecting or deselecting the privileges at the bottom of this window (see section circled in red) the system administrator can determine which privileges are made available to customers using the Web Interface:

  1. Charges
    Selecting this option will allow customers to see charges when viewing tickets and contracts.
    Deselecting this option will hide the Charges area in the ticket view for all customers.
  2. Assets
    Selecting this option will allow customers to see the Assets tab and the list of all assets linked to their account.
    Deselecting this option will hide the Assets tab altogether for all customers and they will not be able to see the list of existing assets.
  3. History Notes
    Selecting this option allows customers to see the Contracts tab and to view all of their existing contracts.
    Deselecting this option hides the Contracts tab altogether and prevents customers from viewing their contracts and terms.
  4. Contract Status
    Selecting this option will allow customers to see the contracts tab and view all of their existing contracts.
    Deselecting this option will hide the contracts tab altogether and customers will not be able to view their contracts and terms.
  5. Download Document public files linked to their account
    In this section, the system administrator can define whether customers can download and view documents linked to their account. Note that only documents marked as Public in the document properties will be available to customers via the Web interface.

    You can also find more details on setting up the Web Interface for files download in the Document Download Settings section.
  6. Public Knowledge Base Articles and Download Linked Files
    In this section, the system administrator can define whether customers can view Knowledge Base articles. The system administrator can also further define whether customers can download files linked to these articles. Note that only articles marked as Public will be available to customers via the Web interface.

For more details on articles privileges, see the Knowledge Base manual, Security and Privileges section.

In any case, make sure to restart the Commit Web Interface service after performing any changes, so they will take effect in the Web Interface.