反饋已提交
網絡繁忙
本文匯總「同步使用者」功能的常見報錯與異常現象，幫助快速定位失敗原因並解決問題 。
以下情況不產生特定報錯碼，但會影響同步使用者的正常操作
次級管理者可見的按鈕取決於當前系統的使用者來源配置：
次級管理者只可見「新增使用者」、「匯入使用者」按鈕，不可見「同步使用者」按鈕
問題描述：建立的伺服器資料集可以正常預覽，但在使用該資料集同步或匯入使用者時，沒有欄位可選 。
原因分析：資料集的 SQL 執行失敗。查看後台日誌，可能出現 SQL ServerException：物件名' '無效 等報錯。常見於儲存程式類的伺服器資料集，嵌套之後 SQL 執行異常 。
解決方案：檢查資料集的建立方式，確認 SQL 語句可以正常執行 。
問題描述：以下兩種情況會觸發此報錯：
角色名稱為非法角色名：superusers
帳號稱與超級管理者重名
解決方案：修改角色名稱或帳號稱，避免使用非法角色名和與超級管理者重名的名稱 。
配置 ID 列後，系統會進行 ID 校驗以防止入庫衝突。校驗失敗的資料會列在同步結果面板中。以下為各類使用者 ID 相關報錯 。
ID 為空
問題描述：ID 為空
原因分析：勾選了 ID 列後，不允許出現 ID 為空但帳號不為空的情況。
解決方案：確定每條有帳號的記錄都填寫了對應的 ID 值。
與原有 ID 衝突
問題描述：和原有 ID 衝突
原因分析：勾選 ID 後更改了帳號，但 ID 不允許更改。例如，原本使用者 Alice 的 ID 為 3，現在變動為 2，即會報 ID 衝突錯誤。
解決方案：保持使用者的 ID 不變。如需更改帳號，ID 應保持原值。
ID 與其他物件重複
問題描述：ID 與其他物件重複
原因分析：多個帳號使用了同一個 ID。
解決方案：確定每個使用者擁有唯一的 ID，不同使用者不能共享同一 ID。
對應多個 ID
問題描述：對應多個 ID
原因分析：同一個帳號存在多個 ID。
解決方案：確定每個帳號只對應一個 ID，刪除重複的 ID 記錄。
遇到報錯碼時，可在下表中快速定位對應條目，再至詳情查看原因分析和解決方案。
術語說明：
部門標記：構建樹資料集時選擇的原始標記欄位。
父部門標記：構建樹資料集時選擇的父標記欄位。
問題描述：本次同步使用者數量將減少 XX%（XX 個），達到設定的中斷值 XX%。請檢查資料源資料是否正常，或暫時關閉「異常資料中斷同步」功能。
原因分析：
同步使用者高度依賴資料源。若資料源出現問題（例如被惡意清空資料庫表），會導致同步到系統中的使用者被清空，操作無法逆轉。因此 FineReport 提供「異常資料中斷同步」功能。
管理者開啟「異常資料中斷同步」後，可設定使用者數量減少達到 X% 時停止同步（X 為 1-100 的正整數）。例如，系統中原有 100 個同步使用者，設定為 30%，即同步減少 30 個及以上使用者時停止本次同步。
解決方案：
1）檢查資料源資料是否正常，確認是否存在大量使用者被刪除的情況。
2）如確認資料源無誤，可暫時關閉「異常資料中斷同步」功能後重試。
問題描述：報表對應多個ID
原因分析：同一個部門存在多個部門 ID。例如，帆軟軟體-報表有 a12 和 a15 兩個部門 ID。
解決方案：確定每個部門只對應一個部門 ID，刪除重複的 ID 記錄。
問題描述：報表ID與其他物件重複
原因分析：不同部門使用了相同的部門 ID。例如，帆軟軟體-報表與帆軟軟體-決策平台使用了相同的部門 ID。
解決方案：確定每個部門擁有唯一的部門 ID，不同部門不能共享同一 ID。
注意：2020-06-08 及之後的 JAR，該錯誤碼將不再出現。
問題描述：決策平台和原有ID衝突
原因分析：部門 ID 發生改變，與系統中已存在的部門 ID 衝突。
解決方案：保持部門 ID 不變，不要修改已同步部門的 ID 值。
原因分析：樹資料集下，多個部門使用了同一個部門標記。例如，DEC 交互和報表的 did 都為 a12。
解決方案：確定每個部門擁有唯一的部門標記值，不同部門不能共享同一 did。
問題描述：ID為空
原因分析：樹資料集勾選部門 ID 後，如果某條記錄的部門 ID 為空，則直接全局報錯。
解決方案：確定每條部門記錄都填寫了部門 ID 值，不允許出現空值。
注意：2020-08-03 及之後的 JAR，該錯誤碼將不再出現。
問題描述：部門標記值與部門ID不一致
原因分析：部門標記為純數字（如 11、111）時，會直接作為 ID 項插入部門表。此時如果又勾選了其他列作為部門 ID，且部門標記值與勾選的部門 ID 不一致，則報錯。
解決方案：當資料源的部門標記為純數字時，建議在 SQL 語句中使用字串連接一個英文字母，使部門標記與部門 ID 保持一致。
問題描述：原始標記相同
did
a12
問題描述：報表有多個直接父部門
原因分析：一個部門有多個父部門標記。例如，報表的 pid 同時為 a1 和 a2。
pid
a1
a2
解決方案：確定每個部門只有一個父部門標記。如需表示多層級關係，應透過逐級指向實現。
問題描述：樹構建失敗，xxx找不到對應父部門
原因分析：父部門標記不為空，但找不到對應的部門。例如，決策平台的 pid 為 a3，但沒有任何部門的 did 為 a3。
a3
解決方案：確定每個父部門標記都能找到對應的部門記錄，或將頂層機構的父部門標記設為空值。
注意：同步使用者資料集時，若伺服器資料集為 樹資料集，頂層機構的父機構應為空值。
問題描述：報表有多個原始標記
原因分析：部門名相同且父部門標記相同（說明是同一個部門），但部門標記不同。例如，報表的 did 有兩個值 a13 和 a12。
a13
解決方案：確定同一個部門只使用一個部門標記值。
問題描述：決策平台，帆軟軟體，DEC研發構成父子結構死循環
原因分析：部門之間的父子標記構成了環形引用。例如，部門a111 的父標記指向部門a11，部門a11 的父標記指向部門a1，部門a1 的父標記又指向部門a111，形成閉環。
解決方案：檢查並消除父子標記之間的環形引用，確定樹狀結構為單向層級關係。
問題描述：名稱與其他來源物件重複
原因分析：匯入的樹資料集中存在與已同步部門重複的資料。例如，先同步了樹資料集 A，再匯入同一樹資料集 A 時會出現此報錯。
解決方案：避免重複匯入已同步的樹資料集。如需更新，應使用同步而非匯入。
問題描述：ID與其他來源物件重複
原因分析：首次同步樹資料集時選擇「保留權限更新」，資料源中某同步部門與平台內建部門的 ID 相同但名稱不同，同步後產生 ID 衝突。
解決方案：確定同步資料集中的部門 ID 不與平台內建部門的 ID 重複。
問題描述：出現空指標異常，請檢查外置庫/伺服器資料集是否存在 null/空字串，或資料庫無法區分空字元與 NULL 資料
原因分析：外置庫或伺服器資料集中存在髒資料（null 或空字串），或資料庫無法區分空字元與 NULL。
解決方案：檢查外置庫和伺服器資料集，排查並清理 null 或空字串資料。
問題描述：請檢查 fine_soft_data（或 FINE_SOFT_DATA）表，必要時清空後重試
原因分析：軟刪除表存在衝突資料。
解決方案：清空軟刪除表後重試同步。
問題描述：資料集列下標越界，請檢查欄位-列映射配置
原因分析：同步配置的列映射與當前伺服器資料集傳回的實際列數不一致。
解決方案：檢查同步設定中的「欄位-列映射」配置，確定與資料集實際列數一致。
問題描述：資料庫唯一鍵衝突，請檢查資料庫大小寫敏感性
原因分析：外置庫存在唯一鍵衝突，常見於資料庫大小寫敏感性問題。
解決方案：檢查資料庫的大小寫敏感性配置，確定資料不因大小寫差異產生唯一鍵衝突。
問題描述：成成批處理配置異常，請檢查外置庫連結 URL 是否開啟 batch 參數
原因分析：外置庫的成成批處理配置存在問題。
解決方案：檢查外置庫連結 URL，確認是否已開啟 batch 參數。
問題描述：伺服器資料集為空，本次同步終止；如需清空同步使用者資料，請手動清空
原因分析：資料集為空，但平台中存在同步資料。
1）確認伺服器資料集的狀態是否正常。
2）如需清空同步資料，請手動清空，不可透過空資料集同步來清除。
問題描述：當前存在重複值：xxx，請檢查資料集中的重複資料或進行髒資料和軟刪除表檢查
原因分析：資料集或軟刪除表中存在重複欄位資料。
1）檢查原始資料集中的重複資料。
2）進行髒資料和軟刪除表檢查。
問題描述：失敗原因：21300109 - xxx外接資料庫插件未註冊，請交握銷售購買
信創版本工程匯入使用者失敗。
原因分析：工程使用了信創版本外接 finedb 資料庫，該類型資料庫的功能點授權已過期，影響了匯入使用者功能。
解決方案：交握帆軟銷售，續購或增購該類型資料庫的使用授權。
問題描述：失敗原因：21307213-非法節點
安裝並使用「同步LDAP域使用者」插件後同步使用者失敗，提示非法節點。
LDAP 伺服器下的資料存在使用者資料節點非葉子節點的情況，其下還存在使用者、部門或角色資料節點。
同步時，使用者屬性、部門屬性和角色屬性會選擇相同的內容，導致資料結構衝突。
方案一：僅同步使用者，不同步部門和角色。
方案二：調整 LDAP 伺服器中的資料儲存結構，確定使用者節點為葉子節點。
問題描述：21300998-同步失敗
原因分析：此類報錯未命中已知分類，需要進一步分析。
解決方案：結合報錯資訊查看後台日誌，獲取詳細堆疊資訊進行分析。
滑鼠選中內容，快速回饋問題
滑鼠選中存在疑惑的內容，即可快速回饋問題，我們將會跟進處理。
不再提示
10s後關閉
反馈已提交
网络繁忙