Using the Service Contacts ReportBuilder







Previous Topic  Next Topic 

The AWARDS Service Contacts ReportBuilder, located in the Reports module, is a powerful tool that can be used to generate user-customized reports of basic client demographics along with detailed services information for services collected using group notes, group activity attendance records, progress notes, reception desk program attendance, and the contacts log (basic or supportive services checklist versions).   To generate and save a Service Contacts ReportBuilder report that can be re-run in the future, to generate a single-use report, or to use and/or update an existing report format to generate a report, complete the following steps:

  TIP: For frequently asked questions about the Service Contacts ReportBuilder, skip down to the bottom of the page.

    1. From the navigation bar, click Reports (or the Reports icon).  The Reports index is displayed.

    1. If you previously bookmarked the Service Contacts ReportBuilder it is displayed on the reports index by default; otherwise, from the left-hand menu bar, click ReportBuilders or All under "Show Reports."
    2. Use the navigation features in the bottom-right corner to locate the Service Contacts ReportBuilder in the index, or enter "service contacts" in the Search field in the upper-right corner.
    3. Click Service Contacts ReportBuilder from the reports index. The Service Contacts ReportBuilder Settings page is displayed.

    1. Click the Program drop-down arrow and select the individual program for which the report is to be run, or a select a group of programs using one of the available "All" selections or a "Custom Grouping."
    2. Click the Roster Date Range drop-down arrow and choose which consumers are to be included in the report based on their program history.  Available selections are:

  In Program - When this option is selected the report will only include clients with program history records indicating they were enrolled in the program at some point during the specified date range.  This selection is recommended if you will be narrowing the report contents using multiple date range filters (set in step 19).

  NOTE: In this context, clients who were enrolled in the program include those who entered the program on or before the report "To" date, those who were discharged from the program on or after the report "From" date, and those who were enrolled in the program for the entirety of the report period.

  In Program Including Pending Clients - When this option is selected the report will include admitted and pending clients - those with an admission date OR intake date, respectively, prior to the report end date, and no discharge date (or no discharge date within the date range).

  NOTE: Pending clients are clients in a multi-step intake program who have had an intake processed but who are not yet fully admitted - or clients for whom a room reservation has been made.  Programs using Drop In functionality also create clients designated as pending. 

  Admitted - When this option is selected the report will only include clients with program history records indicating they were admitted to the program at some point during the specified date range.

  Admitted or Transferred In - This option is available in databases that are set up to use the Transfers module.  When this option is selected the report includes clients with program history records indicating they were either admitted to the program (via the Intake/Admission module) or transferred into the program (via the Transfers module) at some point during the specified date range.

  Discharged - When this option is selected the report will only include clients with program history records indicating they were discharged from the program at some point during the specified date range.  Current program episodes will not be included.

  Discharged or Transferred Out - This option is available in databases that are set up to use the Transfers module.  When selected the report includes clients with program history records indicating they were either discharged from the program (via the Discharge module) or transferred out of the program (via the Transfers module) at some point during the specified date range.

  NOTE: In the event that you are creating a new report format that will be saved, please be aware that the selection you make here is not saved with the report.  It, along with the settings specified in steps 7, 9, and 10 must be set each time the report is run.

    1. By default both Date Range fields contain today's date to include in the report only those clients on the current roster.  If necessary, make changes to that default date range using the available From and To fields/date pickers.  When doing so please keep in mind that a two year period of your choosing is the maximum length of time for which the report can be run.
    2. By default the report contents include all clients with records matching the report settings; any client without records matching those settings is excluded.  If necessary, click one of the other Client radio buttons to make an adjustment to the included clients.  Available selections are:

  Clients with Records - The default.  As noted above, includes in the report all clients with records matching the report settings, and excludes those that do not match.

  All Clients - Includes in the report all clients on the program roster, whether or not they have records that match the report settings.  Those without matches will display "--" for data variables in the report where there is not a matching record.

  Select Client - Limits report contents to those records for a single client only, if records are found for that client that match the report settings.  When selected, use the corresponding drop-down (automatically displayed when "Select Client" is clicked) to choose the client for whom the report is to be generated. (The selection list is limited to those clients matching the roster date range settings selected in previous steps.)

    1. For the clients included in the report, contents are limited to service contacts that took place during the date range specified using the Service Dates fields on this page.  Click the Date Range Applies To drop-down arrow in this portion of the page and choose which type of date is to be used when applying that date range.  Available selections are:

  Contact Date - When selected, the report is limited to records for which the contact date is within the specified date range.

  Date Modified - When selected, the report is limited to records for which the date modified is within the specified date range.

  Date Written - When selected, the report is limited to records for which the date written is within the specified date range.

