Apps in MOLGENIS
MOLGENIS provides developers option to create new 'apps', To manage Apps in MOLGENIS you can use the MOLGENIS App manager. It is a tool to upload, search, and manage your apps. With a an easy to use format we want to facilitate rapid app development on top of your own data models.
The following paragraphs will give a brief tutorial on the App manager and its functions.
When you first go to the app manager, you will probably be greeted by an empty screen with the message that no apps were found.
am01 - empty screen
Lets change that now. Click the big green Upload new app button, and select your app archive.
am02 - upload file
Your result is an app in the app manager, ready to be managed!
am03 - after upload
If anything is missing inside your archive or important configuration is missing from your config file, the app will not be uploaded and you will get a summary of missing files or parameters.
As you can see, the newly uploaded App will be shown as an app card. This card gives you a brief overview about the status and contents of the app.
New apps always start out as inactive, meaning they can not be accessed yet, or be added to the MOLGENIS menu.
Apps which are inactive can be deleted. Apps which are active can not be deleted.
Lets use the toggle button now to activate our example app.
am04 - after activate
Activating an app does two things:
- Set the status of an app to active in the database
Lets add it to the menu and open the app
am05 - open app
The content is a bit minimal but, congratulations! You just added your first app.
Going back to the app manager screen, we have two small pieces of functionality left. Once you get a lot of apps, you can use the search function to quickly find apps that might be relevant to you.
We just imported a lot of them
am06 - before search
and now we are interested in apps having to with Biobanks or Bio
am07 - after search
Once we want to update an app, we can press the update button. A modal will appear where you can select the new app.
Note: Make sure it is the same app!
In the modal you can choose if you want to overwrite your config. If you check that box, you will overwrite your application runtime config, with the new json file in your zip.
am04 - after activate
Toggle our example to inactive, and delete!
am08 - delete app