42Q-MES0166 Customization Platform

42Q Home > Administration > Customization Platfom

 



  Administration

Crew Maintenace 

Version MES15.69

  This SOP is 42Q’s corporate standard.

This document is under revision control. The latest revision is located on Intranet.

Once printed it is an uncontrolled copy. All alterations to this work instruction require approval.

Contact the IT Global Education and Training Department to submit suggested alterations and or updates.  
 

This edition applies to MES15.69 and all subsequent releases and modifications until otherwise indicated in new revisions.

 

Introduction

The Customization Application Platform provides a platform that allows customization teams or customers to develop customized applications that can access MES data through an API.

Process of Customization Platform for External Customers:

1. Developer Register
2. Support team configures the app and assign the APIs to the developer
3. Developer develop the custom apps
4. Dev-Ops run Terraform script to create a Sandbox server to host custom apps
5. Support team configures the Sandbox information into the Server Information 
6. Site admin uploads and deploys the custom apps
7. Site admin configures the Launchpad
8. Site staff runs Launchpad to launch the custom apps

Process of customization platform for 42Q:

1. Customization team develops custom apps
2. Dev-Ops run TF script to deploy the custom apps to a Sandbox server
3. Customization team configures the Launchpad
4. Site staff run Launchpad to launch the custom apps

 

Server Information Configuration

The Server Information form must be filled in by the 42Q support team.

Below are the steps listed to set up the configuration for Server Information:

 

From the menu panel, navigate to Administration > Server Information

 

Figure 1: Accessing The Server Information Portlet

CP ServerInfoPortlet.png

To add new server information, click the Add button.

Figure 2: Adding New Server Information

1. Fill in the fields with the corresponding information.
2. To save the server information, click the Save button or Cancel to abort

 

Figure 3: Filling In The New Server Information

 

Launchpad Maintenance Configuration

The Launchpad Maintenance Configuration Portlet is used by the 42Q support team, site admin, and customization team to maintain the custom app entry in the MES Portal. 

Add a New Application

From the menu panel, navigate to Administration > Customization Apps > LaunchPad Maintenance

 

Figure 4: Access LaunchPad Maintenance Portlet

To add a new application, click the Add button.

Figure 5: Adding a New Application

 

1. Enter a name for the application.
2. Enter the URL of the application.
3. In the Icon field, enter the image address of the application icon.
4. Notice that the Type field is filled in automatically with the default value ‘Iframe’.
5. Enter the application’s version
6. Click the Save button to save the information or Cancel to abort

Figure 6: Filling In The App Information

Edit an Application

 

1. Select an application from the list.
2. Click the Edit button.
3.  

  Figure 7: Selecting an App From The List

 

3. Change the information of the app.
4. Click the Save button to save the information or Cancel to abort.

 

Figure 8: Editing The Application Information

 

Active / Disable an Application

Users are able to activate or disable current applications listed in the Launchpad Maintenance portlet.

In order to activate or disable an application, users must follow the next steps below:  

1. Select an application from the list.
2. Click theActive/Disable button to activate or disable the selected application.

 

  Figure 9: Disabling an Application

 

Note: Applications that are currently active are marked with a blue checked icon under the“Active” column.

 

Figure 10: Application Disabled

 

Custom Apps Management

The Site administrator uses this portlet to upload and deploy the custom apps.

Deploy All Custom Apps

To access the Custom Apps Management portlet, navigate to Administration > Customization Apps > Custom Apps Management.

To deploy all the custom applications, click on the Deploy All button, a pop-up window will display as in Figure 12, users may notice that the column Status indicates whether the deployment was successful (blue tick icon) or not (red ex icon).

Figure 11: Deploying All The Custom Apps