同步/匯入使用者常見問題

1.1 版本

1.2 功能簡介

本文介紹 同步使用者 時一些注意事項及報錯。

次級管理者在部分情況下無法新增使用者，詳情如下表所示：

問題描述：

建立的伺服器資料集可以預覽，但是在使用該資料集同步/匯入使用者時，沒有欄位可選，如下圖所示：

原因分析&解決思路：

查看日誌，發現報錯：SQL ServerException：物件名' '無效。

檢查資料集的建立方式，例如儲存程式類的伺服器資料集，嵌套之後 SQL 執行失敗。

配置了 ID 列後會進行一些 ID 校驗以防入庫時衝突。此時出錯的資料也會列在結果面板中。下面羅列報錯情況。

4.1 ID 為空

報錯資訊如下圖所示：

原因：勾選了 id 後，不允許出現 name 不為空，但是 id 為空的情況。如下圖所示：

4.2 與原有 ID 衝突

報錯資訊如下圖所示：

原因：勾選 ID 之後更改帳號，但是不允許更改 ID，否則會報 ID 衝突的錯誤，比如原本 Alice 的 id 為 3，現在變動成 2 。

4.3 ID 與其他物件重複

報錯資訊如下圖所示：

原因：如下圖所示，多個帳號使用了一個 id 時報錯。

4.4 對應多個 ID

報錯資訊如下圖所示：

原因：如下圖所示，當一個帳號卻有多個 id 時報此錯。

當同步資料集為樹資料集時，往往會因為樹資料集構建問題導致同步失敗，下面列舉各種情況：

注：名詞解譯

• 部門標記：構建樹資料集時選擇的原始標記欄位。

• 父部門標記：構建樹資料集時選擇的父標記欄位。

5.1 21300055-報表、DEC交互原始標記相同

報錯資訊「報表、DEC交互原始標記相同」，如下圖所示：

原因：樹資料集下，多個部門都用了一個部門標記，比如下圖中 DEC 交互，報表的 did 都為 a12。如下圖所示：

5.2 21300056-報表有多個直接父部門

報錯資訊「報表有多個直接父部門」，如下圖所示：

原因：一個部門有多個父部門標記，比如下圖中報表的 pid 有 a1，a2。

5.3 21300057-決策平台找不到對應父部門

報錯資訊「樹構建失敗，決策平台找不到對應父部門」，如下圖所示：

原因：如果父部門標記為空，那麼此部門就是根部門，如果不為空，且父部門標記找不到對應的部門，則報錯。

如下圖所示，決策平台的 pid 為 a3，但是沒有任何部門的 did 為 a3，也即沒有該父部門：

注：同步使用者資料集時，若伺服器資料集為 樹資料集 ，頂層機構的父機構應為空值。

5.4 21300058-報表有多個原始標記

報錯資訊「報表有多個原始標記」，如下圖所示：

原因：如果部門名相同，且父部門標記相同，那麼說明這就是同一個部門，如果他們的部門標記不同，則報錯，如下圖中報表的 did 有兩個：a13，a12。

5.5 21300059-父子結構死循環

報錯資訊「決策平台，帆軟軟體，DEC研發構成父子結構死循環」，如下圖所示：

原因：如果部門 111 的父標記指向部門 11 ，部門 11 的父標記指向部門 1 ，部門 1 的父標記又指向部門 111 ，構成了環，則報錯。

如下圖中帆軟軟體的父標記為 a111，指向 DEC 研發，決策平台的 pid 為 a1，指向帆軟軟體，DEC 研發的 pid 為 a11，指向決策平台。

5.6 21300063-名稱與其他來源物件重複

報錯資訊「名稱與其他來源物件重複」，如下圖所示：

原因：匯入樹資料集的部門中存在和同步部門重複的資料，如先同步了樹資料集 A，再匯入樹資料集 A 則會出現此報錯。

5.7 21300064-ID與其他來源物件重複

報錯資訊「ID與其他來源物件重複」，如下圖所示：

原因：平台有內建部門2，首次同步一樹資料集，選擇保留權限更新，資料源中一同步部門1和內建部門2的ID相同，但名稱不同，同步後會報錯。

樹資料集情況下，如果還勾選了部門 id，且部門 id 列並非部門標記列，還會做 id 校驗工作，會導致全局失敗。以下所有範例中部門標記列為 did，父部門標記列為 pid，部門 id 列為 depId。

6.1 21300054-部門標記值與部門ID不一致

報錯資訊「部門標記值與部門ID不一致」，如下圖所示：

注：2020-08-03 及之後的 JAR ，該錯誤碼將不會出現。

原因：如果部門標記為純數字，比如 11，111，會直接作為 id 項插入到 finedb 的部門表中，此時如果平台又勾選了其他列作為部門 id，且部門標記值和勾選的部門 id 不一樣，則報錯。建議當資料源當部門標記為純數字時，使用 sql 語句的字串連接一個英文字母。

6.2 21300053-ID為空

報錯資訊「ID為空」，如下圖所示：

原因：樹資料集情況下，勾選部門 id 後如果部門 id 為空，則直接全局報錯。如下圖所示：

6.3 21300051-報表ID與其他物件重複

報錯資訊「報表ID與其他物件重複」，如下圖所示：

原因：帆軟軟體-報表，與帆軟軟體-決策平台使用了相同的部門 id。如下圖所示：

6.4 21300050-報表對應多個ID

報錯資訊「報表對應多個ID」如下圖所示：

原因：當部門存在多個部門 id 時會報此錯，如上圖中帆軟軟體-報表有 a12，a15 兩個部門 id。如下圖所示：

6.5 21300052-決策平台和原有ID衝突

報錯資訊「決策平台和原有ID衝突」，如下圖所示：

注：2020-06-08 及之後的 JAR ，該錯誤碼將不會出現。

原因：部門 id 發生改變了，會報錯與原有部門 id 衝突

報錯資訊「21300031 - 本次同步使用者數量將減少XX%(XX個)，達到設定的中斷值XX%。請檢查資料源資料是否正常，或暫時關閉"異常資料中斷同步"功能。」

如下圖所示：

原因：

同步使用者高度依賴資料源，若資料源出現問題，例如被惡意清空資料庫表，會導致同步到系統中的使用者被清空，操作無法逆轉。

因此 FineReport 提供同步熔斷策略。10.0.18 及之後版本的報表工程，新增「異常資料中斷同步」按鈕。

管理者開啟「異常資料中斷同步」後，可設定使用者數量減少達到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-->使用者下角色」

如下圖所示：

原因分析：

LDAP伺服器下的資料存在使用者資料節點非葉子節點，其下還存在使用者 / 部門 / 角色資料節點。

在同步使用者時，使用者屬性、部門屬性和角色屬性會選擇一樣的內容。

那麼同步時檢查資料結構，就會報錯並終止同步LDAP使用者任務。

解決方案：

要麼僅同步使用者，不同步部門角色等

要麼調整LDAP伺服器中的資料儲存

問題描述：

信創版本工程，匯入使用者失敗，報錯資訊：

失敗原因：21300109 - xxx外接資料庫插件未註冊，請聯絡銷售購買

如下圖所示：

原因分析：

工程使用了信創版本外接finedb資料庫，該類型資料庫的功能點授權已過期，因此影響到了匯入使用者功能，無法正常使用。

解決方案：

請聯絡帆軟銷售，續購/增購該類型資料庫相關的使用授權。