This Knowledgebase Article is based on information from Confluence Page ID 21332020. If updated, please review the corresponding Confluence source.


Fieldglass Report Creation

Log into the instance of Fieldglass.

Select Analytics then Create Report.


Image Placeholder


 

Select Time Sheet. This will open the report creation page with the correct options available.


Image Placeholder


 

Columns will default into the report but should be removed by selecting the X. Using the Search For Fields option search for the below fields and drag and drop them into the section Columns in the correct order.


Image Placeholder


Fieldglass Report Fields

 Field Name
Category 
 Time Sheet ID
Time Sheet/ID 
 Worker ID
Worker/Details 
 Last Name
Worker/Details 
 First Name
Worker/Details 
 Buyer Code
Buyer/Details 
 Site Code
Time Sheet/Details 
 Site
Time Sheet/Details 
 Cost Center
Time Sheet/Details 
 Time Sheet Billable Hours
Time Sheet/Hours Worked 
 Rate Component Code
Time Sheet/Rates 
 Time Entry Date
Time Sheet/Line Items 
 Time Sheet Approved Date
Time Sheet/Audit 
 Time Sheet Start Date
Time Sheet/Details 
 Time Sheet End Date
Time Sheet/Details 
 Time Sheet Submit Date
Time Sheet/Details 
 Time Sheet Status
Time Sheet/Details 
 Time Sheet Billable Hours (by Rate Category)
Time Sheet/ Hours Worked 
 Revision #***
Time Sheet/Details 
 Bill Rate
Work Order/Rates 
 Worker End Date
Worker 

***NOTE: The Revision # column will only be available if this Fieldglass client allows revised timesheets. If not this option will not appear when searched but the report can be created without this column.


Fieldglass Report Filter

Under Filter Parameters add:

Time Sheet Status> Equals> Select the drop down and include: Approved, Invoice, Paid, Payment Pending, Pending Allocation, Pending Approval, Pending Review, Pending Review by Supplier, Pending Validation.

**Note: We recommend pulling all pending and approved time each day. When the timecard gets approved it will then create an exception in Exchange to change the status. Once this exception is processed BTE this will update the timesheet to approved. If this is not possible, separate reports will need to be created to pull pending and approved time to meet your company’s sweep requirements.

  1. Add Time Sheet Submit Date (Time Sheet/Details)>In last>30>Days

  2. Add Time Sheet Submit Date (Time Sheet/Details)>In Last>24>Hours

**Note: If testing older weeks, the Time Sheet Submit Date can be changed to Time Sheet End Date>Between and then the testing week dates can be entered, then select Run Now.

Change the Filter Logic to 1 and (2 OR 3) then select OK to save the changes.


Image Placeholder


Select the filter for the Rate Category>Equals and select all the rates to add them to the right side of the pop-up window, then select add.

Select all of the Buyers that should be included in this report and move them to the right side of the pop-up window, then select add.


Image Placeholder


Saving the Fieldglass Report

Enter a report Name. It is important to create a report name that is unique for you. We recommend putting your company name and your client’s name in the report name. This way email delivery will always be able to find your reports. If you have a sweep file and an Approved file, then you need to include this in the report name as well. So your reports would have part of the name be Agency_Customer_Pending and Agency_Customer_Approved.

Select a folder. This does not drive anything within the report, but you must be able to select a folder to save the report. If you do not see a folder option then your login does not have Admin access and will need to be updated.

Select the Output Format of CSV and save the report. Once the report saves, select the Run Now option.


Image Placeholder


***Note: If you receive the following “Error: Number of columns exceeds the limit 500. Narrow the column selections and try again.” Then remove some of the Rate Category’s that were added. One way to determine which Rate Categories should be left is to remove the bill rate and run the report. Then review the report to see which rate categories have hours and ensure those categories are selected.

Scheduling Reports Within Fieldglass

This report then can be accessed through Analytics>My Reports>Actions>Go to Run Time Page. From the Run Time Page Actions>Schedule Report to have the report emailed to Exchange.

A Schedule Name will default as the report name which can be left as is or updated if necessary. Delivery Type should be Attachment, Frequency is Daily, Start Date/Time should be the first date you want the file to run and the time of day the report should be run. We recommend scheduling the report to run overnight so that the report is ready to process first thing in the morning. For Email Addresses enter both the Cert and Production email provided by Bullhorn separated by a semicolon. This will eliminate the need to update the reports when you are ready to move them into production.


Image Placeholder


Exchange Email Box

Login to https://login.microsoftonline.com/ with the provided details. If it asks for additional verification information, select cancel as it is not necessary to provide. This email box will show all emails received from tools so you can verify the email is set up correctly and being received by Bullhorn. If a file needs to be reprocessed as it did not process, mark the email as unread and this will prompt the system to process the email again. The file should normally process within 10-15 minutes depending on its size and the other files the system is processing at the time.

