NetIQ Identity Manager 4.9 版本說明

2024 年 5 月

NetIQ Identity Manager 4.9 提供了幾項新功能、增強功能,提升了可用性,並解決了先前存在的一些問題。此版本中的更新是累積性的。這些更新包括目前版本中的軟體修復和增強,以及過去透過 Service Pack、修補程式和 HotFix 發行的所有修復。這些改進許多是為了直接因應來自顧客的建議。我們衷心感謝您撥冗提供寶貴的建議。也期盼您能繼續協助以確保我們的產品能滿足您所有的需求。您可以在 NetIQ 社群上的 Identity Manager 社群論壇中張貼意見反應,該線上社群還包含產品資訊、部落格以及實用資源的連結。

如需先前版本中新增功能的相關資訊,請參閱 Identity Manager 文件網站上的「Previous Releases」(先前的版本) 區段。

如需此版本和最新版本說明的詳細資訊,請參閱文件頁面。若要下載此產品,請造訪軟體授權和下載入口網站。

1.0 全新功能

Identity Manager 4.9 提供以下新功能和增強功能:

如需 NetIQ Identity Manager Designer 4.9 中新功能的資訊,請參閱《NetIQ Identity Manager Designer 4.9 版本說明》。

1.1 作業系統支援

此版本新增了對下列平台的支援︰

  • Red Hat Enterprise Linux (RHEL) 9.3、9.2、8.9 和 8.8

  • Open Enterprise Server (OES) 24.2

  • Identity Manager Designer

    • Red Hat Enterprise Linux (RHEL) 9.2、9.1、8.9、8.8 和 8.7

    • SUSE Linux Enterprise Server (SLES) 15 SP5

    • Windows 11 (桌面)

    • macOS Sonoma

如需受支援作業系統的完整清單,請參閱 System Requirements for Identity Manager 4.9 (Identity Manager 4.9 系統要求) 頁面。如需此版本所支援封裝元件、資料庫和瀏覽器的資訊,請參閱受支援的元件版本。

1.2 NetIQ 稽核、合規與資料智慧

Identity Manager 引入了稽核、合規與資料智慧 (ACDI),是可為身分相關資料提供視覺分析的新工具。該工具從 Identity Manager 來源收集所有與身分相關的資料,對其進行處理,並在 ACDI 儀表板上提供報告和監控功能。如需此工具的詳細資訊,請參閱《NetIQ Audit, Compliance and Data Intelligence for Identity Manager》(Identity Manager 的 NetIQ 稽核、合規與資料智慧)。

ACDI 是 Identity Manager 4.9 的附加產品。您可以從軟體授權和下載入口網站下載該工具。該工具僅適用於 Identity Manager 4.9 雲端外解決方案,而不適用於雲端部署。

1.3 Identity Manager 驅動程式現在支援 Java 11

此版本為 Identity Manager 4.9 驅動程式新增了 Java 11 支援。下面列出了更新的驅動程式。

表 1 Identity Manager 4.9 驅動程式及其在 4.8.x 中功能相當的版本

驅動程式

Identity Manager 4.9 隨附的版本

基礎版本 (Identity Manager 4.8.x)

Azure Active Directory (AD)

5.2.0.0000

5.1.7.0200

雙向 eDirectory

4.1.0.0000

4.0.8.0300

REST

1.3.0.0000

1.2.0.0000

分隔文字

4.1.0.0000

4.0.2.0200

GroupWise (基於 REST)

4.1.0.0000

4.0.1.1

Identity Gateway Integration Module

1.1.0.0000

1.0.1.0300

JDBC

4.3.0.0000

4.2.2.0400

JDBC Fanout

1.3.0.0000

1.2.8

JMS

4.1.0.0000

4.0.0

LDAP

4.3.0.0000

4.2.0.0200

Lotus Notes

4.2.0.0000

4.1.2.0100

手動任務服務

4.2.0.0000

4.1.0

Oracle E-Business Suite HR

4.2.0.0000

4.1.2.1

Oracle E-Business Suite TCA

4.2.0.0000

4.1.2.1

Oracle E-Business Suite User Management

4.2.0.0000

4.1.2.0101

PeopleSoft

5.3.0.0000

5.2.4.0

授權服務

4.1.0.0000

4.0.1.0

Salesforce

4.2.0.0000

4.1.0.1

SAP HR

4.1.0.0000

4.0.4.1

SAP 入口網站

4.1.0.0000

4.0.2.0100

SAP 使用者管理

4.1.0.0000

4.0.4.1

SCIM

1.1.0.0000

1.0.1.0300

ServiceNow

1.1.0.0000

1.0.0

SOAP

4.2.0.0000

4.1.0.1

工作順序

4.1.0.0000

4.0.0.0 100

Workday

1.4.0.0000

1.3.0.0200

Identity Tracking for Sentinel

4.1.0.0000

4.0.2

ID 提供者

4.1.0.0000

4.0.0.0

除了更新的 Java 類別檔案之外,沒有其他新功能。如需詳細資訊,請參閱 NetIQ Identity Manager Drivers (NetIQ Identity Manager 驅動程式) 頁面上的「Version Shipped with 4.9」(Identity Manager 4.9 隨附的版本)。

1.4 支援新式驗證

除了基本驗證之外,Identity Applications 還支援在內送和外送電子郵件設定中使用新式驗證進行基於電子郵件的核准。新式驗證提供更安全的使用者驗證和存取授權。

此外,新式驗證與 Identity Manager 引擎整合,可以驗證工作通知並在規則執行期間遞送基於樣板的電子郵件。

附註:此版本僅支援透過適用於 Microsoft Outlook 的 Azure Active Directory (Azure AD) 所提供的 Office 365 OAuth 驗證服務進行新式驗證。

1.5 可以在 FIPS 模式下設定 Identity Manager

現在,您可以在 FIPS 模式下設定 Identity Manager 元件。如需詳細資訊,請參閱《NetIQ Identity Manager 安裝和升級指南 - Linux》中的「在 FIPS 模式下設定 Identity Manager」,或《NetIQ Identity Manager 安裝和升級指南 - Windows》中的「安裝和設定 Identity Manager 元件」。

1.6 將工作流程服務整合到監控架構中

現在您可以使用現有的 LDAP 搜尋方法來擷取環境中工作流程服務元件的監控資料。為此,您可以針對 Identity Vault 發出搜尋基礎為 cn=idm,cn=monitor 的搜尋申請。憑藉此增強功能,您可以使用各種統計資料 (例如工作流程總數、進行中的工作流程數、已完成的工作流程數,以及過去 10、60 和 300 秒發出的新申請數等) 來監控工作流程服務的狀態。

此外,此版本還為使用者應用程式的現有統計資料新增了更多 jvm_stats 資料。如需這些增強功能的詳細資訊,請參閱 Monitoring Identity Manager (監控 Identity Manager)。

1.7 Identity Applications 增強功能

此版本引入了以下 Identity Applications 增強功能:

Identity Applications Tools 增強版

