What Happens When You Click Save

4 min read

Overview #

PHX does not use one universal save routine. Each window decides what it must check, what it writes, and what happens after the save. A patient, billing, address, configuration item, and report can therefore respond differently when you select Save.

The common pattern is:

A change makes the window’s Save command available.
PHX checks the requirements for that type of record.
A blocking problem keeps the record open and displays a message.
If the checks pass, PHX writes the record and normally makes Save unavailable until another change is made.

Many record windows also support F2 as the Save shortcut.

Before You Save #

Make sure you are editing the intended record and section. Some PHX windows contain a main record plus separate detail rows or sections with their own confirmation buttons.
Finish the current field or grid entry. A value still being edited may need to be accepted by the field or row before the record-level save can use it.
Review fields that identify the record, such as a Quick-Code, patient, billing number, or status.
Look for an enabled Save button. On many screens, a disabled Save button means PHX has no pending record-level change. On some configuration screens, editing permission also controls whether Save can be enabled.

What PHX Checks #

The checks depend on the window. Verified examples include:

Patient records: first name, last name, Quick-Code rules, Quick-Code uniqueness, and database connectivity.
Address records: Quick-Code rules, Quick-Code uniqueness, and database connectivity.
Billing and claim records: usable transaction-code detail, valid diagnosis pointers, compatible insurance and status selections, at least one diagnosis entry, and place-of-service information.
Configuration records: the fields required to identify that configuration item, plus any record-specific ranges or relationships.

Some fields validate as you leave the field rather than waiting for Save. Patient email fields, for example, display “Invalid Email Format” and keep focus in the field when the value is not accepted.

Blocking Messages, Warnings, and Choices #

PHX does not apply one consistent “warning” and “error” classification to every screen. Use the behavior of the message to decide what it means:

A message with only OK that identifies missing or invalid data is normally blocking. Correct the field and select Save again.
A Yes / No / Cancel prompt is normally asking what to do with unsaved changes before another action, such as moving to another record, starting a new record, closing, printing, or transmitting.
A database or connection message means PHX could not complete the requested data operation. Do not assume the record was saved.

Read the complete question before choosing an answer. The meaning of Yes is not identical in every prompt:

In “Would you like to save first?”, Yes means save before continuing, No means continue without saving, and Cancel means stay on the current record.
In a prompt that asks whether you are sure you want to close without saving, Yes means discard the unsaved changes and close.
Before printing or transmitting, PHX may ask whether to save current billing changes. Cancel stops the requested action. If you continue without saving, the current unsaved entries are not part of the saved billing record used by later operations.

What Counts as a Successful Save #

A successful save means the record passed that window’s checks and PHX completed its save routine. Depending on the window, PHX may then:

Keep the saved record open.
Reload or reposition the current record.
Assign a new record identifier, such as a patient ID or billing number.
Refresh a list or lookup in the window that opened a Quick Add form.
Close a Quick Add or edit window.
Make the Save command unavailable until another change occurs.

PHX often does not display a general success message. The most common visible sign is that Save becomes disabled and the record remains available with its assigned identifier.

If the Save Is Canceled or Fails #

Selecting Cancel in a save prompt normally leaves you on the current record and stops the navigation or close action.
Selecting No normally skips the save and continues the action described in the prompt. Unsaved entries may be discarded or excluded from the next operation.
A blocking validation message leaves the record open so you can correct it.
On many record-navigation screens, PHX checks whether Save is still enabled after attempting the save. If it is, PHX treats the save as unsuccessful and does not move to another record.
If PHX displays a database error, confirm the record after the connection is restored. Do not rely only on the fact that the Save button was clicked.

Why Save Behavior Varies #

PHX screens save different types of information:

A simple setup window may save one row and then disable Save.
The Patients window saves the patient plus related case, custom-field, medication, history, warning, and document information entered on the form.
The Billing window validates and saves a billing header, charge and payment details, claim dates, balances, and billing history.
Some windows have separate Save or OK actions for an individual detail row and for the overall record.

For that reason, do not assume a rule observed on one screen applies everywhere. Follow the message and controls shown on the active window.

Common Reasons a Record Appears Not to Save #

A required field or valid related selection is missing.
A Quick-Code or other unique value is already in use.
The Save button was never enabled because PHX did not register a record-level change.
A detail row was not accepted before the record-level save.
No was selected at a prompt, so PHX continued without saving.
The database connection was unavailable or PHX displayed a database error.
The record saved, but the window did not display a success dialog. Check whether Save is now disabled and whether the record has its assigned identifier.
A print or transmit action used the last saved version because current billing changes were not saved first.

Troubleshooting #

Read and record the complete PHX message.
Correct the field or selection named in the message.
Finish any active grid or detail-row edit.
Select Save again, or press F2 on a window that supports that shortcut.
Confirm that Save becomes unavailable or the expected identifier appears.
If the connection failed, restore the connection and reopen or verify the record before continuing.