> For the complete documentation index, see [llms.txt](https://uidata.gitbook.io/datacentral-knowledge-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uidata.gitbook.io/datacentral-knowledge-center/product-guides/item-management.md).

# Item Management

* [x] Connect to Power BI Workspaces
* [x] Add a Power BI Items to your tenant

{% hint style="info" %}
**Important:** your personal 'My Workspace' can not be added to your tenant
{% endhint %}

* **Accessible Workspaces:** Gain visibility into workspaces accessible through your Azure AD account in the Power BI Service or those accessible via your configured [Power BI Service Principal](/datacentral-knowledge-center/deployments/power-bi-service-principal.md).
* **Role Assignment for Access Control:** Assign roles to reports to manage and control access levels, determining which roles have access to specific reports, see [Role Management](/datacentral-knowledge-center/product-guides/user-and-role-management.md#creating-roles) for more details.

***

### Workspaces and your tenant

The accessibility of workspaces within your tenant is contingent upon the Tenant configurations, which dictate whether workspaces are embedded using your Azure AD account or a Power BI Service Principal. To ensure correct functionality, both the Azure AD account and the Service Principal must hold a minimum 'Member' role within their respective workspaces in Power BI.

To add a workspace to your tenant, navigate to '*Administration -> Power BI Items*' and click on '*Manage Workspaces*'.

<figure><img src="/files/E0badYIbnYfc9NaJgcpH" alt=""><figcaption><p>Add workspace</p></figcaption></figure>

To add a report from a workspace, click '*Add New Item*,' then select your workspace and the report you wish to embed.

<figure><img src="/files/s024W35CeRuv324NuX9G" alt=""><figcaption></figcaption></figure>

Once workspaces and reports have been added, your users can embed reports if:

<img src="/files/tAWB3ptBgVCNaJFyvvOq" alt="" data-size="line"> **Azure AD embedding:**&#x20;

* Azure AD users need to be at least '*Viewer*' within corresponding workspace in Power BI Service (same for external Azure AD users)
* Through Service Principal as fallback options if they don't have access to corresponding workspace.

**Power BI Service Principal embedding:**

* As fallback option when <img src="/files/tAWB3ptBgVCNaJFyvvOq" alt="" data-size="line"> Azure AD lacks access to the specific workspace
* <img src="/files/OwNgrHPXIgDkdJpqDD5a" alt="" data-size="line"> User Pass and <img src="/files/JEfQvFL7OWta5NRfuvpI" alt="" data-size="line"> Mobile ID users require the Service Principal to embed reports

{% hint style="info" %}
If workspace is on a dedicated capacity ![](/files/l2PZjZ2fuRjyXizznNM3)

* Azure AD users can embed without Power BI Pro License and not receive a banner
* Service Principal can embed for User Pass and Mobile ID users and not receive a banner
  {% endhint %}

Diagram showing workspaces with and without capacity, and how reports are embedded into a tenant depending on the user type:

<figure><img src="/files/ROauFQ1Y754UfilsIYzS" alt=""><figcaption></figcaption></figure>

***

### Additional Data

When embedding a report in DataCentral, you will need to click on '*Additional Data*' depending on the reports data model. Here are two possible scenarios.

1. The Power BI report is embedding a Paginated Report (.rdl) within it as a visual. Then, include the GUID for the Paginated Report in the '*Additional Data*' section, and type is '*Report*'.

<figure><img src="/files/e28sESfuHcSVJmmmdcot" alt=""><figcaption><p>Paginated Report within a Power BI Report</p></figcaption></figure>

<figure><img src="/files/ULxJDxR4bsBQOT05l5pS" alt=""><figcaption><p>Diagram view of lineage</p></figcaption></figure>

<figure><img src="/files/93gB2MQbEWvNV9Oggt5n" alt=""><figcaption><p>Additional Data for embedding Paginated Report</p></figcaption></figure>

2. The paginated report (.rdl) has dependencies on a semantic model that has Row-Level Security. Then, the GUID for the semantic model must be included in the  '*Additional Data'*, type is '*dataset'*, and '*Has RLS'* option checked.

<figure><img src="/files/uhzW8TpwcrFDHFOzBny2" alt=""><figcaption><p>Paginated Report with RLS</p></figcaption></figure>

<figure><img src="/files/8QFIG993302EcYju2VFh" alt=""><figcaption><p>Paginated Report on a RLS semantic model</p></figcaption></figure>

<figure><img src="/files/Re7zWy6J5jUBqkZ7E4IR" alt=""><figcaption><p>Additional Data for embedding Paginated Report</p></figcaption></figure>

***

### Pin Tenant Home Page

To set a default report on your tenant's home page, either click '*Go to reports*' on the Home page or navigate to '*Administration -> Power BI Reports*'.

If permitted, your users can subsequently pin their own home page.

<figure><img src="/files/DsD3tnwPRfBlIONUzl42" alt=""><figcaption><p>Tenant Home Page</p></figcaption></figure>

Locate the report intended for embedding on the tenant's home page and click on it.

<figure><img src="/files/ClsIv0sZIatsNlKGCA1C" alt=""><figcaption><p>Pin to Home</p></figcaption></figure>

Ensure that your AAD users have access or that your Service Principal has access to the workspace where the report is embedded from.

<figure><img src="/files/mD84pCOjySgnzlxf5gmm" alt=""><figcaption><p>Tenant overview</p></figcaption></figure>

If permitted, your users can overwrite the default home page by pinning a report of their choice.

<figure><img src="/files/Nzue7DZ8D9tRwjFMjWQy" alt=""><figcaption><p>Report of choice</p></figcaption></figure>