NetIQ Identity Manager 4.9 已更新,包含 Identity Applications 工具增強版。該工具現在支援 Java 11 平台。此次增強包括以下公用程式:

關於如何使用上述每個公用程式的詳細資訊,請按一下清單中的連結。

用於變更預設工作流程記錄行為的新內容

關於啟用工作流程記錄的指導準則已更新。從此版本開始,預設以單個套件的 workflow_logging.xml 檔案中指定的記錄層級優先。例如,如果 com.novell.soa.af.impl.timers 套件的記錄層級設定為 DEBUG,而工作流程引擎的記錄層級 (在全域層級) 設定為 INFO,則應用程式將僅記錄選定套件的 DEBUG 資訊。所有其他套件和記錄器都將在 INFO 記錄層級進行記錄。

此外,系統也引入了 com.microfocus.workflow.engine.logging 的新內容,供您回復到舊行為。如果您希望針對工作流程引擎設定之記錄層級優先於套件的記錄層級,可以將 com.microfocus.workflow.engine.logging 內容新增至 ism-configuration.properties 檔案,並將其設定為 true。如需此內容的詳細資訊,請參閱《NetIQ Identity Manager - Administrator’s Guide to the Identity Applications》(NetIQ Identity Manager - Identity Applications 管理員指南)。

IDVault.get() 函數的變更

IDMProv/rest/access/entities/list 存取 API 已更新,現在包含一個名為 lookupAttr 的新查詢參數。依預設,lookupAttr 設定為 false。設定為 true 時,該 API 將傳回 filterAttr 參數中傳送的屬性之 DNLookup 定義中指定的查閱屬性。filterAttr 是此 API 中使用的另一個查詢參數。

例如,如果您要使用 IDVault.get 函數從 Identity Vault 擷取使用者實體的直屬下屬,則方法簽名將如下所示:

IDVault.get('IDM','/rest/access/entities/list',data.manager, 'user', ["directReports"], true)

其中,directReports 做為 filterAttr 傳送,true 是 lookupAttr 值。

在 directReports 的 DNLookup 定義中,使用者查閱實體的查閱屬性是「姓氏」、「名字」和「姓名首字母縮寫」。如果您將 true 屬性新增至該函數,Identity Application 將在回應中傳回直屬下屬的姓氏、名字和姓名首字母縮寫。如果未設定查閱屬性,則不會在回應中傳回查閱屬性值。

1.8 安裝程式增強功能

此版本為安裝程式整合了以下增強功能:

  • 在 Identity Manager Linux 安裝程式中整合了身分主控台。

  • 新的 ism-sensitive.properties 檔案也引入系統中,讓您可以安全地儲存用於加密所有密碼的金鑰密碼片語和萬能儲存區密碼片語。

2.0 行為或用法的重大變更

Identity Manager 4.9 在此版本中引入了一些變更,可能會影響其現有應用程式或功能的行為。

  • 在 Linux 和 Windows 平台上設定 Identity Manager 元件時,需要提供伺服器的完全合格可辨識名稱 (FQDN) 或短名稱,而不能提供 IP 位址。

  • 現在,組態公用程式 (configupdate.sh) 在啟動之前會提示使用者輸入密碼。

  • 如果您正在 Windows 伺服器上的 Identity Manager 4.9 中設定 Workday 驅動程式並想要存取範例樣式表,您可以在 Identity Manager 4.9 Windows ISO 中的以下位置找到該樣式表:\IdentityManagerServer\products\IDM\windows\setup\utilities\workday\transformation_style_sheets

3.0 棄用的功能

從此版本開始,將棄用對 NetIQ SecretStore 的支援。今後,帳戶密碼將儲存在名為 notfSMTPMailPassword 的新屬性中。此屬性屬於 notfTemplateCollection 類別,將包含在使用者應用程式驅動程式 (UAD) 套件 NOVLUABASE_4.8.8.20240401125038 中。當您安裝 Identity Manager 4.9 時,會自動安裝此 UAD 套件。但是,如果您從早期的版本升級,則需要手動更新該套件。

升級至最新的 UAD 套件並重新啟動 Tomcat 後,NetIQ SecretStore 儲存庫中的現有電子郵件帳戶密碼將自動移轉至 notfSMTPMailPassword 屬性。此密碼移轉程序由 ism-configuration.properties 檔案中的 com.netiq.idm.migrate.secretstore 內容控制。依預設,此內容設定為 true。移轉完成後,該內容將自動設定回 false 並一直保持此狀態。

4.0 受支援的元件版本

本節提供關於支援的元件版本的資訊。

4.1 Identity Manager 的元件版本

Identity Manager 4.9 綑綁了以下元件:

  • NetIQ eDirectory 9.2.9

  • NetIQ 身分主控台 1.7.2

  • NetIQ Identity Manager Engine 4.9

  • NetIQ Identity Manager Remote Loader 4.9

  • NetIQ Identity Manager 擴送代理程式 1.3

  • NetIQ Designer for Identity Manager 4.9

  • NetIQ Identity Applications 4.9

  • NetIQ One SSO Provider (OSP) 6.7.0

  • NetIQ Self Service Password Reset (SSPR) 4.7.0.1

  • NetIQ Identity Manager Identity Reporting 7.2.0

  • NetIQ Sentinel Log Management for IGA 8.6.1.0 (用於事件稽核)

  • NetIQ Identity Manager 驅動程式

    附註:

4.2 協力廠商元件版本

此版本新增了以下協力廠商元件支援:

  • Zulu 11.70+15-CA

  • Apache Tomcat 9.0.85-1

  • PostgreSQL 12.18 (獨立版和容器版)

  • OpenSSL 1.0.2zg-0

  • Nginx 1.24.0-1

  • ActiveMQ 5.18.3-1

4.3 資料庫

所有 Identity Manager 4.9 元件 (包括 NetIQ Identity Applications,但 Identity Reporting 除外) 均與 Oracle 21c 和 MS SQL 2019 相容。Oracle19c 和 MS SQL 2017 資料庫將繼續支援 Identity Reporting 7.2.0。

4.4 網頁瀏覽器

以下任意瀏覽器 (最低版本)︰

  • Google Chrome 126.0.6478.8

  • Mozilla Firefox 126.0

  • Apple Safari 17.5

  • Microsoft Edge 124.0.2478.109

5.0 系統要求

如需硬體要求和受支援作業系統的資訊,請參閱 Identity Manager 的 System Requirements for Identity Manager 4.9 (Identity Manager 4.9 系統要求) 頁面。

6.0 已解決的問題

此版本包含下列軟體修復︰

元件

全域 ID

描述

安裝與升級

OCTCR56A583299

如果在 Microsoft SQL Server 上維護資料庫,則工作流程引擎不會啟動。

Identity Manager 引擎

OCTCR56A580623

SOAP 驅動程式將重復資料新增至 DirXML-PersistentData 屬性,導致 iManager 在「驅動程式集綜覽」頁面上載入儀表板時發生例外狀況。

