5 USM User Interface

The USM web application allows you to manage and create project and project artifacts for service mapping to enable communication between two different applications.

There are 3 different type of users in USM who will have access to certain tabs based on their role. The Admin Role user is the administrator of the application and has access to all the tabs; the Operator Role user has restricted access to certain functions; and the Monitor Role user can only view the information. The following list shows the tabs with decreasing order of access from top to bottom.

• Admin Role user

  • Admin tab

  • Configurations tab

• Operator Roles user

  • Mapper Designer tab

  • Test Drivers tab

  • Import/Export tab

• Monitor Role user

  • Home tab

  • Monitoring tab

  • System Logs tab

Admin

The Admin tab allows Administrators to manage projects and project access. In the projects sub-tab, administrators can create, update, rename, and delete projects.

In the Access sub-tab, Administrators can create and manage access. Using the Create option, you can add users to projects by providing usernames and username aliases.

Using the Manage option, you can remove user access.

Configuration Tab

Configuration tab allows you to edit configuration files and manage DVM for the selected project. In the Edit USM Configuration tab, you can edit the configuration file.

In the Manage DVM tab, you can edit DVM data. It also allows you to create, delete and rename DVM.

In the Manage Credentials tab, you can update credentials.

Mapping Designer

This tab allows you to manage and view Service Mappers for the selected project. In the Edit Service Mappers sub-tab you can browse existing service mappers, edit service mapper files, rename mappers, and delete mappers.

In the Add Service Mapper sub-tab, you can create new service mappers.

Test Data Drivers

Test Data Drivers is a testing tool that enables you to test the service call by reading data from the file system and calling the service.

Test Drivers Tab allows you to manage and view data drivers. In the Execute Drivers sub-tab you can start or stop data drivers. It also allows you to edit the data driver files.

In the Manage Drivers sub-tab, you can create new data drivers. It also allows you to rename or delete an existing data driver.

Import/Export Tab

The Import/Export tab allows you to import and export project files in .zip format.

Home

The Home tab displays the summary of the service mapper application. The System summary panel displays the available mappings, service activity count, and system health, successful and failed activity.

USM metrics for the Today panel show the mappings since midnight. You can search, filter, and select a mapping from the table to view the request and response mapping before and after the mapping.

Monitoring

Monitoring tab displays USM metrics in a tabular format. The data on the monitoring tab has filters service mapper name and Date. User can view all the service mappings with the selected filters using the provided pagination buttons. User can also view the request and response data before and after the mapping by clicking the service mapping activity in the table. By default the monitoring tab displays the service mappings for all the mappers from last 24 hours.

System Logs Tab

In the System Logs Tab user can browse through universal service mapper logs.

Create Project

1. Go to the Admin tab.

2. Click on the Manage Projects sub-tab.

3. Select the Create radio button to create a new project.

4. Enter a new project name and a new module name.

5. Click on the Create button when done.

   Now the Project is created.

Update Project Modules

1. Go to the Admin Tab.

2. In the Admin Tab, click on the Manage Projects sub-tab.

3. Click the Manage radio button to update the project's modules.

4. Select Project Name from the drop down.

   
   

5. Now in the text fields, update the project module names, add or remove project modules as necessary.

   
   

6. Click the Update button once done.

   Now the Project has been updated with new Modules.

Delete Project

1. In the Admin Tab, go to the Project sub-tab.

2. Click on the Manage radio button.

3. Select the Project Name from drop down.

   
   

4. Click the Delete button.

5. A confirmation dialog appears, click on the Okay button.

   
   

   Now the selected project is deleted.

Rename Project

1. In the Admin tab, go to the Project sub-tab.

2. Click on the Rename radio button.

3. Select Project Name from the drop down list box.

   
   

4. Enter the new project name in the New Project Name textbox.

   
   

5. Click on Rename button to rename the project.

Provide User Access to a Project

1. In the Admin tab, go to the Access sub-tab.

