Configuration Management

So you want to reuse your components or code across more than one site. But that means storing configuration information unique to each site so your code will behave the way it needs to.

In IguanaX, you can use :

Custom Fields are a good method for configuring details which apply to a specific component.

You can create custom fields in the Translator config.json file and include default values that are stored in source control. Custom fields entered in the Component Card are encrypted and stored locally in the working directory Component Configuration Files.

Environment are good for dealing with properties which need to be defined across the server. They are stored locally in your working directory Environment Variables Configuration File.

External configuration files can be used to store encrypted configuration values that can be accessed and managed across many components. We have two libraries that can be used to implement this:

Store Library can be used to store and load key value pairs in a SQLite database of file.
Encrypt Library can be used to securely store and load configurations in the Translator.

There is a small library to allow one to load a JSON file from another component when you supply the name of the component and the name of the file.

This might be helpful: CONFIG Library

When using configurations in the Translator, there are two general rules:

It is best to avoid hardcoding values! Instead, parameterize any values that can change.

In the Translator, you want to see as little text as possible.

Good values to parameterize are values like URLs, file paths, database names, etc.