MES Blank Buttons

Good grief! Thanks for the answer book. I'll store it away.



~Charlie

_____

From: vantage@yahoogroups.com [mailto:vantage@yahoogroups.com] On Behalf Of
Chris Thompson
Sent: Thursday, October 29, 2009 9:48 AM
To: vantage@yahoogroups.com
Subject: Re: [Vantage] MES Blank Buttons





Hi Charlie,

I dont know if you have managed to sort this.

The AnswerBook contents for creation and deployment are below ....

PROBLEM DESCRIPTION:
I have set up MES to support customization, and I have noticed several blank
buttons on the MES menu. Am I able to reprogram the buttons for other
programs?
PROBLEM RESOLUTION:
You certainly can.
This topic gets involved, but by all means, if you have permissions to do
customizations, you can assign other V8 (the 8.0 application) programs to
the blank buttons.
Launch MES in customization mode. See section below on how to setup
shortcut for MES Developer. Log in and navigate to a tab that has a blank
button. I will use the Production tab as illustration. Right-click somewhere
on the form, and in the context menu, select Customization. The screen looks
a little bit different. Now, click once on the target (blank) button. The
Customization Tools Dialog box appears.
Creating MES Developer Icon
====================================
* Make a copy of your MES icon and rename it to something like MES Developer
* Then right click on it and choose Properties
* In the Target field locate where it shows -MES and change it to -MESC.
Understanding the button and properties. The customization window is in two
columns: The list of entities (buttons and fields) on the left, and the
corresponding properties on the right.
You may wish to reposition the dialog box so that the desired button to
customize can still be seen.
When the blank button is clicked on the MES menu, the button name on the
left is highlighted, and its corresponding traits appear on the right. In my
example, V8 considers this blank button as "button83" which is highlighted.
All properties of button83 appear on the right.
So what are the pertinent properties?
----------------------------------------------------------
" EpiBinding: The message that appears when the button is clicked. Right
now, a message simply says "not used". Clear this property field.
" Text: The label of the button. This value is blank because the button is
blank. For this example, we will open Purchase Order Tracker. Type PO
Tracker. If you can also see the MES menu, you will notice that the label
now appears on the button.
Saving the setting. Select File - Save Customization.
Script work
----------------
So far, so good. We have cosmetically applied the necessary trait to the
button - we have enabled it, given it a label, and made it exist in the MES
customization framework. Now, we have to get to the "nitty-gritty" of the
script, which serves to assign the button with the desired program.
What is a GUID?
--------------------------
A GUID (pronounced GOO-id) is a unique and long combination of letters and
numbers for every visible entity in Vantage. A GUID has been assigned to the
button you chose, and it cannot be changed. You will note that this property
was grayed out for the button.
What is the menu ID?
----------------------------------
The menu ID is the unique ID assigned to a menu item, in the eyes of
Vantage. This can be determined in Menu Maintenance.
From System Management - Utilities, select Menu Maintenance. Then, in the
tree-view on the left, navigate to the desired program - in this case,
Material Management - Shipping/Receiving - General Operations - Purchase
Order Tracker. Then see the Menu ID field. In my installation, it is
SRGO1003.
Take note of the Menu ID value. You will need it later.
What does the script portion do?
----------------------------------------------------
The purpose of the script portion of the button programming is to assign the
GUID, and hence the button, to the menu ID, and hence the the desired
Vantage program. We will assign the GUID with the SRGO1003, aka Purchase
Order Tracker.
Review the existing script.
-----------------------------------------
In the Customization Tools Dialog box, click the Script Editor tab. A script
appears that controls the logic for the entire customization. It includes
declarations, calls to different logic, this, that, the other. Don't worry
about understanding what's there. (I don't understand it all myself.)
However, take note of the last line: End Module. This must remain the last
line. Take note of the second to the last line: End Sub. That line must stay
where it is, as well. In other words, End Sub and upward must stay together,
and End Module must remain the very last line.
So: We are interested in the gap between the last End Sub line and the last
End Module line.
Adding to the script. You will be entering two very long lines of text. The
first assigns a procedure call to the GUID. The second assigns the same
procedure call to the menu ID.
What does this script do?
---------------------------------------
The script enters a unique procedure, btnLaunchTracker, that ties together
both the GUID and the menu ID. Both are in bold. The GUID comes from the
properties of the button that you clicked; the menu ID comes from the entry
for the desired program in Menu Maintenance. Both will almost certainly have
to be replaced by you. Take note that we also enabled this procedure - in
effect, enabling the button.
Copy the following lines and paste them into the script editor.
Private WithEvents btnLaunchTracker As EpiButton
Private Sub MESMenu_Load(ByVal sender As object, ByVal args As EventArgs)
Handles MESMenu.Load
'//
'// Add Event Handler Code
'//

