Troubleshooting / FAQ
How to configure Proxy settings for this connector?
To configure Proxy settings for this connector, follow these steps:
-
Locate the connector/connector.bat script in the bin folder.
-
Open the script for editing.
Add the following lines after the DEFAULT_JVM_OPTS=… line:
"-Dhttp.proxyHost=<Proxy URL>"
"-Dhttps.proxyHost=<Proxy URL>"
"-Dhttp.proxyPort=3128"
"-Dhttps.proxyPort=3128"| If you are running the connector as a service on a Windows machine, make sure that the service is running under either a regular user account or the SharePoint crawl user account. |
What should you do when the connector is not receiving guidelines?
To address issues with Selenium, such as problems with crawling Guidelines or immediate shutdown after creation, follow these steps:
| Ensure that the Selenium driver version matches the browser version. |
For further analysis and debugging, consider adding logging for the Selenium driver
in the connector/connector.bat script located in the bin folder.
To do this, append the following lines after DEFAULT_JVM_OPTS= …
"-Dwebdriver.edge.logfile=%~dp0../logs/edgedriver.log"
"-Dwebdriver.edge.verboseLogging=true"
"-Dwebdriver.chrome.logfile=%~dp0../logs/chromedriver.log"
"-Dwebdriver.chrome.verboseLogging=true"What might be the issue when the ClickUrl is improperly encoded in the SharePoint Online UI?
When encountering URL encoding issues related to URLs containing '#', it’s important to note that this problem may not be directly related to the connector itself. It could be attributed to SharePoint Online’s default encoding behavior for OOB managed properties such as "OriginalPath," "Path," and "Url," which automatically encode '#' to '%23.'
To resolve this issue, follow these steps:
-
Ensure that the connector is correctly submitting the document’s "clickUrl" in the desired format with '#' included.
-
Verify that SharePoint Cloud Search Service Application (SSA) is also submitting the "clickUrl" in the correct format with '#'.
-
Create a new managed property called "FrontifyClickUrl" with the type "Text" and ensure it’s set as "Retrievable."
-
Map the "clickUrl" property to the newly created "FrontifyClickUrl" managed property.
-
In the Search UI web part configuration, update the "Selected properties" to include the new managed property "FrontifyClickUrl."
-
Additionally, update the "layout slots" by changing "Path" from "DefaultEncodingURL" to "FrontifyClickUrl."
External Group and Group Membership Limits in Microsoft Search
Raytion connectors reflect the custom security model of the source system in Microsoft Search. In order to do so, the connector creates external groups, which correspond to the groups from the source system.
The connector also links Microsoft Search users, i.e., users in Azure AD, to the correct external groups. This way, early-binding security trimming works.
External Groups Limit
However, there is a limit regarding the synchronization of external groups: All Microsoft Graph Connectors within a tenant can create up to 100,000 external groups. If this threshold is reached in your tenant, please contact the Microsoft support and check if they can extend the limit.