# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://uidata.gitbook.io/datacentral-knowledge-center/product-guides/item-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.