btnLaunchTracker =
CType(csm.GetNativeControlReference("6485a0e7-804a-4831-8995-80604acca0ff"),
EpiButton) '// YOU WILL NEED TO REPLACE THIS VALUE WITH THE EPIGUID FROM
THE BUTTON PROPERTIES

btnLaunchTracker.Enabled = True

End Sub
Private Sub btnLaunchTracker_Click(ByVal Sender As Object, ByVal args As
EventArgs ) Handles btnLaunchTracker.Click
ProcessCaller.LaunchForm(MESMenu, "SRGO1003")

End Sub
Save and close.
-------------------------
Close the MES menu; click Yes to the Save message. When you open it, you
should have yourself a new button that launches the desired program.
Note: Deploying the MES customization is explained in answerbook 4306MPS.
What if I want to customize more than one button?
----------------------------------------------------------
You would work with a different set of properties, BUT it would need to be
addressed in this script. You need one procedure, and one pairing, per
button. You would need one declaration of the procedure for the GUID of the
button, and another declaration of the procedure for the menu ID. Also, each
procedure needs a unique name, so if it were another tracker, it might be
btnLaunchTracker2.
Final note: The '// lines are comments. I strongly encourage generous use of
comments. At some future time, someone with no knowledge of GUIDs or menu
IDs may wish to modify the menu, and will need to know the intent of the
menu customization. It is also useful for printing out, in case you wish to
reinstate customizations lost.
What V8 programs can I launch from these buttons?
----------------------------------------------------------
MES licenses are not full production license so you will not have free reign
to add anything you want. You are limited to the following baseline UIs and
Reports. In addition, any custom dashboard or crystal report maybe
launched from a button.


AnswerBook #: 4306ESC Product: Vantage
Date Added: 2/11/2008 Version:
Date Changed: 4/27/2009 Module: Customization

________________________________

Summary:
CUST DEP How to customize the main MES Menu and set to use it instead of
default
Details:
Summary: CUST How do you customize the main MES Menu and set to use it
instead of default
Book: Support Solutions

PROBLEM:
How do you customize the main MES Menu and set to use it instead of default?

Note: this answerbooks also worked for 8.03 MES

SOLUTION
Create your customization
1. Right-click on the shortcut for Vantage 8.0 MES.
2. Copy and paste the copy to the desktop.
3. Rename the copy to something like MES Developer.
4. Right-Click and choose Properties.
5. In the Target area, locate where it shows -MES and change it to -MESC.
6. Click OK to save the changes.
7. Login to MES Developer.
8. Make your customizations and choose Save as
9. Give your customization a name (i.e CustomMES)
10. Save and close MES

To deploy create a SubProcess record
11. Log into your a regular 8.0 session
12. Go to System Management >> Utilites >> Sub Process Maintenance
13. Create a new menu ID and give it a name e.g UDMES1
14. Choose the security you want to apply to this option
15. Enter a parent process like PROCESS or MAINMENU
16. Enter a unique number for the sequence like 10, 15, 20, etc.
17. Under the Program section browse to or type in Epicor.Mfg.Menu.Mes.dll
18. Choose the Customization name you saved in steps 4/5 from the list box
19. Save and close Sub Process Maintenance

