2.1. Names conventions

2.1.1 Workspace

To simplify workspace management in Power BI, we recommend using a single workspace for each product/area. This approach minimizes complexity by keeping everything within one workspace, enabling your team to focus on content creation and collaboration without needing to manage multiple workspaces for different environments.

In Solvay we recommend to use Development (DEV), Test (TEST), Pre-production (PREPROD) and Production (PROD) 

We name each workspace in this simple format [ProductName] | [Environment]

Example:


2.1.2 Report, App and Dashboard

Establishing consistent naming conventions for Power BI assets ensures clarity, traceability, and efficient collaboration among team members. By adopting a standardized naming format, stakeholders can quickly identify the purpose, stage, and environment of each item in the Power BI ecosystem.

The recommended naming format is [ProductName]_[PipelineItem]

Components of the Naming Convention

Naming Conventions for Each Power BI Component

Reports

Reports are detailed and interactive data visualizations designed for analysis. They should be named as:
[ProductName]_Report_[Environment]

Apps

Apps in Power BI are collections of reports and dashboards shared with a wider audience. They should be named as:
[ProductName]_App_[Environment]

Dashboards

Dashboards are high-level summaries designed for monitoring KPIs and other critical metrics. They should be named as:
[ProductName]_Dashboard_[Environment]

Best Practices for Naming Conventions


2.2. Access and Permissions 

In Power BI, access and permissions are managed at three levels—Semantic Model, App/Report, and Workspace. Each level represents a different layer of access control and functionality within Power BI.

LevelScopeExamples of Access
Semantic ModelDataset and data structureView dataset, build reports, RLS enforcement
App/ReportIndividual reports or dashboardsView/Interact with specific content, use in apps
WorkspaceCollection of datasets, reports, and dashboardsCollaborate, manage content and permissions


2.3.1. Semantic Model (Data Model or Dataset Access)

The semantic model represents the underlying dataset in Power BI that defines the data structure, relationships, calculations (e.g., DAX measures), and data security.

Access Considerations:

2.3.2. App/Report (Content Layer Access)

This level controls access to the specific reports and dashboards created from datasets. The content is typically shared with end-users via apps or direct links.

Access Considerations:

2.3.3. Workspace (Collaboration Level Access)

Workspaces are the collaboration environments where datasets, reports, dashboards, and other content are created, shared, and managed. Access to a workspace governs overall permissions to its content.

Access Considerations:


2.4. Row-Level Security (RLS)

Row-level security (RLS) controls access to specific rows in a database based on group membership or execution context, ensuring users only see data relevant to their role or department. It is commonly used in scenarios like restricting employees to their department's data or limiting customers to their own data in a multitenant setup.

RLS is enforced at the database level, applying restrictions every time data is accessed, ensuring security across all platforms, including Power BI. It simplifies security management and applies to queries on a Warehouse.


Implement & Manage Security Roles


Assign Security Roles


Reporting with security roles


2.5. Environment

In this scenario, content creators often collaborate in an additional, development workspace that contains the latest version of the solution.

The following diagram depicts a high-level example of how you might use separate environments with a development, test, and production workspace.


ItemDescription
1
Content creators develop content in their local environment.
2
When ready, content creators publish content to a Test workspace. In this workspace, content creators can develop content that can only be produced with web authoring. Content creators can also validate content.
3
When ready, content creators deploy content to a Pre-production workspace. In this workspace, users validate content, either in the workspace or an app.
4
When ready, content creators deploy content to a Production workspace. In this workspace, content creators distribute content by publishing a Power BI app or sharing content from the workspace.



2.6. Power BI desktop installation

At now users will either have Power BI already installed on their desktops or will need to follow the instructions below to install it. First it depends if you have Company Portal or Software Center (starting June of 2025 users we will just have Company Portal).


COMPANY PORTAL

SOFTWARE CENTER

 

COMPANY PORTAL

SOFTWARE CENTER







 




2.7. License request (Content Creator and Report Viewers)

If you require a Power BI license, please follow these steps to request one:

  1. Submit a Ticket: Start by creating a ticket through Service One portal. Provide all necessary details, including your business need for the license.

  2. Data Visualization Team Review: Once the ticket is submitted, it will be routed to Data Visualization (Data Viz) team. They will evaluate the need for the license based on the business context and confirm alignment with organizational standards.

  3. License Assignment: Upon approval from the Data Viz team, the ticket will be forwarded to the Entra ID/Office Automation Team, who will assign the Power BI license to your account.


Recommendation: We highly recommend Power BI training before using the tool to maximize your proficiency and effectiveness in creating impactful visualizations and reports. Training resources link are available here and can help you get started quickly and effectively.



2.8. New Workspace request

If you require a new Power BI workspace, please follow these steps to request one:

  1. Submit a Ticket: Start by creating a ticket through Service One portal. Provide all necessary details, including your business need for theworkspace.

  2. Data Visualization Team Review: Once the ticket is submitted, it will be routed to Data Visualization (Data Viz) team. They will evaluate the need for the new workspace based on the business context and confirm alignment with organizational standards.