mwestereng1
commented
2 months ago UX Notes:
- [ ] Implement real-time inline validation for the email fields.
- [ ] Validation seems to persist from one user session to the next. To re-create this behavior, login as a petitioner, go to My Account > Change Email. Enter an email address that will give you an error message. Log out, and log back in as a petitioner go to My Account > Change Email. The user receives a live error message.
- [ ] Disregard the email validation for adding/changing an IRS Calendar Administrator for the concerns raised at the beginning of this story.
- [x] When a court user creates a petition (https://app.test.ef-cms.ustaxcourt.gov/file-a-petition/step-1), if the "E-service consent" box is checked, and
- [ ] No email address is entered, the user should receive the "Enter valid email address" error message
- [ ] The email is in an invalid format
Error message when they enter an email address in an invalid format, and the box is NOT checked (this is correct)
Error message when they enter an email address in an invalid format, and the box IS checked (this is correct)
No error message when the "E-service consent" box is checked and no email address is entered (they should receive an error message in this case)
ttlenard
TomElliottFlexion
As a Dawson user, I need error messages to tell me specific actions to take, so that I can correct my submissions.
Some email fields in DAWSON give a generic error message when validating an email address for correct formatting. We would like to update all email address fields in the system to one consistent error message when the email address provided is not in the correct format.
Link to the Figma File
This is the correct error message that we would like to use when user inputs any text or characters that are not in the correct email address format for required or optional email fields. This is a correct example from "Review & Serve Petition":
If the field is required, but they don't enter any text or characters, the error should retain the same "Enter a valid email address" message.
If there are multiple fields for validating the email address (ie. "Change Login & Service Email Address"), the error messages should update individually based on if/what text or characters are entered into each the field.
IMPORTANT NOTE: If any of these email validation updates prevent a dropdown selection chosen by the court from passing validation, we do not want to implement the format validation.
For example, most of the time adding or editing an IRS calendar administrator for a trial session is done through a drop down menu and the email address auto-populates (see image below). If that auto-populated email address can't pass validation, we do not want to add validation to this field. This field currently does not have validation. This example shows an anonymized email address in the pre-production environments, instead of their actual email address. We also don't want to prevent these anonymized emails from passing validation in the pre-production environments.
Below is a summary of where email address fields are located that need to be updated.
"Create Account" (text only update)
Accessed:
For this scenario only, we are not changing the styling of the error message. We are only updating the text.
Current error message and styling
If the email address is in the incorrect format, update the error message text only to: "Enter email address in format: yourname@example.com"
If no email address is entered, there are no changes to the current error message. The error message should state "Enter a valid email address"
"Change Email"
Login as a Petitioner > Utilities > My Account > Change Email
Login as Private Practitioner, IRS Practitioner, or DOJ Attorney > Utilities > My Account > Change Email
Current email error messages
Admissions Clerk - "Add New Practitioner" Login as an Admissions Clerk > Advanced > Practitioner > Add New Practitioner > Login & Service Email > Change Login & Service Email
Pathway to "Add New Practitioner"
Current error messages
Admissions Clerk - Edit Practitioner Login as an Admissions Clerk > Advanced > Practitioner > Search for existing practitioner > select practitioner > Edit > Login & Service Email > Change Login & Service Email
Current pathway to "Edit Practitioner"
Current error messages
Not pursuing with this design debt Add or Edit Trial Session IRS Calendar Administrator Email URL: https://app.test.ef-cms.ustaxcourt.gov/edit-trial-session/e85e85c2-84fb-4bdd-bef6-01a07e4a8361
Log in as a Admissions Clerk, Assistant Deputy Counsel, Case Services Supervisor, Clerk of the Court, Docket Clerk, Petitions Clerk, or Trial ClerkAccess pathway is slightly different for a Judge:
Court User Creates a Petition
Log in as a Case Services Supervisor, Clerk of the Court, or Petitions Clerk
Document QC > "Start a Petition" > Parties > "E-service consent" = checked
Currently, there is no email validation if they check the "E-service consent" box.
Pre-Conditions:
None
Acceptance Criteria:
Pain Avoided/Frustration Saved: Error message tells users exactly what they need to do to fix the error that is preventing their submission.
Breadth/Pervasiveness of Problem: This primarily affects users who are creating a new petitioner account, or users who are changing their email address for login or service.
Complexity of Problem (Low, Medium, High) and Why it's Complex: Low