ServiceNow Knowledge Microsoft 365 Copilot 連接器可讓組織將 ServiceNow 知識庫文章編製索引至 Microsoft 365 Copilot 和搜尋體驗。 本文提供部署 ServiceNow Knowledge 連接器時可能遇到的常見錯誤疑難排解資訊。
若要驗證 ServiceNow 組態資訊以協助疑難排解錯誤,請參閱 設定 連接器擷取的 ServiceNow 服務。
在 Copilot 或 Microsoft 搜尋中找不到 ServiceNow 知識文章
判斷搜尋文章的使用者是否具有存取 ServiceNow 知識文章所需的權限。 使用 ServiceNow 中的 使用者準則診斷 工具。
判斷使用者是否正確對應至 Microsoft Entra 身分識別。 對應問題會在「錯誤」標籤上顯示為
2006錯誤。檢查使用者對應公式,並視需要進行更新。
判斷任何使用者準則中的進階指令碼是否授與文章的存取權。 目前不支援進階指令碼。
如果在知識庫層級的任何使用者準則中
Cannot Read設定進階腳本,則知識庫中的所有文章都會在索引資料中加上拒絕存取戳記。如果在文章層級的任何使用者準則中
Cannot Read設定進階指令碼,則文章會在索引資料中加上拒絕存取戳記。
判斷知識庫層級是否存在空準則 -
Cannot Read,Cannot Contribute。 判斷文章層級是否存在空準則 -Cannot Read。 空白準則是具有空白欄位的使用者準則。 如果存在空白條件,則在索引資料中,文章會以拒絕存取戳記。如果您無法識別根本原因,請連絡 Copilot 連接器支援小組 並提供下列詳細資料:
- 租用戶識別碼
- 連線識別碼
- 文章系統編號
- 知識庫系統 ID
- 對於知識庫,請收集:
- 使用者準則清單sys_id kb_uc_can_read_mtom (誰可以讀取知識庫) 表格中可用
- 使用者準則清單sys_id無法讀取知識庫) 表格中的kb_uc_cannot_read_mtom (中可用
- 使用者準則清單sys_id無法貢獻知識庫) 表格中的kb_uc_cannot_contribute_mtom (中可用
- kb_uc_can_contribute_mtom中可用的使用者條件清單sys_id
- 此外,對於在步驟 3 中收集sys_id項目,請共用:
- 文章can_read_user_criteria欄位中sys_id的使用者條件清單
- 文章cannot_read_user_criteria欄位中sys_id的使用者標準清單
由於已啟用單一登入的 ServiceNow 執行個體而無法登入
如果您的組織使用 ServiceNow 的單一登入 (SSO) ,您可能會無法使用服務帳戶登入。 您可以新增至 ServiceNow 執行個體 URL 來 login.do 顯示使用者名稱和密碼型驗證。 例如,https://<your-organization-domain>.service-now.com./login.do。
無法與 ServiceNow 執行個體連線
連線狀態下的禁止或未經授權的回應可能由於下列原因:
帳號密碼不正確: 如果您使用基本驗證,您提供的認證可能不正確。 再次檢查認證。
如果您使用 OAuth2.0,請確認帳戶密碼正確且未重設。 ServiceNow Knowledge Microsoft Graph 連接器會使用代表服務帳戶擷取的存取權杖進行編目。 存取權杖每 12 小時重新整理一次。 如果您變更密碼,您可能需要重新驗證連線。
表格存取權限: 檢查服務帳戶是否具有必要 條件中提及之資料表的必要存取權。 檢查服務帳戶是否具有資料行中所有資料表的 「讀取」存取權 。
ServiceNow 執行個體位於防火牆後方: 如果 ServiceNow Knowledge 連接器位於網路防火牆後方,則可能無法連線到您的 ServiceNow 執行個體。 您必須允許存取連接器服務。 下表列出每個區域連接器服務的公用 IP 位址範圍。 將 IP 位址新增至您的網路允許清單。
環境 地區 Range 刺 北美 52.250.92.252/30, 52.224.250.216/30 刺 歐洲 20.54.41.208/30, 51.105.159.88/30 刺 亞太地區 52.139.188.212/30, 20.43.146.44/30
變更知識文章的 URL
ServiceNow Knowledge Copilot 連接器AccessUrl會以 格式<instance_url>/kb_view.do?sys_kb_id<sysId>計算sys_id屬性。 它會在後端系統檢視中開啟知識文章。 使用下列步驟將文章重新導向至其他網址:
在 Microsoft 365 系統管理中心,在 [連接器] 索引標籤上,編輯針對 ServiceNow Knowledge 連線設定的結果類型。
在 [編輯結果類型 ] 對話方塊中,選取結果版面配置區段旁的 [編輯 ]。
尋找包含 with 和
AccessUrlvalues 的shortDescription文字屬性的 items 區塊。
若要變更目的地 URL,請編輯
AccessUrl項目區塊中文字屬性的部分。 例如,如果您想要將 ServiceNow Knowledge 文章重新導向至https://contoso.service-now.com/sp,其中sp是服務 URL 入口網站前置詞,請遵循下列步驟。原始價值 新值 "[{shortdescription}]({AccessUrl})""[{shortdescription}](https://contoso.service-now.com/sp?id=kb_article_view&sysparm_article={number})"知識文章編號屬性在哪裡
number。 建立連線時,請在「內容」索引標籤的結構描述區段中將其標示為 擷取 。完成檢閱結果類型更新,然後選取 [提交]。 等待一兩分鐘,讓變更生效。 您的搜尋結果現在應該會重新導向到正確的 URL。
權限問題Only people with access to this data source
如果您看到 ServiceNow 與 Microsoft 搜尋或 Copilot 之間的使用者準則驗證差異,請將系統屬性設定 glide.knowman.block_access_with_no_user_criteria 為 no。
當您完成 OAuth 程序時,會出現 [成功登出] 視窗
當您完成 OAuth 程序時,可能會出現 「成功登出」 視窗,而不會提示輸入 ServiceNow 認證。
根據預設,ServiceNow 會嘗試透過單一登入 (SSO) 瀏覽器驗證,使用 Microsoft 365 系統管理員認證進行連線。 此預設設定可能會導致連線失敗。 因此,會出現 「登出成功」 視窗。
若要解決此問題,請遵循下列步驟:
開啟私人瀏覽器視窗,並使用您的 ServiceNow 認證登入。
在新的索引標籤中,登入 Microsoft 365 系統管理中心。 此步驟允許 ServiceNow SSO 登出並視需要切換認證。
請再次嘗試 OAuth 組態。 應出現以下窗口以授權連接:
如果您有問題或想要提供意見反應,請連絡 Microsoft Graph |支持。
缺少對某些表的存取權
如果沒有正確的存取權限,編目器可能無法索引所有內容,也可能無法準確授與許可權。 您必須是 ServiceNow 管理員才能針對此問題進行疑難排解。
使用下列步驟,使用 REST API 總管來驗證資料表許可權:
模擬您在 ServiceNow 執行個體中建立的編目帳戶。
請確定帳戶具有下列角色:
rest_api_explorer和web_service_admin。移至 System Web Services>REST REST>API 瀏覽器。
選取錯誤訊息中提及的其中一個表格。
設定
sysparm_limit為10(以限制測試) 的結果。選擇 [傳送]。
檢閱回應:
-
如果您收到
403 Status Code以及錯誤訊息,指出您無權存取資料表,請參閱 授與資料表存取權 以提供資料表層級存取權。 -
如果您收到
200 Status Code但回應內文包含空白結果 (例如,沒有欄位) 、列存取權存在,但缺少欄位層級存取權。 若要授與欄位層級存取權,請參閱 授與欄位層級存取權。
如果您在下拉式清單中沒有看到表格名稱,則可能表示無法存取表格本身。
或者,您可以使用瀏覽器來驗證存取:
- 開啟無 痕 瀏覽器視窗。
- 輸入下列 URL (以正確的值取代預留位置) :
https://<instance-url>/api/now/table/<table_name>?sysparm_limit=10。 - 出現提示時,請使用編目帳戶的認證登入。
- 檢閱回應。 如果沒有回應或出現錯誤,則該帳戶沒有必要的存取權。
-
如果您收到