2. Select the Project Name from the drop down list box for which access has to be given.

   
   

3. Enter the Username Alias and Username to which access has to be granted.

   
   

4. Click the Save button.

   The user now has access to the project.

Create New Service Mapper

1. Go the Mapping Designer tab.

2. Open the Add Service Mappers sub-tab.

3. Select the module name from the drop down list box and click on next.

   
   

4. Enter the Service Mapper name of your choice and click Next.

5. Enter the Message Types that are to be supported by the service mapper, in a comma separated format.

6. Click on the Add button.

   Now the new Service Mapper is created with all the necessary files.

Update Service Mapper Files

1. Go the Edit Service Mapper sub-tab in the Mapping Designer tab.

2. Select the service mapper prefix from the drop down list box on the left side of the screen.

   
   

3. Select the mapper file name from the list that appears below it.

   
   

4. Once the file loads, click on the Edit icon on the right side of the screen.

   The text field should be enabled for editing.

5. Edit the content as desired.

   
   

6. Once the editing is done, click the Save icon (it replaced the Edit button).

   The updates to the service mapper are saved.

Rename Service Mapper File

1. Go to the Edit Service Mapper sub-tab in the Mapping Designer tab.

2. Select the service mapper prefix from the drop down list box.

   
   

3. Select the mapper file whose name has to be changed.

   
   

4. Once the file is loaded, click the pencil icon next to the name of the service mapper on the right pane.

   An Edit box opens.

5. Change the name of the mapper file as required.

   
   

6. Click the Save button (it replaced the Edit button).

   The mapper file has been renamed.

Delete Service Mapper File

1. Go to the Edit Service mapper sub-tab in the Mapping Designer tab.

2. Select the mapper prefix from the drop down on the left side of the screen.

   
   

3. Select the mapper file to be deleted once the list below loads.

   
   

4. Once the selected mapper file loads, click the Delete icon on the far right end of the screen on the right pane.

   A confirmation dialog appears.

5. Click Okay to continue.

   The mapper file is deleted.

Create New Driver

1. Go to the Test Driver tab.

2. Click the Manage Driver sub-tab.

3. Click the Create radio button.

4. Select the module name from the drop down.

   
   

5. Enter the Driver Family name.

   
   

6. Click the Add button.

Update Driver Files

1. Go to the Execute Driver sub-tab in the Test Driver tab.

2. Select the driver name from the drop down list box.

   
   

3. Select a Data Driver File or Driver Request Data Mapping Template from the drop down list box.

   
   

4. In the editing panel below, click on the Edit icon on the right side of the screen.

5. Edit the contents of the file as desired.

6. Once done, click the Save icon to save the changes to the file.

   
   

   The file has been updated.

Rename Data Driver

1. Go to the Manage Driver sub-tab in the Test Driver tab.

2. Click the Update radio button.

3. Select the Driver Name from the drop down list box.

   
   

4. Enter a new name for the driver as required.

   
   

5. Click the Rename button.

   The driver is renamed.

Delete Data Driver

1. Go to the Manage Driver sub-tab in the Test Driver tab.

2. Click the Update radio button.

3. Select the driver name from the drop down list box.

   
   

4. Click the Delete button.

   
   

   A confirmation dialog box opens.

5. Click Okay.

   The driver file is deleted.

Edit Configuration File

1. Go to the Edit USM Configuration sub-tab in the Configurations tab.

2. Click the Edit button icon on the right side of the screen.

3. Edit the contents of the file as desired.

   
   

4. Once done, click the Save button.

   The Configuration file is now updated.

Create DVM

1. Go to the Manage DVMs sub-tab in the Configurations tab.

2. Click on the Create radio button.

3. Enter the DVM Name and key in the text boxes.

4. Click on the Add icon to add more keys or remove unneeded keys from the list by click on the Remove icon next to a key.

   
   

5. Once done, click on Save to create the DVM.

   Now the new DVM is created.

Update DVM

1. Go to the Manage DVM sub-tab in the Configurations tab.

