This article is deprecated. Refer to this article.
Studio now allows App Exports. In a scenario where you want to share apps between two different DronaHQ Studio accounts, app export will help you do this seamlessly. This is also very helpful in a situation where you want to duplicate an app in the same account.
Please note that we would be using the term Apps and templates interchangeably through this article.
- It is important that the App is Published and not in Draft state.
- There are two channels namely the one where you create and publish the app and the other where the App is to be exported or customized.
The published apps can be shared to the other channels as templates. Only those ready apps which are live or are published can be added as templates.
Let us see how to export the App:
Under Config Options, click App Export.
You would be taken to the Export App settings page. Make sure that you have published your app before you can Export the app. If the app is in a Draft state you would need to change its status to Active/ Live.
If your app is published then click Export App.
When a template is being shared with other users, the supporting template data and metadata for the same would be selected. This is the vital information/ data that will make it easier for the user to use and manage the template.
Click the Template Meta tab to first select the metadata. Then click the Template Data tab to verify the dependencies and proceed to Publish.
Template name and Description: Under Create Template > Template meta, you can see the fields for Template Name, Description. They would be available by default, you can change them for further customization.
Active: Active ON is applicable if you are going to share your app using a private key.
Preview: Set the Preview toggle ON to enable showing a preview before the App is installed.
PremiumApp: Set the toggle ON if you want to mark the App as a Premium App. Any one using a private key would be able to preview the app but not install it.
Template Group: Select the Template group, Template group is a categorization of templates. Select one which suits your app best.
Key features: Enter the Feature name and Feature Description to further provide a description of the prime features of the App to give the users a brief introduction to your app.
Enter all the details as per your requirement and click Save.
After the Template Meta is set, set the Template Data which provides the details about the different modules used in this app like the list of sheets, connectors, linked workflows, custom functions as well as the PDF Templates used.
Under Sheet Management you can see the different sheets that you have used or are linked to the app. You can choose to provide the sheet along with or without data. Switch the DATA toggle ON for those sheets where you want to install the sheet with data.
This provides a list of workflows and connectors, API as well as DB Connectors that have been linked to be used for the App. Any API or Connector from the app would require some configuration at your end too.
PDF templates used
This is a list of PDF templates used in the App which would be available in the template.
Once all the data is added Publish the app and the App would then be available in your channel.
It is also possible to share the template with other DronaHQ Studio users by sharing the 6 digits private key. The Private Key can only be generated with a Seller account and the App is published.
Under Template data, you have the Private Keys > Generate Key
Click Create. If your account is a reseller account the key would be generated and listed out under Generated Key(s). Copy this key from here and share it with the users who need your app.
Publishing the App
Once you add all the above properties, your template is ready to be published so that it is available in the Templates. To ensure that the app is available and works properly in any account, you need to ensure that the custom controls and custom functions that you might have created for the App are configured properly.
To share it, verify all necessary details are added and click Publish.
Using the App
Now that you have seen how to add your App to the Templates, it can be easily used in the channel. It will have to be installed from the templates section.
Under Studio Console > App, click + (Add), where you are taken to the different categories of app templates.
Click Upload / Import App. Here you can import the app using the private key or by choosing the template’s exported file.
Select the file and click to Continue. Now the app can be installed to the channel.
Click Install. After clicking Install you can make the necessary customization to the App Name, and Description and configure the sheets and the APIs necessary under Sheet management and API management respectively.
Once you have the configuration in place, click Install. You will receive a confirmation for the app to be installed. On installation, the app is opened and is ready for use.
Using the Private App
We have seen how the App Template can be installed. Now let us see how you can use the Private App using the Private Key.
- Under Studio Console > App, click + (Add), where you are taken to the different categories of app templates. Now when you want to install the apps from outside the marketplace, it can be done by using the private key.
- Click Upload App. Here you can import the app using the private key. Click to select. Enter the Private Key and click Continue.
The App is then added to your Account. You can now use it as per your requirement.
You can thus share your apps to the template or share them to a limited channel using the Private Key.
Also read DHQ Containerization Concept