SuperMap GIS基礎產品FAQ集錦(20250901)

一、SuperMap iDesktopX

問題1：咨詢MapGIS數據遷移功能是否支持MapGIS 10版本，在遷移10版本的符號庫時卡在0%并報錯“升級6x系統庫失敗”。

11.3.0
在這里插入圖片描述

【問題原因】客戶使用問題，mapgis6.7里面工程文件和符號庫之前沒有綁定關系，mapgis10中，工程文件和所使用的符號庫已經確定了綁定關系，所以兩者遷移時，參數設置不同。
【解決辦法】
1、原始數據為mapgis6.7版本保存的工程文件，直接遷移mpj，需要設置指定符號庫，這里的符號庫需要指定到6.7版本下的符號庫；
2、通過將mpj另存為mapx后，如果直接遷移，則同樣需要指定符號庫，這里的符號庫需要指定到6.7版本下的符號庫；不能指定10版本的符號庫；
3、通過將mpj另存為mapx后，并且在mapgis 10軟件上打開mapx工程文件，對所有圖層重新指定符號庫后保存mapx。遷移則不需要指定特定符號庫，直接遷移。

問題2：咨詢在iDesktopX二次開發中，是否能實現將所有數據導出功能（如導出shp, tif, Excel等）與數據庫的特定用戶進行權限綁定，限制某些用戶的導出操作。

11.3.0
【解決辦法】可以考慮以下方案進行功能顯隱控制：
1、獲取數據庫用戶權限映射關系可以基于純java代碼連接數據庫獲取；
2、根據用戶的權限情況，準備多份工作環境配置，每份工作環境根據需要配置對應的功能[圖片]；
3、每份工作環境中都移除“工作環境選擇”功能[圖片]，禁止用戶通過 iDesktopX 自己選擇工作環境；
4、在 iDesktopX 登錄用戶時，根據登錄的用戶綁定對應的工作環境，做成用戶/角色與工作環境的強綁定關系，代碼如下：
//加載工作環境配置
WorkEnvironment workEnvironment = new WorkEnvironment();
workEnvironment.initWorkEnvironment(file);
//啟用工作環境
Application.getActiveApplication().getWorkEnvironmentManager().setActiveWorkEnvironment(workEnvironment);
Application.getActiveApplication().reLoadFormUI();

問題3：咨詢如何使用SuperMap產品計算對象的橢球面積。

11.3.0
【解決辦法】可以使用數據集的“計算幾何屬性”功能，其中有“測地線面積（SmArea）”選項，即為橢球面積。

問題4：在GPA建模中，“迭代數據集”算子里的通配符應該怎么填寫？

11.3.0
【解決辦法】通配符的使用方法如下：*表示使用任意字符，?表示使用任意單個字符。可使用通配符來限制輸入名稱，如果未使用通配符，則返回所有輸入。

問題5：咨詢在桌面產品中，是否可以通過“更新列”功能，直接去掉一個字段值中所有的中文字符。

11.3.0
【問題原因】“更新列”功能沒有直接移除所有中文字符的內置函數。
【解決辦法】可以嘗試根據中文字符在字符串中的位置規律，結合使用字符串截取、替換等函數進行處理。

問題6：在iDesktopX中執行“添加視頻地圖”功能后，場景中無法正常顯示視頻內容。

11.3.0
【問題原因】用戶電腦的顯卡驅動存在異常。
【解決辦法】重新安裝最新的顯卡驅動，并參考官方文檔進行三維硬件加速設置優化后，問題解決。參考鏈接：https://blog.csdn.net/supermapsupport/article/details/128440798

問題7：在iDesktopX擴展開發中，如何通過代碼實現關閉Tab頁或程序時不彈出“是否保存”的提示框。

11.2.1
【解決辦法】在iDesktopX文件》選項》常用中取消“窗口關閉時提示保存”

問題8：在iDesktopX 11.3中修改了色卡方案并保存后，咨詢如何恢復到產品的默認色卡設置。

