Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printablefalse

Data

Source Histories

Sources History Overview

Data Source HistoriesSources History was implemented as a separate page that can be found via navigator.

Info
  • Only users with an admin role can access the Data Source HistoriesSources History page, namely ServiceNow [admin] and PBI admin.

  • Non-admin users - PBI Editor and PBI Viewer - don’t have access to view the Data Source HistoriesSources History page. However, all their actions with the data source will be logged in the Data Sources History table.

Info

The feature is available in version 1.6.6 (or higher) of Power BI Connector.

data_sources_history.gifImage Added

The Data Source History table contains records of all actions made to the data sources.

data_source_history_table.gifImage Added

Actions Description

The following table describes operations that can be performed with the data source.

Action Name

Description

Create

The action is triggered when a data source is created. The resulting page is static and contains data of the

Data Source Histories table. Data Source Histories.gifImage Removed

creation moment only, and this data will not be altered after the next modifications.

Data Source Configuration Change

The action is triggered when any of the following fields are set, changed, or removed:

  • Name

  • Description

  • Rows Limit

  • Use field labels for column names

  • Disable editing for other users

  • Allow Groups to Edit

  • Duration in seconds

Delete

The action is triggered when a data source is deleted. The resulting page is static and contains data of deletion moment only, and this data will not be altered after the next modifications.

Fields Add

The action is triggered when either general or reference fields are added.

Fields Change

The action is triggered when the Use display value option is changed for fields, including reference fields.

Fields Delete

The action is triggered when either general or reference fields are deleted.

Filter Change

The action is triggered when the filter string is set, changed, or removed. This action generates a separate entry for each saved change and for each table.

OData Link Click

The action is is triggered when the OData URL is copied from the portal.

BlankQuery Template Link Click

The action is triggered when the BLankQuery Template is copied from the portal.

Table Add

The action is is triggered when a table or database view is added.

Table Delete

The action is triggered when a table or database view is deleted.

Data Sources History Table Columns Description

By default, the Data Source HistoriesSources History table has the following fieldscolumns:

  • Action

  • Data Source

  • Data Source Name

  • Data Source Configuration Fields

  • Fields, Filters

  • Reference Fields

  • Table

  • User

Default and additional fields.gifImage Removeddefault_and_additional_columns.gifImage Added

The Data Source HistoriesSources History table can be configured by selecting the Personalize List option.

Personalize list.gif

Data Source Histories Table Fields Description

Default

Fields

