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 help you solve the following problems:

  • A Placement you created in ATS can't enter time, and you can't find them in BTE.

  • You're not seeing the Payable and/or Billable Charges you expect to see in ATS after time has been entered in BTE.

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.

If you're troubleshooting an individual WTE timesheet, you can quickly open Placement Viewer by clicking the Magnifying Glass icon in the Action column on the timesheet. This option is not available for clock placements.

  1. In the TMC, select Maintenance > Administration.

  2. Select Placement Viewer.

  3. Use the search panel to type in the Assignment/Placement number (the most common method) or the External ID.

  4. Click Search.

  5. Once the search is complete use the tabs displayed to troubleshoot the issue at hand:

    • 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 the refresh message.

    • This tab lists every time this placement has been synced to Pay & Bill. Each row is a BTE timecard event (e.g. time submission, approval, etc). Each timecard 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).

      Click Details on a Timecard Event line to see additional information.

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

    • This tab displays information about the placement you searched for. Here, you can check the employee's Setup, general Employee information, Flags, Approval settings, and Earn Codes.

    • The Client Info tab displays important ATS integration information and Corp-specific settings.

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