11.3.0
【解決辦法】從一個新的iDesktopX解壓包中，將\templates\ColorScheme\目錄下的所有文件復制并覆蓋到當前使用的產品路徑下，即可還原默認設置。

問題9：使用3ds Max插件導出的模型數據，在iDesktopX中查看數據集有對象和屬性，但添加到三維場景中不渲染顯示。

11.3.0
在這里插入圖片描述

【解決辦法】1.max建模通常單位為米，使用插件導入數據后，數據集屬性重設坐標系為建模對應的坐標系，如需添加至球面場景建議投影轉換至對應地理坐標系。詳見官方博客https://blog.csdn.net/supermapsupport/article/details/127495748，6.1.8問題八‘如何將模型導出到正確的地理位置’以及問題九‘3ds Max中模型位置離坐標原點過遠使用球面場景導出后，模型在場景中看不到。’2.模型存在建模冗余數據，模型屬性表計算幾何屬性檢查位置，使用三維數據-模型工具-屬性提取頂點數量，三個點構成一個面，模型位置異常少于三個頂點的冗余數據可自行刪除。3.模型范圍異常，可通過右鍵數據集重新計算范圍。或屬性表選中后另存數據集。

問題10：在iDesktopX 2025中，是否可以使用多邊形開挖功能對S3M格式的傾斜攝影模型進行開挖呢？

12.0.0
在這里插入圖片描述

【解決辦法】多邊形開挖功能是針對地表（地形）數據的，不支持對S3M模型操作。若要對傾斜攝影S3M數據進行開挖，應使用“三維分析-傾斜攝影數據”下的“挖洞”功能。

問題11：咨詢SuperMap iDesktop 12i版本的數據遷移功能是否支持遷移ArcGIS Pro的工程文件。

12.0.0
【解決辦法】支持。可以使用數據遷移工具中的“APRX遷移”功能來遷移ArcGIS Pro的工程文件，此功能對本機是否安裝ArcGIS或其許可沒有要求。

問題12：在iDesktopX中進行繪制操作時，動態顯示的參數提示框會遮擋視線，影響繪制。

11.3.0
【解決辦法】在“對象操作”選項卡的“繪制設置”中，取消勾選“參數化繪制”即可關閉該提示框。

問題13：在Linux服務器上使用SuperMap iDesktopX 11i 2024版本打開數據庫型數據源時報錯，且數據顯示不全。

11.3.0
【解決辦法】用戶將iDesktopX版本升級到2025最新版后，問題解決，可以正常連接數據庫。

問題14：使用iDesktopX的服務遷移功能將ArcGIS服務轉換為iServer服務，頁面提示轉換完成，但在iServer的服務列表中并未找到新轉換的服務。

11.3.0
在這里插入圖片描述

【問題原因】用戶的原始ArcGIS MAP服務需要賬號密碼驗證，而iDesktopX的服務遷移功能不支持攜帶賬號密碼信息進行驗證，導致服務轉發失敗。
【解決辦法】直接在iServer上轉發ArcGIS服務，iServer上支持填寫認證信息進行轉發。

問題15：使用iDesktopX 11.3.0版本連接PostGIS數據源失敗，而舊版iDesktop 11.2.0可以正常連接同一數據源，咨詢是否需要修復數據源以及修復操作是否會影響生產環境。

11.3.0
【問題原因】新版組件需要使用jsonb數據類型，但用戶使用的PostgreSQL 9.3.5版本不支持該類型（9.4版本后支持）。
【解決辦法】建議將PostgreSQL數據庫升級到9.4或更高版本，以兼容新版iDesktopX產品。

問題16：咨詢iDesktop產品中的“管點管線檢查”工具，在iDesktopX產品中是否有對應的功能。

11.3.0
【問題原因】“管點管線檢查”是基于iDesktop(.NET)開發的擴展工具，iDesktopX(Java)中沒有內置此功能。
【解決辦法】如需使用該功能，建議繼續在iDesktop產品中操作。

問題17：在iDesktopX中打開PostgreSQL空間數據庫型數據源，無法顯示其中的數據集。

