42Q-MES0166 Customization Platform

42Q Home > Administration > Customization Platfom

 



  Administration

Customization Platform 

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.

 

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 the Active/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

Note: It is not possible to deploy only one or various custom apps; By clicking on the Deploy All button, all the apps listed will be deployed.

 

Press the Deploy All button as seen in Figure 12 to retry deploying all the apps that failed to be deployed, however, if users retry the deployment, the Deployment History ID and Time values will change.

 

Figure 12: Deployment Details

Note: Users may have to wait between  5 and 15 minutes to run the launchpad after deploying successfully.

 

 

Delete a Custom App

To delete a custom app, select the app to be deleted and click on the Delete button.

 

Figure 13: Select and Delete Custom App

Launchpad

Operators use this portlet to launch the customization application. 

From the menu panel, navigate to Production > LaunchPad.

 

Figure 14: Accessing The LaunchPad Portlet

Click on the icon app to open it.

 

Figure 15: Opening The App

 

 

Figure 16: The Custom Application Running On The 42Q System

 

 

Target Info

This portlet is used by the 42Q administrator to generate the site-target string and add this string to the app attribute in Apigee. Doing so will allow the app to gain access to the site/target’s data defined in the string.   From the menu panel, navigate to Administration > Customization Apps > Target Info.

 

Figure 17: Accessing The Target Info Portlet

This portlet will be used by the 42Q support team in order to provide external Engineers with the Target.

To visualize the user’s Target, select the Site and click on the Targets button, to close the pop-up window click on the OK button.

 

Figure 18: Target Provided By The 42Q Support Team

 

Figure 19: Server Information Shop Floor ID

Note: Notice that the Target matches with the Shop Floor ID from the server information portlet.

 

 

 

 

 

 

Document Revision History

Date	Author	Title	Version	Change Reference	Approved by
05/17/21	Alejandro Duran	Technical Writer	A1	First Release of the Customization Platform at 15.69	Cebrina Tu