Exchange Fieldglass Template Creation

After logging into Cert select the


Image Placeholder


and then


Image Placeholder


The following window will pop-up for initial information to be entered so the template can be created.

Enter the Template Name. This field will help your team to know what file they are reviewing and helps the Bullhorn team if any troubleshooting is required. As such, the name should include your company name (or an abbreviation) and the name of the VMS and the client.

Enter the Customer Associations which is the client ID from the ATS that correspond to the buyers/employees that are included in the file from Fieldglass and select the number that shows as a drop down under the field. The name should then show populate below the box.

Select the Source of Fieldglass.

Select Create.


Image Placeholder


The template will now show up as a new pop-up window.

At the top there are tabs that determine how the template will function.

File Processing Tab

On the File Processing tab enter the Start Date, this can be left blank for testing if desired, but is critical for ensuring time for weeks prior to the transition to Bullhorn do not get duplicated when moving an existing client into Exchange. The Start Date should be the first date for which you do not want to load time. Select an Approval Status Type. This should be left as Peoplenet Approval Status unless you need to see status changes such as Approved to Invoiced as these will not show since they are both considered approved.

For the Auto Process Employee Matches the Match Types should be set to Full Name Without Middle Initial. This will allow this system to match employees from the VMS file to employees under that customer ID if they have the same name. If there are more than one employee with the same name, then the system will only suggest a match for a person to manually confirm.

Auto Process Assignment Matches should remain checked as one-to-one. This will allow employees that have been matched on the employee level to have their assignments match if there is only one assignment in both the VMS and in Bullhorn. If there is more than one assignment in either system, then the system will suggest an assignment match, but it will need to be confirmed by a person prior to any time loading.

Auto Process for Matched Items should be checked as this will allow any time in the file for matched employees to process into BTE when the file uploads. When first testing or loading time this option may be turned off to allow review and confirmation of hours prior to moving to BTE to confirm testing is accurate.

OT Reconciliation should be checked with the OT Calculation Source listed as Peoplenet OT Calculation. This will allow the system to compare the overtime hours entered into the tool with the overtime calculated by Bullhorn according to the state laws of that employees’ work location. If there is a discrepancy that will cause a monetary difference for AR, then it will display a record on the Overtime tab within Exchange so the overtime can be reviewed and corrected. If a client has abnormal overtime rules that are enforced within the tool, then the VMS OT Calculation source can be selected. This will load the hours into BTE exactly as they were received. This means if the pay file sends the reg and OT and DT time that is in the BTE timesheet to the payroll system, then the hours as entered in the VMS system will load to payroll. This also means that the VMS OT Calculation source should not be used if the VMS does not force overtime to be entered correctly.

Ignore Pay Record Sent and Reset Pay Record Sent should be checked if you are allowing time corrections (CPA) to process from BTE into your payroll system. If time corrections will be manually entered into the payroll system these should not be checked. **NOTE: These do NOT need to be checked if you are using Bullhorn One.


Image Placeholder


Report Settings

On the Report Settings tab, the details of the reports will be entered.

Select Report then select the Default Report then change the name of Default Report that populates into the Report Name. This will help if additional reports need to be created for that client/template.

Delivery Type select Email Delivered.

Leave Upload Path, Approval Type, and Approval Date as they default.

Mapping Code select FieldGlass Mapping.

Import rules will be selected dependent upon if a Revision field was able to be added to the report.


 VMS
Rules to Apply 
Conditions 
 Fieldglass - With Revision # field on the report
Keep only the highest revision
Remove Timecards with -ve value 
The client supports negative adjustments. This will cause the system to only take the highest numbered revision if there are multiple revisions on the file. 
 Fieldglass - No revision # on the report
Reject the file if there is a -ve value 
The client does not support negative adjustments. This will create an error if a client starts to use revisions so the revision column can be added to the report at which time the import rules should be updated again. 

An email can be entered under the Error Email so that if there is an error with the file that email will be notified.


Schedule

Select the sub-tab Schedule to enter the expected schedule of the file. Select the correct Time Zone.

Select the Day and Time the file is expected to be received using


Image Placeholder



to add additional days and times. For Fieldglass it is scheduled to run daily so add a schedule for Monday, Tuesday, Wednesday, Thursday, and Friday at the expected file time.

Enter a Window Start and Window End meaning the number of hours before and after the arrival time. This means that if the file is expected at 3:00 AM and the Start and End windows both are 2:00:00 then the system will check if the file is received between 1:00 AM and 5:00 AM (2 hours before 3:00AM and 2 hours after 3:00AM) and create an error if a file is not received.


