Using the Demographics ReportBuilder







Previous Topic  Next Topic 

  TIP: Looking for frequently asked questions about the Demographics ReportBuilder?  Jump down to the bottom of this page!

The Demographics ReportBuilder, located in the Reports module, is used to generate customized reports of detailed client demographics information as recorded at intake/admission, at discharge, and on the face sheet.  To create and save a Demographics 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:

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

    1. Click the Program drop-down arrow in the upper-right corner of the page and select the individual program for which the report is to be run, or select a group of programs using one of the available "All" or "Custom Grouping" selections.
    2. If you previously bookmarked the Demographics ReportBuilder it is displayed on the reports index by default; otherwise, from the left-hand menu bar, click All or ReportBuilders under "Show Reports."
    3. Use the navigation features in the bottom-right corner to locate the Demographics ReportBuilder in the index, or enter "demographics reportbuilder" in the Search field in the upper-right corner.
    4. Click Demographics ReportBuilder from the reports index.  The ReportBuilder Settings page is displayed.

    1. 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 16).

  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 date ranges specified in steps 7, must be set each time the report is run.

    1. By default, the report only looks for clients with program histories (of the type specified in the previous step) during the past year.  In the From and To fields, make changes to the default date range as necessary (using mm/dd/yyyy format or the available 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.  To limit report contents to those records for a single client only, click the Select Client radio button.  Click the corresponding drop-down arrow (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.)  To run the report for all clients, skip this step.
    3. 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 Demographics 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 12 or 19) - 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.

  TIP: In the saved report format list there are several built-in formats made available by Foothold Technology, each prefixed by "Foothold - ".  Most of these saved formats are designed for Data Quality purposes.  Other available built-in formats include:

- Foothold - Missing Address or Phone - Displays a list of clients with missing address and/or phone data, broken out by program.  It is useful for new programs and agencies interested in ensuring complete census data entry, and it can also be used to audit records prior to using E-Prescribing and/or E-Labs functionality.  (For agencies who use E-Labs and/or E-Prescribing, address and phone values must be entered on a client's face sheet in order to access those systems.  If any of the required information is not present, you will receive a pop-up error notifying you that one or more of these required fields are missing; the missing data will need to be entered before proceeding with either of these functions.)

  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 21.

  NOTE:  If you chose to send the report to yourself via the Messages module (in step 10), 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 21.   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 13.

    1. The demographics report includes all clients who were enrolled in, admitted to, or discharged from the selected program(s) during the specified date range, based on the selections made in steps 6 and 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 to list each client only once in the report results, click the Unduplicated Client Count checkbox.

  NOTE: When the Unduplicated Client Count option is selected, only the information for the client's most recent program history is included in the report contents.

    1. The Options page contains a list of client characteristic checkboxes representing data collected in several AWARDS locations - including the intake form, face sheet, discharge form, and FormBuilder forms - grouped by the data's originating location.  Several other characteristics which are not necessarily found on these forms are also available; for example, "Age," "Age at Intake," and "Client ID."

  NOTE: When reviewing the selections on this page, note that:

The client characteristics available for selection are those that the agency collects for the selected program or program group.  If a program group was selected the available characteristics are those collected for any program in that group.

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).

Client characteristic selections with an asterisk (*) next to them are those for which a client may have multiple values.  Multiple value fields include those that have checkboxes for data entry where multiple boxes may be checked for each client, as well as instances where multiple records may have been entered for a client.

Click the checkbox next to each variable to be included in the report.

    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 20

    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 10), 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 21. 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 the following:

The report shows the values for each characteristic as of the date on which the report is generated.  For example, if a client's martial status on his or her date of intake was "Married," but it has since changed to "Divorced," the report shows him or her as divorced, even when the report is run with the date range set to include the client's intake date.

When the report includes multiple value characteristics (those with an asterisk next to them on the initial Report Options page), the individual detail for each client includes a list of the characteristic values separated by commas.  Additionally, because each client may have more than one value, the summary table totals information for any multiple value characteristic may not add up to the total number of clients.

If a report's results include fewer than 5,000 records, the data comes from the live database.  If the report's results include more than 5,000 records, the data comes from the previous night's database backup, and it is exported to a data file rather than displayed on the screen.  The number of records included in the report, and the link to the data file (if applicable), is displayed on the Demographics ReportBuilder page.

 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 Demographics ReportBuilder report is now complete.

Demographics ReportBuilder Frequently Asked Questions

The following frequently asked questions provide details on the most commonly asked about pieces of the Demographics 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.

Are the Demographics Report contents limited to information for active consumers?

Can I limit access to the Demographics Report so that it can only be run once a month?

Can I run the demographics report for "All Agency Programs" even if I don't have chart access to them all?

How is the "intake/admission data entry date" determined when included as a report variable?

What contact information is included in the Demographics ReportBuilder?  A client has more than one record for a contact type, but only one is showing up.

What is the difference between "Entitlements" and "Benefits?"