Create a Calling Process Record:
20. Create a Process Calling using System Management >> Utilities >>

Process Calling Maintenance
21. Choose File >> New
22. Process Called Reference = Epicor.Mfg.Menu.MES
23. Menu ID = UDMES1 (Menu ID create in step 13)
24. Save and close Process Calling Maintenance

Update the configuration file with the name of the custom MES menu.
25. Add the process ID you just created in step # 13 as the value for the
MESCustomMenuID node in the configuration file being referenced by
your MES icon. To find the name of your configuration file check the
properties of your MES icon. In the following example the
configuration file is named ""mes.mfgsys"".

C:\Epicor\vega403\client\MfgSys.exe -MES /config=mes.mfgsys

If the icon properties are C:\Epicor\vega403\client\MfgSys.exe -MES then the
the configuration file would be ""default.mfgsys"".
In Vantage 8.03 you can use the ConfigEditor.exe to change the value of
MESCustomMenuId. In this example you would set it to be
""UDMES1"". In older versions of Vantage you need to open the appropiate
configuration file using NotePad and under the
<appSettings> </appsettings> section make the following change
<MESCustomMenuID value=""UDMES1"" /> . You'll find the configuration
file in the ...epicor/client/config directory.

26. Log into MES again and you should now see your customization.

Note 1: When first installed you will need to change the xxx.mfgsys
file used by each MES user.

Note 2: Be sure to change the one in the Vantage client stored on the
server so that when you install a new release of Vantage and the
client folders are updated the modified xxx.mfgsys is downloaded to
the clients.

-Update the server's xxx.mfgsys to the Client's.

________________________________
From: Charlie Wilson <foamdesigncsw@ <mailto:foamdesigncsw%40yahoo.com>
yahoo.com>
To: vantage@yahoogroups <mailto:vantage%40yahoogroups.com> .com
Sent: Monday, 26 October, 2009 11:38:24
Subject: [Vantage] MES Blank Buttons


I would like to use one of these blank buttons on the MES Screen to load a
dashboard we have created. Is there an answer book on how to do this?

~Charlie

[Non-text portions of this message have been removed]

[Non-text portions of this message have been removed]





[Non-text portions of this message have been removed]
I would like to use one of these blank buttons on the MES Screen to load a
dashboard we have created. Is there an answer book on how to do this?



~Charlie





[Non-text portions of this message have been removed]
Hi Charlie,

I dont know if you have managed to sort this.


The AnswerBook contents for creation and deployment are below ....

