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

From 42Q
Jump to navigation Jump to search
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  
<small>[[42Q_Cloud-Based_MES/MOMS|42Q Home]] > [[Tools|Tools]] > App Garden Quick Guide</small><br/> [[File:42Q Logo.jpg|RTENOTITLE]]
+
<small>[[42Q_Cloud-Based_MES/MOMS|42Q Home]] > [[Tools|Tools]] > App Garden Quick Guide</small><br/> &nbsp;
  
 
&nbsp;
 
&nbsp;
<center>'''Tools'''</center> <center>'''App Garden Quick Guide'''</center> <center>'''Version MES15.3.3 Portal 1.0'''</center> <center>'''Work Instruction&nbsp;'''</center>  
+
<center>'''Tools'''</center> <center>'''App Garden Quick Guide'''</center> <center>'''Version MES15.3.3'''</center> <center>'''Revision B1'''</center> <center>&nbsp;</center> <center>&nbsp;</center> <center>&nbsp;</center>  
 
&nbsp;
 
&nbsp;
<center>This Work Instruction is 42Q's corporate standard.<br/> This document is under revision control. The latest revision is located on Intranet.<br/> Once printed it is an uncontrolled copy. All alterations to this work instruction require approval.<br/> Contact the IT Global Education and Training Department to submit suggested alterations and or updates.</center>
 
<br/> ''This edition applies to MES15 Portal 1.0 and all subsequent releases and modifications until otherwise indicated in new revisions.''
 
  
 
+
= <span class="mw-headline" id="Introduction"><span class="mw-headline" id="Introduction">Introduction</span></span> =
 
 
 
 
= 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.
 
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.
Line 21: Line 16:
 
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 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)&nbsp;: Manages the tablets.  
+
*'''''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.
 
Android Device Maintenance is the primary module for managing the tablets to which the Package Maintenance applications are pushed.
  
*'''''AppGarden''''' (Installed on every tablet)&nbsp;: Allows installation and updates on Android mobile devices  
+
*'''''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.
+
AppGarden APK is an Android management tool, which is used to manage APK installation and uninstall and update 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 https://42qrpt1.42-q.com/mes_wiki/index.php/SOP-5-I-42Q-MES0106-C_42Q_APK].
 
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 https://42qrpt1.42-q.com/mes_wiki/index.php/SOP-5-I-42Q-MES0106-C_42Q_APK].
Line 33: Line 28:
 
&nbsp;
 
&nbsp;
  
 +
&nbsp;
  
= '''Installation on Device''' =
+
= <span class="mw-headline" id="Installation_on_Device"><span class="mw-headline" id="Installation_on_Device">Installation on Device</span></span> =
  
To install APK package follow the following steps:
+
To install the APK package follow the following steps:
  
 
Use File Manager of your own device to Install;
 
Use File Manager of your own device to Install;
  
Click&nbsp;'''File Explorer''' of your own device to locate your SD card or USB for AppGarden APK installation package and double click to install.
+
Click&nbsp;'''File Explorer''' of your own device to locate your SD card or USB for the AppGarden APK installation package and double click to install.
  
 
'''Figure 1: AppGarden Main Tablet Screen'''
 
'''Figure 1: AppGarden Main Tablet Screen'''
  
