Finding group GUIDs for ILST group mapping

To have the ILST manage group membership in your digital workplace, you must enter the GUIDs of your digital workplace groups in the config.xml file. You can find these GUIDs using the API or manually inspecting the groups in your digital workplace.

Sections in this article:

Who can do this?

Any member of a digital workplace can find GUIDs using the API as long as they are signed into their digital workplace.

However, inspecting the groups on the Manage Groups page requires that the member be a:

  • Enterprise administrator
  • Workplace administrator
  • Members of groups with the Manage Groups role. 

GUIDS

GUIDs consist of five segments of alphanumeric characters. For example:

 4c7d1d64-e486-e611-80cf-000af7705322

Find group GUIDs for ILST group mapping using the API

To find the GUIDs of all groups in your digital workplace:

  1. Go to your digital workplace and log in.
  2. Open your browser's developer tools.
  3. Select the Console tab.
  4. Copy and paste the following JavaScript into the console and run it by pressing Enter. 
    (function () {
    let endpoint = "/.api/api.svc/community/usergroups/view";
    axios.get(endpoint).then(function(response) {
        let userGroupData = response.data.response.items;
        let groupType;
        console.log("*** GROUP DATA STARTS ***");
        console.log("ToRemove,GroupType,SpaceName,GroupName,GroupGuid");
        for (let i = 0; i < userGroupData.length; i++) {
            if (userGroupData[i].spaceTitle === "") {
                groupType = ",System Group,";
            } else {
                groupType = ",Space Group,";
            }
            console.log(groupType + userGroupData[i].spaceTitle + "," + userGroupData[i].name + "," + userGroupData[i].id);
        }
        console.log("*** GROUP DATA ENDS ***");
    })
})();

The script will output the following group information to the console:

  • Group Type
  • Space Name
  • Group Name
  • Group GUID

To import this data into Excel:

  1. Copy all the console lines between the message *** GROUP DATA STARTS *** and *** GROUP DATA ENDS ***.
  2. Paste the copied text into Excel.
  3. With the column that you pasted the data into selected, select Text to Columns from the Data ribbon.
  4. Select Delimited, followed by Next.
  5. Under Delimiters, select only Comma, then select Finish.
  6. (Optional) Remove the first column.

To import this data into Google Sheets or Microsoft Excel:

  1. Copy all the console lines between the message *** GROUP DATA STARTS *** and *** GROUP DATA ENDS ***.
  2. Paste the copied text into Google Sheets or Microsoft Excel.
  3. With the column that you pasted the data into selected, select Split text to columns from the Data menu.
  4. (Optional) Remove the first column.

Find group GUIDs for ILST group mapping using your browser

If you only need to find the GUIDs of a couple of groups, you can inspect the group's name on the Manage Groups page:

  1. Go to your digital workplace and log in.
  2. On the Userbar, select  Control Panel.
  3. Under Membership, select Manage Groups.
  4. Find the group that you want the GUID of.
    • Groups are divided into tabs based on their type: System, Member, and Space.
    • If you want to select a space group, you must first select the Space Groups tab and then expand the space where the group is located.
  5. Right-click the group name and select Inspect.

Your browser will open its developer tools and focus on the inspected element. The GUID of the group will appear multiple times in the ID properties of the related element. In the image below, the GUID of the select HR Team would be f9fec9b6-a6a7-4e22-a912-f4b42bf40553.

Viewing GUIDs in the developer tools.