Integration

Creating Permalinks

It is possible to create permalinks both manually and automatically if the fully qualified name and types are known for the elements to be selected.

The structure of a permalink is:
http://<ViewerURL>/dataflow/link?depth=<StepsDisplayed>&direction=<Direction>&filter=<Filters>&filterEdges=<Flows>&level=<Detail>&startNode=<SelectedElement>

Each permalink is a URL, so it must be properly escaped. Each part of a permalink is described in Table 1.

Table 1.1: Description of the Parts of a Permalink

See some examples of permalinks for common objects in Table 2.1. Some example permalinks contain node types while others don't (selected randomly).

Table 2.1: Examples of Permalinks for Common Objects

Adding Links to Third-Party Tools

It is possible to automatically add links to assets in third-party tools for all nodes in the Manta Viewer. The properties of specific links must be defined in the .csv file whose location is defined on the Manta Admin UI page Configurations > Server > Common > Repository Configuration under the viewer.link.definitions property. To modify the file, the Manta Server application must be restarted.

The format of link definitions in the .csv file:

name;base_url;types;link_template

• The first line of the .csv file is considered a header line and ignored.

• Multiple rows can refer to one name — in which case, the base_url is used from the first record which contains the name.

Explanation of the link_template format:

The options for parameter_value are:

• attribute is the name of the node's attribute, which should be used as a parameter value.

• type represents the node type.

• default_value is the value that is used as the parameter value if either the node does not contain the specified attribute or none of the parents are of the given type.

• If no parent is of the given type and no default_value is specified, the parameter is excluded from the link.

Full Example of a csv File with Explanation

link-definitions-example.csv

name          ;base_url                       ;types          ;link_template
3rd_party_tool  ;tool_base_url.com              ;table,column   ;/custom_page?db={database,id,not_found}&node={node.name}
3rd_party_tool  ;                               ;schema         ;/custom_page_schemas?resource={resource, name,}&database={database, size, 10000}&item={node.name}
3rd_party_tool  ;                               ;server         ;?item={node.name}

This configuration adds the 3rd_party_tool attribute to all table, column, schema, and server type nodes in the following formats.

• Table:

  • tool_base_url.com/custom_page?db={id attribute of database or not_found}&node={name attribute of table}

• Column:

  • tool_base_url.com/custom_page?db={id attribute of database or not_found}&node={name attribute of column}

• Schema:

  • tool_base_url.com/custom_page_schemas?resource={name attribute of resource}&database={size attribute of database or 1000}&item={name attribute of schema}

• Server:

  • tool_base_url.com?item={name attribute of server}