Official Documentation (Prime TicketReceiver)

Official Documentation (Prime TicketReceiver)

Official Documentation (Prime TicketReceiver)

Short operator / setup guide for Prime TicketReceiver (Ticketsystem package). Ticket Receiver is the field-technician UI — ticket master data and fleet map live in Prime Ticket and Prime Workforce respectively.

Open Ticket Receiver

  1. Ensure Ticketsystem is installed and the user has access to Ticket Receiver (authorization on the TicketReceiver entity).

  2. Open Ticket Receiver from the sidebar, or navigate to /TicketReceiver.

  3. Field-user roles can be configured to land here after login (LoginController redirect).

Working a ticket (field technician)

State

Positive action

Negative action

State

Positive action

Negative action

New

Accept → In Progress (exclusive assignee; notifies creator)

Decline → removes you; ticket stays New

Paused

Resume → In Progress

Decline

In Progress

Close → Closed (notifies supervisor)

Pause

Tap a ticket card to open detail: address, due date, priority, ticketable link, comments, and Google Maps directions (when lat/lng exist).

Auto-refresh & notifications

  • Toggle auto-refresh to poll ticket changes (default pull interval: 10 seconds — ReceiverPullTime in Ticketsystem config).

  • On first visit, allow browser notifications when prompted for the best experience.

  • Service worker registration enables background notification delivery on supported browsers.

Technician scoring (ticket creation — Prime Ticket)

When creating a ticket linked to a ticketable with position data, the assignee dropdown is ranked by a weighted score (Ticket::weightedList()):

Weight (Ticketsystem config)

Factor

Weight (Ticketsystem config)

Factor

distance

Proximity of technician geoposition to ticketable (0–1 km normalised)

modemcount

Share of affected modems under a net element (Detect / HfcBase)

open_tickets

Inverse load — fewer open tickets score higher

The top-scoring technician is preselected on the create form. Technicians filtered by maintain ability on net-element base types when applicable.

Requires fresh user geoposition and, for plant tickets, HfcBase + modem chart data.

Supervisor map (Prime Workforce)

The hub legacy text describing a map of all technicians and open tickets refers to Prime Workforce Command Center — not Ticket Receiver. Use Workforce for dispatch overview; Ticket Receiver for individual tech workflow.

Requirements

  • Prime Ticket — types, states, assignment, comments

  • User geoposition — for scoring and directions

  • Ticketable coordinates — modem / contract / net element with address or lat/lng

  • HTTPS — recommended for notifications and geolocation in production

Parent hub: Prime TicketReceiver


Legacy hub content (videos & media)

This module adds a responsive view (smartphone, tablet, notebook, desktop) for field technicians working on tickets. One can easily accept, reject, start, stop, pause and re-assign tickets. Furthermore one can get directions to the ticket location.

The tickets supervisor can view all open tickets and see where the field technicians are currently located and on which tickets they are working — see Prime Workforce for the supervisor map.

When creating new tickets a score is calculated based on the availability, technical capability and distance (to the respective ticket) for all field technician. The field tech with the highest score will be preselected.

Feature

State

Details

Feature

State

Details

view all open tickets on geographical map

Prime Workforce Command Center

display current location of field technician

Workforce + browser geoposition

show which ticket is currently being worked on by which technician

Workforce map highlight

provide responsive ticket view for field technician

Ticket Receiver

accept, reject, start, stop, pause and re-assign tickets

Ticket Receiver actions

get directions to the next ticket

Google Maps link in Receiver

determine best matching field technician for a new ticket

Prime Ticket weighted preselection