Getting the Link Groups of a Universe

Gets the link groups of a UNX universe published to a CMS repository.

About Link Groups

In a relational universe, a link group is a set of business objects sharing a dependency link that is expressed in the universe data source model (data foundation) or the universe semantic layer model (business layer). A link group can be one of the following:

  • A data link group

    It is based on the data foundation and it expresses relationships between objects, such as a dimension and another dimension, or a dimension and a measure. A data link group can only contain dimensions and measures. A data link group can be seen as a measure group if it contains at least one measure.

  • A semantic link group

    It is based on the business layer and it expresses relationships between objects, such as a dimension and an attribute. A semantic link group must contain one dimension and its associated attributes if any.

A link group cannot be included into another link group. Link groups can have common dimensions or measures.

A universe contains at least one link group, otherwise it is empty.

Request

GET <slURL>/universes/{universeId}/linkgroups

Where:

  • {universeId} is the universe identifier retrieved from the list of universes
Response

Response type: application/xml

Response body:

<?xml version="1.0" encoding="UTF-8"?>
<linkGroups>
    <linkGroup type="semantic|data">
        <link name="..." id="..."/>
        <link name="..." id="..."/>
        ...
    </linkGroup>
    ...
</linkGroups>

Where:

  • type attribute of <linkGroup> is the link group type. Possible values are:
    • data, if the link group is based on the data foundation
    • semantic, if it is based on the business layer
  • id attribute of <link> is the identifier of the business object
  • name attribute of <link> is the business object path

Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<linkGroups xmlns="http://www.sap.com/rws/sl/universe">
    <linkGroup type="semantic">
        <link name="Customer|folder\Customer|dimension" id="OBJ_13"/>
        <link name="Customer|folder\Customer|dimension\Age|attribute" id="OBJ_9"/>
    </linkGroup>
    <linkGroup type="data">
        <link name="Resort|folder\Service|dimension" id="OBJ_5"/>
        <link name="Sales|folder\Sales Date|dimension" id="OBJ_23"/>
        <link name="Resort|folder\Service Line|dimension" id="OBJ_4"/>
        <link name="Customer|folder\Customer|dimension" id="OBJ_13"/>
        <link name="Resort|folder\Resort|dimension" id="OBJ_2"/>
        <link name="Resort|folder\Resort Country|dimension" id="OBJ_6"/>
        <link name="Customer|folder\Customer Country|dimension" id="OBJ_17"/>
        <link name="Measures|folder\Revenue|measure" id="OBJ_7"/>
        <link name="Measures|folder\Number of guests|measure" id="OBJ_20"/>
    </linkGroup>
    <linkGroup type="data">
        <link name="Resort|folder\Service|dimension" id="OBJ_5"/>
        <link name="Reservations|folder\Reservation Date|dimension" id="OBJ_30"/>
        <link name="Resort|folder\Service Line|dimension" id="OBJ_4"/>
        <link name="Customer|folder\Customer|dimension" id="OBJ_13"/>
        <link name="Resort|folder\Resort|dimension" id="OBJ_2"/>
        <link name="Resort|folder\Resort Country|dimension" id="OBJ_6"/>
        <link name="Customer|folder\Customer Country|dimension" id="OBJ_17"/>
        <link name="Measures|folder\Future guests|measure" id="OBJ_37"/>
    </linkGroup>
</linkGroups>