11.3.0
【問題原因】根據日志分析，用戶在iDesktopX中執行了刪除數據源操作，導致數據源信息損壞。
【解決辦法】將PostgreSQL數據庫中的空間表導出為shp文件，新建一個數據庫，然后在iDesktopX中創建新的數據庫型數據源并重新導入shp文件。

問題18：咨詢iDesktopX 11版本與iServer 10版本是否兼容，能否使用高版本桌面發布服務到低版本服務器。

11.3.0
【解決辦法】不建議跨大版本使用產品（如桌面、服務器、前端），因為大版本之間改動較大，可能會出現不兼容的情況。建議保持各產品大版本一致。

問題19：咨詢iDesktopX中的AI助理功能是否需要單獨購買擴展模塊許可。

11.3.0
【解決辦法】iDesktopX AI助理是基礎版自帶的功能，不需要額外選配擴展模塊。

問題20：在iDesktopX 12i中，對三維網絡數據集進行三維管網符號化，直接修改圖層風格時管網連通性正常，但使用自定義專題圖（適應管徑大小）后，管網節點間的連通性出現異常，如何解決呢？

12.0.0
【解決辦法】1、三維管網中的管點并非單一類型，而是包含閥門、檢查井、水表井等多種功能類別，且不同類別管點需與對應管徑的管線匹配銜接。
2、若統一使用同一種管點符號進行配置，會因符號尺寸、定位基準與部分管徑管線不兼容，導致自定義專題圖模式下連通性異常。
3、需按管點的實際類型（如閥門、各類井體等）分類制作專屬符號，確保每種管點符號的尺寸、銜接基準與所連接的管線管徑適配，從而修復連通性問題。

問題21：使用iDesktopX 12i版本導入SHP文件失敗，日志提示“Set SHAPE_RESTORE_SHX config option to YES to restore or create it.”，無法正常導入數據。

12.0.0
【問題原因】源SHP數據中缺少.shx索引文件。
【解決辦法】重新獲取完整的源數據，確保包含.shp、.shx、.dbf等必要文件后再進行導入。

問題22：在同一地圖比例尺下，平移地圖后，地圖中的符號樣式會發生變化，如何解決？

11.3.0
在這里插入圖片描述

【解決辦法】符號子線設置連接樣式為斜角連接。

問題23：咨詢基于iDesktopX進行擴展開發，若功能模塊調用了底層的iObjects Java空間分析接口，是否可以使用iDesktopX基礎版許可運行。

11.3.0
【解決辦法】不可以。iDesktopX基礎版許可不包含空間分析功能模塊，需要購買基礎版及空間分析擴展模塊的許可才能運行調用了空間分析接口的擴展功能。

問題24：咨詢在iDesktopX中，如何實現一個功能：判斷一個指定范圍內是否存在多個點對象，如果存在，則將這些點標記為重復點。

11.3.0
【解決辦法】：（1）通過‘緩沖區分許’生成點數據集的緩沖區
（2）通過‘屬性更新’將緩沖區范圍內的點要素的編碼通過‘，’字符連接，添加到目標字段

問題25：iDesktopX 11.3版本，將GeoJSON文件導入到PostGIS數據源時操作失敗。

11.3.0
在這里插入圖片描述

【問題原因】：當前數據源"sgs_digicity_defspace"缺少sm系統表
【解決辦法】：工具箱—‘修復數據源’，對數據源進行修復

問題26：iDesktopX創建矢量金字塔時報告主鍵不唯一錯誤，雖然金字塔最終創建成功，但在地圖中會導致數據顯示出現空洞。

11.3.0
在這里插入圖片描述

【問題原因】金字塔構建過程中部分瓦片因主鍵沖突被跳過生成
【解決辦法】檢查數據，去除重復的主鍵之后重建空間索引，再去創建矢量金字塔

問題27：在iDesktopX 11i中打開從ArcGIS Pro提供的數據，發現與底圖疊加時存在坐標偏差，而數據在ArcGIS中顯示正常。