The default selection is "Contact Date."

  NOTE: This selection can be particularly useful to agencies that generate service contacts reports repeatedly over time, enabling them to pull records incrementally without having to generate a full report/export that includes records that been been untouched since the last report/export.

    1. By default the Service Dates date range itself is set for the last month.  If necessary, make changes to that default date range using the available From and To fields/date pickers.  When doing so please keep in mind that a two year period of your choosing is the maximum length of time for which the report can be run.
    2. Leave the Provide ExportBuilder Options checkbox unchecked.  It is NOT relevant to report generation.

  NOTE: This option is used to provide access to an ExportBuilder corresponding to the ReportBuilder with which you are working.  AWARDS ExportBuilders - which are designed for use by individuals who are familiar with export files and formats, their design, and setup - harness the power of ReportBuilder functionality and take it a step further to meet a variety of outside reporting needs.  With ExportBuilders, users can create customized data reports as they would with the ReportBuilder itself, and from those reports generate export files of a number of different types - CSV, TXT, XLS, or XML.  Exported files can be saved to your computer, then uploaded into other data collection systems and/or worked with in other applications as needed.  Additionally, as can be done with ReportBuilders, ExportBuilder formats can be saved and shared for future use.

The instructions provided here detail use of the Service Contacts ReportBuilder only, not the corresponding ExportBuilder.  For more information on using ExportBuilders, click here.

    1. If you would like the report (both its content and an Excel file version) to be sent to your AWARDS Messages module upon its completion, click the Send in AWARDS Message checkbox.  When this option is selected, you need not wait for the report to generate, and can navigate away from the ReportBuilder after finishing the configuration process (in step 14 or 23) - this can be a time-saver, especially when working with reports containing large amounts of data that might otherwise take a while to display in AWARDS.

  NOTE: When using this option the report will remain in your messages for one month, after which time it will be deleted.  (The exact date of deletion will be displayed in red at the top of the report message for your reference.)  If you know you will need the report content after that time, be sure to download the Excel file (Excel File.zip) or HTML content (Report Content.html) attached to the report message.  If you don't download one of these attachments before the message is deleted, you will need to manually re-generate the report if you need access to it in the future.

    1. Use the Select a saved report format drop-down options at the bottom of the page to specify whether you will be generating the report from scratch or using a previously saved report format.  Available choices are to:

  Use a previously saved report format - To generate the report using a previously created and saved format, select that format from this drop-down.  When using this method, you can immediately generate the report without changing any settings.  Alternately, you can first review and modify the settings of the format by checking off the available Provide option to modify settings of saved report format checkbox.

  Start from scratch, without using a previously saved report format - To create your own report format for single-time use or for saving and later re-use, leave the saved report format drop-down blank.

  NOTE: If you (or another user) have previously saved a default report format for this ReportBuilder and program, that format is pre-selected here.  Make changes to the selection as needed, or leave it at its default value.

    1. Click CONTINUE.

If you are using an existing report format and have NOT chosen to view/modify the settings of that format, you are now taken directly to the report page.  Continue with step 24.

  NOTE: If you chose to send the report to yourself via the Messages module (in step 12), a notice is first displayed on the page to let you know that report generation is in process and that the report will be sent to your Messages module upon completion.  You can then navigate away from the page, or wait for the report to complete and then proceed with step 24.   If you did NOT set that option, you can do so now by clicking Send to AWARDS Messages.   

In all other instances, the Options page is displayed.  Continue with step 15.

    1. The Service Contacts ReportBuilder report includes all clients who were enrolled in the selected program(s) at some point during the date range specified in step 7.  In some cases, that may result in duplicate report records in instances where a client has multiple histories in a single program, or a history in multiple programs.  To filter out those duplicates and list each client only once in the report results, click the Unduplicated Client Count checkbox.

  NOTE: When this option is selected, the report contents are limited to the most recent service contact record for each included client.

    1. By default, reception desk data is not included in this report.  If you have access to the Reception Desk module and a non-residential program (or a group of programs that include a non-residential program) was selected in step 5, an Include Reception Desk Records checkbox is shown on this page.  If necessary, click this checkbox to have reception desk data included in the report results.
    2. The remainder of the page is comprised of a list of demographic and service contact variables, grouped by information type, representing data collected in several AWARDS locations:

