How to install eclipse and use it to debug version 7 code

This ‘How-to’ provides information on how to install the open source software Eclipse Luna and use it to debug the Version 7 scripts.

Eclipse Luna is available from the Sage Downloads web site. The following development process demonstrates how to install Eclipse Luna and start debugging the Version 7 code.

1. Install Oracle® Java™ SE Runtime Environment (JRE). Make sure you install the 32-bit (x86) version if you are using Eclipse 32-bit, and the 64-bit version (x64) if you are using Eclipse 64-bit.

   Note: Ensure this is a 32-bit installation. It is recommended that a reboot is performed following the installation.

2. Download Eclipse Luna, including the Sage X3 People plug-in. This is available from the Sage X3 People Studio for Eclipse Downloads web site: http://pluginx3.sage.fr/safex3/studio/downloads/downloads.html.

3. If you have problems when launching Eclipse, please check the troubleshooting page.

  4.  Create a new Sage X3 People project in Eclipse.

  5.  Set up your Version 7 Sage X3 People Client to use Eclipse as the default script editor. To do this:

• Using the 'GESAUS' function (Setup > Users > Users), select the relevant user account.
• Access the Parameter definition tab.
• Locate the 'Chapter=Supervisor', 'Group=Dev', 'Title=Development row', and then right-click and select Detail from the selection menu.
• Set the following parameter values to Yes (if not already set):
• AECLIDBG
• AECLIPSE

        Your default script editor is now Eclipse.

  6.  To start debugging the Version 7 code, perform the following:

• Select your Menu item from your Version 7 Sage X3 People Client ‘Home’ dashboard.
• Open Eclipse.
• Open your script.
• Select 'Debug Perspective' (Window > Open Perspective > Debug).
• Select 'Attach to process and debug'.
• Select your process, and then 'Attach'.
• Position your cursor on the line in your script where you need to start the debug process.
• Select 'Run', and then 'Run to line'.
• In the Version 7 Sage X3 People Client, process your selected transaction. When your transaction reaches the selected line in the code (script), it will stop.

        You can now debug using the standard Eclipse functionality.