Actualize properties

Last modified by Erik Bakker on 2024/02/20 08:32

Error

Note that the functionality mentioned in this microlearning will become obsolete when migrating to the new generation runtime.

In a previous microlearning, we discussed managing your properties in an environment. We will focus on applying these changes to the environment in this microlearning.

Should you have any questions, please contact academy@emagiz.com.

1. Prerequisites

  • Basic knowledge of the eMagiz platform
  • Understanding of property concept
  • At least one flow for which you can change the actual value and where that flow is active

2. Key concepts

Depending on whether you only want to change a property value or whether that property change is linked to a functional flow change, the approach of applying the changes to the environment changes.

3. Actualize properties

3.1 Without a flow change

Once you are satisfied with your configuration of properties, you create a new release. This can be done via the "New Release" button or the wrench icon on the currently active release. Once satisfied, you can activate the release.

Once the release is activated, you must navigate to the Runtime Dashboard to find the runtime(s) on which the flow(s) that use the changed property is running. For each of them, you need to stop the flow and, once destroyed, start it again to ensure that the new property value is actualized.

Warning

Starting and stopping flows can be done in direct sequence unless you change the property of that particular flow multiple times within 2 minutes. eMagiz needs, in that case, 2 minutes to store the property value properly.

3.2 With a flow change

Once you are satisfied with your configuration of properties, you create a new release. This can be done via the "New release" button. For more information on creating a release, please check out this microlearning.

Once you have created your new release, you can use the deployment plan steps to activate the changes on both flow and property levels. More information on how to do this can be found in this microlearning.

4. Key takeaways

  • Make a good plan before you change the property so that there are no unforeseen side effects
  • If the value changes several times, the flow will need 2 minutes of breathing time before the updated property value is considered.

5. Suggested Additional Readings

If you are interested in this topic and want more information on it, please read the help text provided by eMagiz when executing these actions.