Using the Placement Viewer

Placement Viewer is a troubleshooting tool for messages sent from the ATS/Front Office Integration (FOI) to the ATS Billing Sync for Pay & Bill. This tool can be used with both FOI 1.0 and 2.0. It can also be used to troubleshoot Rate Card clients and standard BH1 messages sent to Pay & Bill.

The Placement Viewer is enabled in all environments inside of Bullhorn Time & Expense. It is available to users with Admin level of access or those with the Placement Viewer role setting enabled. Use the steps below to locate and use the Placement Viewer.

1. In the TMC, select Maintenance > Administration.
   
2. Select Placement Viewer.
    
3. Use the search panel to search by Assignment/Placement number (the most common method) or by External ID.
   • externalId = Timehistory..tbl, Emplnames.Record, Id_PlacementNumber (e.g. : 12345_89)
     
4. Once the search is complete use the 3 tabs displayed to troubleshoot the issue at hand:
   
   • Refreshes : ATS --> BTE

     This tab lists every instance of the placement coming over from ATS, with each row representing one refresh. The MessageId column specifies which refresh message it came over in (each refresh message can have more than one placement).

     Select View Details next to a specific refresh to see what information was included in this refresh message.
     

     Placements

     The columns with green text show the individual fields in the placement. These can be used to trace the history of a field and all the times the placement came to BTE.
     

     If an employee's pay rate changed from 45.0 to 70.0, the Placements tab will show when this update occurred in BTE.

     To see what the ATS sent over to BTE and how BTE converted the ATS JSON into a BTE Assignment JSON, select View Details. The Pre-mapped JSON shows what the ATS sent, and the Mapped JSON shows the assignment object after the mapping has been applied on the ATS JSON.
     

     Payfiles

     The Payfiles tab lists every time this placement has been synced to Pay and Bill. Each row is a BTE timecard event (e.g. time submission, approval, etc). Each time card event creates a batch for every placement the employee has for that week.
     

     If an employee has two active placements for a week, the same time card event will trigger two separate batches to Pay & Bill (even if the event was on only one of the placements).

     The top section shows the timestamp at which each stage in BTE's internal messaging system received and processed the timecard event to Pay and Bill. If the message didn't make it to Pay & Bill, the P&B section won't have a timestamp, indicating a problem. Expand the section to view the actual JSON sent to P&B logs.

     Info

     The Info tab shows basic information about the placement.
     

   • Billing Sync : BTE-->BH
   • Placement Summary in BTE

For information on fetching placements or using the discrepancy dashboard, see Fetch Placements and Reconciliation Dashboard.