Intake Form

Face Sheet

Contacts Log

Supportive Services Checklist

Progress Notes

Group Notes

Some variables which are not necessarily found on the above forms are also available; for example, "Age" and "Client ID."

  NOTE: A section for "Date Parts" - common to all ReportBuilders that have date variables available for selection - is also included on this page.  It is intended to allow for greater flexibility of reporting around dates; for example, giving you the option to report out on a month as either a number (1) or a written month (January).

Click the checkbox next to each variable to be included in the report, and/or use the available Check All options as needed.

    1. Click CONTINUE.  The Report Options - Continued page is displayed.
    2. Configure the options in the "Filter Options" portion of the page as necessary to adjust the scope of the report contents.  Set the "Show Individual Detail" and/or "Summary Tables" options to adjust the way in which the contents are displayed.

  TIP: Individual detail report options and/or summary table selections must be set before the report can be generated.  For more information on using the various report options, please click here.

    1. To save the report settings so that this report can easily be re-run in the future, click SAVE REPORT FORMAT.  The Save Report Format dialog box is displayed.

  TIP: If it is not necessary to save the report format and you wish only to view the report contents, please skip to step 23

    1. Configure the fields and options on this dialog box to indicate the specifics of how the format should be saved.

  TIP: For more information on using the save report format options, please click here

    1. Click Save Report Format.  The report format is saved and the Report Options - Continued page is re-displayed.
    2. Click DISPLAY REPORT.  The report is generated and displayed on the ReportBuilder page.

  NOTE: If you chose to send the report to yourself via the Messages module (in step 12), a notice is displayed on the page to let you know that report generation is in process and that the report will be sent to your Messages module upon completion.  You can then navigate away from the page, or wait for the report to complete, and then proceed with step 24. If you did NOT set that option, you can do so now by clicking Send to AWARDS Messages.   

    1. At this time individual detail and/or summary table content can be hidden or sorted as needed.  The report can also be printed or exported to Microsoft Excel.  For more information on working with ReportBuilder report contents, please click here

  NOTE: When working with report data, please keep in mind that:

If the Unduplicated Count option was selected in step 15, only the most recent service contact record for each of the included clients is displayed.

When a report is long enough to require you to scroll down the page to view all of its content, the header row of the data table (individual detail and/or summary) "freezes" at the top of the page.  Similarly, when printing a report that covers more than one page, the header row of any tables split between pages is shown at the top of each page.

The process of generating a Service Contacts ReportBuilder report is now complete.

Service Contacts ReportBuilder Frequently Asked Questions

The following frequently asked questions provide details on the most commonly asked about pieces of the Service Contacts ReportBuilder feature.  Click a question from the list here to navigate directly to the corresponding answer, or scroll through the full list of questions and answers below.

How can I tell which services have been billed/not billed?

How do I build a service contacts report that excludes amended progress note entries?

Is there a way to see which service contacts have been electronically signed?

What do the letters in a "Record ID" mean in services-related ReportBuilders?

When there are multiple signatures on a record, which date populates "Locked by E-Sign Date" on the ReportBuilder?

Who displays as the group leader on ReportBuilders containing data from scheduled group activities?

Why is the "Activity" variable blank or displaying "No Data" in the Service Contacts ReportBuilder report?

Why isn't a note written on a certain date appearing in my ReportBuilder report for that date?

How can I tell which services have been billed/not billed?

A data variable called Invoice ID (Batch ID) is available in the following Services module ReportBuilders for all agencies that use the BillingBuilder:

- Contacts Log ReportBuilder
- Group Notes ReportBuilder
- Progress Notes ReportBuilder
- Service Contacts ReportBuilder

When the Invoice ID (Batch ID) variable is included in one of these ReportBuilders and populated with data, it indicates that the service has been billed/invoiced (meaning that an invoice has been generated and posted to A/R for that service).  If a service is associated with multiple posted invoices, all invoice IDs are reported in the order of the oldest to the newest invoice.

  NOTE: This data field is only populated for program services that are linked to configured billing types. AWARDS hard coded billing types/program services are not included.

Return to the top of the Service Contacts ReportBuilder FAQs list.

How do I build a service contacts report that excludes amended progress note entries?

