Select Page

Develop your own GIS or modeling tool using the eRAMS Roundtrip™ platform.

eRAMS Roundtrip™ is currently in active development; a beta release is expected in the near future.

Request a Roundtrip Instance

Login to eRAMS and navigate to the ALM Roundtrip request page.

screenshot

Provide all required information and select and performance tier, then click Submit.  eRAMS will launch and provision your own personal application development environment.

When the process is complete, you’ll be provided with a url to the ALM Roundtrip dashboard of your Roundtrip instance.

Create your own Roundtrip Project

Open the Roundtrip dashboard for your project at the provided url:

screenshotClick on the “Create Project” button from the dashboard.  Provide the name of your project and then click “Submit.”   A project skeleton will be generated and provided for you to download.

screenshot

You should now see the project you created in the dashboard:

screenshot

Working with a New Project

Click on the “test” link to open the project in the dashboard:

screenshot

You will see the current revision (changeset) of the project, its last modified date, and an initial commit message.  The project has been created using the Mercurial source control management tool.  You can now download and work with your new project by using a mercurial “clone” command using the link below the “Revision” column of your table:

hg clone http://my.roundtrip.url/cgi-bin/hgweb/test

This will download your project to your local computer so that you can immediately begin working with them.

Project Structure

The files are structured so that you, as a developer, can have the greatest flexibility in developing your project while still dividing your application logic into useful categories.  At the top-level, there are two folders, “client” and “server”, as well as a project configuration file.  Within the client folder, you may include images, CSS stylesheets, javascript files, or anything else that you’d like to serve to the user’s web browser.  On the server side, you may include your Django models, views, tests, as well as any other python code or executable that you’d like to call from the web server.  Finally, within the server directory, there is a folder for Django database migrations as well as Django HTML templates that you can use for customizing the look and feel of your project’s GIS/Analysis page.

Editing Project Code

Edit these files in your local development environment.  When you are ready to submit your changes, you will perform mercurial “commit” and “push” commands to update your roundtrip instance.

We recommend making numerous small commits to make finding any syntax errors easier.

hg commit -m “my local changes”

hg push

Once these commands are performed, the roundtrip instance will automatically deploy your changes, to the eRAMS Roundtrip instance created in the first step. Once you have setup an account and logged into eRAMS, you can create a new project using the “test” project template you generated through the dashboard:

screenshot

Then open the GIS/Analysis page to see any changes you’ve made to the code:

screenshot

When you no longer need the project, you can easily delete it from the dashboard.  Upon deletion, any database tables associated with the project will be removed from the database, and all code will be undeployed.

Future Roadmap: Docker Containers

In the future, there are plans to give eRAMS developers even more control over their eRAMS projects, using eRAMS Docker containers that will allow developers to maintain a copy of eRAMS hosted on their own local computers and push these changes to the cloud.

The workflow will look like this:

  • Developer requests eRAMS development environment
    • eRAMS Roundtrip provides developer with link to eRAMS Docker container for download
  • Developer installs Docker container in local environment
  • Developer builds eRAMS projects or plugins using the eRAMS SDK
  • Developer publishes Docker container to eRAMS, AWS, or other cloud environment for hosting