We have a new community! Please visit support.timextender.com
Follow

How to Configure the TX Dictionary project

Visualize your TimeXtender metadata with TX Dictionary

The TX Dictionary project allows developers and business users alike to benefit from the valuable insight provided by TimeXtender's metadata. Once deployed & executed, this project extracts the raw data from TimeXtender's project repository and transforms it into a denormalized data warehouse format ready for reporting and analysis. 

With this project you can:

  1. Provide an always up-to-date Data Dictionary to your business users in the reporting tool of your choice including custom object definitions & data lineage. 
  2. Analyze execution packages in detail to improve performance & pinpoint problem areas.
  3. See detailed execution messages over time. 
  4. Report on validation errors and warnings counts over time. 

Below is an example dashboard analyzing execution performance. 

2018-08-31_16h48_26.png

 

To learn more about the tables and fields available in the TX Dictionary project you can download the 'TX Dictionary Table & Field Descriptions' excel file at the bottom of this article. It contains descriptions of all the tables and fields in the presentation layer as well as a simple data model. 

2018-08-31_16h42_24.png

Download and Configure the TX Dictionary Project

Download the TX Dictionary Project from the Cube Store

  1. In the File Menu, click CubeStore.
  2. Click TXDictionary in the list
  3. Click Request Trial
  4. Click Download

TXDictCubeStoreDownload.png

  

Once imported Select ‘Yes’ to run the Connection Manager

 

In the Connection manager, Click Run Wizard. The wizard will open the "edit" dialogue for each of the database connections in the project. 

  1. Create an ODX database
  2. Connect to an existing MDW Database (Optional)
  3. Connect to an existing Project Repository and ‘Test Connection’
  4. Create an MDW database
  5. Create a DSA database
  6. Create an OLAP Server (Optional)
    • *If you do not have an OLAP server, or plan to use an SSAS Multidimensional OLAP database for analysis, you should delete the OLAP server in the project later. 

 

Once complete, click ‘Test Connections’ and validate the Connection States are all green.

 2018-08-29_01h11_05.png

 

Finally, be sure to Deploy and Execute the Project.

 

Dashboards included with TX Dictionary

Excel Pivot Table Report

The Excel Pivot Table Report works with the included SSAS Multidimensional OLAP Cube as a data source. Ensure you have deployed and executed the OLAP cube included in the TX Dictionary Project. If the Cubes are guarded, right-click the cube and under advanced click Gaurd. 

Download and open the attached "Data Dictionary Pivot Table Report.xlsx" 

In the Analyze tab click Change data source. 

2018-05-01_17h00_19.png

Point Excel to the OLAP server created by the TX Dictionary Project. If you are unsure what this is called, open the project and edit the OLAP server to see the proper name. It should be called "TXDictionary_OLAP"

Once this is done, in the Analyzed tab, click Refresh All. You may need to remove and re-add the pivot table "rows" to get the dashboard to update properly. 

2018-05-01_17h03_09.png

 

Qlik App

The Qlik App provides easy access and reporting on your repository.  There are 4 Dashboards included as part of the TX Dictionary, Execution Time, Failed Executions, and Data Quality. This App connects to the "TXDictionary" Semantic Model, with an added Qlik Endpoint.

2018-08-29_02h00_42.png

Qlik App Installation Instructions:

  1. In the TX Dictionary TimeXtender project, Add a Qlik Endpoint to the TXDictionary Semantic Model & Deploy. 
  2. Right Click on the Endpoint>Qlik Sens Scripts.
  3. Copy the Qlik Script from the Endpoint.
  4. Download the  ‘TX Dictionary.qvf’ file at the end of this article and place into your Qlik Apps folder.
  5. Open the app in Qlik and navigate to the 'Data load editor'. 
  6. In the section called TX DWA (auto-generated) delete any existing script. 
  7. Paste in the script copied from the Qlik Endpoint & Load Data. 

 

Tableau Workbook

The Tableau Workbook provides 4 dashboards including Data Dictionary, Execution Time, Execution Status, and Data Health. 

2018-08-29_01h41_04.png

Tableau Workbook Installation Instructions:

  1. In the TX Dictionary TimeXtender project, Add a Tableau Endpoint to the FieldData and Executions Semantic Models & Deploy. Remember the file path where the TDS files are stored. 
  2. Download The 'TXDictionary.twb' file at the end of this article and open with Tableau. 
  3. Under the 'Data' menu, and under 'FieldData' click 'Replace Data Source...'
  4. Select the FieldData TDS file created earlier. 
  5. Now repeat the last two steps for the 'Executions' Data Source. 

PowerBI Report

The PowerBI report contains 4 sheets including a data dictionary, executions, failed executions, and data quality. This report operates from an SSAS Tabular model. *An SSAS Tabular instance is required. 

  1. In the TX Dictionary TimeXtender project, Add a Tabular Endpoint to the TX Dictionary Semantic Model and Deploy & Execute. Remember the server and database name of your tabular model.  
  2. Download the 'TXDictionary.pbix' file at the end of this article and open with PowerBI. 
  3. Open the pbix file and you will receive an error message like this. 
    1.  2018-08-31_16h54_17.png   Click Edit. 
  4. Put in the server\instance and database name of the TX Dictionary tabular model you deployed in step 1. 
  5. Now click refresh and the report should load with the TX Dictionary data. 

 

 

 

 