Currently we do not have a way to filter amendments out of Service Contact ReportBuilders.  One possible workaround though, is to have staff always enter specific text in their amendments (for example, preceding the note text with "Amendment:") so that you could filter out any notes with that text.  Another option is to use Services > Utilization Reports > Progress Notes Report instead of a ReportBuilder.  This will show you the progress notes portion of the services data collection for the period of time you're looking at, without reporting out on amendments separately.

Return to the top of the Service Contacts ReportBuilder FAQs list.

Is there a way to see which service contacts have been electronically signed?

Yes, all of the Services menu's ReportBuilders have an "E-Signed" variable available which, when included in the report, will display "Yes" for records that have been electronically signed.  In addition, the Client History Report will indicate whether an electronic signature has been placed on a client's progress notes, contacts log entries, group notes, service plans, and certain FormBuilder forms.

Return to the top of the Service Contacts ReportBuilder FAQs list.

What do the letters in a "Record ID" mean in services-related ReportBuilders?

The Record ID data variable available for inclusion in services-related ReportBuilders includes a unique ID for each record.  As part of that ID there is a preceding letter code that also identifies the type of each services record; specifically:

P = Progress Note
C = Contacts Log Record
S = Supportive Services Checklist
G = Group Note
A = Group Attendance Record

  NOTE: In the event that there is a combined Contacts Log/Progress Note record included in the report data, the Record ID reflects the Contacts Log ID/Progress Note ID.

Similarly, a combined Group Attendance/Group Note record reflects the Group Attendance ID/Group Note ID.  When a record ID has both A and G codes, it means that the group was scheduled (using the
Group Schedule Setup functionality), the individual was an expected attendee in that group, and he/she was present.  (Keep in mind that if a record ID only has a G code, it does not mean that there is no attendance record; it only means that the group was not scheduled using Group Schedule Setup, and therefore there are no expected attendees though this individual did attend.)

Return to the top of the Service Contacts ReportBuilder FAQs list.

When there are multiple signatures on a record, which date populates "Locked by E-Sign Date" on the ReportBuilder?

If multiple electronic signatures have been applied to a record, the ReportBuilder's Locked by E-Sign Date data variable populates with the date on which the first of those signatures was applied.  It is that date on which the record was locked from further edits.

Return to the top of the Service Contacts ReportBuilder FAQs list.

Who displays as the group leader on ReportBuilders containing data from scheduled group activities?

The name of the ReportBuilder data variable used to report on a group's leader, as well as where the group leader information is pulled from, varies based on whether a group note has been written.  Specifically:

  In the Service Contacts ReportBuilder - The "Leader" data variable displays the scheduled group leader (set under Services > Group Schedule Setup > Group Schedules), unless there has been a group note written for the group.  In such cases the Leader data variable will reflect the writer of the group note.

  In the Group Activity Attendance ReportBuilder - The "Leader" data variable displays the scheduled group leader (set under Services > Group Schedule Setup > Group Schedules), unless there has been a group note written for the group.  In such cases the Leader data variable will reflect the writer of the group note.

  In the Group Notes ReportBuilder - There is no data variable for "Leader" because AWARDS assumes that the writer of the group note is the group leader.  Activities entered without group notes are not included in the report.

Return to the top of the Service Contacts ReportBuilder FAQs list.

Why is the "Activity" variable blank or displaying "No Data" in the Service Contacts ReportBuilder report?

Activity records are created for group notes only when the user has recorded a note for a scheduled group.  Notes written for unscheduled groups do not create activity records, so the activity information for them will be blank.

Return to the top of the Service Contacts ReportBuilder FAQs list.

Why isn't a note written on a certain date appearing in my ReportBuilder report for that date?

For each note three distinct dates are captured - the contact date, the date written, and the date last modified.  While the label on the progress note itself always refers to "date written," the system relies on behind-the-scenes preferences to determine whether what is shown there is in fact the date written, or is instead the date last modified.  In the case of service contact ReportBuilders through, it will always show you the data that you request.  If you choose to include the "Date Written" data variable for example, it will always show you the true value for when the note was written.  If you are seeing a discrepancy between the date written on the note and the date written for that note in a ReportBuilder, it is an indication that your database has been set up to display the date last modified on progress notes rather than the true date written.

If you would like us to adjust how progress notes work in your database so that the date written always shows you the true written on date on both the note and in ReportBuilders, please contact the Help Desk; otherwise, you may choose to change the selections in your ReportBuilder report from "Date Written" to "Date Modified" - doing so would result in your report and the notes display being consistent.

Return to the top of the Service Contacts ReportBuilder FAQs list.

  https://demodb.footholdtechnology.com/help/?11577