Propagating updates from the Master App to the Tenant App
Before proceeding further into the details, let’s first elaborate who’s who to simplify the images in this article.
Ubaid is the Owner of the Master App. He sent an invitation to Enzo for a Tenant App. Enzo created the Tenant App. Now to distinguish which screenshot is from whom, their illustrations are added to each of the screenshot.
So if any update is required in the schema of the Tenant App, Ubaid had to do that in the Master App and then send the update to Enzo’s Tenant App.
Let’s say the owner of the Master App adds an image field to the Employee entity, as shown in the following image.
To propagate this update to the Tenant App, the owner of the Master App (Ubaid in our case) has to follow the procedure described below:
In the App Settings page (of the Master App), click the App Model.
Click the Instances Tab.
Click the Tenants link.
If the schema had been changed but the app was not updated then a warning message is displayed. Also the Sync button is disabled at the moment.
The App needs to be updated first by clicking the Update App button.
Click the Confirm button.
The Master App is updated.
Again, click the Instances Tab.
Click the Tenants link.
This time the error is not showing.
Click the Sync button.
Confirm the action by clicking the Sync Tenant button.
The sync process starts.
After the syncing is done, the sync status is changed from In Progress to Completed.
Now If Enzo wants to add/edit an employee, the ID Photo field (that was added to the schema by Ubaid), is available in the Tenant App.
What gets synced?
- New Entities created
- New Attributes added to the existing entities
- Existing attributes updated
- Role configurations
What does not get synced?
All runtime artifacts from the Master App including:
- Data
- Lists
- Charts
- Dashboards
- Reports
Notes
Once the Tenant users creates a Tenant app, it can’t be deleted by the owner of the Master app. However if only invitation is sent and the Tenant app is yet to be created, then that invitation can be deleted.
The user invited to create a Tenant app can’t create a new app from workspace. They can only create a Tenant app from the invitation that they received.
The owner of the Tenant app even can’t delete the app once they have created it.