What is the difference between "Length of Complete Stay" and "Length of Program Stay?"

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

Where does "Last Contact Date" information come from on the Demographics ReportBuilder and other AWARDS ReportBuilders?

Where does "Last Visit" information come from on the Demographics ReportBuilder and other AWARDS ReportBuilders?

Where is Employment Status data pulled from?

Which vital signs data is shown in the report when there is more than one vital signs record for a client?

Why aren't all special needs categories represented in summary tables when that is a report variable?

Why aren't Provider roles that are entered as "Other" included in the Demographics ReportBuilder?

Why do the "children detail" variables not correctly identify how many children a consumer has?

Why don't I get the correct results when I try to use the Demographics ReportBuilder to do a "point-in-time" count?

Why don't I see the same variables when running the report for different programs / groups of programs?

Why is a change I made to a consumer's record not immediately reflected in the report?

Why is Medicaid # information sometimes blank on the report?

Why is there a discrepancy between the demographics report and another report in AWARDS?

Are the Demographics Report contents limited to information for active consumers?

Which consumers are included in the report contents is based on the program history type chosen on the initial report settings page using the Roster Date Range selection option. Specifically, when "In Program" is chosen, 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. When "Admitted" is chosen 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. And when "Discharged" is chosen 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.  "Admitted or Transferred In" and "Discharged or Transferred Out" are additional options available in databases set up to use the Transfers module.

Return to the top of the frequently asked questions list.

Can I limit access to the Demographics Report so that it can only be run once a month?

No, such limitations are not possible.

Return to the top of the frequently asked questions list.

Can I run the demographics report for "All Agency Programs" even if I don't have chart access to them all?

All users have an "All Agency Programs" option in their program selection list, including in the Profile module where the demographics report is located.  That option can be used when running the demographics report; however, it is important to note that "All Agency Programs" only includes all of those agency programs to which the user has chart access.  There is no way to run the report for programs to which you do not have chart access permission.

Return to the top of the frequently asked questions list.

How is the "intake/admission data entry date" determined when included as a report variable?

The intake/admission data entry date report variable generally reports the date on which an admission was processed (which can differ from the actual admission date).  In programs using the Process Intake component of multi-step intake/admission however, this variable instead reports the date on which intake was processed, and that date is not overwritten when the admission is later processed.

  NOTE: If intake/admission is re-processed, the original intake/admission data entry date is not overwritten.

Return to the top of the frequently asked questions list.

What contact information is included in the Demographics ReportBuilder?  A client has more than one record for a contact type, but only one is showing up.

A limited amount of contact information is available for inclusion when using the Demographics ReportBuilder in the Profile module.  Specifically, you can choose to report on the name, preferred contact method and value, and address; however, the report data is limited to one contact for each contact type.  Which contact record is included for each type is determined by the following rules:

  If there are multiple contact records of a given type, and only one of those contacts is specified as the "primary contact," that primary contact is included in the report.

  If there are multiple contact records of a given type, and more than one of them is specified as a "primary contact," the primary contact that was updated most recently is included in the report.

  If there are multiple contact records of a given type, and none of those contacts is specified as a "primary contact," the contact that was updated most recently is included in the report.

  If there is only one contact of a given type, it is included in the report regardless of whether or not it has been specified as a primary contact.

  TIP: For questions on which record(s) were updated most recently, the "Record Information" variables available in the Contacts ReportBuilder will enable you to see the specifics of who updated each contact record and when.

For more comprehensive and detailed contact information, use the Contacts ReportBuilder in the Medical module rather than the Demographics ReportBuilder.

Return to the top of the frequently asked questions list.

What is the difference between "Entitlements" and "Benefits?"

When included in the Demographics ReportBuilder, the "Entitlements" data variable provides a list of all current entitlements entered for the individual within the Entitlements module Certified Entitlements feature.  The "Benefits" data variable provides a list of all active entitlements entered for the individual under "Insurance/Subsidized Payments Information" in Certified Entitlements records, along with any Eligibilities and Non-Cash Benefits recorded on his/her Referral Information form.

Return to the top of the frequently asked questions list.

What is the difference between "Length of Complete Stay" and "Length of Program Stay?"

"Length of Complete Stay" displays for agencies set to use the optional Transfer functionality, and refers to the total length of stay for the client throughout all of the transfer records that are part of the program history in the row. This is a count of days from the (original) admission date to the (final) discharge date of the series. If there is no discharge date, the current date is used.  "Length of Program Stay" calculates the days spent in each specific program that is part of the transfer record.

Return to the top of the frequently asked questions 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 frequently asked questions list.

Where does "Last Contact Date" information come from on the Demographics ReportBuilder and other AWARDS ReportBuilders?

The "Last Contact Date" is the last date for which a contacts log record, supportive services checklist record, progress note (both F2F and non F2F), or group note (both scheduled and unscheduled) was recorded.

Return to the top of the frequently asked questions list.

