Label Link Property – Make the Label Text a Link to a File or Action

Have you ever wanted  to select a label that directs you to a webpage? How about running a graph transformation when clicking on a node, e.g. to create a drill-down analysis? Linking labels provides additional flexibility and user engagement options regarding how your graphs are interacted by modifying the Label Link field.

Creating Linking Labels

It varies from view to view. Let us go through each and every view and familiarize ourselves with the use of this handy feature.

Graph View

  1. Select a node or edge from your graph.
  2. In the properties window, input a description of your label into the Label Text field.
  3. Once the label is selected, put the desired action into the Label Link field. See below for a list of possible actions.

    Linking Labels
    Properties Pad with Label Link property highlighted
  4. The easiest way to create a label link is the use of the Label Link dialog that can be started by clicking on the … button. The dialog limits the flexibility of manual entry, however, provides convenience and ease of use.

    Linking Labels
    Dialog Box for Linking Labels

Use Cases

Here are a few use cases to give you inspiration:

  • Open a web page in a browser
    • Provide the URL of the desired web page, e.g., https://soley.io
  • Open a data view 
    • soley://opendataview?view=BarChart.slv
    • This feature will open a previously created view. However, if the specified view has not yet been created, in this case BarChart, the Open View Dialog Box will be displayed. To see additional options for opening a data view with linking labels, please click here.
  • Open a file in the current project
    • soley://openfile?path={name of the file to open relative to current project}
    • Example: soley://openfile?path=MainMetamodel.gm
    • This can be used to open any kind of file, e.g. pdf documents or data files. The only limitation is that the files need to be in a project folder, e.g. soley://openfile?path=New Folder/Documentation 1.pdf
  • Create a new file in the current project
    • soley://newfile
  • Switch focus to a pad
    • soley://switchtopad?pad={C# type name of the pad to switch to}
    • Example: soley://switchtopad?pad=TransformationPad
    • Below is a list of the Soley Studio Pad names and the corresponding C# Pad names:
Pad NameC# Pad name
View ManagerViewManagerPad
Workflow launcherWorkflowLauncherPad
Build and RunTransformationPad
Smart SelectorSmartSelectorPad
Search ResultsSearchResultsPad
PropertiesPropertiesPad
Modeling ElementsModelingPad
MappingMappingPad
LibrariesLibrariesPad
BookmarksBookmarksPad
ToolsToolsPad
Workflow EngineWorkflowEnginepad
File ExplorerFileScout
Solution ExplorerProjectBrowserPad
ErrorsErrorListPad
OutputCompilerMessageView
  • Run a graph transformation defined in the current project
    • soley://buildandrun/runtransformation?sequence= {name of the sequence to execute} OR
    • soley://buildandrun/runtransformation?file= {name of the *.sls file relative to the current project}
    • Example: soley://buildandrun/runtransformation?sequence=buildHierarchy
  • Run a workflow from the current project
    • soley://workflowengine/runworkflow?path={name of the *.slwf file relative to the current project}
    • Example: soley://workflowengine/runworkflow?path=Workflows\WorkflowSample.slwf.

5. The end result is that the given label will appear above the node and if you click on it, it will execute your desired choice amongst the aforementioned options.

Keep in mind that the Linking Labels feature is available for specifically selected elements or element series that are selected via the View Manager.

Table View

  1.  Select the row in the table you want to add a Label Link to.
  2.  In the properties window, enter a description of your label in the Label Text field.
  3.  See point 3 in Graph view.
  4.  See point 4 in Graph view.
  5.  A column called Label Link will appear with an entry in the row you added the label link to. Clicking on it will execute the desired action.

Bar Chart View

  1.  Select the bar you want to add a Label Link to.
  2.  In the properties window, enter a description of your label into the Label Text field.
  3.  See point 3 in Graph view.
  4.  See point 4 in Graph view.
  5.  First, you need to select the relevant set of nodes in the View Manager. It will open its Data Properties on the   bottom left hand side. You should check the Labels Shown option. This will make the label text you chose   appear above the selected bar. All you need to do then is just click on it and it will execute the desired     action.

Matrix View

  1.  Select the row or column in the matrix you want to add a Label Link to.
  2.  In the properties window, enter a description of your label into the Label Text field.
  3.  See point 3 in Graph view.
  4.  See point 4 in Graph view.
  5.  The label text will appear inside the row’s/column’s box. All you then have to do is click on it to execute the  desired action.

Pie Chart View

  1.  Select the slice in the pie chart you want to add a Label Link to.
  2.  In the properties window, enter a description of your label into the Label Text field.
  3.  See point 3 in Graph view.
  4.  See point 4 in Graph view.
  5.  The label text will appear inside the the slice. All you then have to do is click on it to execute the desired   action.

KPI View

  1.  In the case of KPI view, you don’t need to select anything. Properties will display on the bottom left-hand   side of the screen themselves.
  2.  In this view, there’s no Label Text field.
  3.  See point 3 in Graph view.
  4.  See point 4 in Graph view.
  5.  The Key Performance Indicator itself will become a hyperlink and clicking on it will execute the desired   action.

Was this article helpful?

Related Articles