# Linking objects

Each component contain two handlers:

* Source - it's a starting place or arrow indicating a relation of two components
* Target - it's a destination place of components' relation

### Linking objects on diagram

Linking objects is a subject of validation. Validation is based on possible connections that makes sense and are achievable in Jira configuration.

Below there is an example of possible and invalid connection. 

> *It is reasonable to connect custom field (it's attributes like name or ID) inside Filter e.g. insdie used JQL.*\
> *However it doesn't make sense or bring any value, to embed custom field attributes inside attributes of issue type.*

<figure><img src="https://2582686426-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn7nTpq2xv8EGbzULdTCb%2Fuploads%2Fo9FOjXmtRRGY864Z8Oap%2FLink2.png?alt=media&#x26;token=6e72d425-5b7f-49eb-b519-1ec01d9e0fd8" alt=""><figcaption><p>Invalid connection.</p></figcaption></figure>

<figure><img src="https://2582686426-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn7nTpq2xv8EGbzULdTCb%2Fuploads%2Fm9lbHieiJs9dKY5nuAcL%2FLink1.png?alt=media&#x26;token=bd0de734-c191-4c31-ba2a-2e5aed8de2cf" alt=""><figcaption><p>Possible connection.</p></figcaption></figure>

### Linking objects inside attributes

Linking objects on diagram, doesn't fully explains the realation between two components. To provide more details, you can optionally embed variables inside target compone. wut details.&#x20;

1. During a linking process, you will see similar popup message.
2. Click on desired attribute of source component. It will copy to clipboard a variable indicating source attribute value.
3. Paste value inside chosen attribute of linked target component

<figure><img src="https://2582686426-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn7nTpq2xv8EGbzULdTCb%2Fuploads%2FSYWswRooPhSowchalpYm%2Fimage.png?alt=media&#x26;token=03371fff-4e4f-4e12-b5cc-8341dc77600e" alt=""><figcaption><p>Copy source attribute variable into clipboard.</p></figcaption></figure>

4. Paste copied value inside chosen attribute of target component. The example linked attribute value will look like this:

JQL attribute:

```
${atlcloudjira_customfield.MyNewCustomField.id} = "Some value" and project = ABC ORDER BY Rank ASC
```

<figure><img src="https://2582686426-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn7nTpq2xv8EGbzULdTCb%2Fuploads%2Fb7i8xRUbHBQEKcD7h6Jq%2Fimage.png?alt=media&#x26;token=903c4553-ee9f-4d97-b72b-c1ca2d88f250" alt=""><figcaption><p>Now properties of source and target components are linked with variable</p></figcaption></figure>

5. Update component and save plan. Deployment team will now know exactly what was your true intention behind linking of two components.