Difference between revisions of "SOP-42Q-MES0095 AppGarden Quick Guide"

From 42Q
Jump to navigation Jump to search
Line 35: Line 35:
  
 
 
 
 
 +
  
 
= '''Installation on Device''' =
 
= '''Installation on Device''' =
Line 46: Line 47:
 
'''Figure 1: AppGarden Main Tablet Screen'''
 
'''Figure 1: AppGarden Main Tablet Screen'''
  
[[File:Figure 1- AppGarden Main Tablet Screen.png|RTENOTITLE]]
+
[[File:Figure 1- AppGarden Main Tablet Screen.png|700px|Figure 1- AppGarden Main Tablet Screen.png]]
  
 
Select the AppGarden APK, users could turn on the “'''Delete Installer Package'''” checkbox and click '''Install'''.
 
Select the AppGarden APK, users could turn on the “'''Delete Installer Package'''” checkbox and click '''Install'''.
Line 52: Line 53:
 
'''Figure 2: AppGarden Delete Installer Package'''
 
'''Figure 2: AppGarden Delete Installer Package'''
  
[[File:Figure 2- AppGarden Delete Installer Package.jpg|RTENOTITLE]]
+
[[File:Figure 2- AppGarden Delete Installer Package.jpg|700px|Figure 2- AppGarden Delete Installer Package.jpg]]
  
 
Click '''Confirm'''.
 
Click '''Confirm'''.
Line 58: Line 59:
 
'''Figure 3: AppGarden App Installed'''
 
'''Figure 3: AppGarden App Installed'''
  
'''[[File:Figure 3- AppGarden App Installed.jpg|RTENOTITLE]]'''
+
'''[[File:Figure 3- AppGarden App Installed.jpg|700px|Figure 3- AppGarden App Installed.jpg]]'''
  
 
With '''AppGarden''' installed, users can click '''Done''' or '''Open''' on the AppGarden directly.
 
With '''AppGarden''' installed, users can click '''Done''' or '''Open''' on the AppGarden directly.
Line 66: Line 67:
 
[[File:Figure 4- AppGarden Permissions.jpg|700px|Figure 4- AppGarden Permissions.jpg]]
 
[[File:Figure 4- AppGarden Permissions.jpg|700px|Figure 4- AppGarden Permissions.jpg]]
  
 +
 
  
 
== '''''AppGarden Features''''' ==
 
== '''''AppGarden Features''''' ==
Line 75: Line 77:
 
'''Figure 5: Password Protection'''
 
'''Figure 5: Password Protection'''
  
[[File:Figure 5- Password Protection.jpg|RTENOTITLE]]
+
[[File:Figure 5- Password Protection.jpg|700px|Figure 5- Password Protection.jpg]]
 
<ol start="2">
 
<ol start="2">
 
<li>'''Auto Starts '''when Android devices boot. Once booted, the devices will always go to AppGarden, just like an enterprise environment, unless click “Exit Appgarden”.</li>
 
<li>'''Auto Starts '''when Android devices boot. Once booted, the devices will always go to AppGarden, just like an enterprise environment, unless click “Exit Appgarden”.</li>
Line 93: Line 95:
 
'''Figure 7: App Information Icon'''
 
'''Figure 7: App Information Icon'''
  
[[File:Figure 7- App Information Icon .png|RTENOTITLE]]
+
[[File:Figure 7- App Information Icon .png|700px|Figure 7- App Information Icon .png]]
  
 
&nbsp;
 
&nbsp;
Line 154: Line 156:
 
'''Figure 11: Re-Register Asset'''
 
'''Figure 11: Re-Register Asset'''
  
[[File:Figure 11- Re-Register Asset .png|800px|Figure 11- Re-Register Asset .png]]
+
[[File:Figure 11- Re-Register Asset .png|700px|Figure 11- Re-Register Asset .png]]
  
 
&nbsp;
 
&nbsp;
Line 166: Line 168:
 
'''Figure 12: Get Started'''
 
'''Figure 12: Get Started'''
  
[[File:Figure 12- Get Started .jpg|RTENOTITLE]]
+
[[File:Figure 12- Get Started .jpg|700px|Figure 12- Get Started .jpg]]
 
<ol start="6">
 
<ol start="6">
 
<li>The APK Installation files could be deleted by clicking the “Delete Installation files” tab.</li>
 