OCTCR56A584222

使用 do-invoke-rest-endpoint 動作向端點發出 REST 申請時,與使用者應用程式伺服器的連接掛起。

Identity Reporting

OCTCR56A580314

清除 MS SQL 上的報告資料庫時顯示以下錯誤訊息:關鍵字「CASCADE」周圍的語法不正確。

OCTCR56A581810

驅動程式執行狀態工作事件 (event-id:query-driver-ident) 產生以下警告訊息:已從未預期狀態中復原:@cached-time 不可用。

OCTCR56A585188

向 /IDMDCS-CORE/rpt/collectors/{identifier}/trust 端點發出的 REST API DELETE 申請不會從資料收集器記錄的 collect_cert 欄位中移除可信證書。

Identity Applications

OCTCR56A572998

欄位驗證和值重新整理表單產生器功能在非同步方案中不起作用。

 

OCTCR56A573780

Sentinel Universal Collector 無法剖析「CEF 事件:3152C - 使用者訊息」中的訊息欄位。

 

OCTCR56A580840

基於動態實體元件的表單欄位在下拉式清單中顯示方括號做為預設值。

 

OCTCR56A580876

當您使用 RoleVault.getRolesUserIn 函數向 /rest/access/assignments/role/list 端點發出 REST API 呼叫時,只會擷取給定使用者的 10 個角色指定許可權。

升級至 Identity Manager 4.9 後,您可以透過向同一函數新增 true 屬性來擷取關於所有角色的資訊。

語法:方法簽名如下:

RoleVault.getRolesUserIn('IDM','/rest/access/assignments/role/list',userDN,true)

 

OCTCR56A581016

在不同的表單產生器檢視之間切換後,表單欄位在儲存時消失。

 

OCTCR56A581716

升級至 Identity Manager 4.8.4 後,工作流程引擎記錄不起作用。

 

OCTCR56A581762

在外部 Web 來源中查詢資料時,「選取」元件包含額外的 _regex 字串。

 

OCTCR56A581978

在多索引標籤表單中使用「動態實體」元件時,如果使用上一步按鈕回到索引標籤,所選使用者的顯示名稱會變化。

 

OCTCR56A582360

如果針對動態表單欄位的驗證檢查失敗,JSON 表單不會顯示錯誤。

 

OCTCR56A582959

使用 RoleVault.getRoleAssignmentCause 函數向 /rest/access/assignments/list/v2 端點發出 REST API 呼叫時,預設只會擷取 10 個角色的角色指定原因。

升級至 Identity Manager 4.9 後,您可以透過向同一函數新增 true 屬性來擷取所有角色的指定原因。

語法:方法簽名如下:

RoleVault.getRoleAssignmentCause('IDM','/rest/access/assignments/list/v2',identityDn,roleDn,true)

 

OCTCR56A583294

嘗試修改現有團隊時,無法將群組新增至申請者欄位。

 

OCTCR56A583369

如果表單欄位位於「資料網格」元件內部,重新整理時間功能將不起作用。

 

OCTCR56A583373

對於非英文語言,「日」欄位無法正確驗證資料。

 

OCTCR56A583421

