Clear filter
Announcement
Anastasia Dyubaylo · Oct 11, 2019
Hi Community,
It's time for the new videos from Global Summit 2019 on InterSystems Developers YouTube Channel! Are you ready?
Please welcome the first session recording from InterSystems Developers:
The State of the InterSystems Developer Community
In this video we will discuss what’s new and notable in the InterSystems Developer Community. We will survey the broad array of resources for learning, collaborating, and prototyping, including:
Online learning and documentation for InterSystems;
A free new InterSystems IRIS sandbox environment you can spin up in seconds;
What’s new with Developer Community and Global Masters;
GitHub updates.
Spoiler alert: ObjectScript is now a 1st class language on GitHub!
Presenters:
🗣 @Evgeny.Shvarov, Manager, Developers Community and Startups🗣 @David.Reche, Senior Sales Engineer, Spanish Community Manager🗣 @Raj.Singh, Product Manager, Developer Experience
Big applause for these speakers, thank you guys! 👏🏼
In addition, please read this article: InterSystems ObjectScript Package Manager.
And...
What's new on InterSystems Developers YouTube?
We have created a new dedicated Global Summit 2019 playlist & Global Summit Keynotes playlist. They will be updated over time.
Enjoy and stay tuned!
Announcement
Jeff Fried · Oct 28, 2019
Preview releases are now available for the 2019.4 version of InterSystems IRIS, IRIS for Health, and IRIS Studio!
Container images are available via the WRC's preview download site.
The build number for these releases is 2019.4.0.379.0.
InterSystems IRIS Data Platform 2019.4 has many new capabilities including:
Polyglot Extension (PeX) available for .Net
ICM support for Tencent Cloud
List Class available in the Native API for Java and .Net
New CSF (Configuration State File) facility
System security, performance, and efficiency enhancements
Container and Cloud Deployment improvements
InterSystems IRIS for Health 2019.4 includes all of the enhancements of InterSystems IRIS. In addition, this release includes FHIR searching with chained parameters (including reverse chaining) and minor updates to FHIR and other health care protocols.
These are detailed in the documentation:
InterSystems IRIS 2019.4 documentation and release notes
IRIS for Health 2019.4 documentation and release notes
InterSystems IRIS Studio 2019.4 is a standalone development image supported on Microsoft Windows. It works with InterSystems IRIS and IRIS for Health version 2019.4 and below, as well as with Caché and Ensemble.
As this is a CD release it is only available in OCI (Open Container Initiative) a.k.a. Docker container format. The platforms on which this is supported for production and development are detailed in the Supported Platforms document. The download for IRIS Studio 2019.4 is not working. Community kits (preview) for InterSystems IRIS and InterSystems IRIS for Health are now available from the Docker hub.
docker pull store/intersystems/iris-community:2019.4.0.379.0
docker pull store/intersystems/irishealth-community:2019.4.0.379.0
Hi Kurt
Sorry about that. I have corrected the issue with downloading studio.
Please let us know if you run into anything else.
Announcement
Anastasia Dyubaylo · Oct 30, 2019
Hi Community,
The new video from Global summit 2019 is already on InterSystems Developers YouTube:
⏯ Adopting InterSystems IRIS
In this video, we will introduce the InterSystems IRIS Adoption Guide, and describe the process of moving from Caché and/or Ensemble to InterSystems IRIS. We will also briefly touch on the conversion process for existing installations of Caché/Ensemble-based applications.
Takeaway: InterSystems helps customers as they adopt InterSystems IRIS.Presenter: @Andreas.Dieckow, Principal Product Manager, InterSystems
And...
What's new on InterSystems Developers YouTube?
We have created a new dedicated Global Summit 2019 playlist & Global Summit Keynotes playlist. They will be updated over time.
Enjoy and stay tuned!
Announcement
Anastasia Dyubaylo · Feb 7, 2020
Hi Community,
Please welcome the new video on InterSystems Developers YouTube, recorded by @Stefan.Wittmann:
⏯ Supporting All Tools for Development in InterSystems IRIS
InterSystems Product Manager @Stefan.Wittmann talks about InterSystems IRIS Data Platform support for all tools for development.
Try InterSystems IRIS: https://www.intersystems.com/try
Stay tuned! 👍🏼
Question
Daniel Kutac · Feb 7, 2020
Hi guys,
I thought I test the InterSystems IRIS for Health 2020.1, the Docker image. but for some reason, the container only lives for about 10 seconds and I can see from the message.log file that as soon as IRIS starts it then performs shutdown thus ending also container. Anyone else seen this?
here is the message.log part
*** Recovery started at Fri Feb 7 14:37:02 2020 Current default directory: /durable/iris-config/mgr Log file directory: /durable/iris-config/mgr/ WIJ file spec: /durable/iris-config/mgr/IRIS.WIJRecovering local (/durable/iris-config/mgr/IRIS.WIJ) image journal file...Starting WIJ recovery for '/durable/iris-config/mgr/IRIS.WIJ'. 0 blocks pending in this WIJ.Exiting with status 3 (Success)02/07/20-14:37:02:433 (760) 0 [Generic.Event] Automatically configuring buffers02/07/20-14:37:02:494 (760) 0 [Generic.Event] Allocated 1528MB shared memory: 1024MB global buffers, 300MB routine buffers02/07/20-14:37:02:495 (760) 0 [Crypto.IntelSandyBridgeAESNI] Intel Sandy Bridge AES-NI instructions detected.02/07/20-14:37:02:532 (760) 0 [WriteDaemon.UsingWIJFile] Using WIJ file: /durable/iris-config/mgr/IRIS.WIJ02/07/20-14:37:02:532 (760) 0 [Generic.Event] No journaling info from prior system02/07/20-14:37:02:533 (760) 0 [Generic.Event] InterSystems IRIS is started with NOSTU option.02/07/20-14:37:02:546 (761) 0 [WriteDaemon.Started] Write daemon started.02/07/20-14:37:02:636 (760) 0 [Generic.Event] Startup of InterSystems IRIS [IRIS for UNIX (Ubuntu Server LTS for x86-64 Containers) 2020.1 (Build 197U) Thu Jan 23 2020 10:15:13 EST] in /usr/irissys/bin/ with mgr: /durable/iris-config/mgr with wij: /durable/iris-config/mgr/IRIS.WIJ from: /durable/iris-config/mgr/ OS=[Linux], version=[#30~18.04.1-Ubuntu SMP Fri Jan 17 06:14:09 UTC 2020], release=[5.3.0-28-generic], machine=[x86_64] nodename=[iris]. numasyncwijbuf: 0, swdwrtmax: 0, wijdirectio: off, synctype: 3 System Initialized.02/07/20-14:37:02:656 (792) 0 [Database.MountedRW] Mounted database /durable/iris-config/mgr/ (SFN 0) read-write.02/07/20-14:37:02:660 (761) 1 [Generic.Event] Cannot lock /usr/irissys/mgr/irislib/ err(13): will try accessing readonly02/07/20-14:37:02:661 (792) 0 [Database.MountedRO] Mounted database /usr/irissys/mgr/irislib/ (SFN 1) read-only. File or filesystem allows read-only access. 02/07/20-14:37:02:666 (792) 0 [Database.MountedRW] Mounted database /durable/iris-config/mgr/irislocaldata/ (SFN 2) read-write.02/07/20-14:37:02:670 (792) 0 [Generic.Event] init_gcr_seed: gen_crypt_rand seeded from /dev/urandom: 64 bytes.02/07/20-14:37:02:708 (799) 0 [Utility.Event] Shutting down InterSystems IRIS02/07/20-14:37:02:708 (799) 0 [Utility.Event] Notifying Clients02/07/20-14:37:02:709 (799) 0 [Utility.Event] No user shutdown routines to execute02/07/20-14:37:02:709 (799) 0 [Utility.Event] Stopping User Jobs02/07/20-14:37:02:710 (799) 0 [Utility.Event] Stopping Network Servers02/07/20-14:37:02:710 (799) 0 [Utility.Event] Withdrawing from License Domain02/07/20-14:37:02:711 (799) 0 [Utility.Event] Waiting for users to stop02/07/20-14:37:02:711 (799) 0 [Utility.Event] Stopping Client Networking02/07/20-14:37:02:711 (799) 0 [Utility.Event] Removing database locks02/07/20-14:37:02:711 (799) 0 [Utility.Event] Updating Journal File02/07/20-14:37:02:712 (799) 0 [Utility.Event] Journal restore not required at next startup02/07/20-14:37:02:712 (799) 0 [Utility.Event] Transaction rollback not required at next startup02/07/20-14:37:04:713 (799) 0 [Utility.Event] Waiting for database updates to complete02/07/20-14:37:04:713 (799) 0 [Utility.Event] Database updates complete02/07/20-14:37:04:713 (799) 0 [Utility.Event] Stopping System Jobs02/07/20-14:37:04:814 (771) 0 [Generic.Event] EXPDMN exited due to system shutdown02/07/20-14:37:04:815 (763) 0 [Generic.Event] JRNDMN exited due to system shutdown02/07/20-14:37:04:815 (762) 0 [Generic.Event] GARCOL exited due to system shutdown02/07/20-14:37:04:916 (764) 0 [Generic.Event] SWRTDMN #1 exited due to system shutdown02/07/20-14:37:04:916 (767) 0 [Generic.Event] SWRTDMN #2 exited due to system shutdown02/07/20-14:37:04:917 (765) 0 [Generic.Event] SWRTDMN #3 exited due to system shutdown02/07/20-14:37:04:917 (768) 0 [Generic.Event] SWRTDMN #4 exited due to system shutdown02/07/20-14:37:04:917 (766) 0 [Generic.Event] SWRTDMN #5 exited due to system shutdown02/07/20-14:37:04:917 (770) 0 [Generic.Event] SWRTDMN #6 exited due to system shutdown02/07/20-14:37:04:917 (769) 0 [Generic.Event] SWRTDMN #7 exited due to system shutdown02/07/20-14:37:05:420 (761) 0 [Generic.Event] No blocks pending in WIJ file02/07/20-14:37:05:420 (761) 0 [Generic.Event] WRTDMN exited due to system shutdown02/07/20-14:37:05:519 (760) 0 [Generic.Event] CONTROL exited due to system shutdown02/07/20-14:37:06:619 (799) 0 [Utility.Event] Shutdown complete
thank you for suggestion where else to search for the source of issue.. I admit I may have something wrong with my docker configuration script as standard kits work just fine.
Dan
Hi Dan.
Sometimes it happens because you are out of resources in docker desktop.
Different options of docker prune could help. E.g.
docker system prune -f
Read more in @Dmitry.Maslennikov article. Unfortunately, that did not help. I'll investigate further.
it turned out to be access privileges issue with license file, what a silly mistake of mine. Anyway, thank you Evgeny for pointing me to some useful info, anyway!
Article
Peter Steiwer · Feb 25, 2020
Preview Mode was added to InterSystems IRIS Business Intelligence to give designers a quick view of what their resulting Pivot Table will look like without needing to wait for the results to fully execute. This can be beneficial when designing pivot tables because if you are dragging and dropping elements to see how they look/work in your pivot table and seeing if they have the desired data. Since you are exploring and designing, you don't necessarily care about the results at the moment, but you would still like to see how your table looks with the changes you have made.
I previously wrote "DeepSee Tips & Tricks: Auto-execute" which can also be beneficial while designing Pivot Tables. However, with Auto-execute, you see no preview after dragging and dropping elements. It is more geared towards someone who knows exactly what their end result will be, someone who wants to prevent the intermediate executions while dragging and dropping elements. Preview Mode is more for exploring what the data looks like and how it can work in the Pivot Table.
At any point, you can simply turn Preview Mode off by using the checkbox at the top of Analyzer. You can also click the "Show All" button towards the bottom of Analyzer to see the full results of the current pivot. Adding new elements will continue to execute in Preview Mode.
The Documentation also has a brief explanation about Preview Mode.
Announcement
Anastasia Dyubaylo · Jan 24, 2020
Hi Community,
New video, recorded by @Benjamin.DeBoe, is available on InterSystems Developers YouTube:
⏯ What Developers Love About InterSystems IRIS
InterSystems Product Manager @Benjamin.DeBoe talks about what developers love about InterSystems IRIS Data Platform - the data and code are "next to one another" making your code very efficient.
Try InterSystems IRIS: https://www.intersystems.com/try
Enjoy watching the video! 👍🏼
Announcement
Anastasia Dyubaylo · Apr 24, 2019
Hi Community!You're very welcome to watch a new video on InterSystems Developers YouTube, recorded in a new format called "Coding Talks":Developing with Docker and InterSystems IRIS Community Edition In this video, presented by @Evgeny.Shvarov, you will know how to develop InterSystems IRIS solution on ObjectScript using Docker with example of dockerised InterSystems IRIS repository.Read how to dockerize your repo here.And...A little bit about our new video format: Coding Talks is a short video in which the developer demonstrates a particular feature or functionality of InterSystems Data Platforms which he/she uses to in coding. Typical format: the face on side and editor with ObjectScript.So! Enjoy watching the video and you're very welcome to share your own ideas/themes for our new video format in the comments to this post!Stay tuned! This article needs to link to pre-requisite articles to be of much use. For a developer who is used to writing ObjectScript in Studio on a local Ensemble installation, the starting point for this video is so far removed from what is familiar as to make it pretty useless. Similarly, for a newcomer to InterSystems development there is little here to latch onto to get things started. As part of a series this might well make a lot of sense, but as a standalone video its like demonstrating how to build a space rocket by showing an astronaut strapping themselves in for takeoff - it felt like all of the hard work had already been done. Hi Duncan!As mentioned above the video is a sort of "work through" for this article. Could you be more specific what doesn't work?BTW, just Yesterday I recorded another one which shows how to start a totally new app with Github, IRIS on docker and VSCode. Hope it will answer some of your questions.
Article
Erik Hemdal · Jul 22, 2019
One of my colleagues at InterSystems encountered an unexpected issue when running InterSystems IRIS on a Macintosh in a container using Docker for Mac. I’d like to share what we found, so you might avoid running into similar issues.The ProblemThe task at hand was running a Java application with XEP to do a large data load into IRIS. When running the data load, the write daemon hung soon after starting the job, with messages like these in messages.log: 05/21/19-14:57:50:625 (757) 2 Process terminated abnormally (pid 973, jobid 0x00050016) (was a global updater)05/21/19-14:58:52:990 (743) 2 CP: Pausing users because the Write Daemon has not shown signs of activity for 301 seconds. Users will resume if Write Daemon completes a pass or writes to disk (wdpass=98). This problem was completely reproducible and was very mysterious, so Support got involved. What we foundWe were able to start the SystemPerformance utility while reproducing the problem and discovered the issue readily.In the iris.cpf file, the cache for 8KB databases was set to 4GB:globals=0,0,4096,0,0,0 That looked reasonable for an instance running on a machine with 8GB of memory. Since this was a test, the Mac was otherwise not heavily loaded. However, not all of that system memory was actually available to IRIS, as we saw in the output of the Linux free command inside the container: Memtotal, used, free, shared,buf/cache,available,swaptotal, swapused, swapfree, 1998, 331, 322, 513, 1344, 1003, 1023, 11, 1012, 1998, 340, 312, 513, 1345, 994, 1023, 11, 1012,. . . 1998, 272, 72, 1563, 1653, 44, 1023, 105, 918,. . . 1998, 123, 67, 1770, 1807, 12, 1023, 870, 153,. . . 1998, 135, 54, 1777, 1809, 14, 1023, 1023, 0, Only about 2GB was actually available. During the heavy data load, IRIS rapidly consumed the database cache until all memory and swap space available was exhausted; at which point the instance hung.The CauseDocker relies heavily on some key Linux technologies, particularly cgroups and namespaces, that aren’t available natively on platforms like Macintosh and Windows. On these platforms, Docker uses a Linux virtual machine internally: in the case of the Macintosh, this is provided by HyperKit. And as we found, it is possible to overallocate memory on this platform and configure IRIS with more memory than is actually available. If you are using Docker for Mac as your development platform, keep this internal VM in mind and size memory appropriately. I think it would be good to add screenshot like this, to show how to configure memory limits in macOS. In Windows should be quite similar I think. Thanks Dmitry! It looks like you did it.
Announcement
Andreas Dieckow · Jul 23, 2019
Preview releases are now available for the 2019.3 version of InterSystems IRIS and IRIS for Health! Container images are available via the WRC's preview download site.The version number for these releases is 2019.3.0.302.0 Public announcements will be made shortly, with separate announcements for each product. InterSystems IRIS Data Platform 2019.3 is a CD (continuous delivery) release of InterSystems IRIS. It has many new capabilities including:Continuous Delivery Releases of InterSystems IRISInterSystems API ManagerNode-level Architecture for Sharding and SQL SupportInfrastructure and Cloud Deployment ImprovementsPort Authority for Monitoring Port Usage in Interoperability ProductionsX12 Element Validation in Interoperability ProductionsNew Framework for Coding Business Hosts in JavaJava and .NET Gateway Reentrancy InterSystems IRIS for Health 2019.3 includes all of the enhancements of InterSystems IRIS. In addition, this release includes updates toFHIR STU3 PATCH SupportNew IHE Profiles XCA-I and IUAX12 Element Validation in Interoperability Productions These are detailed in the documentation:InterSystems IRIS 2019.3 prerelease documentation and release notes InterSystems IRIS for Health 2019.3 prerelease documentation and release notes As this is a CD release, it is only available in OCI (Open Container Initiative) a.k.a. Docker container format. The platforms on which this is supported for production and development are detailed in the Supported Platforms document. For more information on what a CD release is, review the new release cadence post on InterSystems Developer Community. Preview releases allow our customers to get an early start working with new features and functionality. They are supported for development and test purposes, but not for production. How about community edition in docker hub, when to expect it there?
Announcement
Anastasia Dyubaylo · Jul 29, 2019
Hi Everyone!
Please watch the new video on InterSystems Developers YouTube, recorded by @Sourabh.Sethi6829 in a new format called "Coding Talks":
A SOLID Design in InterSystems ObjectScript
In this session, we will discuss a SOLID Principle of Programming and will implement it in the example.We have used Caché Object Programming Language for examples. We will go step by step to understand the requirement, then what common mistakes we use to do while designing, understanding each principle and then complete design with its implementation via Caché Objects.
Additional resources:
CodeSet
Presentation
Also, check out the first part of "Locking in InterSystems ObjectScript" Coding Talk.
If you have any questions or suggestions, please write to @Sourabh.Sethi6829 at sethisourabh.hit@gmail.com.
Enjoy watching this video!
Announcement
Anastasia Dyubaylo · Jul 23, 2019
Hi Everyone!InterSystems HealthShare is nominated for the Computable Awards 2019! The Unified Health Record that we implemented together with our partner Itzos in the St. Maartens Clinic has a chance to become the "ICT Project of the Year in Healthcare". A great honour, but of course we also want to win. We need 4,000 votes! Therefore we'd like to ask you to vote! The process of voting is a bit complicated, but we created a step-by-step guide to make it easier:1. Register on → Computable website2. You will receive an email from Computable with a link. Click on the link and you will get to the voting page.3. Use CTRL/COMMAND + F to search for InterSystems on the page, or just scroll down to the award category near the bottom “IT project of the Year in Healthcare.” Vote for the second group:4. Done? Awesome! You will get a "Thank you" email from Computable Awards.So,We hope for you! Help InterSystems to win! Please share, like and send as direct message to your customers, friends and prospects.In addition, we prepare a special challenge to vote on InterSystems Global Masters Advocacy Hub. Please complete it and get a good amount of extra points.Stay tuned! For what it's worth, it looks like it's possible to vote without subscribing to any of the updates - I filled in my information, left all four subscription check-boxes blank, and selected "verstuur", and received an email with a link to vote. Hi Samuel, this is such an awesome correction! Thank you!! I edited the instructions :) Hi ,I filled in my information, and received an email with a link to vote. and I have voted for Intersystems. Thanks Hi Uthman,Thanks for your support! Done! Hi Esther,Thanks for your attention to us! Thanks to all who voted for us, on behalf of the Benelux team!
Announcement
Eduard Lebedyuk · Nov 12, 2019
First webinar on InterSystems API Management!
We are pleased to invite you to the upcoming webinar in Russian: Introduction to InterSystems API Management on November 21 at 10:00 Moscow time (GMT+3)!
As you might have heard, we recently introduced the InterSystems API Manager (IAM) - a new feature of the InterSystems IRIS Data Platform,enabling you to monitor, control and govern traffic to and from web-based APIs within your IT infrastructure.
In this webinar I will highlight some of the many capabilities IAM allows you to leverage. InterSystems API Manager brings everything you need:
to monitor your HTTP-based API traffic and understand who is using your APIs; what are your most popular APIs and which could require a rework.
to control who is using your APIs and restrict usage in various ways. From simple access restrictions to throttling API traffic and fine-tuning request payloads, you have fine-grained control and can react quickly.
to protect your APIs with central security mechanisms like OAuth2.0 or Key Token Authentication.
to onboard third-party developers and provide them with a superb developer experience right from the start by providing a dedicated Developer Portal for their needs.
to scale your API demands and deliver low-latency responses
There would be a live demo.
This webinar is for System Architects, Developers and DevOps Engineers.Time: November 21 at 10:00 Moscow time (GMT+3)!
The language of the webinar is Russian.
Register! Any chance of repeating this webinar in English? Hi Fred! Have you seen this introduction? Hi Fred,
I just published the API Management session from Global Summit 2019 on DC YouTube channel.
Hope it will be useful for you! 😉 Is there any interest in English Webinar?
Please reply in comments if you would like a rerun of this or similar webinar but in English! Yes
Article
Evgeny Shvarov · Jan 13, 2020
Hi Developers!
In previous articles, we spoke on how to publish your application. But how to make Open Exchange work its best for your application?
What do you want for your application on Open Exchange? It is attention (traffic) and downloads.
Let's talk about how Open Exchange can deliver this.
How Do I know how many downloads I have?
There is an Analytics tab that is visible for the Author of application. It shows how many times users clicked on the Download button.
We have a roadmap for this tab and soon will add the monthly info on Downloads and some other information and you are very welcome to submit what else do you want to see here.
E.g. we plan to make this Downloads counter publicly available and make a sorting upon Downloads.
Prepare your Application's page
Your application's page should contain enough description of what the application does. This makes users want to click on the Download button.
How to set up the description?
If your application is the facade for a GitHub repo Open Exchange can import Readme.Md from your Github repo. E.g. like here: check the Open Exchange page and the related Github repo page
So, in this case, you just need to properly maintain README.md file in the Github repo which will be automatically updated on Open Exchange.
In case it is a non-Github application you setup the description on your own the Long Description field.
This field supports markdown so you have rich formatting tools to describe the purpose, features, installation steps and usage terms.
A good example of a Markdown description on Open Exchange.
Make Regular Releases
If your app is evolving this is noticed by users. Add the feature and don't forget to make a release on Developers Community. It takes 5 min but it adds the release notes to News, it places your app on top on the main page, it gets your subscribers notified on the new features your bring to your application.
Post the Related Developer Community article
You can tell a lot how to use your application and how people can benefit from its features? It's a great reason to write an article about it on Developers Community and highlight the features of your application.
Of course, you will add the hyperlinks to your application page inside the text but you also can feature the application using DC tools. E.g. you can add the "Related Open Exchange Application" link and this will add a special button on top of your article and in the news feed and an URL to the app at the bottom of the application. See the Example.
You also want to link back the application on Open Exchange to the article on DC:
This will make the Discuss button active on the Application page.
An average DC article gets about 800 reads so you can deliver additional traffic to your application using this channel.
Easy installation and setup
If your application has 12 steps of "How to install it" this probably doesn't help to increase the number of downloads. Ideally, this should be a one-step installation.
If your application is InterSystems ObjectScript I recommend pack and publish it with an ObjectScript Package manager. This really makes your installation into one command:
USER:zpm>install your-application
Example.
Use Your Global Masters' "Miles"
Another way how you can get more traffic to your application page is to use Global Masters points.
You may know we have a Global Masters advocates hub where we give points to participants for there contribution to InterSystems Community. The ways of the contribution could be articles, answers, and questions on DC, applications on Open Exchange (yes, you get GM points for submitting applications).
So, you probably have some GM points(sign in with your DC or Open Exchange credentials) and if you give to the Community and the Community could give you back and you can use GM points to get more attention to your Open Exchange application.
How?
Google Ads promotion
You can spend some points and set up a Google Adwords campaign of $1,000 which InterSystems will cover and manage. Learn more.
App of the week
We have "News blocks" on every page of Developers Community and this News block can tell about your Open Exchange application. Learn more.
Your Application Screencast On InterSystems Developers Youtube
If you have a screencast on the features of your application you can get more views and traffic publishing it on Developers Community Youtube.
And the simplest and the most working approach: add the features which everybody likes and thus you get the most attention and downloads)
Choose any recipes above or take all of them and boost the downloads of your InterSystems Application on Open Exchange!
If you have any ideas on how we could better help to make your Open Exchange applications more noticed and helpful submit suggestions and bug reports here.
Submit your InterSystems apps and stay tuned!
Article
Evgeny Shvarov · Jan 10, 2020
Hi Developers!
This post describes how you could publish your InterSystems application on Open Exchange.
What is the InterSystems application?
It could be anything, which is built with InterSystems data platforms or to help work with InterSystems data platforms: InterSystems IRIS, InterSystems IRIS for Health, InterSystems HealthShare, InterSystems Ensemble and InterSystems Caché. This could be tools, frameworks, adapters, examples and business solutions.
Why publish on Open Exchange?
InterSystems Open Exchange is an "App Central" for the solutions in InterSystems. It's the first place where the developer goes to look for tools, frameworks, and examples on InterSystems IRIS. And Open Exchange brings the added traffic to your solution which could be converted into leads.
We are having a set of business development tools for published Open Exchange applications. This definitely makes your InterSystems application more noticed.
Submitting an application
Suppose you have a library with open source published on Github which you want to publish on Open Exchange. For the purpose of a demo, I'll fork this remarkable project of @Peter.Steiwer ObjectScript-Math which I forked and renamed to object script-super-math.
First of all, you need to sign in. You can do this using your DC account or create a new one (which will be suitable for DC too).
Once signed in you'll see Profile Menu available which has My Apps section:
Click on a New button to submit a new InterSystems application:
OEX has a nice integration with Github which allows filling all the matching fields from the Github repo. E.g. let's try with objectscript-super-math:
It imports the name, short description, license, Full description, Download URL. To have the application ready for publishing you just need to peek InterSystems Data Platform it works with and the related tags.
Also, if there is an article on DC where you discuss the application, add the link to this article.
If you publish not Github app with open source, but e.g. the solution you need to accurately fill all the mandatory fields:
Name, Download URL, Short Description, License, Tags, Product.
And the optional fields which you think should be filled.
You also can add the related Youtube videos and two very important checkboxes:
We'll talk about this later.
Once you are happy with the fields you are welcome to Save the application.
Before publishing the app you can set up the app's icon:
Upload screenshots:
And after that once you are ready, send it for approval on publishing:
Here you need to submit the version and the release notes of the version.
Release notes section supports Markdown so you can paste here very informative description with rich formatting on what are the changes come with the new release of your application.
This will send the application to Open Exchange management for approval and once it's approved the application will be published on Open Exchange, you'll get the notification on email and the release news will be published on Open Exchange News.
Next time we'll discuss profile setup, company setup and some special cases. Stay tuned! A tip for anyone trying to upload a different image for an already-published app. You need to unpublish it first, to make the "Upload image" option appear on the menu. See this GH issue comment.
A related tip is that when you send your unpublished-and-modified app for approval you can override the default next version number that appears in the dialog, setting it to the same as the current version. You'll still have to enter something in the Release Notes field, but when your changes are subsequently approved your published app won't show any change in the Version History tab. John!
Thanks for the heads up! It's really not very convenient! We'll fix it.