Where does "Last Visit" information come from on the Demographics ReportBuilder and other AWARDS ReportBuilders?

The "Last Visit" is the last date for which attendance data was recorded for the client with the Reception Desk module Program Attendance feature OR for a scheduled activity with the Services - Group module's Activities feature for both expected and unexpected members.  A "Last Visit" value of "Never" indicates that the client does not have any program attendance recorded.

  NOTE: Unscheduled group attendance does not create "Last Visit" data.

Return to the top of the frequently asked questions list.

Where is Employment Status data pulled from?

Employment Status and data for related follow-up questions comes from the "Miscellaneous" section of the face sheet.

Return to the top of the frequently asked questions list.

Which vital signs data is shown in the report when there is more than one vital signs record for a client?

When vital signs data variables are included in the Demographics ReportBuilder, they report out on the most recent value for each selected item separately, rather than reporting the values contained in the most recent vital sign record as a whole.  For example, if height and weight were saved in a vital signs record on June 15th and then on July 15th a new record was created containing only blood pressure, the Demographics ReportBuilder will display the height and weight data collected in June and the blood pressure data collected in July.  (If there is more than one row of data for a client on the report, it is an indication that he/she was enrolled in the program more than once during the report date range.)

Return to the top of the frequently asked questions list.

Why aren't all special needs categories represented in summary tables when that is a report variable?

If there is no data for a particular special needs category in the specified report date range, that category does not appear in the summary table.

Return to the top of the frequently asked questions list.

Why aren't Provider roles that are entered as "Other" included in the Demographics ReportBuilder?

Because an individual can have multiple "Other" assignments, that information is not available for inclusion on the Demographics ReportBuilder.  To see those assignments detailed on an aggregate report, use the Providers ReportBuilder under Medical > Providers.

Return to the top of the frequently asked questions list.

Why do the "children detail" variables not correctly identify how many children a consumer has?

The "Children Detail" information (ages and gender) is pulled from the client's intake record, not his or her household information form.  As a result, if two children were recorded for the client at intake, only those two children are included in the demographics report, regardless of how many were entered on the household information form.  If the child detail information entered at intake is incorrect, it can be corrected by opening the client's intake form within the Intake module and making the changes there.

Return to the top of the frequently asked questions list.

Why don't I get the correct results when I try to use the Demographics ReportBuilder to do a "point-in-time" count?

While the Demographics ReportBuilder allows you to select a particular date range for the census, the information displayed on the report is the most up-to-date information for any particular consumer record.  To run a "point-in-time" count for a program, you should either use the Demographics ReportBuilder with a date range limited to the day of the count, or use the Residence History option on the Housing Report.

Return to the top of the frequently asked questions list.

Why don't I see the same variables when running the report for different programs / groups of programs?

The client characteristics/report variables available for selection when running a demographics report are those that the agency collects for the program you are running the report for.  If you chose to run the report for a group of programs instead, the available characteristics are those collected for any program in the agency.  Differences in which variables are available for selection are the result of different program setups.

Return to the top of the frequently asked questions list.

Why is a change I made to a consumer's record not immediately reflected in the report?

There are two possible causes when demographics reports are not immediately displaying information updated in the same database login session.  First, it may be indicative of a memory cache issue.  To get around this, press <CTRL+R> while viewing the report page, or click your browser's refresh icon.

Second, if a report's results include fewer than 5,000 records, the data comes from the live database and should reflect what's currently in client and household member records.  If the report's results include more than 5,000 records, the data comes from the previous night's database backup, and is exported to a data file rather than displayed on the screen.  As a result, any changes made to records between the time of the backup and when the report was run will not be reflected in the report data.

Return to the top of the frequently asked questions list.

Why is Medicaid # information sometimes blank on the report?

This data variable is designed to show the CURRENT Medicaid #


The Demographics ReportBuilder "Medicaid #" data variable is designed to show the number associated with the CURRENT "Medicaid" or "MEDICAID" record.  In order for data to be pulled into the report for this variable:

-  The eligibility entered in the Entitlements module Certified Entitlements feature must be named exactly "Medicaid" or "MEDICAID."  Any variation in the naming of the entitlement record (for example, "Healthfirst Medicaid" or "Medicaid Managed Care") will result in the report value being blank.

- The expiration date on the corresponding entitlement record must be blank or dated in the future.

Return to the top of the frequently asked questions list.

Why is there a discrepancy between the demographics report and another report in AWARDS?

The demographics report may not collect its information from the same location as other AWARDS reports.  For example, the Program Profile and Demographics reports look at different information when calculating the number of families served in a program.  Specifically, the Program Profile report households count pulls its information from the face sheet household information form.  The Demographics report looks at the individual/family type selection on the intake form.  Differences in the data entry in these two locations would account for discrepancies in the totals between the two reports.  Additionally, in this example if there is one household with multiple intakes, each of those will be counted separately in the Demographics report which will also affect the totals.

Return to the top of the frequently asked questions list.

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