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 by manually inspecting the groups in your digital workplace.

Considerations and caveats

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 Workplace Administrator, Enterprise Administrator, or have the Manage Groups Role.

What GUIDs look like

GUIDs consist of five segments of alphanumeric characters. 

For example:

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

How to 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:

1. Copy all the console lines between the message *** GROUP DATA STARTS *** and *** GROUP DATA ENDS ***.
2. Paste the copied text into Google Sheets.
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.

Inspecting the Manage Groups page

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. Select the 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 selecting 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 4c7d1d64-e486-e611-80cf-000af7705322.