Apps in MOLGENIS
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.
How to create your own MOLGENIS app is described here
The following paragraphs will give a brief tutorial on the App manager and its functions.
Uploading your first app
We will be using the example app to go through this tutorial.
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.
Lets change that now. Click the big green Upload new app button, and select your app archive.
Your result is an app in the app manager, ready to be managed!
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.
Manage your first app
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.
Activating your 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.
Activating an app does two things:
- Set the status of an app to active in the database
- Add an app to our internal Plugin table, allowing for management via the Menu manager, or setting permissions via the Permission manager
Add app to menu and view
Lets add it to the menu and open the app
The content is a bit minimal but, congratulations! You just added your first app.
Searching for apps
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
and now we are interested in apps having to with Biobanks or Bio
Deleting an app
Once we want to update an app, we will have to disable and remove the older one first. Toggle our example to inactive, and delete!
You are now free to make changes to the config, descriptions, name, and resources. After making your changes you can upload the archive again and use the app as you see fit!