Article
· Mar 14, 2022 4m read

How to publish an Application on Open Exchange

Publishing process

You can publish your own application on Open Exchange and it will be listed in an Applications Gallery. The publishing process is a set of following steps:

  1. Register on Open Exchange
  2. Create the application description
  3. Submit the application for approval
  4. Done! Please find below the detailed description.

To publish an application first you need to sign in to Open Exchange. You can do this using your Developer Community account or create a new account here. Once signed in open the applications section in a profile menu:

Screenshot 2020-10-17 at 13 11 00

Then click on Add Application button:

Screenshot 2020-10-17 at 13 14 13

 

Setting up an application: importing data from GitHub

If your application has the public repository on GitHub you can import the majority of fields automatically from Github.
Place the URL of your repository in Github URL field:

Screenshot 2020-10-17 at 13 21 07

And the data from the GitHub repo will be imported automatically:

Screenshot 2020-10-17 at 13 34 14

You need to choose the category and select InterSystems Products supported and you good to submit for approval.

 

Setting up an application manually

And you can fill all the fields manually of course:

Screenshot 2020-10-17 at 13 34 14

Name

This the name of your application. It should be unique amongst Open Exchange applications.

 

Download URL

The URL where the application could be downloaded. It will be converted to a Download button on your application’s page:

Screenshot 2020-10-17 at 14 27 56

License URL

Place here an URL that describes the license available for any interactions with your application. The majority of Open Source developers consider a MIT License, but you are not limited by it. Commercial applications can provide different types and forms of licensing, provide a link where these terms could be observed.

Category

You can pick one category to which your application belongs from the following:

  • Analytics
  • Development Environment
  • Framework
  • Interoperability
  • Solution
  • Technology Example

 

InterSystems Technology

Please choose InterSystems product or/and technology your solution or tool works with:

Screenshot 2020-10-17 at 13 43 48

 

Industry

Select the industry(s) to witch your solution implies:

Screenshot 2020-10-17 at 13 51 37

Package manager checkbox

Check it on if you plan to submit your application to the ZPM Package Manager. Learn more here

Screenshot 2020-10-17 at 13 55 46

Take a look on the full process of creating and submitting ObjectScirpt App to Github with ZPM support

Package First Development Approach with InterSystems IRIS and ZPM

 

Short description

This is the description that will appear on application tiles in the gallery.

Screenshot 2020-10-17 at 14 02 54

 

More fields

Screenshot 2020-10-17 at 14 06 08

 

A long description

This is what you see on the page of any application. Example. If your application is on GitHub you can just use GitHub README.md of this repository - manage it with this checkbox:

Screenshot 2020-10-17 at 14 11 43

Please note, that in long description you should mention:
- App's goals and functions
- How to use the app
- If it is open source app - please, provide the installation instructions 

A long description supports markdown notation so you can use rich text format and insert screenshots and videos e.g. from YouTube.

 

Tags

Tags is a mandatory field. Place here a comma-separated list of tags that relate to your solution, tags will form virtual categories for the applications. E.g. SQL, JSON.

Community Article URL

Place the article where you announce the application or invite to discuss it’s features or the newest release details - this will be converted into the clickable Discuss button on the application’s page.

Screenshot 2020-10-17 at 14 20 46

 

YouTube URL

Place a link to a YouTube video that describes your application - the video will be embedded into your application’s page, example.

Documentation URL

Link to the application’s online documentation if any.

Support URL

Link to the page where you can submit a support ticket.

 

Saving the draft of the application

You can check how your application’s page looks like and Save the draft if you are good.

Screenshot 2020-10-17 at 14 30 31

 

Changing the icon of an application

You can customize the icon/logo of your application while it is in a draft mode. Use the application’s edit menu option:

Screenshot 2020-10-17 at 14 34 40

 

Submitting the application for approval

Once you are happy with how your application’s page looks like you can submit the draft for approval.

Screenshot 2020-10-17 at 14 37 39

You’ll be questioned about the version of the first release and the release notes, please fill it in and click the Send button.

Screenshot 2020-10-17 at 14 38 09

After that wait until the approval notification from the Open Exchange team by email and see your application published in the Applications Gallery.

 

What’s Next

Once your application is published you can submit new releases, learn more. If you want to make changes to the description of the application you need to edit it, make changes, and send for approval again. Learn more.

Have you already published an app on Open Exchange?
Discussion (3)1
Log in or sign up to continue