🐬【教學】Spotfire 執行按鈕報錯「The name is already used」完整排查與修復指南（含腳本示例）

-

摘要

本文以淺顯方式說明：在 TIBCO Spotfire 點擊自訂按鈕（例如 Run Rpt）後，出現錯誤

Could not execute script 'runrpt': The name 'FT_YIELD_RPT' is not a valid table name since the name is already used.

該如何快速定位問題與修復。文內提供三種安全做法（取代資料、先刪後建、自動避開撞名），並補充「資料來源帳密要求」常見排查清單，幫你從零搞懂發生原因與處理邏輯。


你遇到的狀況（白話版）

  • 開啟 DXP 後按下 Text Area 的按鈕（例如：Run Rpt）。

  • Spotfire 執行內嵌腳本（通常是 IronPython 或 Data Function）去產生/更新一張報表資料表。

  • 第一次可能成功，但第二次就跳錯：「這個表名已被使用」。

  • 另外，有時開檔會跳出「請輸入資料來源帳密」的視窗，帳密看起來正確卻連不上。

為何會報「name already used」？

在 Spotfire 裡，每張資料表 名稱不可重複。
如果腳本每次都用 CreateDataTable("FT_YIELD_RPT", ...) 或資料函數輸出固定表名，就會在文件已存在同名表時失敗。

一句話：你正在「再建立一次同名表」，所以撞名。


三種修法（依建議順序）

A. 推薦：保留視覺與欄位設定，改用「取代資料」

重點： 不要重建表，改為 ReplaceData，讓同名表「原位換資料」。

（示例：改良後的 IronPython 範例，已匿名化） 

from Spotfire.Dxp.Data import DataManager
from Spotfire.Dxp.Data.Import import TextFileDataSource, TextDataReaderSettings

table_name = "FT_YIELD_RPT"

# 假設你的資料來源是檔案；若是資料庫/查詢，改為對應的 DataSource 物件
settings = TextDataReaderSettings()
settings.Separator = "\t"
data_source = TextFileDataSource(r"C:\path\report.tsv", settings)

dm = Application.GetService[DataManager]()

if Document.Data.Tables.Contains(table_name):
    # 已存在 → 原位更新資料
    Document.Data.Tables[table_name].ReplaceData(data_source)
else:
    # 首次建立
    dm.CreateDataTable(table_name, data_source)

優點

  • 保留視覺化設定、計算欄位、標籤、篩選、關聯。

  • 執行速度與使用者體驗佳。

B. 簡單粗暴：先刪同名，再新建

如果這張表只給該報表用、刪除不會影響其它圖表，就可直接移除再新建。 

from Spotfire.Dxp.Data import DataManager
from Spotfire.Dxp.Data.Import import TextFileDataSource, TextDataReaderSettings

table_name = "FT_YIELD_RPT"
dm = Application.GetService[DataManager]()

if Document.Data.Tables.Contains(table_name):
    Document.Data.Tables.Remove(Document.Data.Tables[table_name])

# 重新建立資料表
settings = TextDataReaderSettings()
settings.Separator = ","
data_source = TextFileDataSource(r"C:\path\report.csv", settings)
dm.CreateDataTable(table_name, data_source)

注意

  • 可能需要重接關聯或重設視覺標籤（視你的 DXP 設計而定）。

C. 需要歷史快照？自動避開撞名（加尾碼）

如果你的需求是「每次產生一張新快照表」，那就不要固定表名，自動加數字尾碼。 

base = "FT_YIELD_RPT"
name = base
i = 1
while Document.Data.Tables.Contains(name):
    i += 1
    name = "{}_{}".format(base, i)

# 用 name 建立新表，不會撞名
# ... data_source 準備同上
new_table = Application.GetService[DataManager]().CreateDataTable(name, data_source)
print "Created table:", name

如果是 Data Function（R / TERR / Python）產生的表

  • 開啟 Edit ▸ Data Function Properties…

  • 在 Output Parameters 把輸出表設定為：Replace existing（或是把輸出表名改為不重複）。

  • 確定資料函數每次執行不會硬要「新增同名表」。

兩段快速自我檢查腳本

1) 目前文件有哪些資料表？ 