11.3.0
【問題原因】iDesktopX不支持識別.jpg格式的影像坐標
【解決辦法】在ArcGIS中把這個影像圖片導出為tif文件，再在iDesktopX中打開就能正常識別坐標了

問題28：咨詢iDesktopX的“更新列”功能是否能夠實現字段值的自動補全，例如將"N3L1D15"批量處理為"N003L01D015"。

11.3.0
【解決辦法】使用”更新列“里的”函數運算“功能，輸入表達式：‘N’ ||
substr(‘000’ || substr([字段名], instr([字段名],‘N’)+1, instr([字段名],‘L’)-instr([字段名],‘N’)-1), -3) ||
‘L’ ||
substr(‘00’ || substr([字段名], instr([字段名],‘L’)+1, instr([字段名],‘D’)-instr([字段名],‘L’)-1), -2) ||
‘D’ ||
substr(‘000’ || substr([字段名], instr([字段名],‘D’)+1), -3)

問題29：IDeskTopX二次開發，Generalization.aggregatePolygons返回值是null，怎么看是什么原因導致的

11.3.0
【問題原因】數據集的坐標系不正確導致面聚合的失敗。
【解決辦法】對數據集重設正確的坐標系后，可正常執行面聚合并返回結果。

問題30：12i的idesktopx，對接海量數據庫（Vastbase G100，v2.2.15）遇到個問題。將udbx的二維線數據復制到海量數據庫的數據源，postgres、vastbase連接方式都出現字段丟失的情況；只有postgis連接方式才能保留全部字段。但是客戶期望走postgres連接方式來配合業務系統。應該如何排查呢?

12.0.0
【問題原因】字段丟失是因為該字段長度超過了數據庫限制。
【解決辦法】修改字段長度后，可確保字段不丟失。

問題31：iDesktopX2025安裝版，安裝時候跳出錯誤，是因為什么呀，使用了管理員安裝也設置了勾選了目錄的完全控制權限，也還是報錯

12.0.0
在這里插入圖片描述

【問題原因】指定的安裝目錄字符太長，安裝過程中部分文件目錄長度超出windows限制。
【解決辦法】1.按照默認路徑安裝或指定一個較短的安裝目錄；2.官網下載最新安裝包，產品已做優化：https://support.supermap.com/DownloadCenter/DownloadPage.aspx?id=2985

問題32：SuperMap iDesktopX11.3.0擴展開發自定義exe，運行后會卡在啟動界面，是什么原因？

11.3.0
【問題原因】iDesktopX11.3.0生成exe的腳本變更了。
【解決辦法】請在下方鏈接獲取新的腳本：
鏈接: https://pan.baidu.com/s/1jx4JoLwoj8AwW5iokOITrQ?pwd=74ux

問題33：iDesktopX桌面需要對模型數據集瓦片進行裁剪時，需要向場景中添加一個傾斜才能激活裁剪按鈕。

11.3.0
在這里插入圖片描述

【解決辦法】已在iDesktopX12i中實現直接添加模型數據集瓦片后進行裁剪，下載鏈接https://support.supermap.com/DownloadCenter/DownloadPage.aspx?id=2985

問題34：iDesktopX中同一個點數據集，我想實現只顯示一部分點的注記，但點符號要全顯示，怎么操作？

11.3.0
【解決辦法】地圖屬性中壓蓋設置里面點隨標簽顯隱勾掉

二、SuperMap iServer

問題1：咨詢通過iServer的數據服務添加一個要素時，是否只能使用POST請求。嘗試使用PUT請求時報“字段名與字段值數量不相等”的錯誤。

11.3.0
【問題原因】用戶的請求寫錯了
【解決辦法】iServer數據服務的feature接口支持使用PUT請求，參考示例：https://help.supermap.com/iServer/zh/mergedProjects/SuperMapiServerRESTAPI/root/data/datasources/datasource/datasets/dataset/features/feature/feature.htm

問題2：iServer配置使用云許可（員工許可）登錄時報錯，無法獲取許可。

