Getting Started

This guide will outline the initial setup for plugin configurations required for the Governance Centre App.

Prerequisites

You will need:

• 1 instance of Joget with the Governance Center installed
• At least 1 or more instances of Joget that are reachable from the Governance Center (whether publicly, or within the same network of the Governance Center)
• Admin access to all the instances

Upon importing the Governance Center, you will need the following plugins for the Governance Center to work:

• API Builder Addon For DX
• Governed API Plugins(governed-api-plugins-8.0-SNAPSHOT)
• Governed Plugins(governed-plugins)

Upon launching the Governance Center, you will need the following setups to proceed:

• At least 1 or more users are assigned as App Owner in the Manage User Role
• At least 1 user is assigned as App Developer in the Manage User Role or 1 user is assigned in a Groups

Step 1: Setting Up Plugin Configuration

Go to Governance Centre App. Add a new plugin configuration using Administration > Plugin Config. 

You will see this form to fill up when you click the "New" button.

Click "Submit" when you are done with the configuration.

Look at Plugin Config for more information.

Figure 1: Manage Plugin Config Form

Step 2: Generate API Key

Next, you will need to generate an API Key to be used by the plugin configuration. You can do so by going to Administration > API Keys > New. 

Follow Manage API Key Menu to create a new API Key.

Look at API Keys for more information.

Figure 2: Manage API Key Form

Step 3: Manage Plugin Permission

After creating the plugin configuration and API Key, you will need to configure plugin permission (Administration > Plugin Permission > New).

Click on Save to save the plugin permission and you will be done with the configuration.

Look at Plugin Permission for more information.

Figure 3: Manage Plugin Permission Form

Step 4: Setup Governed Plugins in Joget Instance

Go to the Joget instance that wants to make use of the governed plugin service.

In this example, we are choosing the Meeting Room Booking App and the plugin type is Form Options Data Store.

We will test this Plugin Config on Meeting Room Booking App > Form > Select Box.

In the select box, on Load Data From choose Governed Form Options Data Store and fill in the domain URL and API Key (information is available on plugin permission). Then choose the plugin config and save.

Figure 4: Configure Governed Plugin

Step 5: Test the Governed Plugins

After saving the form, go to live view to view the form.

Now we can see the select box options are loading the plugin configuration that we had set up on the Governance Center App.

Figure 5: Live view of the form