Image Placeholder


Email Delivery

Select the sub-tab Email Delivery tab. This will allow the emailed file to import into Exchange.

From Address is fieldglass@fieldglass.net.

To Address is the email that Bullhorn provided for Cert and then will be updated to the production email when migrated to production.

Subject Key Words should be Scheduled report is ready for download.

Email Body URL Key Words should remain blank.

Email Body KeyWords would be the report name including your company and client name and any defining details of the report from when you saved the report in Fieldglass. It is important that this information is unique to every file sent so the system can correctly map the file to the right template and schedule.

File Extension is .CSV.

Header Row is 1.

File Delimiter should show as “,”

Check the box for Has Attachment.

Leave Is Attachment Zipped and Do Not Convert to CSV as unchecked.


Image Placeholder


Template Settings Tab

The Owner field can be updated to select the admin that will be responsible for processing the files for this client or tool. This is particularly helpful if you have multiple admin’s working in Exchange to process files. If only one admin will be working in the system to process all the files, then this field can remain as Not Assigned.


Image Placeholder


Exception Processing Tab

On the Exception Processing tab, each exception type can be set to one of the following:

  • Ignore: No action required when this exception type is received, and there will be no changes made to the timesheet.

  • Load if Pay Record not Sent: No action required when this exception type is received, if the initial time loaded has not been sent to the payrolling system then the update to the hours/status will be loaded to BTE. **NOTE: This is not used for Bullhorn One.

  • Always Load: No action required when this exception type is received, the update to the hours/status will automatically load to BTE regardless of whether the pay record has been sent.

  • Manual Resolution: The exception will require review at which point the person can decide if it should be processed to BTE or Ignored which will leave the hours/status in BTE unchanged.

Duplicate Time Card: Set to Ignore as there is no update to the time or status.

Time Adjustment Only: If corrections will require a manual update in the payrolling system (not using Bullhorn 1), select Manual Resolution. Otherwise, either Always Load or Manual Resolution should be selected depending upon if the change in time should be reviewed prior to processing to BTE.

Approval Status Change Only: Select Always Load to automatically update the timesheet status from Pending to Approved. The hours will not be impacted with this exception.

Time and Approval Status Change: Should be set to the same processing type as a Time Adjustment Only.

Multiple time cards exception: This should be sent to Manual Resolution so a person can review and confirm it is additional time and not duplicate time. The exception can then be processed to add the time or ignored.

Time History Detail Load Failed: This should be set to Manual Resolution.

Time card is before start date: This should be set to either Manual Resolution or Ignore dependent upon if there are concerns about late time entry for week endings prior to the transition into Exchange.


Image Placeholder


Map Earn Codes Tab

The Map Earn Codes tab is not needed for Fieldglass templates as the earn codes are already mapped accordingly.

Rate Reconciliation Tab

Rate Reconciliation can be used for Fieldglass which will allow the system to compare the rate an employee has in the VMS with the rate the person was set up with in Bullhorn. This is helpful for preventing AR discrepancies that arise from rate differences. When the rates are different it will create an item on the Rate Reconciliation tab to be reviewed to determine which system needs to be updated. However, some margin of error costs more to correct and will be written off as a small balance so the system can automatically ignore those items. Enter the Margin of Error your company is comfortable with.

Leave Check Reg hours, Check OT hours, and Check DT hours checked.

Discount Source will depend on if the Assignment includes the discount. If the assignment does not include the discount, but this client does have a discount, select File template and enter the discount percent.


Image Placeholder


Resolution Settings Tab

The Resolution Settings tab can be used to set emails to send upon resolution of files by entering the Name, Email Address, selecting Contact Type, and checking Auto Send Resolutions Email. The message can be customized by entering information into the boxes at the bottom.

Once all updates are made to the template select Save & Close.


Image Placeholder


Exchange Test File Import

If testing with current files, then the file will run according to the schedule in Fieldglass and import into Exchange for testing. On the first date scheduled to run, the report should show under the File Activity tab.

If testing with older dates, login to Fieldglass and Select Analytics>My Reports and find the file that was created earlier. Select Actions>Go to Run Time Page. This will retrieve the saved report features on a run page. Change both the Time Sheet Submit Date to Between and enter the dates of the time period for testing and select Run. Which will download a file using those dates.

Return to Exchange Cert Environment and Select


Image Placeholder

In the window that pops up select Choose File and locate the file downloaded. Then select the correct Template/File set up and select OK.


Image Placeholder


A confirmation window will appear at which point select OK again. It may take a few minutes for the file to show onto the File Activity tab.

