• Description: Allows the user to determine the date range for all activity for the report.
• Control Type: Multi-option

Use the following parameters to set start and end dates.

• BCS Parameter: report_start_date (required)
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: one month prior to the date the report is run
• BCS Parameter: report_end_date (optional)
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: 'now', or the last successful database refresh

Use the following parameters to set dates for a number of previous intervals, such as, "previous 3 months."

• BCS Parameter: report_date_period (required)
  • Possible Values: 1 (Days), 2 (Weeks), 3 (Months), 4 (Years)
  • Default Value: 3
• BCS Parameter: report_date_period_count (required)
  • Possible Values: valid numeric value with the following maximum value for each report_date_period:

    Days - 9999

    Weeks - 999

    Months - 999

    Years - 99

  • Default Value: 1
• BCS Parameter: report_to_date (optional)

  The report_to_date setting allows you to include all activity up to the current date and time, regardless of the report_date_period chosen.

  • Possible Values: true or false
  • Default Value: true
• BCS Parameter: display_units (optional and used in chart templates only)
  • Possible Values: 1 (Year), 2 (Quarter), 3 (Months), 4 (Weeks), 5 (Days)
  • Default Value: 3

• Description: Provides the ability to select one, many, or all assets in the filter criteria.
• Control Type: Multi-select list
• BCS Parameter: asset_list
  • Possible Values: CSV list of <any_asset_id> values
  • Default Value: All available

• Description: Provides the ability to select specific asset categories.
• Control Type: Multi-select
• BCS Parameter: asset_category
  • Possible Values: 1 (Book), 2 (Course), 3 (Custom Content), 5 (Evaluations), 6 (Express Guides), 7 (External Learning Objects), 8 (Instructor Led Training), 9 (Job Aids), 12 (Learninig Events), 15 (Mentoring), 16 (Practice Labs), 17 (Projects), 18 (Simulations), 19 (SkillBriefs), 20 (TestPrep Exams), 21 (Videos), 22 (Voucher Exams), 23 (Miscellaneous), 24 (Learning Sparks), 25 (Business Impact), 26 (Challenge), 27 (Book Sections), 28 (Course Topics)
  • Default Value: All available
• BCS Parameter: asset_subcategory
  • Possible Values: 0 (chapter), 1 (journal), 2 (reference suite), 3 (execsummary), 4 (execblueprint), 5 (journal style toc), 6 (analyst perspective), 7 (review), 8 (video), 9 (recorded session), 10 (newsletter)
  • Default Value: All available

• Description: Provides the ability to specify a completion status.
• Control Type: Multi-select
• BCS Parameter: completion_status
  • Possible Values: 1 (completed), 2 (in progress), 3 (waived)
  • Default Value: Any

• Description: Provides the ability to filter on one or two fields that exist in the report definition. You can define either an AND or an OR statement when using two filters. The field selector drop-down will include all fields that are available in the report definition.
• Control Type: Logical filter
• BCS Parameter: you cannot specify custom filters when running this report via BCS

• Description: Allows the user to select one event and then filter that event by date.
• Control Type: Single-select
• BCS Parameter: date_filter_field
  • Possible Values: first_access_date, last_access_date, completion_date

Dynamic Dates

For dynamic dates that change each time the report is accessed, use the following parameters:

• BCS Parameter: filter_start_date
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: one month prior to the date the report is run
• BCS Parameter: filter_end_date (optional)
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: 'now', or the last successful database refresh

    Note: Default start and end dates will only be used if a date_filter_field value is entered and the date values are left blank.

Static Dates

For static dates, use the following parameters:

• BCS Parameter: filter_date_period (required)
  • Possible Values: 1 (Days), 2 (Weeks), 3 (Months), 4 (Years)
  • Default Value: 3
• BCS Parameter: filter_date_period_count (required)
  • Possible Values: valid numeric value with the following maximum value for each report_date_period:

    Days - 9999

    Weeks - 999

    Months - 999

    Years - 99

  • Default Value: 1

Filter to Date

The filter_to_date parameter allows you to include all activity up to the current date and time, regardless of the report_date_period chosen.

• BCS Parameter: filter_to_date (optional)
  • Possible Values: true or false
  • Default Value: true

• Description: Provides the ability to include subgroups within the scope of the report.
• Control Type: Single-select check box
• BCS Parameter: select_subgroups
  • Possible Values: 0 (don’t select), 1 (select)
  • Default Value: Don't select

• Description: Provides the ability to specify user statuses.
• Control Type: Multi-select
• BCS Parameter: user_status
  • Possible Values: 1 (activated), 2 (deactivated)
  • Default Value: Activated

• Description: Provides the ability to select one, many, or all users or groups as part of the filter criteria.
• Control Type: Multi-select
• BCS Parameter: user_list
  • Possible Values: CSV list of <username> values
  • Default Value: All
• BCS Parameter: group_list
  • Possible Values: CSV list of <group_orgcode> values
  • Default Value: All

    Note: In some templates the Group or the User filter may not be available. For instance, if the report is group specific then the user filter may be disabled.

• Description:  Provides the ability to filter data based on user profile fields that have been configured and enabled on the User Profile page.
• Control Type:  Logical filter
• BCS Parameter: You cannot specify User Profile filters when running this report via BCS.

• Description: Includes timestamps in all date fields in the report.
• Control Type: Single-select check box
• BCS Parameter: show_date_with_time
  • Possible Values: 0 (don’t show), 1 (show)
  • Default Value: Don't show

• Description: Provides a list of standard time zones so you can determine the presentation of date outputs. When selected, a calculation will be performed on the output during processing to change the date value from UTC to the selected time zone. Default value is GMT.
• Control Type: Single-select
• BCS Parameter: time_zone
  • Possible Values: see BCS SubmitReport Time Zones for a list of acceptable values
  • Default Value: GMT

• Description: The title of the asset.
• BCS Value: asset_title

• Description: The total cumulative duration for all launches in the specified date range for assets for which duration is tracked. Displayed in hh:mm format for Previewed reports, and reports exported to PDF and HTML. Displayed in minutes for reports exported to CSV and Excel.
• BCS Value: sum_of_session_durations

• Description: The type of the asset.
• BCS Value: asset_category

• Description: The ID of the learning asset, for example, COMM0101.
• BCS Value: asset_name

• Description: The average number of accesses per user. This is determined by taking "Accesses" and dividing it by "Unique Users."
• BCS Value: ave_launches_per_user

• Description: The average actual duration per completed asset. Only for assets for which duration is tracked and for which the status is completed. Displayed in hh:mm format for Previewed reports, and reports exported to PDF and HTML. Displayed in minutes for reports exported to CSV and Excel.
• BCS Value: ave_duration_per_user_who_completed

• Description: The average actual duration per user. Only for users that have activity that includes a duration for that asset. Displayed in hh:mm format for Previewed reports, and reports exported to PDF and HTML. Displayed in minutes for reports exported to CSV and Excel.
• BCS Value: ave_duration_per_user

• Description: The expected duration of the asset. Displayed in hh:mm format for Previewed reports, and reports exported to PDF and HTML. Displayed in minutes for reports exported to CSV and Excel.
• BCS Value: asset_expected_duration

• Description: The user's last access during the report's time span. If the course was not launched (no access) during the date range of the report, this field will return no data.
• BCS Value: last_access

• Description: The total number of launches of this specific asset in the specified date range.
• BCS Value: count_of_launches

• Description: The total number of the users who have completed the asset, not including revoked completions.
• BCS Value: count_of_completing_users

• Description: The total number of students who have accessed the asset.
• BCS Value: count_of_accessing_users