Guest Medical Records β Form Builder and Database Prerequisites
This article explains the two prerequisites that must be in place before structured data captured in a form appears in a guest's Medical Record tab: the form must include components from the Medical Record category in the form builder, and the allergen, medication, and condition databases must be populated before master list search returns results.
Audience: Zenoti administrators who configure clinical forms and manage the Medical Record component databases.
Availability: Requires the EMR feature to be enabled for your organization. If the Medical Record category components described in this article are not visible in the form builder, contact your Zenoti representative.
On this page
Before you begin
The EMR feature must be enabled for your organization. If it is not, the Medical Record component category does not appear in the form builder. Contact your Zenoti representative to request enablement.
You must have an existing form created in the form builder, or be in the process of creating one. For instructions on creating a form, see Create and manage custom forms.
You need the following permissions:
Permission: Edit under CustomFields in the Administrator section of the security role β Required to add or modify Medical Record components in the form builder. Admin path: Configuration > Security > Security roles > [your role] > PERMISSIONS > Administrator > CustomFields > Edit
To populate the allergen, medication, and condition databases, you need administrative access to Configuration > Clinical setup > Medical Record.
Steps
Complete the following steps to configure guest medical records.
Verify that Medical Record components appear in the form builder
Before adding Medical Record components to a form, confirm that the EMR feature is active for your organization by checking whether the component category is visible.
- Navigate to Configuration > Forms > Form creation > Custom forms and open an existing form, or create a new one.
- In the form builder, look for the Medical Record category in the component panel on the left side.
- If the Medical Record category is visible, proceed to Add Medical Record components to a form.
- If the Medical Record category is not visible, the EMR feature is not enabled for your organization. Contact your Zenoti representative to request enablement before continuing.
Note: The Medical Record component category appears in the form builder only when the EMR feature is enabled at the organization level. This is an organization-wide setting β it cannot be enabled for individual centers independently.
Add Medical Record components to a form
Structured data captured in a form is reflected in the corresponding sections of the guest's Medical Record tab (allergies, medications, medical history, and social history) only when the form includes components from the Medical Record category. Forms that use standard components without Medical Record category components do not write data to the Medical Record tab.
- Navigate to Configuration > Forms > Form creation > Custom forms and open the form you want to configure.
- In the form builder component panel, locate the Medical Record category.
- Drag the appropriate Medical Record component onto the form canvas:
- Use the Allergies component to capture allergy data that appears in the Allergies section of the guest's Medical Record tab.
- Use the Medications component to capture medication data that appears in the Medications section.
- Use the Medical History component to capture condition data that appears in the Medical History section.
- Use the Social History component to capture lifestyle and social data that appears in the Social History section.
- Configure each component's settings as needed using the component settings panel.
- Select Save to save the form.
Important: Only components from the Medical Record category write data to the guest's Medical Record tab. Adding a standard text field or custom field with similar labels does not populate the Medical Record tab sections. You must use the dedicated Medical Record category components.
Worked example: A medspa wants allergy information captured during intake to appear automatically in the guest's Medical Record tab. The administrator opens the intake form in the form builder, drags the Allergies component from the Medical Record category onto the form canvas, and saves the form. When a provider fills in the allergies section during a guest's appointment, that data appears in the Allergies section of the guest's Medical Record tab.
Populate the allergen, medication, and condition databases
When a Medical Record component is configured to use master list search, it allows the provider filling out the form to search a predefined database of allergens, medications, or conditions. If the corresponding database is empty, master list search returns no results β the provider sees a search field but cannot find any entries.
Populate the databases before enabling master list search on any Medical Record component.
- Navigate to Configuration > Clinical setup > Medical Record.
- Select the database you want to populate:
- Allergens β Add entries that appear in the allergen search on Allergies components.
- Medications β Add entries that appear in the medication search on Medications components.
- Conditions β Add entries that appear in the condition search on Medical History components.
- For each database, select Add Row to add a new entry.
- Enter the name and any required details for the entry.
- Select Save to save your changes.
- Repeat for each database you need to populate.
Important: An empty database returns no search results when master list search is active on a form component. Populate each database before directing providers to use forms that include master list search on Medical Record components.
Note: Database entries are available organization-wide. All centers in your organization share the same allergen, medication, and condition databases.
Use the Custom Forms banner to identify and migrate forms with medical data
When your organization has the guest medical record migration capability enabled, a banner appears at the top of Configuration > Forms > Form creation > Custom forms. This banner is a shortcut into the Medical Record migration wizard β it helps you quickly identify existing forms that contain medical data so you can migrate them using the full wizard at Configuration > Clinical setup > Medical Record.
How the banner works
When the banner first appears, it screens your existing forms for medical data and displays the message "Identifying forms with medical data. This may take a few minutes." while the screening is in progress.
When screening completes, the banner reports the number of forms found to contain medical data and offers a control to start a migration for those forms.
Start the migration from the banner
Selecting the start-migration control from the banner pre-selects up to 25 of the identified forms and navigates you to the Medical Record migration wizard at Configuration > Clinical setup > Medical Record. The full migration procedure is completed in that wizard.
Note: The banner does not host a separate migration procedure. It is a shortcut that opens the migration wizard with forms pre-selected. Follow the wizard's steps to complete the migration. For the full migration procedure, see Configure clinical settings.
Re-run the screening
The banner also provides a control to re-run the screening. This control is briefly unavailable immediately after each screening run to prevent rapid re-submission. Once the brief delay has passed, you can select it again to screen for newly added or changed forms.
Tip: Re-run the screening after adding new forms or modifying existing ones to ensure the banner reflects the current state of your form library.
Tips
- Populate the allergen, medication, and condition databases before publishing any form that uses master list search on Medical Record components. Providers who encounter empty search results may enter free-text data instead, which does not benefit from the structured database format.
- When building a clinical intake form, add all relevant Medical Record category components in a single pass rather than updating the form incrementally. Each time you publish a new version of a form, existing submitted form data is associated with the version that was active at the time of submission.
- If your organization uses multiple intake forms for different service types, each form that should contribute to the Medical Record tab must independently include the appropriate Medical Record category components. Data from a form without these components does not flow to the Medical Record tab regardless of how the form is named or described.
- After adding Medical Record components to a form, review the form using the form builder's preview capability to verify that the components render as expected before saving and publishing the form.
- If the Custom Forms banner reports a large number of forms containing medical data, use the start-migration control to begin migrating them in batches of up to 25 at a time. Complete each batch in the migration wizard before returning to the banner to start the next.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| The Medical Record category does not appear in the form builder component panel. | The EMR feature is not enabled for your organization. | Contact your Zenoti representative to request EMR enablement. The component category only appears after the feature is active at the organization level. |
| Master list search on an Allergies, Medications, or Medical History component returns no results. | The corresponding database (allergens, medications, or conditions) has not been populated. | Navigate to Configuration > Clinical setup > Medical Record and add entries to the relevant database. Until entries exist, search returns no results even when master list search is correctly configured on the component. |
| Data entered in a Medical Record component on a form does not appear in the guest's Medical Record tab. | The form uses a standard component (such as a text field) rather than a component from the Medical Record category. | Open the form in the form builder and replace the standard component with the corresponding Medical Record category component (Allergies, Medications, Medical History, or Social History). Only Medical Record category components write structured data to the Medical Record tab. |
| The Custom Forms banner shows a screening in progress but does not complete. | The screening process may be delayed due to a large number of forms. | Wait a few minutes, then refresh the page. If the banner still shows screening in progress after several minutes, contact your Zenoti representative. |
| The start-migration control on the Custom Forms banner is not available immediately after re-running the screening. | The control is briefly unavailable after each screening run to prevent rapid re-submission. | Wait a short time, then try again. The control becomes available once the brief delay has passed. |