Body measurements: templates, records and progress tracking

Measurement templates

You manage templates on the Body Measurements → Measurement Templates page in the left menu. A template determines which fields are filled in during a measurement session.

When you enable the module from the Pi Store, a Genel Ölçüm (general measurement) template marked Default is added for you (weight, height, body fat percentage, waist, hip). If the module was switched on together with your business type when the business was set up, the list starts empty and says “No templates found”; create your first template with New Template.

New Template opens the New Measurement Template window. Enter the Template Name and tick at least one field under Measurement Fields; the Create button stays disabled until both are done. The fields are organised into four groups:

• General: weight, height, body mass index (BMI), body fat percentage, muscle mass, water percentage, basal metabolism, visceral fat, bone mass, metabolic age.

• Circumference Measurements: neck, shoulder, chest, right and left upper arm, right and left forearm, waist, abdomen, hip, right and left thigh, right and left calf.

• Nutrition: target weight, daily calorie goal and daily calorie need.

• Segmental Analysis: body fat percentage and muscle mass separately for the right and left arm, the right and left leg and the trunk — the values a body composition scale measures.

For a measurement that is not in the catalogue, use Add Custom Field in the Custom Fields section and enter a field name and a unit (for example grip strength, kg); the custom field's name is required. Save with Create (when you edit an existing template the button is called Update).

The list shows each template's name, field count and status (Active or Archive). The three-dot menu on a row offers Edit, Archive (Activate for an archived template) and Delete. The default template cannot be deleted, but it can be archived. An archived template cannot be chosen for a new measurement; measurements already taken with it are not affected.

Entering a measurement record

1. 1

   Open the window

   The New Measurement button on the Measurement Records page opens the New Measurement Session window. If you open it from the Measurements tab on the customer card, the customer is already selected.

2. 2

   Choose the customer, template and date

   Search for the Customer by typing at least 2 characters. Only active templates are listed under Template. The Date starts as today; a future date cannot be picked.

3. 3

   Enter the values and save

   The template's fields appear under Measurement Values. You can leave fields you did not measure empty; if you enter no value at all you see “Enter at least one measurement value.” Add a Note if you like and click Save.

The record list and measurement detail

The Measurement Records list shows the customer, template, date, weight, body fat percentage, BMI, the number of fields entered and the number of photos. Filter with the Start and End dates and choose Newest or Oldest under Sort; Clear removes the filters.

The BMI badge in the list shows only the number and a colour: green below 25 (including underweight values below 18.5), yellow from 25 to 30, red at 30 and above. On the customer card's Measurements tab the badge is always blue. The status name (Underweight, Normal, Overweight, Obese) appears only on the measurement's detail page.

The Measurements tab on the customer card lists the customer's 20 most recent measurements; you can find older ones on the Measurement Records page using the Start and End dates.

The Details button on a row opens the Measurement Details page. It shows the BMI card and status, every value (Field, Value, Unit), the customer (the Profile button takes you to the customer card), the template, the staff member who took the measurement, the date, the note and when it was created.

Importing from a body composition scale

Tanita body composition scales write every measurement to a file on their SD card (e.g. DATA1.CSV). Importing these files into Piyzi saves you from typing the values one by one.

1. 1

   Get the files

   Put the scale's SD card into a computer and find the measurement files (DATA1.CSV, DATA2.CSV …). Each file belongs to one person slot on the scale.

2. 2

   Open the import

   On the Measurement Records page, click Import from device next to New Measurement and choose the customer; files cannot be selected until a customer is chosen. If you open it from the Measurements tab on the customer card, the customer is already selected.

3. 3

   Drop the files

   Drag the files onto the area or click to choose them (CSV or TXT; up to 512 KB per file, at most 10 files at once). The system recognises the format by itself and lists the records in a table, file by file.

4. 4

   Select this customer's rows

   Each row is one measurement: date and time, weight, body fat, muscle mass and the profile on the scale (gender, age). Rows are not selected automatically; tick only the ones that belong to this customer. The box on a file's header row selects every eligible row in that file.