11.3.0
【問題原因】iServer連接Online云許可服務中斷或異常。
【解決辦法】登錄SuperMap Online許可管理界面，強制退出該機器的許可連接，然后在iServer許可配置頁面重新連接即可。

問題3：使用iServer 20250729雙周包，管理頁面的“服務管理”按鈕點擊后無法跳轉，而舊版本則正常。

12.0.0
【解決辦法】該問題通常由瀏覽器緩存導致，清空瀏覽器緩存后即可解決。

問題4：使用iServer的API更新服務狀態時，傳入了管理員賬戶申請的Token，但請求依然返回400錯誤。

11.3.0
【問題原因】API請求體（body）的JSON格式錯誤，參數應為一個數組，但用戶傳入的是一個對象。
【解決辦法】在請求體的最外層加上方括號“[]”，將其構造成一個JSON數組格式。

問題5：iServer運行GPA流程報錯，提示:javalang.llegalStateException, hasp feature expired

11.3.0
在這里插入圖片描述

【問題原因】許可過期了，缺少許可。
【解決辦法】重新申請許可。

問題6：iServer轉發一個開啟了安全認證的ArcGIS REST地圖服務時，服務無法啟動，日志提示圖層不存在。

11.3.0
在這里插入圖片描述

【問題原因】源ArcGIS服務開啟了安全認證，但在iServer中創建Web數據源進行轉發時，未填寫認證所需的用戶名和密碼。
【解決辦法】在iServer中配置轉發服務時，正確填寫源服務的安全認證信息即可。

在這里插入圖片描述

問題7：部署iServer時，查看啟動日志發現大量錯誤信息，但服務可以正常運行。

11.3.0

【解決辦法】經查看完整日志，確認報錯與操作系統缺少某些字體相關，這些錯誤不影響iServer的核心功能和正常使用。

問題8：在并發調用已發布的GPA模型時，由于模型中以秒級時間變量創建數據源導致命名沖突而失敗，咨詢解決方案。

11.3.0
【問題原因】并發調用時，以秒為單位的時間變量可能產生重復值，導致創建文件型數據源重名失敗。
【解決辦法】在GPA模型中，使用行內變量%Date#timespan%（基于時間戳）的方式為創建的數據源命名，可解決命名沖突問題。

問題9：咨詢iServer集群環境下，主版本使用12i而服務擴展節點使用11i版本是否兼容。

12.0.0
【解決辦法】不支持跨版本部署，iServer主版本與服務擴展節點版本需要保持一致。

問題10：咨詢如何配置iServer，以隱藏web打印和數據目錄服務列表，避免匿名用戶直接訪問到該服務

11.3.0
在這里插入圖片描述

【解決辦法】使用11.1.0及其以上版本，并參考以下文檔可以禁止匿名用戶訪問web打印和數據目錄服務iServer的services頁面去掉web打印服務和數據目錄服務的方法

問題11：通過第三方客戶端（如高德地圖API、QGIS）以ZXY方式加載iServer發布的MVT矢量瓦片服務時，出現位置偏移。

11.3.0
【問題原因】底圖和數據的坐標不一致導致的偏移
【解決辦法】底圖為3857，數據為4326，修改數據為3857后，加載就正常了

問題12：iServer支持發布存放在S3對象存儲里面的工作空間了嗎

11.3.0
【解決辦法】目前iServer不支持直接發布S3對象存儲里面的工作空間

三、SuperMap iClient3D for WebGL

問題1：尋求官網一篇關于白模美化文章中使用的測試數據和PBR材質文件。

11.3.0
【解決辦法】支持人員提供了相關材質包的下載地址，并說明測試數據可使用任意建筑矢量面數據按文檔流程處理得到。材質包下載地址：https://pan.baidu.com/s/1gWptYf7OarDkwl41BqwzPA?pwd=2wu2

問題2：iServer發布的ArcGIS瓦片服務，在iServer自帶的WebGL預覽中請求的是webp格式，但在外部WebGL示例中加載時請求的是png格式，咨詢如何指定請求webp格式。