2. Click the Edit radio button.

3. Select the DVM Name to be edited from the drop down list box.

   
   

4. Changes are made to the DVM as rows are added, edited, or deleted:

   • Click the Edit icon to edit the DVM row.

   • Click the Delete icon to delete the row.

   • Click the Insert icon on the top right corner of the table view to add more DVM rows.

   
   

Delete DVM

1. Go to Manage DVM sub-tab in the Configurations tab.

2. Click the Edit radio button.

3. Select the DVM Name from the drop down list box.

   
   

4. Click the Delete button on the top right corner of the table view.

5. A delete confirmation dialog appears, click OK to confirm the operation.

   
   

   The DVM table is deleted.

Rename DVM

1. Go to the Manage DVM sub-tab in the Configurations tab.

2. Click the Rename radio button.

3. Select the DVM from the drop down list box.

   
   

4. Enter the new name for the DVM in the DVM Name text box.

5. Once done, click the Rename button to rename the DVM.

   
   

   Now the DVM table has been renamed.

Mandatory Post-Deployment Setup

After deployment, perform the following procedures.

Configure Initial Project

To configure the initial project, perform the following steps:

1. Login to USM UI as an admin.

2. Go to the Admin -> Manage Access tab and enter the information:

   • Select Project - Select LogFireIntegration

   • Username Alias - Select or enter usmAdminUiUserAlias

   • UserName - Enter the admin username (for example, rics.admin)

3. Click Save.

Update External JSON

1. Go to Configurations -> Edit Usm Configuration

2. Select external_env_info.LogFireIntegration from the dropdown menu, click the Edit button, and enter the values:

   • name: Enter LogFire_Host_Url_Key

   • value: Enter the logFire Host URL. For example:

     https://<Host-Url>:443/lgf_int_qa
     

   
   

3. Click the Save button.

Update DVM

1. Go to the Configurations -> Manage DVM tab.

   • Select CompanyCode_dvm.LogFireIntegration from the dropdown menu.

   • Click the Edit button of the row to edit.

   • Update the value of CompanyName for the LogFire application

     For example: RGBU6

   • Click the Save button.

   
   

2. Select FacilityCode_dvm.LogFireIntegration from the dropdown menu.

   • Click the (+) button to add a new row and enter the FacilityId, FacilityType, and FacilityTimeZone for the LogFire application.

     For example:

     • FacilityId - 55

     • FacilityType - WAREHOUSE

     • FacilityTimeZone - US/Eastern

Test the Deployment

After you deploy the server successfully, USM Web Application can be accessed using the following URL:

http://<host-server>/<Sub-name-space>/usm/

Information on Roles and Groups in USM Application

USM Application has some basic roles and groups which are used to determine the type of user:

Roles

• AdminRole - Users with this role have access to all the functions of the USM app. They can also setup the security permissions for other users.

• OperatorRole - Users with this role have the ability to read, write and modify content in the service mapper files. However they will not have access to the admin functions and cannot see the admin tab at all.

• MonitorRole - Users with this role can only view the data in the service mapping files.

Groups

• UsmAdminGroup - Users that belong to this group can perform all operations

• UsmOperatorGroup - Users that belong to this group can perform all operations except access the admin tab. The admin tab is not visible unless the user is logged in as an admin user.

• UsmMonitorGroup - Users that belong to this group can only view the data.

Functions by Role and Group

The following table lists all the functions which can be performed by the roles and groups mentioned above:

Role Name	Admin Role	Operator Role	Monitor Role
Group Name	UsmAdminGroup	UsmOperatorGroup	UsmMonitorGroup
Admin Tab Functions	Yes	No	No
Project Files Editing and Management	Yes	Yes	No
Service Mapper Files Editing and Management	Yes	Yes	No
Driver Editing and Management	Yes	Yes	No
Configuration File Editing	Yes	Yes	No

In the above table Editing and Management refers to all functions like create, delete, update, and rename operations.