wiki:XgapCustomization

Version 1 (modified by trac, 14 years ago) (diff)

--

XGAP Customization

Programmers can download and customize the XGAP using the Eclipse workspace as follows:

  1. We assume you already installed and configured the software described in XgapInstall, step 1-7. Only difference is that you should not automatically run tomcat.
  2. Download and unzip XGAP developer workspace (xgap_workspace.zip)
  3. Install Eclipse Integrated Development Environment
    You need to install the J2EE version (which allows you to (re)start/stop tomcat)
  4. (Optional) MOLGENIS autogenerates documentation for the XGAP application. This includes a graphical representation of the XGAP model in UML format. This requires GraphViz to work: Download and install graphviz from http://www.graphviz.org/Download.php Make sure your PATH is set to run 'dot.exe' from the commandline.
  5. Start Eclipse and open the xgap_workspace as your workspace.
    Now you are ready to start extending your XGAP system:
    • Edit the xgap_db.xml model file to change the object model
    • Edit the xgap_ui.xml model file to change the user interface
    • Run the generator by right-clicking the file 'handwritten/java/default/MolgenisGenerate' and choosing 'run' (next time you can use the green 'play' button).
    • Right-click on your xgap project and 'refresh' to make Eclipse compile the generated code.
    • Load your newly generated datastructure into MySQL by choosing 'handwritten/java/default/MolgenisUpdateDatabase' and choosing 'run'
      !Warning!: any existing data in XGAP will be overwritten.
    • Run your new XGAP extension by right-click on your 'xgap' project and choose 'run on server'. That is all there is to it ;-)

Check the full http://www.molgenis.org/wiki/MolgenisGuide for much more details on MOLGENIS data modeling and plug-in development. Check the full http://www.molgenis.org/wiki/MolgenisGuide for much more details on MOLGENIS data modeling and plug-in development.