SpaceRunner Support

How To Posts

Knowledge Base

Create a Link Between Xyicons

Links can be created between two Xyicons to establish a connection or relationship between them. While any Xyicon can be linked to any other Xyicon, some example ways that links can be used include:

  • Hardware Accessories: Identifying an "accessory" piece of hardware connected to a network piece of equipment (e.g., a Monitor or Scan Gun may be linked to a Computer to establish the Computer as the "primary" Xyicon).
  • Human Resources: Marking an Employee Xyicon as a manager of another Employee Xyicon.
  • Mapped Printers: Planning the Default and Backup Printers that a Computer will print to.
  • Network Planning: Identifying the Data Port that a piece of equipment will be connected to.

There is no limit to the number of links that a Xyicon can have. A Xyicon can also have multiple types of links at once to help in the planning and execution of your project. 


Creating a Basic Link

A Basic link establishes a relationship between two Xyicons, while leaving both Xyicons displayed on the Space.

Links Menu 1st.png
Example of an Employee Xyicon linked to a Doctor Xyicon.

Example of an Employee Xyicon linked to a Doctor Xyicon.

  1. Find the Xyicon by panning to it on the Space, searching for it in the Search Panel, or adding one from the Catalog.
  2. Click the Xyicon to select it. When Xyicon is selected, the Xyicon Menu Bar will appear above the Xyicon. Select the first button, labeled Link.... The button will become orange, indicating it is ready to link.
  3. Find the Xyicon you want to Link to and click on that Xyicon. A green message will appear saying "Link Added".
  4. See the new link by clicking either Xyicon, and viewing the "Links" section in the Quick Edit Panel. All linked relationships will be listed and the icons of any linked Xyicons will be displayed. Click any of the linked Xyicons to set your Quick Edit focus to that Xyicon. 

NOTE: You can also right click on a Xyicon and select Link to Xyicon in the drop down. In the popup window, search for the Xyicon to link to, select it in the list, then hit SAVE

Link Basic.gif

Creating a Hidden Link

A Hidden link establishes a relationship between two Xyicons, but one Xyicon is "hidden" inside another Xyicon, and is not displayed on the space. This scenario is useful when defining accessory items that need to connect to parent items. The parent Xyicon will display an orange counter showing how many hidden links it contains. This type of link can be "unhidden" and turned into a basic link. The hidden Xyicon will still be visible inside of Quick Edit.


When both Xyicons are displayed on the Space,
and no Link exists:

  1. Find the Xyicon by panning to it on the Space, searching for it in the Search Panel, or adding one from the Catalog.
  2. Click the Xyicon to select it. When Xyicon is selected, the Xyicon Menu Bar will appear above the Xyicon. Select the second button, labeled Attach to Xyicon. The button will become orange, indicating it is ready to link.
  3. Find the Xyicon you want to link to and click on that Xyicon. A green message will appear saying "Link Added". The parent icon will immediately display an orange counter showing how many hidden icons it contains. If there were already existing hidden links, the count will increase.
  4. See the new link by clicking either Xyicon, and viewing the Links section in the Quick Edit Panel. All linked relationships will be listed and the icons of any linked Xyicons will be displayed. Click any of the linked Xyicons to set your Quick Edit focus to that Xyicon. 
Example of Hidden Links: A scan gun and keyboard are accessories of a desktop computer. The linked Xyicons can be seen in Quick Edit in the Links section, but on the Space the relationship is shown with an orange counter on the PC, displaying that it contains 2 hidden links.

Example of Hidden Links: A scan gun and keyboard are accessories of a desktop computer. The linked Xyicons can be seen in Quick Edit in the Links section, but on the Space the relationship is shown with an orange counter on the PC, displaying that it contains 2 hidden links.

 
Link Hide Existing Link.gif