5. 5

   Import

   Save with the import button at the bottom; it shows how many rows you selected. The measurements are added to the customer's history, charts and comparisons.

• The template is created for you: on the first import a template named after the scale model (e.g. "Tanita BC-601") is created with the fields the scale measures. Body mass index is recalculated from weight and height.

• The same record is never imported twice: a row that was imported before shows as "Already imported" or "Saved to another customer" and cannot be selected.

• Rows that cannot be imported: a corrupted row, a row without a weight value, a row whose date cannot be read and a row dated in the future (the device clock is wrong) are not imported.

• Warnings: if the gender or age on the scale does not match the customer record, or the day/month order of the date is unclear, the row shows a warning; check it and import it anyway if it is right.

• Source details: the detail of an imported measurement shows an "Imported from device" badge, the scale model and the file name.

Goals

Goals are kept on the Goals tab of the customer card; there is no separate goals page on the web.

1. 1

   Click New Goal

   In the window that opens, each row is one goal: choose the Field, set the Direction (Decrease or Increase) and enter the Start and Goal values.

2. 2

   Check the date

   The Date field on a row is the goal's start date and starts as today. It is not the date by which the goal should be reached, and it is not shown on the goal card.

3. 3

   Save

   Use Add Goal to add rows for more measurements; the bin icon removes a row. Click Create. Rows without a field, a start value or a goal value are not saved; if no valid row remains you see “Enter at least one valid goal.”

• The goal card shows, for each measurement, the Start and Goal values, the Current value from the customer's latest measurement and a progress percentage. The current value is read from the latest measurement only; if that measurement does not include the field, Current is not shown and progress stays at 0%.

• A goal is not completed automatically, even at 100%. Click Reached at the top of the card and confirm with Yes; close a goal you are giving up on with Cancel. The status filter lists Active, Reached or Cancelled goals.

• Goals cannot be edited on the web; to change one, cancel it and create a new one. In the mobile app an active goal can be edited.

Progress and comparison

• Progress: switch to Progress on the Measurements tab of the customer card. Line charts appear for weight, body fat percentage, BMI and waist; a chart appears once that field has at least two measurements.

• Compare: choose the First Measurement and the Latest Measurement and click Compare. Every field shows Previous, Next, Difference and Change %; the selection lists the customer's 20 most recent measurements. It is the most effective way to show a client their progress.

In the comparison a decrease is shown in green and an increase in red. The colour shows only the direction, not whether the change is good or bad: an increase in muscle mass is red too.

Permissions

You grant permissions in My Business → Settings → Roles & Permissions (the permission names are shown in Turkish on the role screen):

• “Can view body measurements” (“Vücut ölçümlerini görüntüleyebilir”): seeing the Body Measurements menu, the templates and the measurement records. This permission is needed to open the menu.

• “Can list body measurement templates” (“Vücut ölçümü şablonlarını listeleyebilir”): seeing the template list.

• “Can view customer body measurements” (“Müşteri vücut ölçümlerini görüntüleyebilir”): seeing a customer's measurements and the progress and comparison views. In the mobile app the Measurements tab on the customer card opens with this permission.

• “Can manage body measurement templates” (“Vücut ölçümü şablonlarını yönetebilir”): creating, editing, archiving and deleting templates.

• “Can edit customer body measurements” (“Müşteri vücut ölçümlerini düzenleyebilir”): entering measurements and importing from a scale.

• “Can delete customer body measurements” (“Müşteri vücut ölçümlerini silebilir”): deleting a measurement record.

• “Can manage body goals” (“Vücut hedeflerini yönetebilir”): creating goals, Reached and Cancel.

The built-in “Personel” (Staff) role can view, enter measurements and manage goals, but cannot manage templates or delete. On the web every button except Import from device is shown to everyone; when you try something your role does not allow, nothing is saved and a warning appears.