Placement Viewer

Overview

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.

Locating the Placement Viewer

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.

To access Placement Viewer select Maintenance > Administration, then scroll down and select Placement Viewer.  

Using the Placement Viewer

The top section contains a search panel where you can search by Assignment/Placement number (the most common method) or by external ID.

  • externalId = Timehistory..tbl, Emplnames.Record, Id_PlacementNumber (e.g. : 12345_89)

Once the search is complete, 3 tabs will display:

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

Refreshes: ATS to 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.

  • For example, 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.

  • For example, 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.

Fetch Placements

The Fetch Placements tool allows you to pull placements from the ATS to BTE without needing to trigger an event in the ATS, which usually involves saving a placement or making a key data change (for example: moving a placement into an approved status).

  1. To access this tool, click the green Fetch Placements icon. This will pull placements for this specific client code.
  2. When the popup box opens, add the placementIDs that you wish to pull into BTE in a comma-separated string (for example: 1, 2, 3, 1394, 2948).
    • The maximum number of placements is 100.

  3. Click Submit. These placements will be pulled into BTE via REST API.

Placements pulled in via the Fetch Placements tool will "jump the line" of existing placements that have events created for them, as they are requested at a higher level of priority.