[[File:Figure 1- AppGarden Main Tablet Screen.png]]
+
[[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 50: Line 46:
 
'''Figure 2: AppGarden Delete Installer Package'''
 
'''Figure 2: AppGarden Delete Installer Package'''
  
[[File:Figure 2- AppGarden Delete Installer Package.jpg]]
+
[[File:Figure 2- AppGarden Delete Installer Package.jpg|700px|Figure 2- AppGarden Delete Installer Package.jpg]]
  
 
Click '''Confirm'''.
 
Click '''Confirm'''.
Line 56: Line 52:
 
'''Figure 3: AppGarden App Installed'''
 
'''Figure 3: AppGarden App Installed'''
  
'''[[File:Figure 3- AppGarden App Installed.jpg]]'''
+
'''[[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 62: Line 58:
 
'''Figure 4: AppGarden Permissions'''
 
'''Figure 4: AppGarden Permissions'''
  
[[File:Figure 4- AppGarden Permissions.jpg|700px]]
+
[[File:Figure 4- AppGarden Permissions.jpg|700px|Figure 4- AppGarden Permissions.jpg]]
 +
 
 +
&nbsp;
 +
 
 +
&nbsp;
  
== '''''AppGarden Features''''' ==
+
== <span class="mw-headline" id="AppGarden_Features"><span class="mw-headline" id="AppGarden_Features">'''AppGarden Features'''</span></span> ==
  
#"'''Password Protection'''" which restricts anyone to exit this AppGarden unless a password has been entered.  
+
#"'''Password Protection'''" restricts anyone to exit this AppGarden unless a password has been entered.  
 +
 
 +
&nbsp;
  
 
'''Figure 5: Password Protection'''
 
'''Figure 5: Password Protection'''
  
[[File:Figure 5- Password Protection.jpg]]
+
[[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>
 
</ol>
 
</ol>
 +
 +
&nbsp;
  
 
'''Figure 6: Exit AppGarden'''
 
'''Figure 6: Exit AppGarden'''
  
[[File:Figure 6- Exit AppGarden.png|700px]]
+
[[File:Figure 6- Exit AppGarden.png|700px|Figure 6- Exit AppGarden.png]]
 
<ol start="3">
 
<ol start="3">
 
<li>Show the Asset No, Name, Group, Plant, Device Type, Sync-Time, Service Host, current IP address by clicking the “Information” tab.</li>
 
<li>Show the Asset No, Name, Group, Plant, Device Type, Sync-Time, Service Host, current IP address by clicking the “Information” tab.</li>
 
</ol>
 
</ol>
 +
 +
&nbsp;
  
 
'''Figure 7: App Information Icon'''
 
'''Figure 7: App Information Icon'''
  
[[File:Figure 7- App Information Icon .png]]
+
[[File:Figure 7- App Information Icon .png|700px|Figure 7- App Information Icon .png]]
 +
 
 +
&nbsp;
  
 
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
 
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
Line 108: Line 116:
 
'''Figure 8: App Information'''
 
'''Figure 8: App Information'''
  
[[File:Figure 8- App Information .png|700px]]
+
[[File:Figure 8- App Information .png|700px|Figure 8- App Information .png]]
 +
 
 +
&nbsp;
  
 
'''Figure 9: App System Setting'''
 
'''Figure 9: App System Setting'''
  
[[File:Figure 9- App System Setting .png|700px]]
+
[[File:Figure 9- App System Setting .png|700px|Figure 9- App System Setting .png]]
 
<ol start="4">
 
<ol start="4">
 
<li>Show the Android system settings by clicking the “System Setting” tab.</li>
 
<li>Show the Android system settings by clicking the “System Setting” tab.</li>
Line 126: Line 136:
 
*Close  
 
*Close  
  
<u>'''NOTE'''</u>: Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.
+
<u>'''Note'''</u>: Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.
 +
 
 +
&nbsp;
  
 
'''Figure 10: App Settings'''
 
'''Figure 10: App Settings'''
  
[[File:Figure 10- App Settings.png|700px]]
+
[[File:Figure 10- App Settings.png|700px|Figure 10- App Settings.png]]
 
<ol start="5">
 
<ol start="5">
 
<li>Get Started register Asset NO. by clicking the “Re-register Asset No.” tab, e.g. portal-uat.42-q.com.</li>
 
<li>Get Started register Asset NO. by clicking the “Re-register Asset No.” tab, e.g. portal-uat.42-q.com.</li>
 
</ol>
 
</ol>
 +
 +
&nbsp;
  
 
'''Figure 11: Re-Register Asset'''
 
'''Figure 11: Re-Register Asset'''
  
[[File:Figure 11- Re-Register Asset .png|800px]]
+
[[File:Figure 11- Re-Register Asset .png|700px|Figure 11- Re-Register Asset .png]]
 +
 
 +
&nbsp;
  
 
'''Re-register Asset No.'''
 
'''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.
 
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.
 +
 +
&nbsp;
  
 
'''Figure 12: Get Started'''
 
'''Figure 12: Get Started'''
  
[[File:Figure 12- Get Started .jpg]]
+
[[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>
 
</ol>
 
</ol>
 +
 +
&nbsp;
  
 
'''Figure 13: Delete Installation Files'''
 
'''Figure 13: Delete Installation Files'''
  
[[File:Figure 13- Delete Installation Files .png|800px]]
+
[[File:Figure 13- Delete Installation Files .png|700px|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.
+
&nbsp;
 +
 
 +
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'''
  
'''[[File:Figure 14- File Browser .png|800px]]'''
+
'''[[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. For more details please refer to <a href="[https://sanmina.atlassian.net/browse/PAR-1327 https://sanmina.atlassian.net/browse/PAR-1327]">[https://sanmina.atlassian.net/browse/PAR-1327 https://sanmina.atlassian.net/browse/PAR-1327]</a>.
+
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.
 +
 
 +
&nbsp;
  
 
'''Figure 15: Indicators'''
 
'''Figure 15: Indicators'''
  
'''[[File:Figure 15- Indicators .png|800px]]'''
+
'''[[File:Figure 15- Indicators .png|700px|Figure 15- Indicators .png]]'''
 +
 
 +
&nbsp;
  
== '''''AppGarden Login''''' ==
+
== <span class="mw-headline" id="AppGarden_Login"><span class="mw-headline" id="AppGarden_Login">'''AppGarden Login'''</span></span> ==
  
 
#Open the AppGarden application  
 
#Open the AppGarden application  
#First time users will enter the Service Host (i.e., MES Portal IP) to login into the field provided.  
+
#First-time users will enter the Service Host (i.e., MES Portal IP) to login into the field provided.  
  
'''Note&nbsp;: '''Clicking the “H” button will show the latest 3 Host histories for returning users.
+
'''<u>Note:</u> '''Clicking the “H” button will show the latest 3 Host histories for returning users.
  
 
'''Figure 16: Get Started'''
 
'''Figure 16: Get Started'''
  
[[File:Figure 16- Get Started .png|800px]]
+
[[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.
+
<u>'''Note''':</u> The new 2.05 version was updated to add a scanner and “H” host function.
  
 
'''Figure 17: Host Information'''
 
'''Figure 17: Host Information'''
  
[[File:Figure 17- Host Information .png|800px]]
+
[[File:Figure 17- CustomKeyboard.png|700px|Figure 17- CustomKeyboard.png]]
 +
 
 +
&nbsp;
 
<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>
 
<li>Input the Register and Asset No. Fields, there is a scanner button beside that asset No. as well.</li>
 
<li>Input the Register and Asset No. Fields, there is a scanner button beside that asset No. as well.</li>
 
</ol>
 
</ol>
 +
 +
<br/> <u>'''Note''':</u>&nbsp;Customer Keyboard and ‘H’ function apply only for Android 7, 8, and 9 using “Appgarden-42Q-2.06.apk“. For Android 5 and 6, still use “Appgarden-42Q_2.05.apk”. For Android 4, still use the remaining “Appgarden-42Q-2.05.1.apk”.
 +
 +
&nbsp;
  
 
'''Figure 18: Enter Asset Number'''
 
'''Figure 18: Enter Asset Number'''
  
'''[[File:Figure 18- Enter Asset Number.png|800px]]'''
+
'''[[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>
 
</ol>
 
</ol>
  
'''Figure 19&nbsp;: Asset Already Exist Message'''
+
'''Figure 19: Asset Already Exist Message'''
  
'''[[File:Figure 19- Asset List Report.png|800px]]'''
+
'''[[File:Figure 19- Asset List Report.png|700px|Figure 19- Asset List Report.png]]'''
  
 
&nbsp;
 
&nbsp;
Line 205: Line 237:
 
'''Figure 20&nbsp;: Register Page'''
 
'''Figure 20&nbsp;: Register Page'''
  
[[File:Figure 20 - Register Page.png|800px]]
+
[[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 212: Line 244:
 
'''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]]
+
[[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 .
 
 
 
&nbsp;
 
 
 
&nbsp;
 
 
 
 
 
== &nbsp; ==
 
 
 
&nbsp;
 
 
 
&nbsp;
 
 
 
<br/> &nbsp;
 
 
 
== <br/> AppGarden Main Menu ==
 
 
 
When a user selects AppGarden from the AppGarden home screen, the AppGarden main menu appears. First time users may need to enter their AppGarden password.
 
 
 
&nbsp;
 
 
 
'''Figure 4: Enter Password'''
 
 
 
[[File:Figure 4 Enter Password AppGarden.png|500px|Figure 4 Enter Password AppGarden.png]]
 
 
 
&nbsp;
 
 
 
The main menu contains the following selections:
 
 
 
• Information
 
 
 
• System Setting
 
 
 
• Exit AppGarden
 
 
 
• Re-register Asset No.
 
 
 
• Delete Installation Files
 
 
 
• Close
 
 
 
&nbsp;
 
 
 
'''Figure 5: AppGarden Main Menu'''
 
 
 
'''[[File:Figure 5 AppGarden Main Menu.png|500px|Figure 5 AppGarden Main Menu.png]]'''
 
 
 
=== <br/> Information ===
 
 
 
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.
+
'''Note''': Clicking the colorful icon located at the button right allows you to enter in a password to gain access to the application.
  
• '''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.
 
  
 
&nbsp;
 
&nbsp;
 
'''Figure 6: Information'''
 
 
'''[[File:Figure 6 Information AppGarden.png|500px|Figure 6 Information AppGarden.png]]'''
 
 
=== <br/> System Settings ===
 
 
Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.
 
 
&nbsp;
 
 
'''Figure 7: System Settings'''
 
 
'''[[File:Figure 7 System Settings AppGarden.png|500px|Figure 7 System Settings AppGarden.png]]'''
 
 
=== <br/> Exit AppGarden ===
 
 
Select this function to quit the AppGarden application.
 
 
&nbsp;
 
 
=== 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
 
 
1. 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.
 
 
2. 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.
 
 
&nbsp;
 
 
'''Figure 8: Re-register Asset Number'''
 
 
[[File:Figure 8 Re-register Asset Number.png|500px|Figure 8 Re-register Asset Number.png]]
 
 
<br/> '''Figure 9: Re-register Asset Number Information'''
 
 
[[File:Figure 9 Information Re-register Asset Number.png|500px|Figure 9 Information Re-register Asset Number.png]]<br/>  
 
 
=== Delete Installation Files ===
 
 
In the process of air deployment there will installation files that are downloaded to the tabled 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.
 
 
&nbsp;
 
 
&nbsp;
 
 
= Document History =
 
 
{| border="2" cellpadding="4" cellspacing="0" width="100%"
 
|-
 
| align="center" bgcolor="#00FFFF" | <font color="#FFFFFF">Date</font>
 
| align="center" bgcolor="#00FFFF" | <font color="#FFFFFF">Author</font>
 
| align="center" bgcolor="#00FFFF" | <font color="#FFFFFF">Title</font>
 
| align="center" bgcolor="#00FFFF" | <font color="#FFFFFF">Version</font>
 
| align="center" bgcolor="#00FFFF" | <font color="#FFFFFF">Change Reference</font>
 
|-
 
| 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
 
| &nbsp;
 
| 42Q Format
 
|}
 

Latest revision as of 17:36, 8 October 2021

42Q Home > Tools > App Garden Quick Guide
 

 

Tools
App Garden Quick Guide
Version MES15.3.3
Revision B1
 
 
 

 

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 update 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 the 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 the 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" 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- CustomKeyboard.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.


Note: Customer Keyboard and ‘H’ function apply only for Android 7, 8, and 9 using “Appgarden-42Q-2.06.apk“. For Android 5 and 6, still use “Appgarden-42Q_2.05.apk”. For Android 4, still use the remaining “Appgarden-42Q-2.05.1.apk”.

 

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 to the application.