11.3.0
【解決辦法】在前端代碼中加載REST地圖服務時，通過設置tileFormat參數為’webp’來指定請求的瓦片格式。

問題3：咨詢iClient3D for WebGL中，用于對三維模型進行位置移動和旋轉操作的接口或實現方法。

11.3.0
【解決辦法】可以參考官方提供的KML編輯范例實現：http://support.supermap.com.cn:8090/webgl/Cesium/examples/webgl/editor.html#KML_edit

問題4：在iClient3D for WebGL加載iServer地圖服務時，是否支持在前端根據不同的地圖比例尺來控制圖層的顯示與隱藏。

11.3.0
【解決辦法】可以通過監聽iClient3D for WebGL場景的相機變化事件，獲取相機高度并將其換算為地圖比例尺，根據比例尺值動態設置影像圖層的顯示或隱藏。換算代碼參考：https://share.note.youdao.com/s/PzfRWDqe

四、SuperMap 其他

問題1：客戶采用私有云許可（Web許可），由于網絡管制需要將許可服務器地址加入白名單，咨詢該地址是什么。

11.3.0
【解決辦法】私有云許可（Web許可中心）的訪問地址格式為http://ip:9183，其中ip為部署Web許可中心服務的那臺機器的IP地址。

問題2：咨詢SuperMap的3ds Max插件是否支持3ds Max 2021版本。

11.3.0
【解決辦法】不支持。3ds Max插件目前僅支持偶數版本（如2018, 2020, 2022, 2024），不支持奇數版本。

問題3：咨詢Web正式許可是否綁定服務器MAC地址，以及當服務器故障或更換時，如何遷移或重新申請許可。

11.3.0
【解決辦法】Web正式許可是通過*.reportc文件生成的，綁定了服務器的MAC地址。如果需要更換服務器，可以聯系【集團管理支撐團隊/合同管理團隊】重新辦理許可。

五、SuperMap iPortal

問題1：iPortal服務啟動成功后，通過瀏覽器無法訪問其首頁。

11.3.0
【問題原因】用戶使用的Chrome瀏覽器版本過低（81版本），不支持iPortal前端頁面所需的JavaScript replaceAll 方法。
【解決辦法】將Chrome瀏覽器升級到85或更高版本即可正常訪問。

問題2：咨詢iPortal版本升級后，舊版本中已注冊的服務、制作的地圖工作室與地圖大屏等內容是否能夠遷移到新版本中。

11.3.0
【解決辦法】iPortal支持版本升級和內容遷移，具體操作可參考官方教學視頻：https://www.bilibili.com/video/BV1pC4y1A7jB?p=20

問題3：iPortal使用管理員用戶登錄后，頁面仍持續彈出提示信息，無法正常使用。

11.3.0
【問題原因】iPortal啟動日志報錯“java.lang.RuntimeException: can not run elasticsearch as root”，是由于用戶以root用戶解壓并啟動了iPortal服務。
【解決辦法】使用非root用戶重新解壓并啟動iPortal服務即可。

六、SuperMap iManager

問題1：iManager云套件環境在斷電重啟后，部分空間分析服務出現異常，而使用相同工作空間的地圖數據服務卻能正常訪問，節點均在線。

11.3.0
【問題原因】云套件的這個服務實例指定了多個服務節點，服務節點存在異常所致。
【解決辦法】將服務實例指定一個服務節點，且該服務節點開啟多個副本。

問題2：在Kubernetes（K8S）環境中，由于iManager沒有許可無法進入管理頁面，咨詢如何重新指定許可服務（bslicense-server）運行到特定的工作節點。

11.3.0
【解決辦法】1. 進入K8S Dashboard頁面，切換到supermap命名空間；2. 在Deployments中找到 “bslicense-server” 并編輯其YAML配置；3. 在spec.template.spec層級下添加nodeName字段，值為目標節點的名稱；4. 保存后，許可服務會自動調度到指定節點。