• 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 (optional)
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: the first day of the preceding calendar month
• 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)

  If you are using report_date periods, report_to_date=true will include all activity for the requested periods plus activity in the current period up to the current date and time.  If report_to_date=false, the report will only include activity for the requested periods.

  • Possible Values: true or false
  • Default Value: true
• Example:
  • If report_to_date = true, the end date is always the date the report is run, up to and including the most recent database refresh.
  • If report_to_date = false, the end date is the last day of the previous interval. For instance, if today is December 31, the ‘Previous [n] Months’ ends on November 30 and the ‘Previous [n] Years’ ends on December 31 of the prior year.
• 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
• BCS Parameter: asset_list
  • Possible Values: CSV list of <book_asset_id> values
  • Default Value: All available

• Description: Provides the ability to select all or specific asset categories and sub-categories.
  • Categories and sub-categories can be selected independently of each other.
  • Selecting an asset category will include all sub-categories for that value.
  • You can also select sub-categories individually.
• Control Type: Multi-select
• BCS Parameter: asset_category
  • Possible Values: 1 (Books), 21 (Videos)
  • Default Value: All available
• BCS Parameter: asset_subcategory
  • Possible Values: See the tables below for a list of sub-categories available for each category. There are no sub-categories for the Videos category.

• Description: Provides the ability to select Books and Videos collections to include in the report.
• Control Type: Multi-select
• BCS Parameter: collection_list
  • Possible Values: CSV list of <collection_id> values
  • Default Value: All available

• 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: Multi-option
• BCS Parameter: date_filter_field
  • Possible Values: first_access_date, last_access_date

Static Dates

To enter static dates, use the following parameters with a specific date for the filter_start_date and filter_end_date parameters:

• BCS Parameter: filter_start_date (optional)
  • Possible Values: <date_value in the format MM/DD/YYYY>
  • Default Value: the first day of the preceding calendar month
• 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. In this instance, the date values are dynamic and will update each time the report is run.

Dynamic Dates

For dynamic dates that change each time the report is run, 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

If you are using filter_date periods, filter_to_date=true will include all activity for the requested periods plus activity in the current period up to the current date and time. If filter_to_date=false, the report will only include activity for the requested periods.

• BCS Parameter: filter_to_date (optional)
  • Possible Values: true or false
  • Default Value: true
• Example:
  • If filter_to_date = true, the end date is always the date the report is run, up to and including the most recent database refresh.
  • If filter_to_date = false, the end date is the last day of the previous interval. For instance, if today is December 31, the ‘Previous [n] Months’ ends on November 30 and the ‘Previous [n] Years’ ends on December 31 of the prior year.

• Description: Provides the ability to specify a seat status.
• Control Type: Single-select
• BCS Parameter: seat_status
  • Possible Values: 0 (deleted), 1 (occupied), 2 (Any)
  • Default Value: Any

• 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 a Books and Videos subscription for a list of all subscriptions associated with the Skillport site.
• Control Type: Single-select
• BCS Parameter: subscription_id
  • Possible Values: <books_subscription_id>
  • Default Value: Company subscription id

• 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 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 filter data based on user profile fields that have been configured and enabled on the User Profile page.
• Control Type:  Logical filter
• BCS Parameter: N/A

• Description: Provides the ability to include assets with no activity.
• Control Type: Single-select check box
• BCS Parameter: show_assets_with_no_activity
  • Possible Values: 0 (don’t show), 1 (show)
  • Default Value: Don't show

• Description: Used to determine how records that contain field(s) that could have multiple values (such as a user that exists in multiple groups) present or stored the data in the report. If multiple rows are selected, a record will be provided for every instance.
• Control Type: Single-select
• BCS Parameter: show_multiple_groups
  • Possible Values: 1 (multiple rows), 2 (single row)
  • Default Value: Multiple rows

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

• Description: The title of the collection, for example, ITPro or BusinessPro.
• BCS Value: collection_title

• Description: User's login name.
• BCS Value: skillport_username

• Description: The type of asset sub-category.
• BCS Value: asset_subcategory

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

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

• Description: The total number of times that a book or video was viewed by all users.
• BCS Value: count_of_asset_session_launches

• Description: The number of Chapters to Go files downloaded by the specified user during the specified time range.
• BCS Value: count_of_chapter_to_go_downloads

• Description: The user's first name.
• BCS Value: user_first_name

• Description: The organization code associated with the group.
• BCS Value: group_orgcode

• Description: The number of page views during the specified time range.
• BCS Value: count_of_pages_viewed

• Description: The user's last name.
• BCS Value: user_last_name

• Description: The number of downloads by the specified user during the specified time range.
• BCS Value: count_of_other_downloads_for_user

• Description: Unique character string used to identify Books and Videos subscriptions.
• BCS Value: bs_subscription_display_name

• Description: The number of video files launched by users in the subscription(s) during the specified time range. Applies to subscriptions that include LDC only. Does not count embedded videos launched from a Skillsoft Advantage product.
• BCS Value: count_of_video_launches

• Description: The description of the asset.
• BCS Value: asset_description

• Description: The author/speaker in the video asset.
• BCS Value: b24x7_speaker

• Description: The copyright date of the asset.
• BCS Value: b24x7_copyright_date

• Description: The user's first name as it appears in Skillport.
• BCS Value: cud_display_first_name

• Description: The user's last name as it appear in Skillport.
• BCS Value: cud_display_last_name

• Description: The email address of the user.
• BCS Value: cud_user_email

• Description: For courses, this is the expected duration of the asset. For videos, audio books, and recorded sessions, this is the actual run time. 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 expiration date of the video asset.
• BCS Value: b24x7_expire_date

• Description: The name of the group.
• BCS Value: group_title

• Description: The path to the group's location based on the hierarchy configured in Skillport.
• BCS Value: group_path

• Description: The ISBN for the title. For assets that do not have ISBN numbers, such as videos, this value is blank.
• BCS Value: b24x7_ISBN

• Description: The user's geographic location (for example, where the user's office or branch is located).
• BCS Value: cud_location

• Description: The publisher or producer of the asset.
• BCS Value: b24x7_publisher_or_producer

• Description: The date the asset was published to the Skillport site. This field only includes data for Book assets.
• BCS Value: b24x7_site_published_date

• Description: The Skillport database internal userid field.
• BCS Value: cud_user_id

• Description: The user's status: Activated, Deactivated, or Pending.
• BCS Value: user_status