<li>The APK Installation files could be deleted by clicking the “Delete Installation files” tab.</li>
Line 175: Line 177:
 
'''Figure 13: Delete Installation Files'''
 
'''Figure 13: Delete Installation Files'''
  
[[File:Figure 13- Delete Installation Files .png|800px|Figure 13- Delete Installation Files .png]]
+
[[File:Figure 13- Delete Installation Files .png|700px|Figure 13- Delete Installation Files .png]]
  
 
&nbsp;
 
&nbsp;
Line 183: Line 185:
 
'''Figure 14: File Browser'''
 
'''Figure 14: File Browser'''
  
'''[[File:Figure 14- File Browser .png|800px|Figure 14- File Browser .png]]'''
+
'''[[File:Figure 14- File Browser .png|700px|Figure 14- File Browser .png]]'''
  
 
There are some indicated shows on the Appgarden screen, such as the Service Host, Asset No., Latest network time, Latest heartbeat time, Download Task, Remove Task, Device Time, Submit Time, and the download status indicate: PSI download finished, please wait.
 
There are some indicated shows on the Appgarden screen, such as the Service Host, Asset No., Latest network time, Latest heartbeat time, Download Task, Remove Task, Device Time, Submit Time, and the download status indicate: PSI download finished, please wait.
Line 191: Line 193:
 
'''Figure 15: Indicators'''
 
'''Figure 15: Indicators'''
  
'''[[File:Figure 15- Indicators .png|800px|Figure 15- Indicators .png]]'''
+
'''[[File:Figure 15- Indicators .png|700px|Figure 15- Indicators .png]]'''
  
 
== '''''AppGarden Login''''' ==
 
== '''''AppGarden Login''''' ==
Line 202: Line 204:
 
'''Figure 16: Get Started'''
 
'''Figure 16: Get Started'''
  
[[File:Figure 16- Get Started .png|800px|Figure 16- Get Started .png]]
+
[[File:Figure 16- Get Started .png|700px|Figure 16- Get Started .png]]
  
 
'''NOTE''': The new 2.05 version was updated to add a scanner and “H” host function.
 
'''NOTE''': The new 2.05 version was updated to add a scanner and “H” host function.
Line 208: Line 210:
 
'''Figure 17: Host Information'''
 
'''Figure 17: Host Information'''
  
[[File:Figure 17- Host Information .png|800px|Figure 17- Host Information .png]]
+
[[File:Figure 17- Host Information .png|700px|Figure 17- Host Information .png]]
 
<ol start="3">
 
<ol start="3">
 
<li>Select the arrow icon to continue to the next row to insert “Asset Number”.</li>
 
<li>Select the arrow icon to continue to the next row to insert “Asset Number”.</li>
Line 216: Line 218:
 
'''Figure 18: Enter Asset Number'''
 
'''Figure 18: Enter Asset Number'''
  
'''[[File:Figure 18- Enter Asset Number.png|800px|Figure 18- Enter Asset Number.png]]'''
+
'''[[File:Figure 18- Enter Asset Number.png|700px|Figure 18- Enter Asset Number.png]]'''
 
<ol start="5">
 
<ol start="5">
 
<li>We have added the Re-register Asset No. control on the Appgarden 2.05, if the tablet already registers an activated asset No v8., and when users try to register a new inactive asset No 92. it will pop up this message “Your device has already registered. Do you want to switch to a new asset No?“. Users can click ‘Register' to continue or click the 'back’ button to exit register a new asset No.</li>
 
<li>We have added the Re-register Asset No. control on the Appgarden 2.05, if the tablet already registers an activated asset No v8., and when users try to register a new inactive asset No 92. it will pop up this message “Your device has already registered. Do you want to switch to a new asset No?“. Users can click ‘Register' to continue or click the 'back’ button to exit register a new asset No.</li>
Line 223: Line 225:
 
'''Figure 19&nbsp;: Asset Already Exist Message'''
 
'''Figure 19&nbsp;: Asset Already Exist Message'''
  
'''[[File:Figure 19- Asset List Report.png|800px|Figure 19- Asset List Report.png]]'''
+
'''[[File:Figure 19- Asset List Report.png|700px|Figure 19- Asset List Report.png]]'''
  
 
&nbsp;
 
&nbsp;
Line 232: Line 234:
 
'''Figure 20&nbsp;: Register Page'''
 