Columns

  • Additional Fields

  • Default Fields

    Field

    Column

    Description

    Action

    The column shows the name of an action performed with a data source

    (Create, Data Source Fields Change, Delete, Fields Add, Fields Change, Fields Delete, Filter Change, Link Click, Table Add, and Table Delete)

    . See Actions Description.

    Data Source

    The referenced field on the Data Sources page corresponds to the current data source. Navigating to it will open the data source page.

    Info

    The value “(empty)” is setwhen data source has been deleted

    Data Source Name

    The static text

    field

    column used to specify the name of a data source in a particular action moment.

    Data Source Configuration Fields

    The

    field

    column contains a list of configuration fields that have been changed:

    • Name

    ,
    • Description

    ,
    • Rows Limit

    ,
    • Use field labels for column names

    ,
    • Disable editing for other users

    ,
    • Allow Groups to Edit

    ,
    • Duration in seconds

    .
    Info

    The field will be empty if no changes have been made.

    Fields

    The

    field lists

    column shows the fields

    for

    of a particular table that have been changed (e.g. added, deleted, or changed their use display value).

    Info

    The field will be empty if no changes have been made to fields.

    Filters

    The

    field

    column shows the modified filter string for a specific table.

    Info

    The field will be empty if no changes have been made.

    Reference Fields

    The

    field lists

    column shows the Reference Fields for a particular table that have been changed (e.g. added, deleted, or changed their use display value).

    Info

    The field will be empty if no changes have been made. For Table Add and Table Delete action where no fields are present, the field will display [].

    Table

    The

    field

    column displays the name of the table for which changes were made. The Data

    Source

    Source [x_acsof_power_bi_s_datasource] is set for all actions not related to changes with tables or fields.

    User

    The

    field

    column indicates the user who triggered the action, in other words, who made changes.

    Additional

    Fields

    Columns

    Field

    Column

    Description

    Created

    The

    field

    column shows the date when action was triggered (created).

    Data Source URL

    The

    field

    column displays the OData link of the edited data source.

    Created by

    The

    field

    column indicates the user who triggered the action, which is also represented by the User field.

    Export Config

    The

    field

    column contains the full export configuration of the current source, and it’s filled only for Created and Delete actions.

    Updated

    The

    field

    column shows the date when an action row was manually updated in the tab;es, exclusively from the backend.

    Updated by

    The

    field

    column displays the name of the user who updated the action row from the table, exclusively from the backend. By default, it’s Created by.

    Updates

    The

    field

    column shows the number of rows that have been updated, with a default value of 0.

    Tags

    The

    field

    column represents the system SN field and is empty by default.

    Action Description with Examples

    • Create - is triggered when a data source is created. The resulting page is static and contains data of the creation moment only. The data on this page will not be changed after the next modifications.

    Create.gifImage Removedcreaaate.jpgImage Removed
    Data Source Fields Change - is triggered when any of the following fields are set, changed, or removed: Name, Description, Rows Limit,

    Use Case Description

    ➡️ A user creates a data source with the following data source configuration and export configuration.

    data_sources_configuration_fields.gifImage Addedexport_configuration.gifImage Added

    The corresponding record appears in the Data Sources History table.

    • Table Delete - is triggered when a table or database view is deleted.

    tabdel.jpgImage Removed
    • Action: Create → It means a data source has been created.

    • Data Source: Use Case Description → This is the referenced field on the Data Sources page that corresponds to the current data source.

    • Created: 01/04/2024 03:07:55 → These are the date and time when the data source has been created. The format is the following: dd/mm/yyyy hh/mm/ss.

    • Data Source Name: Use Case Description → This is the actual data source name.

    • Data Source Configuration Fields: {"Use display value":"false","Data Source Owner":"Liubov Topchyi ","Duration In Seconds":"false","Use field labels for column names, Disable editing for other users, Allow Groups to Edit, Duration in seconds.

    dsfc1.jpgImage Removeddcfc2.jpgImage Removed

    • Delete - is triggered when a data source is deleted. The resulting page is static and contains data only of deletion moment. The data on this page will not be changed after the next modifications.

    del1.jpgImage Removeddel2.jpgImage Removed

    • Fields Add - is triggered when either general or reference fields are added.

    ffff1.jpgImage Removedf3a.jpgImage Removed

    • Fields Change - is triggered when the use display value is changed for fields, including reference fields.

    f1.jpgImage Removed

    • Fields Delete - is triggered when either general or reference fields are deleted.

    f2d.jpgImage Removed

    • Filter Change - is triggered when the filter string is set, changed, or removed. This action generates a separate entry for each saved change and for each table.

    fil1.jpgImage Removedfil2.jpgImage Removed

    • OData Link Click - is triggered when the OData URL is copied from the portal.

    od1.jpgImage Removedod2.jpgImage Removed

    • BlankQuery Template Link Click - is triggered when the BLankQuery Template is copied from the portal.

    bl1.jpgImage Removedbl2.jpgImage Removed

    • Table Add - is triggered when a table or database view is added.

    tab1.jpgImage Removedtabad.jpgImage Removed

    • ":"false","Description":"This data source is created for the test purposes."… → This is the configuration that has been selected by the user during data source creation.

    • Table: Data Source [x_acsof_power_bi_s_datasource] → This value is set when actions are not related to changes with tables or fields. During the data source creation, the user just selected tables and fields and didn’t make any changes.

    • User: Liubov Topchyi → This is the user name who performed the action.

    data_sources_history_record_1.gifImage Added

    If you select the Create action (from the previous screen), you can see the detailed description of the Data Source History record. In particular, in the Export Config field, you can see what table and fields have been selected.

    data_sources_history_record_details.gifImage Added

    ➡️ The user then has added one more table with its fields.

    export_config.gifImage Added

    After this, one more record appears in the Data Source History table.

    • Action: Table Add → It means the user has added an extra table to the data source.

    • Data Source: Use Case Description → This is the referenced field on the Data Sources page that corresponds to the current data source.

    • Created: 01/04/2024 04:10:50 → These are the date and time when the data source has been created. The format is the following: dd/mm/yyyy hh/mm/ss.

    • Data Source Name: Use Case Description → This is the actual data source name.

    • Table: Activity Event [sys_activity] → This is the name of the table that has been added by the user.

    • Fields: [{"name":"sys_created_on","displayValue":false}… → This is a list of fields that have been added by the user.

    • Reference Fields: [] → This value is set when the added table does not include any reference fields. See the Default Fields section.

    data_sources_history_record.gifImage Added

    ➡️ Another user decided to export this data source using the OData link.

    export_with_odata_feed.gifImage Added

    Another record appears in the Data Sources History table.

    • Action: OData Link Click → It means that the user has clicked Copy OData URL.

    • Data Source: Use Case Description → This is the referenced field on the Data Sources page that corresponds to the current data source.

    • Created: 01/04/2024 04:10:50 → These are the date and time when the data source has been created. The format is the following: dd/mm/yyyy hh/mm/ss.

    • Data Source Name: Use Case Description → This is the actual data source name.

    • Table: Data Source [x_acsof_power_bi_s_datasource] → This value is set when actions are not related to changes with tables or fields.

    • User: Lilli Belward → This is the user name who performed the action.

    odata_link_click.gifImage Added

    Useful Tips

    How to Find Deleted Data Source

    • In the Action Search field, enter Delete.

    search_action.gifImage Added

    • You will see a list of all deleted data sources. Here you can find the required data source by its name.

    list_of_deleted_data_sources.gifImage Added

    • If you don’t remember the name, you can compare the deleted data source URL and URL in your Microsoft Power BI.

    details.gifImage Addeddeleted_data_source_URL.gifImage Added

    How to View Data Source History for Particular Data Source

    1. Find the required data source.

    2. Under the Data Source field, select its name.

    select_data_source.gifImage Added

    1. Scroll down and you will records for a particular data source.

    data_source_histories.gifImage Added

    How to Clear Data Sources History for Specific Data Source
    Status
    colourGreen
    titlenew

    Info

    Starting with version 1.6.15 of Power BI Connector for ServiceNow, you can clear data sources history.

    1. Via Navigator, find and select Data Sources History (under Power BI Connector for ServiceNow).

    sn-navigator-power-data-soures-history.gifImage Added

    1. Find and select the data source you need.

    data-soures-history-select-entity.gifImage Added

    1. Select Clear Data Source History.

    data-soures-history-clear-data-source-history.gifImage Added

    1. Select Start Date and End Date, and then select Submit.

    start-date-end-date-submit.gifImage Added

    How to Clear Data Sources History in Bulk
    Status
    colourGreen
    titlenew

    1. Via Navigator, find and select Data Sources History (under Power BI Connector for ServiceNow).

    sn-navigator-power-data-soures-history.gifImage Added

    1. Select entities of Data Sources History you need.

    Info

    It might be entities of a single data source or of multiples data sources.

    select-entities.gifImage Added

    1. Select Actions on selected rows, and then select Delete.

    select-action-on-selected-rows-delete.gifImage Added

    1. Select Delete.

    select-action-on-selected-rows-delete-confirmation.gifImage Added