for t in Document.Data.Tables:
    print t.Name

2) 按鈕綁的腳本在哪？

  • 右鍵 Text Area → Edit HTML → Edit Script…

  • 找到 runrpt 或相關腳本，檢查是否有 CreateDataTable("FT_YIELD_RPT", ...) 或資料函數輸出的表名剛好一樣。

額外加碼：開檔時一直跳「請輸入資料來源帳密」怎麼辦？

這通常不是「登入 Spotfire」出錯，而是 DXP 裡的資料來源連線需要認證或連不到。以下是手順級檢查清單：

  1. 找出連的是誰
    Data ▸ Data Table Properties ▸ 選表 ▸ Source/Settings → 確認連線類型（SQL/Oracle/ODBC/檔案）、Server、Database、認證方式。

  2. 帳號格式

    • Windows/AD：試 DOMAIN\user 或 user@domain。

    • 純資料庫帳號：只填帳號，不加網域。

  3. 同機測試連線

    • SQL Server：
      sqlcmd -S <server>,<port> -U <user> -P <password> -Q "SELECT 1"

    • Oracle：
      tnsping <TNS> → sqlplus <user>/<password>@<TNS>

  4. 認證方式吻合

    • 連線設定若從「Windows/SSO」換成「Database/SQL Authentication」，原本能用的 AD 帳號會失效（反之亦然）。

    • 於連線頁按 Test Connection。

  5. 驅動/位元數正確

    • Spotfire 64-bit → 驅動與 DSN 需 64-bit。

    • Oracle 要有對應版本 Client，TNS_ADMIN 指向正確 tnsnames.ora。

  6. 網路/VPN/防火牆

    • ping <server>、Test-NetConnection <server> -Port <port> 檢查可達性。

  7. 帳號鎖定/密碼過期

    • 請 DBA 查登入日誌，排除被鎖或密碼過期。

  8. Information Link 認證策略

    • Tools ▸ Information Designer → 該 Data Source 是否被設為 Prompt user；如能用 SSO/Trusted，改成不跳視窗。

常見問答（FAQ）

Q1：我想保留所有儀表板格式與計算欄，哪個做法最好？
A：ReplaceData。它只換資料，不動視覺設定。

Q2：我想「每次」產生一份報表快照怎麼辦？
A：用「自動加尾碼」避開撞名，並把快照日期或批次號塞進尾碼，方便管理。

Q3：按下按鈕就跳要帳密視窗，能不能別每次都輸入？
A：可在資料連線裡設定 Save password（注意公司資安政策）或採用 SSO/Trusted 方式；若是排程，建議在伺服器端用固定服務帳號執行。

結語

這個錯誤的本質其實很單純：同名表被重建。
把「新增」改為「取代」，或在確定不影響的情況下「先刪再建」，就能優雅地解決。再搭配上方的資料來源連線檢查清單，你的 Spotfire 報表按鈕就能穩定跑起來。

下載小抄（Check List）

  • 用腳本列出目前所有資料表名稱

  • 檢查 runrpt 是否使用 CreateDataTable 固定表名

  • 優先改為 ReplaceData

  • 如需快照 → 自動加尾碼

  • Data Function 輸出設為 Replace existing

  • 連線帳密/認證方式/驅動/網路逐項測試

留言

張貼留言

這個網誌中的熱門文章

🔍Vue.js 專案錯誤排查：解決 numericFields is not defined 與合併儲存格邏輯最佳化