PROBLEM DESCRIPTION:
I have set up MES to support customization, and I have noticed several blank buttons on the MES menu. Am I able to reprogram the buttons for other programs?
PROBLEM RESOLUTION:
You certainly can.
This topic gets involved, but by all means, if you have permissions to do customizations, you can assign other V8 (the 8.0 application) programs to the blank buttons.
Launch MES in customization mode. See section below on how to setup shortcut for MES Developer. Log in and navigate to a tab that has a blank button. I will use the Production tab as illustration. Right-click somewhere on the form, and in the context menu, select Customization. The screen looks a little bit different. Now, click once on the target (blank) button. The Customization Tools Dialog box appears.
Creating MES Developer Icon
====================================
* Make a copy of your MES icon and rename it to something like MES Developer
* Then right click on it and choose Properties
* In the Target field locate where it shows -MES and change it to -MESC.
Understanding the button and properties. The customization window is in two columns: The list of entities (buttons and fields) on the left, and the corresponding properties on the right.
You may wish to reposition the dialog box so that the desired button to customize can still be seen.
When the blank button is clicked on the MES menu, the button name on the left is highlighted, and its corresponding traits appear on the right. In my example, V8 considers this blank button as "button83" which is highlighted. All properties of button83 appear on the right.
So what are the pertinent properties?
----------------------------------------------------------
" EpiBinding: The message that appears when the button is clicked. Right now, a message simply says "not used". Clear this property field.
" Text: The label of the button. This value is blank because the button is blank. For this example, we will open Purchase Order Tracker. Type PO Tracker. If you can also see the MES menu, you will notice that the label now appears on the button.
Saving the setting. Select File - Save Customization.
Script work
----------------
So far, so good. We have cosmetically applied the necessary trait to the button - we have enabled it, given it a label, and made it exist in the MES customization framework. Now, we have to get to the "nitty-gritty" of the script, which serves to assign the button with the desired program.
What is a GUID?
--------------------------
A GUID (pronounced GOO-id) is a unique and long combination of letters and numbers for every visible entity in Vantage. A GUID has been assigned to the button you chose, and it cannot be changed. You will note that this property was grayed out for the button.
What is the menu ID?
----------------------------------
The menu ID is the unique ID assigned to a menu item, in the eyes of Vantage. This can be determined in Menu Maintenance.
From System Management - Utilities, select Menu Maintenance. Then, in the tree-view on the left, navigate to the desired program - in this case, Material Management - Shipping/Receiving - General Operations - Purchase Order Tracker. Then see the Menu ID field. In my installation, it is SRGO1003.
Take note of the Menu ID value. You will need it later.
What does the script portion do?
----------------------------------------------------
The purpose of the script portion of the button programming is to assign the GUID, and hence the button, to the menu ID, and hence the the desired Vantage program. We will assign the GUID with the SRGO1003, aka Purchase Order Tracker.
Review the existing script.
-----------------------------------------
In the Customization Tools Dialog box, click the Script Editor tab. A script appears that controls the logic for the entire customization. It includes declarations, calls to different logic, this, that, the other. Don't worry about understanding what's there. (I don't understand it all myself.)
However, take note of the last line: End Module. This must remain the last line. Take note of the second to the last line: End Sub. That line must stay where it is, as well. In other words, End Sub and upward must stay together, and End Module must remain the very last line.
So: We are interested in the gap between the last End Sub line and the last End Module line.
Adding to the script. You will be entering two very long lines of text. The first assigns a procedure call to the GUID. The second assigns the same procedure call to the menu ID.
What does this script do?
---------------------------------------
The script enters a unique procedure, btnLaunchTracker, that ties together both the GUID and the menu ID. Both are in bold. The GUID comes from the properties of the button that you clicked; the menu ID comes from the entry for the desired program in Menu Maintenance. Both will almost certainly have to be replaced by you. Take note that we also enabled this procedure - in effect, enabling the button.
Copy the following lines and paste them into the script editor.
Private WithEvents btnLaunchTracker As EpiButton
Private Sub MESMenu_Load(ByVal sender As object, ByVal args As EventArgs) Handles MESMenu.Load
           '//
           '// Add Event Handler Code
           '//
Â
btnLaunchTracker = CType(csm.GetNativeControlReference("6485a0e7-804a-4831-8995-80604acca0ff"), EpiButton)  ‘// YOU WILL NEED TO REPLACE THIS VALUE WITH THE EPIGUID FROM THE BUTTON PROPERTIES
Â
btnLaunchTracker.Enabled = True
Â
End Sub
 Private Sub btnLaunchTracker_Click(ByVal Sender As Object, ByVal args As EventArgs ) Handles btnLaunchTracker.Click
ProcessCaller.LaunchForm(MESMenu, "SRGO1003")
Â
End Sub
Save and close.
-------------------------
Close the MES menu; click Yes to the Save message. When you open it, you should have yourself a new button that launches the desired program.
Note: Deploying the MES customization is explained in answerbook 4306MPS.
What if I want to customize more than one button?
-------------------------------------------------------------------------------
You would work with a different set of properties, BUT it would need to be addressed in this script. You need one procedure, and one pairing, per button. You would need one declaration of the procedure for the GUID of the button, and another declaration of the procedure for the menu ID. Also, each procedure needs a unique name, so if it were another tracker, it might be btnLaunchTracker2.
Final note: The '// lines are comments. I strongly encourage generous use of comments. At some future time, someone with no knowledge of GUIDs or menu IDs may wish to modify the menu, and will need to know the intent of the menu customization. It is also useful for printing out, in case you wish to reinstate customizations lost.
What V8 programs can I launch from these buttons?
-----------------------------------------------------------------------------
MES licenses are not full production license so you will not have free reign to add anything you want. You are limited to the following baseline UIs and Reports.  In addition, any custom dashboard or crystal report maybe launched from a button.
Â
Â
AnswerBook #: 4306ESC Product: Vantage
Date Added: 2/11/2008 Version:
Date Changed: 4/27/2009 Module: Customization

________________________________

Summary:
CUST DEP How to customize the main MES Menu and set to use it instead of default
Details:
Summary: CUST How do you customize the main MES Menu and set to use it instead of default
Book: Support Solutions

PROBLEM:
How do you customize the main MES Menu and set to use it instead of default?

Note: this answerbooks also worked for 8.03 MES

SOLUTION
Create your customization
1. Right-click on the shortcut for Vantage 8.0 MES.
2. Copy and paste the copy to the desktop.
3. Rename the copy to something like MES Developer.
4. Right-Click and choose Properties.
5. In the Target area, locate where it shows -MES and change it to -MESC.
6. Click OK to save the changes.
7. Login to MES Developer.
8. Make your customizations and choose Save as
9. Give your customization a name (i.e CustomMES)
10. Save and close MES

To deploy create a SubProcess record
11. Log into your a regular 8.0 session
12. Go to System Management >> Utilites >> Sub Process Maintenance
13. Create a new menu ID and give it a name e.g UDMES1
14. Choose the security you want to apply to this option
15. Enter a parent process like PROCESS or MAINMENU
16. Enter a unique number for the sequence like 10, 15, 20, etc.
17. Under the Program section browse to or type in Epicor.Mfg.Menu.Mes.dll
18. Choose the Customization name you saved in steps 4/5 from the list box
19. Save and close Sub Process Maintenance

Create a Calling Process Record:
20. Create a Process Calling using System Management >> Utilities >>

Process Calling Maintenance
21. Choose File >> New
22. Process Called Reference = Epicor.Mfg.Menu.MES
23. Menu ID = UDMES1 (Menu ID create in step 13)
24. Save and close Process Calling Maintenance

Update the configuration file with the name of the custom MES menu.
25. Add the process ID you just created in step # 13 as the value for the MESCustomMenuID node in the configuration file being referenced by
your MES icon. To find the name of your configuration file check the properties of your MES icon. In the following example the
configuration file is named ""mes.mfgsys"".

C:\Epicor\vega403\client\MfgSys.exe -MES /config=mes.mfgsys

If the icon properties are C:\Epicor\vega403\client\MfgSys.exe -MES then the the configuration file would be ""default.mfgsys"".
In Vantage 8.03 you can use the ConfigEditor.exe to change the value of MESCustomMenuId. In this example you would set it to be
""UDMES1"". In older versions of Vantage you need to open the appropiate configuration file using NotePad and under the
<appSettings> </appsettings> section make the following change <MESCustomMenuID value=""UDMES1"" /> . You'll find the configuration
file in the ...epicor/client/config directory.

26. Log into MES again and you should now see your customization.

Note 1: When first installed you will need to change the xxx.mfgsys
file used by each MES user.

Note 2: Be sure to change the one in the Vantage client stored on the
server so that when you install a new release of Vantage and the
client folders are updated the modified xxx.mfgsys is downloaded to
the clients.

-Update the server's xxx.mfgsys to the Client's.




________________________________
From: Charlie Wilson <foamdesigncsw@...>
To: vantage@yahoogroups.com
Sent: Monday, 26 October, 2009 11:38:24
Subject: [Vantage] MES Blank Buttons

Â
I would like to use one of these blank buttons on the MES Screen to load a
dashboard we have created. Is there an answer book on how to do this?

~Charlie

[Non-text portions of this message have been removed]







[Non-text portions of this message have been removed]