When both Xyicons are displayed on the Space,
and a Link already exists

  1. Find the primary Xyicon by panning to it on the Space, searching for it in the Search Panel, or adding one from the Catalog.
  2. Click the Xyicon to select it. 
  3. View the Links section in the Quick Edit Panel. All linked relationships will be listed and the icons of the linked Xyicons will be displayed.
  4. In the Links section, find the linked Xyicon that needs to be hidden, and check the checkbox to the left of that Xyicon.
  5. Click the Hide button on the links toolbar, indicated by a down arrow icon.
  6. The parent icon will immediately display an orange counter showing how many hidden icons it contains. If there were already existing hidden links, the count will increase.
 
Link HIdden Xyicon Catalog.gif

When only the parent Xyicon is on the Space
- creating hidden links directly from the Catalog panel

  1. Find the primary Xyicon by panning to it on the Space, searching for it in the Search Panel, or adding one from the Catalog.
  2. In the Catalog panel, find the item that needs to be hidden in the parent Xyicon.
  3. Click and hold the icon from the catalog, and drag it so that it is directly above the parent Xyicon on the space.
  4. You will notice that the Xyicon will enlarge slightly. Drop the icon onto the parent Xyicon. A green message will appear saying "Link Added".
  5. The parent icon will immediately display an orange counter showing how many hidden icons it contains. If there were already existing hidden links, the count will increase.
  6. See the new link by clicking either Xyicon, and viewing the Links section in the Quick Edit Panel. All linked relationships will be listed and the icons of any linked Xyicons will be displayed. Click any of the linked Xyicons to set your Quick Edit focus to that Xyicon. 

Linking a Xyicon to a Port

Catalog items can contain port templates to support a deeper level of linking between Xyicons. Port templates allow the relationships to be further defined and labeled on an individual Xyicon basis. Ports can be used to label cabling outlets and connect equipment to them, define mapped printer relationships between computers and printers, or plan irrigation sprinkler and valve systems. To set up ports on your Catalog items, please contact support@xyicon.com.

Scenarios:

Ports for Cabling: Ports can be added to Cabling catalog items, so that groups of ports (or faceplates) can be labeled on each individual Xyicon, while the actual jacks are templated to be the same. For example, faceplates may need to be labeled individually as 101, 102, 103 while each faceplate contains an A, B, C, and D port.

Ports for Cabling: Ports can be added to Cabling catalog items, so that groups of ports (or faceplates) can be labeled on each individual Xyicon, while the actual jacks are templated to be the same. For example, faceplates may need to be labeled individually as 101, 102, 103 while each faceplate contains an A, B, C, and D port.

Ports for Mapped Printers: Ports can be added to Printer catalog items to help define printer mapping relationships. For example, the ports on printers could be labeled "Default", "Backup", and "Receipt". A computer can then be linked to a network printer port to show that it always prints to that printer by Default, and link to another port on a receipt printer to show it uses that printer for all receipt printing. The example above shows Ports from the perspective of the Printer on the left, while the right image shows the links from the perspective of the Computer.

Ports for Mapped Printers: Ports can be added to Printer catalog items to help define printer mapping relationships. For example, the ports on printers could be labeled "Default", "Backup", and "Receipt". A computer can then be linked to a network printer port to show that it always prints to that printer by Default, and link to another port on a receipt printer to show it uses that printer for all receipt printing. The example above shows Ports from the perspective of the Printer on the left, while the right image shows the links from the perspective of the Computer.

 
  1. In the Space, click on the Xyicon that contains the port.  When Xyicon is selected, the Xyicon Menu Bar will appear above the Xyicon.
  2. Select the first button, labeled Choose Link Port. A drop down of available ports on that Xyicon will appear. 
  3. In the drop down, click the port that needs the link. The button will become orange, indicating it is ready to link.
  4. Click the Xyicon that will be linked to the port. A green message will appear saying "Link Added".
  5. See the new link by viewing the Ports section of the port Xyicon in the Quick Edit Panel. All port relationships will be listed and the icons of any linked Xyicons will be displayed. Click any of the linked Xyicons to set your Quick Edit focus to that Xyicon. 
Links to ports.gif

NOTE: You can also right click on a Xyicon and select Link to Port in the drop down. In the popup window, search for the port to link to, select it in the list, then hit SAVE

Shawna Sterle