Big Data (Admin)
Stratus Big Data makes it easy to build cross-project Power BI dashboards without wrestling with complex APIs or raw data exports. It delivers a clean, aggregated data set with custom calculated fields, a fast API, a simple data model, and the dashboards can be embedded directly in Stratus for in-context reporting.
- 1 Stratus Academy Course Video
- 2 Stratus Setup
- 2.1 Prepare Reports and Fields
- 2.2 Configuration
- 2.2.1 Reports
- 2.2.2 Start Date
- 2.2.3 Run As Admin User
- 2.2.4 Database Connection
- 2.3 Analytics Reports
- 2.4 Sync History
- 3 Power BI Setup from Scratch
- 4 Power BI Setup from Template
- 5 Power BI Training Resources
- 6 Contractor Metrics Recommendations
Stratus Academy Course Video
To take the Big Data course, login to Stratus Academy and and locate the course ADM-521: Big Data.
Stratus Setup
Prepare Reports and Fields
Create new reports and fields dedicated to Big Data Analytics for Models, Packages, Assemblies, and Parts that specify metrics to be captured.
Prepare Fields and Reports Summary:
Big Data Package and Assembly reports are analogous to existing Package and Assembly dashboard reports, and can be configured to extract as many package and assembly data fields as needed.
Report configuration tips:
Dedicated Big Data Reports - Create a dedicated report be created for each of area (Models, Packages, Assemblies, and Parts) and that the reports only be utilized by Stratus Big Data. A single report will specify metrics to be captured in each Big Data area (Models, Packages, Assemblies, and Parts). Any unexpected changes to the referenced reports or fields can cause issues with the Power BI data and republishing data could take up to 2 days to complete.
Permissioned Reports - In addition to creating dedicated reports, it is also recommended that Big Data reports be permissioned to those who are involved in Big Data and creating Power BI reports.
Report Item Types - When creating reports, only the following Report Item Types are allowed:
Models - Parts
Note: The Model report is actually a “Part” item type report and does not work like the others. Report metrics are gathered at the model level, so this report only extracts aggregated column data (the bottom or total row) holding a Sum or Average numeric result.
Packages - Package
Assemblies - Assembly
Parts - Part
Required Properties - Only one report can be specified for each area (Models, Packages, Assemblies, and Parts), so create each report with the required properties that need to be published and used in Power BI. Note: If a report field needs to be added after the database has been published, it can take up to 2 days to publish the database again to include a missed report field.
Report Field Format and Precision - Set the Format to String, Integer, Decimal, Date, and Boolean. If, for example, FeetInch or InchFraction is selected, Big Data will convert it to a Decimal as Power BI does not recognize these as numbers. Configure Precision control to the number of decimal places.
Report Field Built-in Properties - The following Report Field properties are automatically included in reports published to Power BI and do not need to be included as a Report Field of a Report. If they are included, they will be ignored. Below is a list of “built-in properties”.
Report Field Header or Field Display Name - Under Reports > Report Fields, the Header overrides the Property Name. Similarly, under Fields the Display Name overrides the Name. Overriding these names can become confusing in Power BI if more than one field has the same override name. For this reason, it is recommended that Big Data report fields do not use either a Report Field Header or Field Display Name.
Converted Property Names - SQL and/or Power BI requires that Report Field property names follow certain standards, so Stratus helps convert property names. For example, spaces and invalid characters are replaced with an underscore. Below are some examples of how property names will be converted:
STRATUS.Assembly.NumParts to NumberofParts
Package(s) to Package_s_
Spool Name to SpoolName
Model Viewer Checkbox - Check the Model Viewer checkbox while testing and validating the data in the report. Once the report is working as expected, the Model Viewer checkbox can be unchecked.
Configuration
To Configure Big Data:
Go to Admin > Company > Big Data.
Reports
Under Reports, select the report to be used for:
Models
Packages
Assemblies
Parts
Containers
Start Date
The Start Date is used to filter dated Tracking Log and Task entries. Only those entries newer than the Start Date will be published to the Big Data database in Power BI.
Run As Admin User
The user selected under Run As Admin User is required to publish Big Data. The selected user does not require a specific project role and the data is not filtered based on the selected user’s permissions.
Database Connection
The Database Connection section has two parts. The Server and Database values will automatically populate after the full data sync has completed. See the Sync History tab to see the data sync percent complete. The Regenerate SQL User and Password button generates the user name and password that enables login to the database in Power BI. These values will be used when connecting to Power BI. In addition, this section provides an option to rebuild the data after relevant Stratus report fields have changed.
Server and Database - The Server and Database information identifies the database in Stratus Big Data. These values are copy/pasted into the SQL Server database dialog during step 3 of the Power BI Setup process.
Regenerate SQL User and Password - The SQL Server database in step 1 requires a User name and Password. To generate this User name and Password:
Click the Regenerate SQL User and Password button. The Regenerate SQL User and Password prompt will display. In addition to the prompt message, know that Stratus does NOT store the username and password. You must store these values for safe keeping within your own password management system. If Yes is clicked and a username and password already exists, then all existing connections will be broken and will require updating to the new username and password values.
Click Yes to generate a new SQL User name and Password.
The New SQL User and Password dialog will display. Warning: Be sure to copy the entire Password string as it is cutoff in this dialog. Store this User and Password in a safe place. All users running Power BI desktop will use this User name and Password to access the SQL Server database. Copy/paste this information during step 5 of the Power BI Setup process
Rebuild Data (As Needed) - Clicking the Rebuild Data button is used to force a full refresh of all big data. This manual operation is done anytime changes are made to the configured Report Fields and referenced field expressions as Stratus does not attempt to recognize all the potential modifications an admin can make that would impact the report generated results. Know that a full big data rebuild may take up to two days to complete as it processes all active projects in your company database. Once the Rebuild Data button is clicked, the process will begin within one hour.
Analytics Reports
The Analytics Reports section is where Power BI reports are registered and embedded within Stratus.
To register a New Analytics Report:
Click the New Analytics Report button.
Name - Enter the Name that will display in your analytics dropdowns in Stratus.
Report Type - Defines the report type. Right now, the only option is Power BI.
Report Id - Copy/paste the unique ID that associates a specific report. This reportId is found in Power BI under File > Embed Report > Website or portal.
Tenant Id (CTID) - Copy/paste the unique ID that associates a specific Microsoft tenant. This tenantId is found in Power BI under File > Embed Report > Website or portal.
Service Principal Authentication (Optional) - This is a unique Microsoft Authentication and can be used like a universal username and password for accessing all Big Data reports embedded in Stratus. Without configuring the Service Principal Authentication, when a user attempts to access a report, like under Projects > Analytics, they will be prompted for their credentials.
Workspace Id - Locate Workspace Id in your company’s Azure settings.
Client Id - Locate Client Id in your company’s Azure settings.
Client Secret - Locate Client Secret in your company’s Azure settings.
Projects - Select this option to display the Analytics Report under the Projects > Analytics tab in Stratus.
Models - Select this option to display the Analytics Report under the Models > Analytics tab in Stratus.
Packages - Select this option to display the Analytics Report under the Packages > Analytics tab in Stratus.
Show Filters - Choose this option if you want your Analytics Report filters to display. This will give users access to the same filters you might see in Power BI.
Note: Since Power BI is leveraged to aggregate data, non-Stratus data sources (Ex. ERP) can also be used and embedded within the context of Stratus projects.
Sync History
The Sync History tab shows the history of data syncs from Stratus to the Stratus Analytics database. The Sync History section keeps the oldest publish record along with the most recent 9 updates, so 10 total. This allows you to see when the last full Rebuild took place and monitor how long each hourly sync is taking to complete. During a full rebuild, you can monitor the percent complete to know when all data has been updated in the big data SQL database. The initial data extraction may take up to two days to complete, as it processes all active projects in the company database. After the initial data sync, the data automatically synchronizes changed data every hour.
Power BI Setup from Scratch
Connect to SQL Server Data Tables
Each user who will use the Power BI Desktop application needs to connect to the SQL Server database generated in Stratus Big Data using the same SQL Server database Username and Password. See the Database Connection section for more information.
In Power BI, click Get data and then click More.
In the Get Data dialog, click Azure, then Azure SQL database and then Connect.
In the SQL Server database dialog, copy/paste the Server and Database information from the Stratus provided Database Connection under Admin > Company > Big Data > Configuration. See step 1 of the Database Connection section for more information.
For Data Connectivity Mode, select either:
Import (Recommended) - Check this option if you want to download the entire database and “Import” it into the report.
DirectQuery - Check this option if you want to query the server database directly. This method has limitations which includes the inability to Filter via Date Hierarchy (Ex. Year, Month, Day).
When done, click Connect. The SQL Server database dialog will display.
With Database selected, copy/paste the safely saved SQL Server database User name and Password. See step 2c of the Database Connection section for more information.
Click Connect.
After a successful database connection, the Navigator dialog will display the list of available SQL data tables available to bring into a Power BI report.
Note: Use <shift> + click to select the first then last to toggle ON and select all tables, then click Load button.
When done, each table will be available in Power BI as a separate data set.
The data tables will load into Power BI and are available for report building including:
Default tables and any tables added via the configured reports.
Big Data Updates table which includes the last refreshed date-time. This data table will automatically populate the PowerBI Data when any Big Data update is made such as clicking the Rebuild Data button is clicked from Admin > Company > Big Data or when any scheduled update is executed.
Note: The SQL Server database username and password are stored in Power BI and are used for multiple reports. If credentials need to be purged, in Power BI:
Click Options and settings
Click Data source settings
Locate the s-bigdata source
Click either Edit Permissions to change the permissions, or click Clear Permissions to purge the permissions.
Data Table Relationship Mapping
After data tables have been published to Power BI, relationships between the data tables must be established prior to creating a report. This section demonstrates common relationship connections between the project, model, and package that you will configure in your data model. Note that this section does not go into detail behind the setup. See the Power BI Training Resources for more information.
To configure relationships between data tables:
In Power BI, click the Model View button on the left side. The data tables will display.
Click and drag the data tables below to get them in proximity to each other.
Configure the relationship between the Projects and Models data tables.
Within the Projects table, locate the Id property.
In the Models table, locate the Project Id property.
Click the Id property and drag it until it highlights the Project Id property.
The New relationship dialog displays informing that when the property name is Id, like in the Projects table, that it is a unique value in that table. Contrarily, if the property name includes another name like Project and Id, then this is not a unique value. So, in this case, there is one project that can have many models.
Click Save when done.
A visual representation of the tables displays the one to many relationship.
Continue the process of connecting tables.
Below is a table of relationships that should work for all companies.
Common Data Table Relationships
Table | Column | Cardinality | Table | Column |
|---|---|---|---|---|
Models | ProjectId | Many to one | Projects | Id |
Packages | ModelId | Many to one | Models | Id |
Packages | PackageCategoryId | Many to one | PackageCategories | Id |
PackageTracking Updates | PackageId | Many to one | Packages | Id |
PackageTracking Updates | TrackingStatusId | Many to one | TrackingStatuses | Id |
Assemblies | ModelId | Many to one | Projects | Id |
Parts | ModelId | Many to one | Projects | Id |
Power BI Setup from Template
The following was originally posted in the Stratus Community discussion Big Data Template!
In an effort to make Big Data and Power BI more accessible, the Stratus Customer Success tam has created a Power BI Template file with some pre-built visualizations to help get you started. It also comes with most of the relationships already established and even a few custom columns for added flexibility. Note: This Template is built with Import instead of DirectQuery so the file may be very large once you bring your data in.
Click the link below to download the Power BI template file.
This file is saved as a PBIT, meaning it does not contain any stored data or credentials. Once downloaded, the data source can be modified as needed.
Cloneable Reports
A set of reports has already been created for this template. Your CSM can clone them for your company, or you can generate new reports using your own custom fields
Power BI Training Resources
Contractor Metrics Recommendations
Many contract agree that focusing Big Data metrics on throughput is the best way to start building out visualizations. It’s a straightforward yet powerful metric that provides immediate insights into your production efficiency.
Below are some getting started metrics contractors have configured:
Durations for fab packages - How long each part is in a range of tracking statuses (Office, Shop, Field)
% complete on any project
Pipe length by material & size and tracking status
Duct weight by category, tracking status, etc.
Package lead time - With tracking status updates being time stamped, you can really see how long things are taking to work their way through the shop. A huge bonus is all the wonderful dimensions you can slice by along the way.