β v30 Fixes: PCT weekday/weekend split, RN cap (+2 WD/+1 WE), MID shifts in day balance, MID weekend min 1, + CHG renamed to CN, CN count fixed in coverage summary (min 3), + PAYRO β PTO (payroll code preserved), admin time codes no longer misclassified as shifts
π How to Use This Tool Start Here
βΌ Click to expand instructions
π₯ CVICU Schedule Balancer β What This Tool Does
This tool takes a MyTime (UKG/Kronos) schedule export and automatically fills in coverage gaps for both Day and Night shifts β respecting all CVICU scheduling rules, staff type requirements, weekend obligations, and shift separation. It never modifies ANMs and preserves self-scheduled shifts wherever possible.
π» About This File β Sharing & Browser Requirements
π Completely Standalone
This is a single .html file. Everything β the balancing logic, staff roster, all scheduling rules β is built into the file itself. No login, no account, no subscription required.
π Works in Any Modern Browser
Open the file in Google Chrome, Microsoft Edge, Safari, or Firefox. Simply double-click the file or drag it into a browser window. Chrome or Edge recommended for best experience.
π€ How to Share
Send the CVICU_Balancer_v30.html file as an email attachment, via Teams, or upload to SharePoint. Recipients just open it in their browser β no installation needed.
π Data Stays on Your Computer
Your schedule data is never uploaded to any server. All processing happens locally in your browser. Nothing leaves your machine.
πΆ Internet Connection
An internet connection is only needed for the Excel download feature (loads the Excel library from a public CDN). All other features β upload, balance, view results β work fully offline.
πΎ Nothing is Saved Between Sessions
The tool uses your browser's local storage to remember the Master Staff Database between sessions on the same device. Clearing browser data will reset it. Always export the master CSV as a backup.
π€ Step 1 β Upload MyTime Export
In MyTime/UKG, run the Employee Schedule Monthly report
Export as .xlsx
Drag & drop the file onto the upload zone, or click to browse
The tool reads all staff, dates, and shift codes automatically
β Supports 6-week pay period exports
βοΈ Step 2 β Set Coverage Requirements
RN Weekday Min β target RN count MonβFri (default: 15)
RN Weekend Min β target RN count SatβSun (default: 14)
Cap sliders β max RNs above minimum per day type:
Sat +1, Sun +2, Mon/Tue/Wed/Fri +3, Thu +4
PCT Weekday min 2, PCT Weekend min 1
CN (Charge Nurse) min 3 per shift
EB and ES minimums (skill mix)
π₯ Step 3 β Review Staff Roster
Verify each staff member's Type (FT/PT/PRN)
Verify their Shift (Day AM / Night PM / Mid)
Verify their Skills (CN, EB, ES)
Use πΎ Master Staff Database to save this info permanently β future uploads will auto-fill it
ANMs (Cruz, Rodriguez, Bruce) are marked π and will never be moved
β οΈ Always verify shifts for new staff before balancing
π Step 4 (Optional) β Protect Staff
Check any staff whose schedule must not be changed
Use for: school commitments, pre-approved vacation, FMLA, medical accommodations
Protected staff are skipped entirely during balancing
β‘ Step 5 β Run Balancing
Click π Analyze Schedule first to preview coverage gaps before making any changes β this button appears in the balancing panel once your file is loaded
βοΈ Balance Day Shift β fills AM + MID shift gaps
π Balance Night Shift β fills PM shift gaps
π Balance Both β runs day then night in one click
The algorithm: fills PCT first β CN β EB/ES β RN; respects all caps
Weekends are prioritized first in the fill order
π‘ If results aren't ideal, adjust cap sliders and re-run
π₯ Step 6 β Download Results
π₯ Download Excel β multi-sheet workbook:
β’ Coverage Summary (weekday/weekend view)
β’ Day Shift (ANMs β MID RNs β RNs β PCTs)
β’ Night Shift
β’ Original MyTime Import (pre-balance)
π Download Move Report β CSV of every change made
Review the Move Tracker section to see Added vs Moved per staff
β‘ Key Rules to Know
Shift Separation
Day (AM) and Night (PM) staff are completely separate pools. The tool never crosses them over.
Mid Shift (MID)
Counts toward Day coverage. Min 1 MID on Sat and Sun. Kesbeh & Hickman are MID.
PTO = Worked Shift
PTO, FMLA, LOA count toward the 18-shift (FT) / 12-shift (PT) minimum. SICK does not.
Weekend (Night)
Friday counts as a weekend day for night shift staff. Fri/Sat/Sun = 7 required.
Late Submitters
FT <18 or PT <12 shifts submitted = classified Late β gets unlimited moves assigned.
Move Caps
Compliant staff: max 2 changes. Non-compliant: max 6. Blank fills are free (not counted as moves).
PAYRO Code
ANM payroll admin code (4amβ12pm office shift). Counts as worked, shows as PAYRO not PTO.
RN Cap (no +5)
Max overage: Sat +1, Sun +2, Mon/Tue/Wed/Fri +3, Thu +4. Hard ceiling enforced.
π‘ Tips & Troubleshooting
First time setup: After loading your first MyTime file and verifying the roster, click πΎ Save Current as Master. Every future upload will auto-fill Job/Type/Shift/Skills from that saved database. Staff showing wrong shift type? Edit their Shift dropdown in Step 3 and save as master. The Job field in MyTime must contain "(AM)", "(PM)", or "(MIDSHIFT)" for auto-detection. Coverage still showing gaps after balancing? Some gaps can't be filled if all eligible staff have hit their weekly cap (3 shifts/week FT, 2 shifts/week PT). This is a genuine staffing shortage that requires agency or overtime. Move tracker shows too many added shifts for one person? Always click Balance fresh β don't click the button multiple times in a row without reloading, as trackers reset on each run. ANM schedule looks different from MyTime? ANMs are never moved. If their schedule looks off, re-export MyTime with a fresh file β the issue is in the source data, not the tool.
π Scheduling Rules Reference Always Active
βΌ Click to collapse rules
π CODE REFERENCE β MyTime to Tool Translation
Use this reference to understand how MyTime codes translate and what counts toward requirements
β WORKING SHIFTS (Count Toward Requirements)
MyTime Code(s)
Tool Code
Description
Counts Toward
Weekend?
Sunday?
Total Shifts?
6T19Q, 6T19, 7A
7A
Day Shift (7amβ7pm)
RN, PCT, CN, EB, ES
β
β
β
10W2Q, 10W2, MID
MID
Mid Shift (10amβ10pm)
RN, PCT, CN, EB, ES
β
β
β
18T7Q, 18T7, 7P
7P
Night Shift (7pmβ7am)
RN, PCT, CN, EB, ES
β
β
β
β TIME OFF / NON-WORKING (Do NOT Count Toward Requirements)
MyTime Code(s)
Tool Code
Description
Counts Toward
Notes
PTO
PTO
Paid Time Off
SHIFT requirement β
Pre-approved time off
VAC, VACATION
PTO
Vacation
SHIFT requirement β
Vacation leave
SICK
SICK
Sick Leave
Nothing β
Sick time β does NOT fulfill shift requirement
R/O, RO
R/O
Requested Off
Nothing β
Staff-requested day off
HOL, HOLIDAY
HOL
Holiday
Nothing β
Holiday leave
FMLA
FMLA
FMLA Leave
SHIFT requirement β
Family/Medical Leave
LOA
LOA
Leave of Absence
SHIFT requirement β
Extended leave
(blank/empty)
β
No Shift Scheduled
Nothing β
Available day, no shift assigned
PAYRO
PAYRO
Payroll
AM/PM SHIFT requirement β
Payroll Time for ANMs β 8 Hour Shift
β οΈ SPECIAL CODES (Check Unit Policy)
MyTime Code(s)
Tool Code
Description
Default Behavior
Notes
ORI, ORIENT
ORI
Orientation
Counted as working; not included in balance
New hire orientation
ADMIN 4:00 AM (early AM times)
ADMIN
Administrative / Office Shift
Counts toward shift minimum β NOT included in coverage balance
Meetings, admin duties. 4:00 AM = Rowena's 4amβ12pm office shift
EDU, EDUCATION
EDU
Education Day
Counted as working; not included in balance
Training, CEUs
FLOAT
FLOAT
Float to Another Unit
Counted as working; not included in balance
Working but not on this unit
CALL, ON-CALL
CALL
On-Call
Not counted
Available if needed
PRECEPT
PRECEPT
Precepting
Counted as working; included in balance
Training new staff while working
βοΈ QUICK SUMMARY
What counts as a WORKING shift?
7A (Day), MID (Mid), and 7P (Night) shifts
Do MID shifts count toward weekends?
YES β MID shifts count toward ALL requirements
Does PTO count toward shift requirement?
YES β approved time off counts toward total shifts (18 FT / 12 PT)
Payroll time for ANMs (8 hr shift) β counts toward AM/PM shift requirement. NOT a PTO request.
What about Night shifts (7P)?
YES β counts toward requirements and weekend totals
π Minimum Shifts (6-Week Period)
FT
18 shifts (3/week Γ 6 weeks)
PT
12 shifts (2/week Γ 6 weeks)
PRN
1β2 shifts minimum
π Weekend Requirements
FT Day
5 weekends + 2 Sundays
FT Night
7 weekend shifts
PT
4 weekends + 2 Sundays (day)
Mid
β€3 weekend shifts (cap, not floor)
PRN
No weekend requirement
π Weekend Definition
Day shift
Sat & Sun only
Night shift
Fri, Sat & Sun β Friday counts!
Mid shift
Sat & Sun only
π Move Cap Rules
Late submitter
Unlimited (cap: 99)
Non-compliant
Max 6 moves
Compliant
Max 2 moves
Blank fills
FREE β never counted as move
π Protected Staff
ANMs
Cruz, Rodriguez, Bruce β never moved
PRN
Never moved; no weekend req
User-protected
School, FMLA, vacation selections
Shift separation
AM β PM pools never cross
πΌ PTO = Worked Shift
FT
3 PTO/FMLA/LOA in week = week done β
PT
2 PTO/FMLA/LOA in week = week done β
SICK
Does NOT count toward requirements β
Total
PTO+FMLA+LOA count toward 18/12 minimum
π¬ Feedback, Bug Reports & Suggestions
For End Users
π£ This is your voice. Use it.
This tool is built for the CVICU team and will keep getting better with your input.
If something doesn't look right, a shift got miscounted, a rule was applied incorrectly,
or you have an idea to make this more useful β this is where to post it.
Copy and paste your feedback below and send it back to the tool administrator.
Every report helps make the next version more accurate.
π Reporting a Bug
Please include:
β’ Which shift (Day / Night / Both)
β’ Which staff member is affected
β’ What the tool showed vs what you expected
β’ Date(s) where the issue occurred
β’ Screenshot if possible
β οΈ Reporting a Coverage Issue
Please include:
β’ Date with the coverage problem
β’ Actual count shown in the Excel output
β’ Expected count based on unit policy
β’ Whether it was a weekday or weekend
β’ Day shift or Night shift
π‘ Suggestions & Improvements
Ideas welcome β big or small:
β’ New scheduling rules to enforce
β’ Different output format needs
β’ Staff-specific adjustments
β’ Workflow improvements
β’ Anything that would save you time
π How to Submit
1. Type your feedback in the box below
2. Click π Copy Feedback
3. Paste into an email to:
π§ Rowena.Cruz@UTSouthwestern.edu
4. Attach your Excel output or a screenshot if relevant
Your feedback goes directly into the next version.
βοΈ Write Your Feedback Here
β Copied! Now paste it into an email to Rowena.Cruz@UTSouthwestern.edu β attach a screenshot or your Excel output if helpful.
Thank you for helping improve this tool for the entire CVICU team. π₯ | Contact: Rowena.Cruz@UTSouthwestern.edu
π€ Step 1: Upload MyTime Export Required
π
Drop MyTime Excel file here or click to browse
Supports .xlsx files from UKG/Kronos
β File loaded: Pay Period: Staff Count:
βοΈ Step 2: Set Coverage Requirements
Weekday = MonβFri | Weekend = Sat/Sun | Cap = Min + offset β tweak to control max RN overage