本文介紹 同步使用者 時一些注意事項及報錯。
次級管理員在部分情況下無法新增使用者，詳情如下表所示：
次級管理員只可見「新增使用者」、「匯入使用者」按鈕，不可見「同步使用者」按鈕
開啟了同步使用者
問題描述：
創建的伺服器資料集可以預覽，但是在使用該資料集同步/匯入使用者時，沒有字段可選，如下圖所示：
原因分析&解決思路：
查看日誌，發現報錯：SQL ServerException：物件名' '無效。
檢查資料集的創建方式，例如存儲過程類的伺服器資料集，嵌套之後 SQL 執行失敗。
配置了 ID 列後會進行一些 ID 校驗以防入庫時衝突。此時出錯的資料也會列在結果面板中。下面羅列報錯情況。
報錯信息如下圖所示：
原因：勾選了 id 後，不允許出現 name 不為空，但是 id 為空的情況。如下圖所示：
原因：勾選 ID 之後更改賬號，但是不允許更改 ID，否則會報 ID 衝突的錯誤，比如原本 Alice 的 id 為 3，現在變動成 2 。
原因：如下圖所示，多個賬號使用了一個 id 時報錯。
原因：如下圖所示，當一個賬號卻有多個 id 時報此錯。
當同步資料集為樹資料集時，往往會因為樹資料集構建問題匯致同步失敗，下面列舉各種情況：
注：名詞解釋
部門標記：構建樹資料集時選擇的原始標記字段。
父部門標記：構建樹資料集時選擇的父標記字段。
報錯信息「報表、DEC交互原始標記相同」，如下圖所示：
原因：樹資料集下，多個部門都用了一個部門標記，比如下圖中 DEC 交互，報表的 did 都為 a12。如下圖所示：
報錯信息「報表有多個直接父部門」，如下圖所示：
原因：一個部門有多個父部門標記，比如下圖中報表的 pid 有 a1，a2。
報錯信息「樹構建失敗，決策平台找不到對應父部門」，如下圖所示：
原因：如果父部門標記為空，那麼此部門就是根部門，如果不為空，且父部門標記找不到對應的部門，則報錯。
如下圖所示，決策平台的 pid 為 a3，但是沒有任何部門的 did 為 a3，也即沒有該父部門：
注：同步使用者資料集時，若伺服器資料集為 樹資料集 ，頂層機構的父機構應為空值。
報錯信息「報表有多個原始標記」，如下圖所示：
原因：如果部門名相同，且父部門標記相同，那麼說明這就是同一個部門，如果他們的部門標記不同，則報錯，如下圖中報表的 did 有兩個：a13，a12。
報錯信息「決策報表，帆軟軟件，DEC研發構成父子結構死循環」，如下圖所示：
原因：如果部門 111 的父標記指向部門 11 ，部門 11 的父標記指向部門 1 ，部門 1 的父標記又指向部門 111 ，構成了環，則報錯。
如下圖中帆軟軟件的父標記為 a111，指向 DEC 研發，決策平台的 pid 為 a1，指向帆軟軟件，DEC 研發的 pid 為 a11，指向決策平台。
報錯信息「名稱與其他來源物件重複」，如下圖所示：
原因：匯入樹資料集的部門中存在和同步部門重複的資料，如先同步了樹資料集 A，再匯入樹資料集 A 則會出現此報錯。
報錯信息「ID與其他來源物件重複」，如下圖所示：
原因：平台有內置部門2，首次同步一樹資料集，選擇保留權限更新，資料源中一同步部門1和內置部門2的ID相同，但名稱不同，同步後會報錯。
樹資料集情況下，如果還勾選了部門 id，且部門 id 列並非部門標記列，還會做 id 校驗工作，會匯致全局失敗。以下所有示例中部門標記列為 did，父部門標記列為 pid，部門 id 列為 depId。
報錯信息「部門標記值與部門ID不一致」，如下圖所示：
注：2020-08-03 及之後的 JAR ，該錯誤碼將不會出現。
原因：如果部門標記為純數字，比如 11，111，會直接作為 id 項插入到 finedb 的部門表中，此時如果平台又勾選了其他列作為部門 id，且部門標記值和勾選的部門 id 不一樣，則報錯。建議當資料源當部門標記為純數字時，使用 sql 語句的字符串拼接一個英文字母。
報錯信息「ID為空」，如下圖所示：
原因：樹資料集情況下，勾選部門 id 後如果部門 id 為空，則直接全局報錯。如下圖所示：
報錯信息「報表ID與其他物件重複」，如下圖所示：
原因：帆軟軟件-報表，與帆軟軟件-決策平台使用了相同的部門 id。如下圖所示：
報錯信息「報表對應多個ID」如下圖所示：
原因：當部門存在多個部門 id 時會報此錯，如上圖中帆軟軟件-報表有 a12，a15 兩個部門 id。如下圖所示：
報錯信息「決策平台和原有ID衝突」，如下圖所示：
注：2020-06-08 及之後的 JAR ，該錯誤碼將不會出現。
原因：部門 id 發生改變了，會報錯與原有部門 id 衝突
報錯信息「21300031 - 本次同步使用者數量將減少XX%(XX個)，達到設定的中斷值XX%。請檢查資料源資料是否正常，或暫時關閉"異常資料中斷同步"功能。」
如下圖所示：
原因：
同步使用者高度依賴資料源，若資料源出現問題，例如被惡意清空資料庫表，會匯致同步到系統中的使用者被清空，操作無法逆轉。
因此 FineReport 提供同步熔斷策略。5.1.15 及之後版本的 BI 工程，新增「異常資料中斷同步」按鈕。
管理員開啟「異常資料中斷同步」後，可設置使用者數量減少達到X%，停止同步。X為1-100的正整數。
例如系統中原有100個同步使用者（不包含手動新增/匯入的使用者數），設置為30%，即同步減少30（100*30%）個使用者及以上，就會停止本次同步。
安裝並使用插件「同步LDAP域使用者」後同步使用者失敗，報錯信息：
失敗原因：21307213-非法節點
使用者在使用者下:
user1-->使用者下使用者
部門在使用者下:
user2-->cn=使用者下部門,cn=xxx,cn=xx,cn=roles,o=fanruan,dc=fr,dc=com
角色在使用者下:
user3-->使用者下角色」