Successfully execute the Azure Active Directory Get List method when a group name contains an ampersand (&)
KB003055
PRODUCT
Introduction
When using Azure Active Directory groups containing an ampersand (&) in the name, a SmartObject filter error occurs when executing the Get List method. This is due to the way in which the .net URI object encodes query strings. To allow the successful execution of the Get List method, edit the Hostserver.exe.config file. Add the setting to turn on the IRI.
URI = Uniform Resource Identifier
IRI = International Resource Identifier
Use these links as reference for more information on URI and IRI settings:
https://docs.microsoft.com/en-us/dotnet/api/system.uri.escapedatastring?view=netframework-4.7.2
Steps
Turn on the IRI by following these steps:
- Stop the K2 Host Server.
- Open the HostServer.exe.config file located in [INSTALLDIR]SlotsKUIDK2 blackpearlHost ServerBin.
- Look for the closing tag section "</configSections>".
- Add the following section just below the </configSections> section and above the opening tag "<sourcecode.sharepoint.groupProvider>" section:
<uri>
<idn enabled="All" />
<iriParsing enabled="true" />
</uri>
- Start K2 Host Server
Considerations
- Rather use Notepad instead of Notepad ++ to make the changes in the Hostserver.exe.config file.
- This setting does not depend on a K2 version and is a global setting in the Hostserver.exe.config file.