'''Figure 20&nbsp;: Register Page'''
  
[[File:Figure 20 - Register Page.png|800px|Figure 20 - Register Page.png]]
+
[[File:Figure 20 - Register Page.png|700px|Figure 20 - Register Page.png]]
 
<ol start="7">
 
<ol start="7">
 
<li>Added below 6 indicated fields on the AppGarden home screen.</li>
 
<li>Added below 6 indicated fields on the AppGarden home screen.</li>
Line 239: Line 241:
 
'''Figure 21: New Fields in the Home Screen'''
 
'''Figure 21: New Fields in the Home Screen'''
  
[[File:Figure 21- New Fields in the Home Screen .png|800px|Figure 21- New Fields in the Home Screen .png]]
+
[[File:Figure 21- New Fields in the Home Screen .png|700px|Figure 21- New Fields in the Home Screen .png]]
  
 
'''Note''': Clicking the colorful icon located at the button right allows you to enter in a password to gain access into the application .
 
'''Note''': Clicking the colorful icon located at the button right allows you to enter in a password to gain access into the application .

Revision as of 14:16, 7 May 2020

42Q Home > Tools > App Garden Quick Guide
RTENOTITLE

 

Tools
App Garden Quick Guide
Version MES15.3.3 Portal 1.0
Work Instruction 

 

This Work Instruction 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 Portal 1.0 and all subsequent releases and modifications until otherwise indicated in new revisions.

 

 

Introduction

AppGarden is 42Q’s solution to manage and ensure compliance concerning the applications that may run on its Android tablets on the shop floor. This document explains the primary functions in AppGarden. It is assumed that the user has a tablet with AppGarden installed.

In order to control permissions for tablet users, stream updates and configure the installation to tablet applications, therefore, 42Q provides three solutions to manage tablet use on the factory floor, the tools should be used together.

  • APK “Android Package Maintenance” (MES Portal) : Serves as a repository for Android tablet applications

Android Application Package (APK) is the format for the installation and distribution of application software implemented by Android’s operating system. The MES development team has provided a mobile data collection solution that allows for manufacturing execution at the shop floor level through the use of convenient tablets. These inexpensive tablets provide mobility, flexibility, and scalability to increase productivity while decreasing overhead costs.

  • Android Device Maintenance (MES Portal) : Manages the tablets.

Android Device Maintenance is the primary module for managing the tablets to which the Package Maintenance applications are pushed.

  • AppGarden (Installed on every tablet) : Allows installation and updates on Android mobile devices

AppGarden APK is an Android management tool, which is used to manage APK installation and uninstall and updates on android devices, access and system information collection; this APK should be the last install after installing all/any other MES Android Applications.

For more information on Android Package Maintenance, Android Device Maintenance, and/or AppGarden solutions visit https://42qrpt1.42-q.com/mes_wiki/index.php/SOP-5-I-42Q-MES0106-C_42Q_APK.

 

 


Installation on Device

To install APK package follow the following steps:

Use File Manager of your own device to Install;

Click File Explorer of your own device to locate your SD card or USB for AppGarden APK installation package and double click to install.

Figure 1: AppGarden Main Tablet Screen

Figure 1- AppGarden Main Tablet Screen.png

Select the AppGarden APK, users could turn on the “Delete Installer Package” checkbox and click Install.

Figure 2: AppGarden Delete Installer Package

Figure 2- AppGarden Delete Installer Package.jpg

Click Confirm.

Figure 3: AppGarden App Installed

Figure 3- AppGarden App Installed.jpg

With AppGarden installed, users can click Done or Open on the AppGarden directly.

Figure 4: AppGarden Permissions

Figure 4- AppGarden Permissions.jpg

 

AppGarden Features

  1. "Password Protection" which restricts anyone to exit this AppGarden unless a password has been entered.

 

Figure 5: Password Protection

Figure 5- Password Protection.jpg

  1. Auto Starts when Android devices boot. Once booted, the devices will always go to AppGarden, just like an enterprise environment, unless click “Exit Appgarden”.

 

Figure 6: Exit AppGarden

Figure 6- Exit AppGarden.png

  1. Show the Asset No, Name, Group, Plant, Device Type, Sync-Time, Service Host, current IP address by clicking the “Information” tab.

 

Figure 7: App Information Icon

Figure 7- App Information Icon .png

 

