> For the complete documentation index, see [llms.txt](https://documentation.ardoq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.ardoq.com/integrations/advanced-features/fully-qualified-path-double-colon-notation.md).

# Fully-qualified Path (Double-colon Notation)

Use the double-colon (::) format to quickly specify hierarchical relationships in your Excel import.

The colon notation expresses a parent-child relationship or, in notation form, `parent::child`. It is a quick way to define multiple components and their relationships from a single column.

As an example, examine the following table:

| Reference Source    | Reference Target       | Reference Type |
| ------------------- | ---------------------- | -------------- |
| Monetization::Sales | SaaS::Google Analytics | Owns           |

Once imported, it forms the following relationships:

* Monetization → Parent of → Sales
* SaaS → Parent of → Google Analytics
* Sales → Realizes → Google Analytics

The key detail to note is that it is the children components that have the reference created between them:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2Ftll2OaSktxt0NCiIko8w%2Fimage.png?alt=media&amp;token=d7b72a1c-447a-46fd-b041-208dfb783db6" alt=""><figcaption></figcaption></figure>

## Example of Mapping using Double-colon Notation <a href="#h_b2cdcf81a8" id="h_b2cdcf81a8"></a>

As an example, we'll use the following table of Capabilities and Applications:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FYsvfMTKTTgIPyAFol46P%2Fimage.png?alt=media&amp;token=49daa4e7-4474-45dc-b526-05229d5852e6" alt=""><figcaption></figcaption></figure>

Capabilities and Applications are defined using the double-colon notation and specify that a capability has sub-capabilities and that individual applications are children to an application category type.

Instead of mapping these components separately in another sheet and establishing a Custom ID-based relationship mapping, we'll create components and establish relationships directly from this single sheet.

We'll start by defining the worksheet as a references worksheet and by creating a source and target workspace:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2Fy2JPfVTkDOzKeOTYxxeo%2Fimage.png?alt=media&amp;token=7485c8e8-85f6-4cd2-b9da-ebb41c4d8801" alt=""><figcaption></figcaption></figure>

Then we'll set the **Capability** column to the **Source** column type with the following configuration:

* **Format**: Component path
* **Reference type**: Implicit
* **If source component is missing**: Create new component

Similarly, we'll set the Applications column to the Target column type with the following configuration:

* **Format**: Component path
* **If target component is missing**: Create new component

Finally, we'll set the **Type** column to the **Type** column type.

We'll then review our import and import our data, then look at our workspace:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FSELKLr8s0m7RqAyOi2N3%2Fimage.png?alt=media&amp;token=d1fc0270-2fa2-42ce-a92d-acda5d33a7bc" alt=""><figcaption></figcaption></figure>

You will notice that the relationships we defined with the double-colon notation are indeed replicated when imported into Ardoq (if a bit hard to see in the web of references). Specifically:

* Monetization → Parent of → Sales
* SaaS → Parent of → Google Analytics
* Sales → Realizes → Google Analytics

## Extended Examples <a href="#h_a0588f6c72" id="h_a0588f6c72"></a>

You can extend the parent-child relationship as much as you need by continuing to apply the `::` notation. For example, take a look at the following configuration:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FDtkpEi3A7Yzu520QYSoX%2Fimage.png?alt=media&amp;token=93674cfd-4f2a-491e-b15e-ecbfce20084d" alt=""><figcaption></figcaption></figure>

When importing the relationship, Ardoq will create the following structure:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FCYaYVIuJe2dxixtxAkmJ%2Fimage.png?alt=media&amp;token=97702b96-fef0-4f0e-9c01-5957ad7c1727" alt=""><figcaption></figcaption></figure>

As expected, every component separated by a `::` will have a parent-child relationship and the final components in the chain will have relationship type defined by the **Type** column.

## Using a Custom Component Path <a href="#h_a11b7a54b6" id="h_a11b7a54b6"></a>

If your parent-child references are coming from third-party systems that use other notation to indicate the relationship, you can configure the notation form to use different characters with the Path separator field:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FmjymyEplW0kVMK21ddEe%2Fimage.png?alt=media&amp;token=a8d77ddc-4e6e-4a2e-9103-d5e239fef6ef" alt="" width="258"><figcaption></figcaption></figure>

For example, you can import the following configuration:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FOo6imhB6fPe84ruJhq98%2Fimage.png?alt=media&amp;token=daac6641-ad0a-4827-9dca-2195d9d011eb" alt=""><figcaption></figcaption></figure>

By using the following reference path separator:

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2F2EiYEsIf9CkTiWFAFGAy%2Fimage.png?alt=media&amp;token=28b3edf5-8393-44ac-bb4b-25117ae8e90f" alt="" width="244"><figcaption></figcaption></figure>
