References are the glue that connects/links components together. In addition to this article, also check out our video guide to references.
We will go through different ways of creating references below. The fastest way for doing many reference linkings in one turn is at the end.
Check out the last paragraph in our Formatting article for a tip on type text for references.
Create references directly in the Navigator sidebar
By hovering over the source component you want to start the reference from, you will see a "link" icon showing on the right side. Click it once, do not hold it, and drag it to the component you want to target - then click again.
If you need to open a Parent to access child components after you clicked on the source component, just right click.
This will open the Reference tab on the right side, in order for you to choose the right reference and additional information if necessary.
You can also create multiple references at once in Ardoq
- Bulk select components in the navigator (hold down shift or control/command while clicking).
- Click the link icon on one of the selected components.
- Select whether the references should be incoming or outgoing.
- Edit details for all references.
Using the Grid Editor To Create References:
As you might be using the Grid Editor to create new components, you can also use this for creating references.
First open your Grid Editor at the bottom of the page.
Choose References and adjust window.
Start creating new references or change existing ones in the Grid Editor by choosing Target components and Source. Be aware that, as most functions in Ardoq, what you see and can choose from is context sensitive. You will only see the components from the workspace you are standing in, and the level of components that you are standing in (choose Workspace level for all Parents, and the correct Parent for the underlying children components).
Using the view Dependency Matrix for making References
First of all, choose the View "Dependency Matrix", and open up the Workspace containing your Source Component(s). Then choose the Targets component(s) Workspace. The Target Workspace has to be opened as well.
Choose the kind of Reference you wish to create by clicking on the "On cell click" and choose between references already created for the Source Workspace. You will now be creating that reference when you click. The component left side will be the Source and the component showing in the top will be the Target.
If you clicked the wrong field, just right click and choose Delete Reference.