OPENING A .PBIT FILE (client-side, manual)
============================================

This is for opening a delivered .pbit directly in Power BI Desktop —
not the New-FleetPbit.ps1 generation script. See INSTRUCTIONS.txt for that.


GETTING IT OPEN
----------------
1. Double-click the .pbit file. You'll get a parameters prompt before
   anything loads — enter:

     Environment              Test or Production (match the file name)
     Version                  1.1 (default, leave as is unless told otherwise)
     API Key                  (as per the API key given to you)
     Start Date               leave the default (01/01/2020) unless told otherwise

2. Click Load — this kicks off the first data refresh, pulling workshop,
   fuel, and fleet history back to the Start Date, so give it several
   minutes.

   - If you get a credentials prompt for test.myausfleet.com or
     myausfleet.com, choose Anonymous and Connect (you may see one per
     host). If asked about privacy levels, Public is fine.

3. Once loaded, save it as a regular .pbix (File > Save) so you're not
   re-entering parameters each time — reopening the .pbix later just
   refreshes with what you saved.

If anything errors on that first load, a screenshot of the message is
all that's needed to diagnose. A 503 / "service unavailable" on a Test
refresh means the .pbit predates the 27/08/2026 API change — request an
updated file rather than troubleshooting.


PARAMETER NOTES
----------------
- Environment: Test targets test.myausfleet.com; Production targets
  myausfleet.com. Core Production endpoints are live; Accidents,
  Infringements, Hire Bookings and Checklists are not yet released in
  Production, so those pages stay empty there — expected, not a fault.
- Start Date sets how far back ALL reporting history reaches (fuel, hire,
  checklists, workshop). It is the main refresh-time lever. Leave blank to
  auto-detect the earliest fuel transaction year from the API (slower;
  workshop history is then capped at a rolling 8 years).
- The Workshop Year Lookback parameter was removed 28/08/2026 — workshop
  history now follows Start Date like everything else. Older .pbit files
  still prompt for it; files generated after that date will not.
- See CLAUDE.md param table for full parameter reference.