Selecting Information from the main menu displays the specifications for the tablet and its respective configuration with regards to 42Q. The information that is listed includes

Asset No: The asset number of the device unique to the group

Name: The name given to the device.

Group: The group to which the device was added.

Plant: The plant where the device operates.

Device Type: Designates the type of device.

Sync Time: Designates the Sync interval (in minutes) for the device.

Service Host: Designates the Service Host IP.

IP Address: Represents the IP used by the device.

 

Figure 8: App Information

Figure 8- App Information .png

 

Figure 9: App System Setting

Figure 9- App System Setting .png

  1. Show the Android system settings by clicking the “System Setting” tab.

The main menu contains the following selections:

  • Information
  • System Setting
  • Exit AppGarden
  • Re-register Asset No.
  • Delete Installation Files
  • Close

NOTE: Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.

 

Figure 10: App Settings

Figure 10- App Settings.png

  1. Get Started register Asset NO. by clicking the “Re-register Asset No.” tab, e.g. portal-uat.42-q.com.

 

Figure 11: Re-Register Asset

Figure 11- Re-Register Asset .png

 

Re-register Asset No.

This function allows the plant administrator to re-register the Asset Number for the device. This feature applies to when the plant administrator needs to connect the device to a different MES Portal server, or when the Asset Number that was previously registered is incorrect. To use this function, enter the Service Host in the initial field provided and select the arrow icon to the right of the field to confirm the entry. A new field appears directly below the Service Host field. In the new field enter the Asset Number. The user is then directed to the User Info screen where the status of the Asset Number is given, along with the Asset Number itself and its respective Name, Group, Plant, and Device Type.

 

Figure 12: Get Started

Figure 12- Get Started .jpg

  1. The APK Installation files could be deleted by clicking the “Delete Installation files” tab.

 

Figure 13: Delete Installation Files

Figure 13- Delete Installation Files .png

 

In the process of air deployment there will be installation files that are downloaded to the table to be initialized at a scheduled time. It may be preferred, however, that these files be deleted in order to save space or because an error occurs during the download of the installation files. The Delete Installation Files function allows the user to delete these files. To perform this action, simply select Delete Installation Files from the AppGarden menu. The message, “Delete installation files completed!” appears at the bottom of the screen.

Figure 14: File Browser

Figure 14- File Browser .png

There are some indicated shows on the Appgarden screen, such as the Service Host, Asset No., Latest network time, Latest heartbeat time, Download Task, Remove Task, Device Time, Submit Time, and the download status indicate: PSI download finished, please wait.

 

Figure 15: Indicators

Figure 15- Indicators .png

AppGarden Login

  1. Open the AppGarden application
  2. First time users will enter the Service Host (i.e., MES Portal IP) to login into the field provided.

Note : Clicking the “H” button will show the latest 3 Host histories for returning users.

Figure 16: Get Started

Figure 16- Get Started .png

NOTE: The new 2.05 version was updated to add a scanner and “H” host function.

Figure 17: Host Information

Figure 17- Host Information .png

  1. Select the arrow icon to continue to the next row to insert “Asset Number”.
  2. Input the Register and Asset No. Fields, there is a scanner button beside that asset No. as well.

Figure 18: Enter Asset Number

Figure 18- Enter Asset Number.png

  1. We have added the Re-register Asset No. control on the Appgarden 2.05, if the tablet already registers an activated asset No v8., and when users try to register a new inactive asset No 92. it will pop up this message “Your device has already registered. Do you want to switch to a new asset No?“. Users can click ‘Register' to continue or click the 'back’ button to exit register a new asset No.

Figure 19 : Asset Already Exist Message

Figure 19- Asset List Report.png

 

  1. Click Register

Figure 20 : Register Page

Figure 20 - Register Page.png

  1. Added below 6 indicated fields on the AppGarden home screen.

Figure 21: New Fields in the Home Screen

Figure 21- New Fields in the Home Screen .png

Note: Clicking the colorful icon located at the button right allows you to enter in a password to gain access into the application .

 

Document History

Date Author Title Version Change Reference
06/04/16 Dane Parker Technical Writer v 1.0 This is the first version of the AppGarden Quick Guide.
12/15/16 Martha Jordan Technical Writer v1.0 42Q Format
03/18/20 Tiana Technical Writer v.1.1 Updated photos for version 2.05 and revised grammar. Added more info  concerning APK, Android Device Maintenance, and AppGarden