Was this article helpful?
1 out of 1 found this helpful

16 Comments

  • 0
    Avatar
    Andri Páll Heiðberg

    Do you perhaps have a similar dashboard in the works for Power BI?

  • 0
    Avatar
    Joseph Treadwell

    Hi Andri, We are working on PowerBI and Tableau dashboards for this as well. 

  • 0
    Avatar
    Padarthi, Satish

    We brought this project from cube store and the cube supports project data dictionary on a spreadsheet. Not sure why its not picking up any changes to our data model,. We did refresh the cube on database, Is there anything else that needs to happen? 

  • 0
    Avatar
    Bas Hopstaken

    I'm missing the Qlik Models in the Data Lineage. Besides that, I'm also waiting for a Power BI version of the TX Dictionary Dashboard. 

  • 0
    Avatar
    Joseph Treadwell

    There is a new version of the TX Dictionary project available in the cube store as well as Power BI and Tableau dashboards added to this article. Let me know how they work for you!

  • 0
    Avatar
    Rory Smith

    The PowerBI dashboard attached does not seem to work with the current state of the TX Dictionary project. I get the following error:

     

    Connecting to the endpoint from a fresh PowerBI report does seem to work. 

    Edited by Rory Smith
  • 0
    Avatar
    Albert Overweg

    We have been using the TXDictionary Tableau workbook and are wondering to what extent this project is maintained as part of the TimeXtender release cycle. Will it be updated when the data model changes?

    Also, is there a reason why schema is not included in Container/Field or Data Lineage? Schemaname in Container quite often incorrectly shows dbo.
    As we are looking to further expand use of the TXdictionary it would be great to see this corrected.

  • 0
    Avatar
    Joseph Treadwell

    Hi Rory, I encourage you to work with your SSP Alex Wijnen on this. 

    Hi Albert, we maintain this project as a convenience to our customers. We make no guarantees on the future of this project. Which leaves you with 2 options. 

    1. Begin your own development on the project and split from our release cycle.  OR
    2. Wait for a new features to be release by our team when we have the capacity to do so. 

    As for the schema issue. I will look into resolving this in a future release. Thanks for the heads up. 

  • 0
    Avatar
    Gerard Cuijpers

    Hi,

    when used with a SSAS Tabular model, the processing of the model can fail when the PackageExecutionTime.ExecutionMessage exceeds 131072 characters (limit for strings in Tabular models)

    https://docs.microsoft.com/nl-nl/analysis-services/tabular-models/data-types-supported-ssas-tabular?

  • 0
    Avatar
    Permanently deleted user

    Hi Gerard, 

    You are correct, in tabular models the string limit is 131072.

    An easy workaround for this is to add a custom transformation on PackageExecutionTime.ExecutionMessage in the MDW. The custom transformation should use the Left() function to return the first 131072 characters. Example below:

    Left([ExecutionMessage], 131072)

  • 0
    Avatar
    Lennaert van den Brink

    Hi, I am trying to configure the TX dictionary project, but when I do a deploy+execute I get the following error on the DSA:

    Could not find server '[myserveradress]' in sys.servers. Verify that the correct server name was specified. If necessary, execute the stored procedure sp_addlinkedserver to add the server to sys.servers.

    I ran the connection manager and all the connections seem valid. What does the error mean and how do I solve it?

    Edit: Found what the issue was: the project has Direct Reads enabled on the Datawarehouse settings of the DSA. Disable them and it works.

    Edited by Lennaert van den Brink
  • 0
    Avatar
    Roy Verharen

    If you want to use only one DSA/MDW database, which can be sufficient for this purpose, make sure you set either the default database schema for the dsa or the mdw other then etl (so etl is only used once). Otherwhise you get conflicting issues (culumns) when running the project.

  • 0
    Avatar
    Peter Jensen

    Can you provide us with information on how to add the mapped custom view fields to the lineage table ?
    We've setup views in our project - using parameters and 'map custom view fields', but they do not appear in the reports.

    We're also missing the mappings of Custom Table Inserts, but that's a common issue (also not available in Data Lineage in TX itself).

     

  • 0
    Avatar
    Ben van der Helm

    Is there some equivelant project for an Azure DB / Synapse environment? 

    When we try to deploy this solution within a Sql pool, we stumble into a lot of errors regarding things that are not available for Azure DB. 

     

  • 0
    Avatar
    Sowjanya Guntupalli

    Is this work with Power BI now? 

  • 1
    Avatar
    Bas Hopstaken

    Will be a new version available in the future that allows monitoring the ODX Server in the TX Dictionary project? And a version for the new V6XXX version as well?

Please sign in to leave a comment.