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 Indigo and use it to debug the Version 7 scripts.

Eclipse Indigo is available from the Sage Downloads web site. The following development process demonstrates how to install Eclipse Indigo 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 Indigo, including the Sage X3 plug-in. This is available from the Sage X3 Studio for Eclipse Downloads web site: http://pluginx3.sage.fr/safex3/studio/downloads/downloads.html.

3. If you used the download provided from step 2, to use Eclipse with Version 7, you must upgrade to Eclipse Indigo SR2 as per the following steps:

• Run Eclipse.
• Select Help.
• Select Check for Updates.
• Select the latest version (SR2) and update.

  4.  Create a new Sage X3 project in Eclipse.

  5.  Set up your Version 7 Sage X3 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
• AECLIDBGTR
• 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 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 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.