Best practices for setting the environment variables for a custom build application?

Can you try adding all your settings under "parameters"? 

You can see a few different type of parameters / settings here:

"parameters": [
  {
    "name": "subdomain",
    "type": "text",
    "required": true,
    "secure": false,
    "default": "yoursubdomain"
  },
  {
    "name": "token",
    "type": "text",
    "required": true,
    "secure": true
  },
  {
    "name": "useSSL",
    "type": "checkbox"
  }
]

Cedric,

I tried to follow your advice and I added a new line to the manifest file "ACSServiceBaseUrl":

I added the line with an empty value as I was expecting to fill it an use it in the app settings and use it in the code.

After I validated, packaged and install the app in Zendesk, I opened the the app settings, but I do not see a place where I can update a value for "ACSServiceBaseUrl".

Did I miss anything from your explanation?

manifest.json

Thanks Nicole!

Thanks for jumping in, Cedric! Very helpful. You rock. 

You are very welcome Sorin.

Thank you for those ideas. This seems to be the correct way to do the setup.

Hi Sorin,

No worries at all.

One would actually only name the parameters in the manifest file. The manifest file does not hold the values. It is more of a placeholder. 

The actual values are applied within Zendesk. So what happens if you were to add the following parameter to your manifest file?

  {
    "name": "subdomain",
    "type": "text",
    "required": true,
    "secure": false,
    "default": "yoursubdomain"
  },

First you would need to change your app to use this parameter in your code. You would get those parameters using client.metadata():

var client = ZAFClient.init();
client.metadata().then(function(metadata) {
  console.log(metadata.settings);
});

Next, when installing the app in Zendesk, you would have to open the settings of your newly installed app and provide the sub-domain within the settings. That value is then used within the app.

This way you can create an app, that would work in any environment as the end-user can enter the values for those variables that differ from company to company.

Maybe have a look at some of your Zendesk apps within Zendesk and check out there Settings page to get a better understanding. Hope this helps.

Cedric,

Thank you for the response.

I see how your solution will move the variables from the javascript code (where I have them now) to the manifest file.

Does this means that for various environments, I will need to have more manifest files, of that I will need to change the values in the manifest before each "zap package" operation?

Hi Sorin,

I hope this message finds you well and healthy.

I think what you need is a settings page for the user of the app.

Did you use the new framework for the app?

You can allow users to enter these details within the settings of your app You would do this by adding parameters to your manifest file:

"parameters": [
  {
    "name": "subdomain",
    "type": "text",
    "required": true,
    "secure": false,
    "default": "yoursubdomain"
  },
  {
    "name": "token",
    "type": "text",
    "required": true,
    "secure": true
  },
  {
    "name": "useSSL",
    "type": "checkbox"
  }
]

You can retrieve the setting values in your app with client.metadata():

var client = ZAFClient.init();
client.metadata().then(function(metadata) {
  console.log(metadata.settings);
});

You can find more here: https://developer.zendesk.com/apps/docs/apps-v2/setup#defining-installation-settings 

Hope this helps.

Cedric