Kalix's templates and documents contain auto-calculated fields, which calculate BMI, ideal body weight, energy, and macronutrient requirements. For more information about auto calculated fields, click here.
If you are experiencing issues with making auto-calculated fields calculate, there are a few things we recommend that you check:
The Document is Linked to a Client
Check whether the document is linked to a client. Click here for information about the difference between a document and template.
Client Date of Birth & Gender are Saved
The client has a date of birth and a gender saved against their client details page (if you find these details missing, please read the note below: Click on the link for more information about the Client Details page.
Reset the Saved Document's Client's Details
Please Note: If you update a client's details e.g. add their date of birth and/or gender, the client's details will not automatically update on already saved documents. For your auto-calculations to recalculate, you will need to reset the client details on the saved documents. To do this follow the step below.
- Click on the unlink icon associated with the client's name on the top of the document.
2 ) Search for and reselect the client.
Why Does Kalix Behave Like This?
When you create a client document in Kalix, Kalix takes a snapshot and freezes the client's details at the point of time that the doc was created. This is done for a number of reasons, but one of them is so that doc's calculated fields do not auto-update every time you open the saved doc.
Age and gender are variables in an number of Kalix's auto-calculations (e.g. energy, protein and fluid needs), if Kalix auto-updated a client's details every time you opened a saved document, the client's energy and micronutrient needs would continue to change overtime and would no longer be relevant to the time you created the document. Because of this snapshotting, if you originally create a document at a point in time in which the age and/or gender is missing but you later update it, the updated information will not automatically update on the saved document. You need to "reset" a client's information on created document by following the steps above.
Weight, Height or Ideal Body Weight is Missing
Check that there is a valid weight, height and IBW value entered into the applicable NCPT terms.
The Auto-calculations are Switched On
All auto-calculated fields can be turned off for the entry for manual data entry. It is possible to turn a field off by accident. You can determine whether an auto-calculated field is on or turned off by it's color. If it a purple color, rather than an orange, it is off (on manual entry). If an auto-calculated field is on, it is an orange color. Additionally, if you put your cursor in the actual field, there will also be an orange message in the pop up window as shown below.
To turn a manual auto-calculate field on. Click on the applicable field. Next click on the gray lightening bolt. Done!
All of the Applicable Term Fields are Complete
Check that all of the applicable fields are completed in the actual term. Using Total Estimated Energy Needs as an example:
- A units of measurement must be selected (kJ/day, kJ/kg/day, kcal/day or kcal/kg/day).
- You can select whether you would like to add or subtract energy (from the total energy estimated needs) to achieve weight loss or weight gain (optional).
- An energy equation must be selected.
- Select the activity level used in the calculation. Kalix will automatically add the applicable activity factor range based on your selection and the energy equation used. Alternatively, you can enter your own activity range.
- If you wish to use a stress/injury factor, select the application medical condition. Kalix will auto add the applicable stress factor range. Alternatively, enter your own stress factor (optional).
- You must select whether you wish for the calculation to use the client's actual body weight (as entered in the NCPT Weight field) or their ideal body weight (as calculated by the NCPT Ideal/Reference Body Weight (IBW) term).