Use the blue hyperlink of the File Template Name to review the details and process the file. **see file processing document (not yet created)

Once the file is complete another file can be run for additional submit dates to then process and review how the system handles the file.


Image Placeholder


Move to Production

After sufficient testing has been completed and it is time to migrate this client to production, the template will need to be exported from Cert. If you are implementing exchange for the first time, transferring the templates to production may be completed by your Implementation team. However, you will be responsible for updating the fields within each template if needed.

Log in to the Cert environment.

Select the templates for Export with the right-hand check boxes.

Select Export Templates.

A file will download to your computer.

Log in to the Production environment.

Select Import Template and browse to the file you downloaded.

The templates will appear in the new environment after you refresh the page.

You should review the new templates to make sure that the settings are appropriate for the new environment. Correct the To Email Address under the Report Settings to the production email provided by Bullhorn, enter the Start Date as the first date for which you do not want hours to load, confirm all client IDs have been updated on the template if necessary, and update the schedule if needed to account for each day the report should be received by the system.

 












FAQ

Q: Why can’t I find the Revision field to add to my report?

A: The client did not opt to have the ability to revise timesheets within Fieldglass so corrections are done through Credit/Debit Memos. The report can be created without that field but leaving the other fields in their respective places. It is important to select the correct Report Input Rules on the template.

Q: I set up a new file in Fieldglass, but the file did not load to Exchange?

A: Confirm the file emailed to the Exchange inbox otherwise updates may need to be made to the schedule within Fieldglass. Check the details on the email with the details entered in Report>Email Delivery. Also confirm that the key words are specific enough to the individual report. If there is another report in any of your templates or another customer’s template with the same report name, the report will not be able to load. Therefore, it is recommended you include your company name and the client’s name within the template.

Q: All of my Fieldglass reports were not received by Exchange even though previous reports have been received?

A: Log into Fieldglass and select Analytics>Report Outputs. This page should show you the reports recently run so if it does not reflect on this page then the report failed to run within Fieldglass. Review your report schedule to ensure it is still accurate and then reach out to Fieldglass to see if there is a system issue that prevented the report from running. If the report shows on the Report Outputs page but still does not reflect within Exchange, check the email inbox for your Exchange reports for the email. Change it back to unread if it is reflecting in the inbox to have the system pick up the file for processing again.

Q: My file failed because of a negative value, what do I do?

A: When the file was set up it is likely that the revision field was not in Fieldglass so it is not set up on the report that is loading into Exchange. Go into Fieldglass and add the revision field into the correct order on the report. Once that update is saved on the report and schedule, then the template needs to be updated as well. On the Report General tab the import rules need to be updated to include “Keep only the Highest Revision'' and “Remove Timecards with –ve value.” A new report can be manually run from Fieldglass including that revision column and then uploaded into Fieldglass or you can wait until the next day when the scheduled report will run.

Q: I have exceptions that state the time is before the Start date. Why did these create?

A: The start date entered should be the first date for which you do not want time to load. For example, if the first timesheet to load in Exchange is for Monday 10/11/2021-10/17/2021, then the Start Date should be entered as 10/10/2021.

Q: I tried to run the report in Fieldglass but it gives an error that there are over 500 columns. What should I do?

A: If you remove the Bill Rate column and run the report, then it should successfully run. The Bill Rate field provides the bill rates onto the report so the rate recon comparison can take place. Once the report runs, the columns showing the hours worked can be used to determine which rates are important to include. Very often there are many rate categories that are not used by the client so only those rate categories that are used can be selected to help limit the number of columns to report pulls. Once the rates categories that should be selected have been determined, add the bill rate column back on the report. Then under the Filters, select the Rate Category filters and only select the rate categories that are used by this client and move them to the right side of the screen. Save the updates to the report and try and run it again. This should allow the report to run without the 500 column error.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Proprietary Notice and Disclaimer

 

© 2016 Bullhorn Inc. The information contained herein is Confidential and Proprietary to Bullhorn, and cannot be divulged to any third party without the prior written consent of Bullhorn.

This Proposal, including all related enclosures and attachments, is to be used for evaluation purposes only. You may make and distribute copies of the Proposal to those employees and consultants who have a need-to-know during your review period. In the event the contract award is not granted to Bullhorn, this Proposal in its entirety must either be destroyed or returned to Bullhorn, as directed by Bullhorn.

Unless otherwise noted, this Proposal is valid for a period of 60 days.

Bullhorn Proprietary: For Use by Bullhorn Customers for Planning Purpose Only (Forecasted Dates May Change without Notice). The following information is furnished for informational use only, is subject to change without notice, and should not be construed as a guarantee, commitment, condition, or offer by Bullhorn.