在「自訂預設值」函數中新增包含單引號 (') 的備註會損毀表單。

 

OCTCR56A583440

使用 setFieldValue() 函數設定自訂預設值時,驗證進程會無限期執行。

 

OCTCR56A583441

如果將申請的許可權對應至存取權限受控的資源,儀表板上的「申請歷程」頁面會顯示錯誤訊息。

 

OCTCR56A583590

Identity Manager 允許任何一個已驗證使用者變更另一使用者的偏好地區設定。

 

OCTCR56A583609

即使在拒絕任務之後,「申請歷程」頁面上的「申請狀態」也會顯示為「已佈建」。

 

OCTCR56A583692

編輯「服務台票證」磚或者編輯在「管理應用程式」頁面上做為磚連接的任何其他 PRD/表單時,瀏覽器主控台記錄中會顯示錯誤。

 

OCTCR56A583714

多次按「建立委託指定」頁面上的建立按鈕時,會建立重複的委託。

 

OCTCR56A583722

在「申請歷程」頁面上檢閱申請的詳細資料時,記錄活動的作者和相應備註不會以空格分隔。

 

OCTCR56A583747

在 Javascript 程式碼中使用 alert() 表單動作方法時,JS 編輯器和表單 JSON 停止運作。

 

OCTCR56A583754

如果您在表單產生器中再次修改表單,儲存在 JS 編輯器中的所有自訂函數都會消失。

 

OCTCR56A584217

Identity Manager 儀表板上呈現的表單,與表單產生器預覽模式下顯示的表單不同。

 

OCTCR56A584275

啟用靜態搜尋設定為 true 的「選取」元件無法搜尋長度超過 50 個字元的值。

「選取」元件現在允許您搜尋長度不超過 1000 個字元的值。

 

OCTCR56A584283

為任何元件定義邏輯時,無法為事件觸發的動作選取某個內容。

 

OCTCR56A584291

當「選取」和「選項圓鈕」元件的標籤位置設定為左 (右對齊) 時,顯示的選項不會正確對齊。

 

OCTCR56A584322

「核取方塊」元件的「自訂預設值」函數不會在最初載入表單時執行,也不會在由某項變更或明確的 triggerChange() 執行觸發時執行。

 

OCTCR56A584373

儀表板上的「任務」頁面不會自動重新整理。即使在使用核准表單核准某個任務後,該任務仍會顯示在清單中。

 

OCTCR56A584374

儀表板上的「許可權」頁面不再在搜尋結果中列出包含方括號或花括號的許可權。

 

OCTCR56A584399

在「設定」中設定為可編輯屬性的屬性在「我的設定檔」和「使用者」頁面上不可編輯。

 

OCTCR56A584489

申請 PRD 時,「新申請」頁面會顯示用於輸入生效日期和過期日期的欄位。

 

OCTCR56A584625

當地語系化表單中缺少欄位標籤。

 

OCTCR56A584638

設定了顯示限制 (可申請或檢視的最大項目數) 的動態實體元件不會在搜尋結果中列出所有相符的實體。

 

OCTCR56A584639

啟用線上模式後,如果進入離線模式然後再回到線上模式,那麼,在首次登入後,表單產生器將不允許使用其他身分證明登入。

 

OCTCR56A584666

設定 > 自訂中的使用者清單容器選項無法用於在「他人的新申請」頁面上列出使用者。

 

OCTCR56A585183

Identity Manager 儀表板上的「應用程式」頁面顯示的類別標題不包含允許的項目。

 

OCTCR56A585185

設定為同時顯示行事曆和時間元素的「日期/時間」元件中缺少時間輸入元素。

 

OCTCR56A585231

無法編輯或刪除在「我的設定檔」頁面上的電話號碼屬性中輸入的電話號碼。

 

OCTCR56A585264

每次使用者在表單產生器檢視之間切換時,表單產生器就會執行「自訂預設值」函數。

 

OCTCR56A585443

將任務重新指定給其他團隊成員的程序不按所述方式進行。

 

OCTCR56A585477

使用者設定檔頁面上的「簽名」屬性顯示文字值而不是簽名影像。

 

OCTCR56A585503

在未建立網際網路連接的 Windows 系統上從 Designer 啟動時,表單產生器無法正常載入。

 

OCTCR56A585527

升級至 Identity Manager 4.8.7 後,「他人的許可權」頁面上的許可權計數器在支援的地區設定 (英文和葡萄牙文除外) 中位置不正確。

 

OCTCR56A585557

設定條件後,表單產生器的「DN 顯示」元件會顯示錯誤訊息。

 

OCTCR56A585618

升級後無法存取使用者應用程式和 SSPR。重新啟動 eDirectory 上的 ndsd 服務以及 Identity Applications 伺服器上的 Tomcat 可以暫時解決該問題,但一段時間過後,這些元件將再次不可存取。

 

OCTCR56A585698

將 Identity Manager 設定為管理多個用戶端後,「我的設定檔」頁面會顯示錯誤的屬性。

 

  • OCTCR56A584920

  • OCTCR56A585772

使用者的「卡片檢視」以及 Identity Manager 儀表板「使用者」頁面上的屬性所顯示的屬性,與用戶端自訂設定中設定的屬性不同。

7.0 安裝 NetIQ Identity Manager 4.9

Identity Manager 4.9 在單個 ISO 檔案中提供進階版和標準版。在下載安裝檔案之前,您必須瞭解每個版本中分別包含哪些功能,以及用於下載 Identity Manager 元件的選項。

7.1 Identity Manager Advanced Edition 和 Identity Manager Standard Edition 支援的功能

為了滿足不同的客戶需求,Identity Manager 功能分成兩個產品群組提供︰

  • Identity Manager Advanced Edition

  • Identity Manager Standard Edition

Identity Manager Advanced Edition 包含 Identity Manager Standard Edition 提供的 Identity Manager 功能,以及一些額外功能。下表對 Identity Manager Advanced Edition 和 Standard Edition 中提供的功能進行了比較︰

特性

進階版

標準版

基於規則的自動化使用者佈建

是

是

即時身分同步

是

是

密碼管理與密碼自助服務

是

是

統一身分資訊工具 (Analyzer)

是

是

REST API 和單一登入支援

是

是 (有限制的支援)

目前狀態報告

是

是

基於角色的企業級佈建

是

否

業務規則執行的自動化核准工作流程

是

否

Identity Applications 中的進階自助服務

是

否

資源模型和目錄方便資源佈建

是

否

歷程狀態報告

是

否

已連接系統報告

是

否

角色和資源管理

是

否

7.2 下載 Identity Manager

購買 Identity Manager 4.9 後,登入軟體授權和下載入口網站,然後按一下相應的連結下載該軟體。以下檔案包含 Identity Manager 元件:

檔名

描述

Identity_Manager_4.9_Linux.iso

包含 Identity Manager 伺服器 (Identity Manager 引擎、遠端載入器、擴送代理程式、身分主控台)、Identity Applications 和 Identity Reporting。

Identity_Manager_4.9_RL_Linux.iso

包含適用於 Linux 的 Identity Manager 遠端載入器.

Identity_Manager_4.9_Containers.tar.gz

包含 Identity Manager 引擎、遠端載入器、擴送代理程式、ActiveMQ、PostgreSQL、表單轉譯器、OSP、Identity Applications、Identity Reporting、SSPR 和身分主控台。

Identity_Manager_4.9_Windows.iso

包含 Identity Manager 伺服器 (Identity Manager 引擎、遠端載入器、擴送代理程式)、Identity Applications 和 Identity Reporting。

Identity_Manager_4.9_RL_Windows.iso

包含適用於 Windows 的 64 位元 .NET 遠端載入器.

Identity_Manager_4.9_Designer_Linux.tar.gz

包含適用於 Linux 平台的 Designer.

Identity_Manager_4.9_Designer_Windows.zip

包含適用於 Windows 平台的 Designer.

Identity_Manager_4.9_Designer_MacOSX.dmg

包含適用於 macOS Sonoma 的 Designer 檔案。

SentinelLogManagementForIGA8.6.1.0.tar.gz

包含 Sentinel Log Management for Identity Governance and Administration (IGA).

僅支援在 Linux 上安裝。

重要:Identity Manager 4.9 ISO 中不包含 Analyzer 工具。如果已安裝 Analyzer,請確定將其更新至版本 4.8.5 並將其與 Identity Manager 4.9 配合使用。如需安裝和升級 Analyzer 的資訊,請參閱《NetIQ Identity Manager 安裝和升級指南 - Linux》或《NetIQ Identity Manager 安裝和升級指南 - Windows》。

7.3 尋找可執行檔和預設安裝路徑

Linux 上的可執行檔和預設安裝路徑

Identity Manager 元件

ISO 中可執行檔的位置

預設安裝路徑

Identity Manager 伺服器 (包含 Identity Manager 引擎、遠端載入器、擴送代理程式、身分主控台)

掛接位置中的 install.sh

  • 引擎: /opt/novell/eDirectory/lib/dirxml

  • Remote Loader︰ /opt/novell/dirxml/bin/x86_64

  • 擴送代理程式: /opt/novell/dirxml/fanoutagent

  • 身分主控台: /opt/novell/eDirAPI/sbin/

Identity Applications (Identity Manager 儀表板和管理介面、使用者應用程式、角色與資源服務驅動程式、使用者應用程式驅動程式、組態更新公用程式、One SSO Provider、Self Service Password Reset)

掛接位置中的 install.sh

  • Identity Applications: /opt/netiq/idm/apps

  • 使用者應用程式: /opt/netiq/idm/apps/UserApplication

  • 組態更新公用程式: /opt/netiq/idm/apps/configupdate

  • 表單轉譯器: /opt/netiq/idm/apps/sites

  • NGINX: /opt/netiq/common/nginx

Designer for Identity Manager

/designer/packages

/root/designer

Identity Reporting

掛接位置中的 install.sh

/opt/netiq/idm/apps/IDMReporting

密碼管理元件

./install.sh (位於掛接位置的 /sspr 目錄中)

/opt/netiq/idm/apps/sspr

Sentinel Log Management for IGA

./install.sh (位於 SentinelLogManagementForIGA8.6.1.0.tar.gz 檔案的 /SentinelLogManagementforIGA 目錄中)

/opt/novell/sentinel

Windows 上的可執行檔和預設安裝路徑

Identity Manager 元件

ISO 中可執行檔的位置

預設安裝路徑

Identity Manager 伺服器 (包含 Identity Manager 引擎、遠端載入器、擴送代理程式)

install.exe (位於 \<iso 掛接位置>\Identit ManagerServer\ 中)

  • 引擎: C:\netiq\idm

  • 遠端載入器︰ C:\netiq\idm\RemoteLoader

  • 擴送代理程式: C:\netiq\idm\FanoutAgent

Identity Applications (Identity Manager 儀表板和管理介面、使用者應用程式、角色與資源服務驅動程式、使用者應用程式驅動程式、組態更新公用程式、One SSO Provider、Self Service Password Reset)

install.exe (位於 \<iso 掛接位置>\IdentityApplications\ 中)

  • Identity Applications: C:\netiq\idm\apps\

  • 使用者應用程式: C:\netiq\idm\apps\UserApplication

  • 組態更新公用程式: C:\netiq\idm\apps\configupdate

  • 表單轉譯器: C:\netiq\idm\apps\sites

  • NGINX: C:\netiq\common\nginx

Designer for Identity Manager

install.exe (位於 Identity_Manager_4.8_Designer_Windows.zip 檔案的 \designer_install\ 資料夾中)

C:\netiq\

Identity Reporting

install.exe (位於 \<iso 掛接位置>\IdentityReporting\ 中)

C:\netiq\idm\apps\IdentityReporting

密碼管理元件

install.exe (位於 <iso 掛接位置>\common\sspr 中)

C:\netiq\idm\apps\common\sspr

7.4 安裝 NetIQ Identity Manager 4.9

依據您要安裝的版本,請從以下其中一個資源檢閱該資訊︰

8.0 升級至 NetIQ Identity Manager 4.9

可以直接從 Identity Manager 4.7.5 和 4.8.x (其中 x 為 0、1、2、3、4、5、6 和 7) 版本升級至 Identity Manager 4.9。

在開始升級之前,請先檢閱目前版本的版本說明中的資訊。

如需升級 Identity Manager 的詳細資訊,請參閱《NetIQ Identity Manager 安裝和升級指南 - Linux》中的升級 Identity Manager,或《NetIQ Identity Manager 安裝和升級指南 - Windows》中的「升級 Identity Manager」。

8.1 從 Identity Manager 4.8.x 版本升級

下表列出了 Identity Manager 4.8.x 版本的元件範圍升級路徑:

元件

基礎版本

升級後的版本

Identity Manager 引擎

4.8.x

  1. 將作業系統升級至支援的版本。

  2. 將 Identity Vault 升級至 9.2.9。

  3. 將 Identity Manager 引擎升級至 4.9。

遠端載入器/擴送代理程式

4.8.x

升級至遠端載入器/擴送代理程式版本 4.9。

Designer

 

安裝 Designer 4.9。

Identity Applications

4.8.x

在升級 Identity Applications 之前,請確定 Identity Vault 和 Identity Manager 引擎已分別升級至 9.2.9 和 4.9。

  1. 將作業系統升級至支援的版本。

  2. 停止 Tomcat。

  3. 將資料庫升級至支援的版本。如需受支援資料庫版本的資訊,請參閱 NetIQ Identity Manager 技術資訊網站。

  4. (視情況而定) 如果 SSPR 安裝在其他電腦上,請將該元件升級至 4.9 版本。

  5. 使用 Designer 更新使用者應用程式驅動程式以及角色與資源驅動程式套件。

  6. 將 Identity Applications 升級至 4.9。

  7. 啟動 Tomcat。

Identity Reporting

4.8.x

在升級 Identity Reporting 之前,請確定 Identity Vault、Identity Manager 引擎和 Identity Applications 已分別升級至 9.2.9、4.9 和 4.9。

  1. 將作業系統升級至支援的版本。

  2. 將資料庫升級至支援的版本。如需受支援資料庫版本的詳細資訊,請參閱 NetIQ Identity Manager 技術資訊網站。

  3. 將 SLM for IGA 升級至支援的版本。

  4. 更新資料收集服務和受管理服務閘道驅動程式套件。

  5. 將 Identity Reporting 升級至 7.2.0。

  6. (視情況而定) 從 Identity Manager 的「資料收集服務」頁面建立資料同步規則。

  7. 啟動 Tomcat。

在開始升級之前,請先檢閱 NetIQ 文件頁面中適用於您所用版本的版本說明中的資訊。

8.2 從 Identity Manager 4.7.x 版本升級

下表列出了 Identity Manager 4.7.x 版本的元件範圍升級路徑:

元件

基礎版本

升級後的版本

Identity Manager 引擎

4.7.5

  1. 將作業系統升級至支援的版本。

  2. 將 Identity Vault 升級至 9.2.9。

  3. 將 Identity Manager 引擎升級至 4.9。

遠端載入器/擴送代理程式

4.7.5

升級至遠端載入器/擴送代理程式版本 4.9。

Designer

 

安裝 Designer 4.9。

Identity Applications

4.7.5

在升級 Identity Applications 之前,請確定 Identity Vault 和 Identity Manager 引擎已分別升級至版本 9.2.9 和 4.9。

  1. 將作業系統升級至支援的版本。

  2. 停止 Tomcat。

  3. 更新使用者應用程式驅動程式以及角色與資源驅動程式套件。

  4. 將資料庫升級至支援的版本。如需受支援資料庫版本的資訊,請參閱 NetIQ Identity Manager 技術資訊網站。

  5. (視情況而定) 如果 SSPR 安裝在單獨的伺服器上,請將該元件升級至版本 4.9。

  6. 將 Identity Applications 升級至 4.9。

  7. 啟動 Tomcat。

Identity Reporting

4.7.5

在升級 Identity Reporting 之前,請確定 Identity Vault、Identity Manager 引擎和 Identity Applications 已分別升級至 9.2.9、4.9 和 4.9。

  1. 將作業系統升級至支援的版本。

  2. 將資料庫升級至支援的版本。如需受支援資料庫版本的詳細資訊,請參閱 NetIQ Identity Manager 技術資訊網站。

  3. 將 SLM for IGA 升級至支援的版本。

  4. 更新資料收集服務和受管理服務閘道驅動程式套件。

  5. 將 Identity Reporting 升級至 7.2.0。

  6. 啟動 Tomcat。

在開始升級之前,請先檢閱 NetIQ 文件頁面中適用於您所用版本的版本說明中的資訊。

8.3 升級至進階版

NetIQ 提供下列從較早的進階版或標準版升級至 Identity Manager 4.9 Advanced Edition 的升級路徑︰

  • Identity Manager 4.8 Advanced Edition 升級至 Identity Manager 4.9 Advanced Edition

  • Identity Manager 4.8 Standard Edition 升級至 Identity Manager 4.9 Advanced Edition,使用下列方法之一︰

    • 從 Identity Manager 4.8 Standard Edition 升級至 4.9 Standard Edition,然後再升級至 4.9 Advanced Edition

    • 從 Identity Manager 4.8 Standard Edition 升級至 4.8 Advanced Edition,然後再升級至 4.9 Advanced Edition

  • Identity Manager 4.7.5 Advanced Edition 升級至 Identity Manager 4.9 Advanced Edition

  • Identity Manager 4.7.5 Standard Edition 升級至 Identity Manager 4.9 Advanced Edition,使用下列方法之一︰

    • 從 Identity Manager 4.7.5 Standard Edition 升級至 4.9 Standard Edition,然後再升級至 4.9 Advanced Edition

    • 從 Identity Manager 4.7.5 Standard Edition 升級至 4.7.5 Advanced Edition,然後再升級至 4.9 Advanced Edition

8.4 升級至標準版

您可以從 Identity Manager 4.8 Standard Edition 升級至 Identity Manager 4.9 Standard Edition。如需升級說明,請參閱《Quick Start Guide for Installing and Upgrading NetIQ Identity Manager 4.9 Standard Edition》(安裝和升級 NetIQ Identity Manager 4.6 Standard Edition 的快速入門指南)。

Identity Manager 4.9 Standard Edition 繼續提供對下列報告的支援︰

  • 使用者的驗證

  • 伺服器的驗證

  • 資料庫統計資料

  • 自助密碼變更

  • 密碼重設

  • Identity Vault 驅動程式關聯報告 - 目前狀態

  • Identity Vault 使用者報告 - 目前狀態

  • 使用者密碼變更事件摘要

    如需詳細資訊,請參閱《Administrator Guide to NetIQ Identity Reporting》(NetIQ Identity Reporting 管理員指南)。

    重要:若要使用報告,請將最新的報告定義輸入至 Identity Reporting 中。登入 Reporting 應用程式,並使用應用程式中的下載頁面來下載報告。

9.0 已知問題

NetIQ 致力確保我們的產品能提供最優質的解決方案,以符合您的企業軟體需求。以下是現在正在研究的問題:若您有任何問題需要進一步的協助,請聯絡技術支援。如需 Designer 中已知問題的清單,請參閱《NetIQ Identity Manager Designer 4.9 Release Notes》(NetIQ Identity Manager Designer 4.9 版本說明)。

9.1 Windows 安裝程式顯示例外

問題: 安裝 Identity Manager 4.9 元件後,啟動 Tomcat 時顯示以下例外:SEVERE [main] org.apache.catalina.util.LifecycleBase.handleSubClassException 無法啟動元件 [Connector["ajp-nio-<IP_address>-8010"]]

此問題發生在全新安裝期間以及升級至 Identity Manager 4.9 之後。[問題:OCTCR56A607041]

解決方式: 它不會導致功能受損。但是,若要解決該問題,請刪除 server.xml 檔案中的以下行:

<Connector port="8010" protocol="AJP/1.3" redirectPort="8543"/>

server.xml 檔案位於 C:\NetIQ\idm\apps\tomcat\conf 中

9.2 使用雙因素驗證登入 Identity Manager 時發生錯誤

問題: 如果將 Identity Manager 伺服器上的 NetIQ One SSO Provider (OSP) 設定為使用 NetIQ 進階驗證進行雙因素驗證,則使用者可能會遇到登入失敗的問題。OSP 記錄檔案顯示以下錯誤:Unexpected error while searching: internal.atlaslite.jcce.exception.CoreInitializationException: No administrator password is configured。

[問題:OCTCR56A605248]

解決方式: 沒有可用的解決方式。

9.3 dirxml_remote 和 RLConsole 內容顯示過時的產品版本

問題: 透過 Identity_Manager_4.9_RL_Windows.iso 或 Identity_Manager_4.9_RL_Linux.iso 安裝或升級遠端載入器時,您可能發現,dirxml_remote 內容視窗中的產品版本沒有變化。版本仍顯示為 4.8.0.0。RLConsole 內容中存在同樣的問題。[問題:OCTCR56A608072]

解決方式: 此問題不會影響遠端載入器的功能。您可以檢查同一視窗中的檔案版本來確認是否已成功安裝遠端載入器。

9.4 安裝程式產生空的資料庫綱要 SQL 檔案

問題: 在 Identity Applications 元件升級期間,如果您選擇寫入檔案選項來建立資料庫綱要,則安裝程式會建立空的 databaseschema.sql 和 wfedatabaseschema.sql 檔案。由於這些檔案是空的,升級完成後,您無法使用它們來建立資料庫綱要。[問題:OCTCR56A586043]

解決方式: 在應用程式伺服器上從協力廠商網站下載適用於您的 Identity Applications 資料庫的資料庫 jar 檔案。將此檔案與 Identity Applications 一起安裝在單獨的系統或伺服器上。

在 Identity Applications 更新期間,當安裝程式提示您輸入 Identity Applications 和工作流程引擎資料庫 JDBC jar 檔案路徑時,請指定已安裝的資料庫 jar 檔案所在位置。

9.5 使用 MS SQL 資料庫時某些報告不擷取任何資料

問題: 如果您使用 MS SQL 做為 Identity Reporting 資料庫,則依接收者列出的存取權申請、依申請者列出的存取權申請和依資源列出的存取權申請報告不會傳回任何資料。[問題:OCTCR56A604404]

解決方式: 若要擷取上述報告的資料,請執行以下步驟:

  1. 登入安裝了 Identity Reporting 的伺服器。

  2. 開啟資料庫管理員工具,例如 SQL Server Management Studio。

  3. 執行以下查詢︰

    附註:在 <Identity Reporting 資料庫名稱> 欄位中指定相應的 Identity Reporting 資料庫名稱。

    USE [<identity reporting database name>]
    GO
    
    /****** Object:  UserDefinedFunction [IDM_RPT_DATA].[get_formatted_user_dn]    Script Date: 5/9/2020 7:03:55 PM ******/
    DROP FUNCTION [IDM_RPT_DATA].[get_formatted_user_dn]
    GO
    
    /****** Object:  UserDefinedFunction [IDM_RPT_DATA].[get_formatted_user_dn]    Script Date: 5/9/2020 7:03:55 PM ******/
    SET ANSI_NULLS ON
    GO
    
    SET QUOTED_IDENTIFIER ON
    GO
    
    CREATE FUNCTION [IDM_RPT_DATA].[get_formatted_user_dn] 
    (
           -- Add the parameters for the function here
           @user_path nvarchar(max)
       , @user_name nvarchar(200)
    )
    RETURNS nvarchar(max)
    AS
    BEGIN
           DECLARE
            @new_path        nvarchar(200),
            @new_path_2      nvarchar(max),
            @l_user_path     nvarchar(max),
            @l_old_delimiter nvarchar(1) = '\\',
            @l_new_delimiter nvarchar(1) = '.',
            @MyCursor CURSOR,
            @MyField nvarchar(max);
    
        if @user_path is not null
        BEGIN
        SET @l_user_path = SUBSTRING(@user_path , 2 , (LEN(@user_path)-1));
        SET @MyCursor = CURSOR FOR
                        SELECT value FROM STRING_SPLIT( @l_user_path , @l_old_delimiter )
        OPEN @MyCursor 
        FETCH NEXT FROM @MyCursor 
        INTO @MyField
            WHILE @@FETCH_STATUS = 0
            BEGIN
                if @MyField is not null
                BEGIN
                    SET @new_path = @l_new_delimiter + @MyField;
                END
                if @new_path_2 is not null
                BEGIN
                    SET @new_path = @new_path + @new_path_2;
                END
                SET @new_path_2 = @new_path;
              FETCH NEXT FROM @MyCursor 
              INTO @MyField
            END
            CLOSE @MyCursor
            DEALLOCATE @MyCursor
                 
            if @new_path is not null
                        BEGIN
                           SET @new_path = @user_name + @new_path;
                        END
            else
                        BEGIN
                               SET @new_path = @user_name;
                        END
        END
           return LTRIM(RTRIM(@new_path));
    END;
    
    GO
    
    CREATE FUNCTION [IDM_RPT_DATA].[patternReplace]
    (
       @InputString VARCHAR(4000),
       @Pattern VARCHAR(100),
       @ReplaceText VARCHAR(4000)
    )
    RETURNS VARCHAR(4000)
    AS
    BEGIN
       DECLARE @Result VARCHAR(4000) SET @Result = ''
       -- First character in a match
       DECLARE @First INT
        -- Next character to start search on
        DECLARE @Next INT SET @Next = 1
        -- Length of the total string -- 8001 if @InputString is NULL
        DECLARE @Len INT SET @Len = COALESCE(LEN(@InputString), 8001)
        -- End of a pattern
        DECLARE @EndPattern INT
    
     
    
         WHILE (@Next <= @Len) 
         BEGIN
         SET @First = PATINDEX('%' + @Pattern + '%', SUBSTRING(@InputString, @Next, @Len))
          IF COALESCE(@First, 0) = 0 --no match - return
           BEGIN
              SET @Result = @Result + 
                 CASE --return NULL, just like REPLACE, if inputs are NULL
                    WHEN  @InputString IS NULL
                     OR @Pattern IS NULL
                     OR @ReplaceText IS NULL THEN NULL
               ELSE SUBSTRING(@InputString, @Next, @Len)
            END
         BREAK
      END
      ELSE
      BEGIN
         -- Concatenate characters before the match to the result
         SET @Result = @Result + SUBSTRING(@InputString, @Next, @First - 1)
         SET @Next = @Next + @First - 1
    
     
    
         SET @EndPattern = 1
         -- Find start of end pattern range
         WHILE PATINDEX(@Pattern, SUBSTRING(@InputString, @Next, @EndPattern)) = 0
            SET @EndPattern = @EndPattern + 1
         -- Find end of pattern range
         WHILE PATINDEX(@Pattern, SUBSTRING(@InputString, @Next, @EndPattern)) > 0
               AND @Len >= (@Next + @EndPattern - 1)
            SET @EndPattern = @EndPattern + 1
    
     
    
         --Either at the end of the pattern or @Next + @EndPattern = @Len
         SET @Result = @Result + @ReplaceText
         SET @Next = @Next + @EndPattern - 1
      END
          END
          RETURN(@Result)
       END;
    
    
    GO
  4. 導覽至 CDN 網站。

  5. 按一下依接收者列出的存取權申請報告。

  6. 下載依接收者列出的存取權申請報告的 .rpz 和 .zip 檔案。

  7. 針對依申請者列出的存取權申請和依資源列出的存取權申請報告執行步驟 5 和步驟 6。

9.6 Identity Manager 不反映對身分主控台中「使用 SMTP TLS」選項所做的變更

問題: 在身分主控台中設定電子郵件伺服器時,如果您在樹狀檢視中選擇為預設通知樣板啟用或停用 notSMTPUseTLS 屬性,則您可能會注意到,相同的值未顯示在 Identity Manager 的「基於電子郵件的核准」頁面上。但是,會儲存所做的選擇,並且會根據您的偏好更新電子郵件伺服器。

之所以發生這種情況,是因為 notfSMTPUseTLS LDAP 屬性在 Identity Applications 和身分主控台中的更新方式不同。當您在身分主控台中進行變更時,該屬性會直接更新。然而,當您在 Identity Manager 之「基於電子郵件的核准」頁面的外送電子郵件設定中變更使用 SMTP TLS 值時,會更新 ism-configuration.properties 檔案中的 com.netiq.rbpm.smtp.tls 內容。但是,仍會套用您在身分主控台中選取的值,即使它未顯示在 Identity Manager 的「基於電子郵件的核准」頁面上。[問題:OCTCR56A585739]

解決方式: 為了確保行為一致,您可以根據您在身分主控台中選取的值,修改 Identity Manager 之「基於電子郵件的核准」頁面上外送電子郵件設定選項中的使用 SMTP TLS 值。

9.7 在 Linux 上,iManager 升級後顯示空白頁面

問題: 將 Identity Manager 升級至 4.9 後,如果將 iManager 與其他元件一起安裝,iManager 不再可以正常運作。當您嘗試啟動以前安裝的版本時,iManager 會顯示空白頁面。

解決方式: 安裝並使用身分主控台來代替 iManager。但是,將 Identity Manager 升級至版本 4.9 後,如果您想要繼續使用 iManager,請確定:

  • 將 iManager 安裝在獨立伺服器上。

  • 伺服器包含支援的 Java 版本。例如,在 Identity Manager 4.8.6 上安裝 Java JDK 1.0.8 Update 342 中的 iManager 3.2.6.0200

    執行以下步驟以重用舊的 Java 檔案:

    1. 使用以下指令建立新目錄:

      mkdir -p /opt/novell/iManager/java_iman
    2. 將 iManager 的現有 Java 檔案複製到新目錄:

      cp -r /opt/netiq/common/jre/ /opt/novell/iManager/java_iman
    3. 若要變更新目錄的擁有權,請執行以下指令:

      chown -R novlwww:novlwww /opt/novell/iManager/java_iman 
    4. 導覽至 /etc/opt/novell/tomcat9/,然後使用 tomcat9.conf 檔案中的新 Java 路徑更新 JAVA_HOME 和 JRE_HOME。

    5. 使用以下備註重新啟動 Tomcat:

      rcnovell-tomcat9 restart

9.8 警告:發生不合法的反射存取操作

問題: 設定 Identity Applications 時,您可能會看到以下訊息:

警告:發生不合法的反射存取操作

出現這種情況是因為目前版本的 Identity Applications 使用 Java 11。[問題:OCTCR56A583685]

解決方式: 該警告不會影響任何功能。您可以忽略該問題。

9.9 將 Identity Manager 升級至 4.9 後,Tomcat 在 RHEL 8.x 和 9.x 上無法啟動

問題: 在執行 RHEL 8.x 或 RHEL 9.x (其中 x 是 4.9 中支援的版本) 的伺服器上將 Identity Manager 升級至版本 4.9 時,OSP 因資料庫連接問題而無法啟動。在部署 OSP 時,如果隨機金鑰產生程序花費的時間超過預期,則通常就會發生這種情況。因此 Tomcat 服務也無法啟動。[問題:OCTCR56A584564]

解決方式: 修改位於 /opt/netiq/common/jre/conf/security 的 java.security 檔案中的以下行,然後重新啟動 Tomcat:

附註:在運用該解決方法之前,請參閱 RHEL 文件來瞭解關於亂數產生器的詳細資訊。

  • 將 securerandom.source=file:/dev/random

    取代為

    securerandom.source=file:/dev/./urandom
  • 將 securerandom.strongAlgorithms=NativePRNGBlocking:SUN

    取代為

    securerandom.strongAlgorithms=SHA1PRNG:SUN

9.10 缺少層級 2 或更高層級關係階層的組織圖按鈕

問題: 對於層級 2 或更高層級的關係,組織圖不顯示用於選擇要檢視的關係、導覽至關係階層中的下一層級、傳送電子郵件以及檢視關於該實體之詳細資訊的選項。當一般設定中的階層深度設定為層級 2 (或更高) 時,就會出現此問題。[問題:OCTCR56A585426]

解決方式: 若要檢視層級 2 (或更高層級) 關係的組織圖按鈕,請在組織圖中搜尋層級 2 使用者/實體。

9.11 升級後遠端載入器報告驅動程式物件密碼無效

問題: 在 Windows 平台上將遠端載入器升級至版本 4.9 後,無法使用基本驗證密碼連接到 Active Directory 驅動程式。[問題:OCTCR56A584022]

解決方式: 將 Identity Manager 升級至 4.9 後,執行以下步驟:

  1. 停止遠端載入器伺服器上的遠端載入器例項。

  2. 重設驅動程式物件密碼和遠端載入器密碼。

  3. 啟動 Active Directory 驅動程式的遠端載入器例項。

9.12 出現錯誤:Catalina 記錄檔案中顯示 StatusLogger 重新組態失敗

問題: 在 Windows 平台上安裝 Identity Manager 4.9 後,您可能會在 catalina.out 記錄中看到以下錯誤訊息:

錯誤:StatusLogger 重新組態失敗:在「null」中的「null」處找不到「<xxxxxxxx>」的組態

[問題:OCTCR56A584800]

解決方式: 該錯誤不會影響任何功能。您可以忽略該問題。

9.13 表單產生器問題

在表單產生器中處理 JSON 表單時,您可能會遇到以下問題。

欄位驗證訊息不能清晰傳達訊息

問題: 當使用者在欄位中輸入無效或不可接受的值時,表單欄位驗證訊息會告知使用者輸入有問題。這些訊息通常由鍵值組構成,其中的值會向使用者顯示。但在此版本中,表單欄位顯示的是鍵而不是相應的值。例如,輸入無效的電子郵件地址時,會顯示 invalid_email 而不是 Email must be a valid email。

[問題:OCTCR56A598009]

解決方式: 若要新增英文訊息,請執行以下操作:

  1. 啟動表單產生器。

  2. 按一下 當地語系化圖示。

  3. 按一下英文以展開控制項。

  4. 在最後一行新增尾隨逗號,然後新增訊息的鍵值組。

    例如,

    {
    "Submit": "",
    "error": "Please fix the following errors before submitting.", 
    "invalid_date": "{{field}} is not a valid date.", 
    "invalid_email": "{{field}} must be a valid email.", 
    "invalid_regex": "{{field}} does not match the pattern {{regex}}.", 
    "mask": "{{field}} does not match the mask.", 
    "max": "{{field}} cannot be greater than {{max}}.", 
    "maxLength": "{{field}} must be shorter than {{length}} characters.", 
    "min": "{{field}} cannot be less than {{min}}.", 
    "minLength": "{{field}} must be longer than {{length}} characters.", 
    "next": "Next", 
    "pattern": "{{field}} does not match the pattern {{pattern}}", 
    "previous": "Previous", 
    "required": "{{field}} is required"
    }
  5. 按一下「儲存」。

將 Designer 升級至版本 4.9 後表單欄位顯示非陣列驗證錯誤

問題: 如果單值表單欄位包含多個值,表單產生器現在會顯示非陣列驗證錯誤。最新版本的表單產生器中已新增這項驗證檢查。因此,將 Designer 升級至 4.9 版本後,現有表單中就會出現此問題。[問題:OCTCR56A586045]

解決方式: 若要修復該錯誤,請執行以下操作之一:

  • 在表單產生器中開啟表單,然後選取受影響表單欄位中的多個值核取方塊。如此會在該欄位中新增新增另一個按鈕,使用者可以透過該按鈕輸入更多值。

  • 修改受影響欄位中的「自訂預設值」函數,以便僅顯示陣列中傳回的第一個值,即使該陣列只有一個值。

滾動時表單產生器掛起

問題: 在表單 JSON 和 JS 編輯器檢視中滾動 JSON 表單時,表單產生器有時會凍結。在兩種情況下會出現此問題:

  • 在處理包含許多函數和方法的 JSON 表單時。

  • 當螢幕解析度與系統建議的值不同時。

[問題:OCTCR56A602415]

解決方式: 沒有可用的解決方式。您可以重新啟動表單產生器。

按鈕動作不起作用

問題: 升級至 Designer 4.9 後,JSON 表單中的按鈕元件不可用於執行核准和申請動作。[問題:OCTCR56A604329]

解決方式: 請執行以下步驟:

  1. 移至按鈕元件的顯示索引標籤。

  2. 複製按鈕申請邏輯或按鈕核准邏輯欄位中指定的邏輯。

  3. 將動作變更為自訂。

  4. 指定在步驟 2 中複製的邏輯。

  5. 按一下「儲存」。

網路樹元件問題

對於表單產生器中的網路樹元件,您可能會遇到以下問題:

  • 在表單預覽中,欄位顯示非陣列驗證錯誤。將網路樹元件設定為顯示預設值時會發生此錯誤。只有在解決驗證錯誤之後,您才能提交表單。[問題:OCTCR56A585664]

    若要解決該錯誤,請在表單 JSON 檢視中使用該欄位的 ID 變更預設值。

  • 網路樹元件的展開功能不能依預期運作。預覽表單不允許您展開或選取子容器。

  • 當您選取容器或子容器時,欄位會顯示 dn 值而不是 name。

    以下資料來源原始 JSON 是取自網路樹元件的範例資料:

    {
      "dn": "unique id",
      "name": "container data",
      "data": "any meta-data attached with the container",
      "subContainers": [
        {
          "dn": "id1",
          "name": "container data1",
          "icon": "glyphicon glyphicon-cloud"
        },
        {
          "dn": "id2",
          "name": "container data2",
          "data": "any meta-data attached with the container",
          "subContainers": [
            {
              "dn": "id3",
              "name": "container data3",
              "icon": "glyphicon glyphicon-cloud"
            }
          ]
        }
      ]
    }

    當您在預覽中選取 container data 選項時,欄位將顯示 unique id 而不是 container data。[問題:OCTCR56A603396]

10.0 聯絡 Micro Focus

如果遇到具體的產品問題,請在 https://www.microfocus.com/support-and-services/ 上聯絡 Micro Focus 支援人員。

可透過多種來源取得其他技術資訊或建議︰