-
  前言 在前端開發專案中，處理表格數據與 Excel 匯出是常見的需求。 最近在專案中，遇到一個常見但讓人頭痛的錯誤訊息： Uncaught ReferenceError: numericFields is not defined 本文將用簡單的方式，帶你了解這個錯誤的成因、如何修改程式碼，以及如何最佳化「合併儲存格」與「數值加總」的邏輯。 問題場景：表格合併與數值加總 專案中需要達成以下功能： 同一個 APS_PLAN_NO 下，若 TFT4 相同，則 TFT5 欄位要合併。 數值欄位要加總，並以千分位格式輸出。 匯出到 Excel 時，也要套用相同邏輯。 在 Vue 的 rowSpans 計算邏輯中，初始版本如下： const rowSpans = computed ( () => { const rows = filteredData. value const spans = rows. map ( () => { const obj = {} tableHeaders. value . forEach ( key => obj[key] = 0 ) return obj }) ... return spans }) 但是，當我們在 exportToExcel() 使用時，出現了以下錯誤： Uncaught ReferenceError: numericFields is not defined 錯誤原因 這個錯誤訊息代表： 👉 numericFields 在程式中根本沒有宣告，所以瀏覽器不知道它是什麼。 舉例來說，假設我們在程式裡寫了這樣的判斷： if (numericFields. includes (key)) { // 處理數值欄位 } 但其實 numericFields 沒有定義，程式就會直接報錯。 解決方案：定義 numericFields ...
閱讀完整內容

🖥️遠端桌面連線完整新手指南：Windows RDP、Chrome Remote Desktop、AnyDesk、TeamViewer 一次搞懂

-
目錄 什麼是遠端桌面？我為什麼需要？ 方法一：Windows 10/11 內建遠端桌面（RDP） 方法二：Chrome Remote Desktop（免固定 IP） 方法三：AnyDesk / TeamViewer（跨平台、穿透 NAT） 安全性最佳實務 常見問題與故障排除（速查） 工具比較表 選擇流程圖（工程師的懶人決策） 出門前最後檢查清單 FAQ 常見問答 什麼是遠端桌面？我為什麼需要？ 「遠端桌面連線」讓你在 A 電腦上，直接操作 B 電腦的桌面與程式，就像坐在 B 電腦前一樣。 常見情境：出差連回公司電腦、在家存取辦公室檔案、協助同事排錯、或在手機/平板臨時控管主機。 方法一：Windows 10/11 內建遠端桌面（RDP） 前置條件 被連線的電腦版本需為 Windows 10/11 專業版或企業版。 兩台電腦彼此能網路互通（同網段、VPN、或正確路由）。 被連線端設定（只需做一次） 打開： 設定 → 系統 → 遠端桌面 → 啟用。 記下「此電腦名稱」或 IP。 確保 Windows 防火牆允許「遠端桌面」。 連線端操作 按 Win + R → 輸入 mstsc → Enter。 在「電腦」欄位輸入對方電腦名稱或 IP → 連線 → 輸入該電腦的帳號密碼。 跨外網的正確姿勢 首選 VPN ：先連公司/家裡的 VPN，再用 RDP，安全又穩。 不建議直接把 3389 埠對外曝光；若不得已，請做好強密碼、改連接埠、IP 白名單與入侵偵測。 方法二：Chrome Remote Desktop（免固定 IP） 優點是跨平台、穿透 NAT、用 Google 帳號配對，對新手友善。 在被連線與連線端都安裝 Chrome 與 Chrome Remote Desktop 擴充。 以同一 Google 帳號登入，為「被連線」電腦設定 PIN。...
閱讀完整內容

🔎EF Core 連 Oracle 出現 ORA-00600 [kpp_concatq:2] 的完整排錯指南（含 EF Core ToString/CultureInfo 錯誤）

-
  摘要（Meta Description） 在 .NET EF Core 對 Oracle 查詢時，若遭遇 ORA-00600 [kpp_concatq:2] ，多半是查詢優化器在字串型別轉換或重寫（Query Transformation）時踩到版本 Bug。本文以實戰日誌形式，示範如何用 FromSqlRaw + 參數型別/長度對齊 + CAST + Hint 立即止血，並處理 EF Core 另一個常見錯誤：「 CultureInfo 常值被傳進 ToString 造成可能記憶體外洩 」。附可直接套用的程式碼。 目錄 錯誤現象 根因分析 三步驟「立即止血」 安全重構：可直接貼用的程式碼 進階避雷：CTE/MATERIALIZE 與 View 包裝 EF Core ToString / CultureInfo 錯誤的正確處理 版本與長期解法（根治） 效能與穩定性小技巧 檢查清單（Checklist） FAQ 結語 錯誤現象 常見堆疊片段如下（節錄）： Oracle .ManagedDataAccess .Client .OracleException ( 0 x80004005): ORA-00600 : 內部錯誤代碼, 引數: [kpp_concatq:2] , [4] , [3] ...
閱讀完整內容