# How to Fetch Business Partner Relations from CDQ.POOL ## Overview This tutorial describes how to explore the organizational structure of a Business Partner available in the CDQ.POOL directly from the First Time Right application. Business Partners often belong to larger corporate structures consisting of: * Legal Entities (LE), * Organizational Units (OU), * Operational Entities (OE). Instead of searching for each organization separately, users can retrieve the relevant organizational hierarchy with a single action. The **Fetch BP Relations** feature calls the Fetch Business Partner Relations endpoint and displays the returned hierarchy in a dedicated side panel, allowing users to explore related Business Partners together with their identifiers and address information without leaving the current search context. Info The displayed hierarchy depends on the type of the selected Business Partner. If the selected record is a Legal Entity (LE), the complete organizational hierarchy is displayed, including all related Organizational Units (OUs) and Operational Entities (OEs). If the selected record is an Operational Entity (OE), the hierarchy focuses on the selected Operational Entity, showing its parent hierarchy together with other Operational Entities related to the same parent. **Learning Goals** In this tutorial, you will learn how to: * Search for a Business Partner in CDQ.POOL * Fetch Business Partner relations directly from the CDQ.POOL search results * Review the relations panel, including business partner types, addresses, and identifiers * Navigate large hierarchies using expand/collapse and identifier tooltips ## Prerequisites To go through the tutorial, you have to log in to the [CDQ Cloud Apps](https://apps.cdq.com/). | | ![](/assets/image01login.4e448e048eed3968a0dd2ddf2c89ae53dbf7c83fb043c6d594d6b908d92eeb54.c941f44b.png) | Click on Sign In and enter your username and password. | | ![](/assets/image02login.317613ec01be15708944edd41eadff3017d2bc0433579ddb7efb8ffc608feee3.c941f44b.png) | Warning If you have no access to the CDQ Cloud App, ask your internal point of contact to create a CDQ dedicated account. Account details will be sent by email. Warning If you have no access to the CDQ Cloud App, ask your internal point of contact to create a CDQ dedicated account. Account details will be sent by email. ## Step 1: Run a Search and Select a CDQ.POOL Result 1. Go to the First Time Right cloud app. | | ![First Time Right cloud app](/assets/pg-img001.d9da0ce5b811d34b6637778bf956307b9e7d4dabe10b3d1d25d3ee837636ea4e.a20a38e6.png) | | 1. Click the **Settings** button. 2. In the **Data Sources** field, select **CDQ.POOL**. 3. In the **Lookup** section, enable the `ACTIVATE_DATASOURCE_CDQ_POOL` feature under **Features On**. | | ![Enabling the CDQ.POOL data source and the ACTIVATE_DATASOURCE_CDQ_POOL feature in First Time Right settings](/assets/pg-img002.0cd354807ac36b65e3c19310a58829a22d99c2d3a0e70d39bf41e5351784efc0.a20a38e6.png) | | 1. Click **Save Changes**. ## Step 2: Fetch the Business Partner Relations 1. Search for a Business Partner. 2. Select a Business Partner returned from CDQ.POOL. | | ![Enabling the CDQ.POOL data source and the ACTIVATE_DATASOURCE_CDQ_POOL feature in First Time Right settings](/assets/pg-img003.a1c92b5d58f7e0aa5184f54850a5af8a62dcafdaddea4b53fa5fad093c02078b.a20a38e6.png) | | 1. In the action panel for the selected result, locate **Fetch BP Relations**. | | ![Action panel for a CDQ.POOL result, showing the Fetch BP Relations action](/assets/pg-img004.0c0f9b53f96f9c70e754d24a6de50fb0b594720f24fa20b748ae785691d86797.a20a38e6.png) | | Info The **Fetch BP Relations** action is available only for Business Partners returned from CDQ.POOL. If no relations are found for the selected Business Partner, or if the request fails, the panel displays a "No relations found" message instead of the hierarchy. If you don't see the action, confirm the selected record's data source. 1. Click **Fetch Business Partners Relations**. 2. A right-side panel opens over the main view, with the Business Partner's name shown as the panel header. The main view remains visible in the background. | | ![Relations panel open over the main view, with the Business Partner name as the panel header](/assets/pg-img005.47cd3cffed005860c2cd9ba294052c540969763163fb227acb2b86b70ac8ad35.a20a38e6.png) | | ## Step 3: Read the Relations Hierarchy The panel displays a hierarchical tree of the Business Partner's organizational structure, broken down into three node types: | Type | Description | | --- | --- | | `LE` | Legal Entity. | | `OU` | Organizational Unit. | | `OE` | Operational Entity. | Each node in the tree shows: - Business Partner name - Business Partner type — `LE`, `OU`, or `OE` - Address — thoroughfare (value and number), post code, locality, and country - Identifiers (if available) Identifiers are displayed as follows: 1. If a node has a single identifier, its value is displayed directly in the node. 2. If a node has multiple identifiers, only the first value is shown inline, followed by a counter — for example `9G4362W432 … (+1)`. 3. Click the **i** icon next to an identifier to open a tooltip listing the value and type of every identifier on that node. | | ![Relations hierarchy panel showing LE, OU, and OE nodes with addresses and identifiers](/assets/pg-img006.8cc931dbc360b896abf1469952f644acaae7183afadbc1ce1aef83962774730b.a20a38e6.png) | | Info Click a node to expand or collapse its children. For nodes with many children, a `+X more - Click to expand` indicator appears instead of listing every child at once. Click it to reveal the remaining entries. ## Summary In this tutorial, you learned how to enable CDQ.POOL as a data source in First Time Right, fetch a Business Partner's organizational relations, read the resulting hierarchy of Legal Entities, Organizational Units, and Operational Entities, and navigate large hierarchies using expand/collapse controls and identifier tooltips. ## Related Resources - [First Time Right](/documentation/_public/tutorials/solution-tutorial/cdq-first-time-right) ## Your opinion matters! We are constantly working on providing an outstanding user experience with our products. Please share your opinion about this tutorial!