API / SDK / developer guide
system.tag.readBlocking
| 目標讀者 TA | HMI 資料開發者 |
|---|---|
| 官方文件能力 | 讀取含品質與時間戳的標籤值。 |
| 輸入 → 輸出 | 標籤路徑 → 有序 QualifiedValue 清單。 |
| 執行環境 | Ignition8.3；有效標籤提供者與腳本範圍。 |
| 本站選型評估 | 呼叫阻塞至完成／逾時；單看數值可能忽略不良品質。 |
| 本站建議驗證 | 顯示前核對路徑對應、品質與新鮮度。 |
工業 IoT／SCADA · SDK
Ignition Scripting APIs
Inductive Automation
透過官方系統腳本函式擴充 SCADA 流程。
IGNITION 8.3 SCRIPTING / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 公司 | Inductive Automation 開發 Ignition，提供 SCADA 與應用建置功能的模組化工業自動化平台。 |
|---|---|
| 腳本邊界 | 這些 system 函式在 Ignition 範圍與安裝模組內執行，並非獨立 Python 套件或十個獨立網頁 API。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · system.tag.readBlockingAPI / SDK / developer guide | 讀取含品質與時間戳的標籤值。HMI 資料開發者 |
| 02 · system.tag.writeAsyncAPI / SDK / developer guide | 提交標籤寫入並以回呼取得完成結果。控制整合開發者 |
| 03 · system.db.execQueryAPI / SDK / developer guide | 執行 select Named Query 資源。資料庫整合者 |
| 04 · system.historian.queryRawPointsAPI / SDK / developer guide | 從設定提供者擷取原始歷史點。歷史資料分析者 |
| 05 · system.alarm.queryStatusAPI / SDK / developer guide | 依篩選查詢目前警報狀態。警報儀表板團隊 |
| 06 · system.dataset.toDatasetAPI / SDK / developer guide | 由 Python 資料列建立 Dataset。介面／報表開發者 |
| 07 · system.net.httpClientAPI / SDK / developer guide | 建立／重用 Java HTTP 用戶端。外部服務整合者 |
| 08 · system.util.getLoggerAPI / SDK / developer guide | 取得具名記錄器進行診斷。維運開發者 |
| 09 · system.util.invokeAsynchronousAPI / SDK / developer guide | 在不同執行緒執行 Python callable。互動介面開發者 |
| 10 · system.perspective.sendMessageAPI / SDK / developer guide | 將訊息送往設定的元件處理器。Perspective 開發者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
system.tag.writeAsync
| 目標讀者 TA | 控制整合開發者 |
|---|---|
| 官方文件能力 | 提交標籤寫入並以回呼取得完成結果。 |
| 輸入 → 輸出 | 路徑與值 → 回呼 QualityCode 清單。 |
| 執行環境 | Gateway／Vision／Perspective；適用標籤編輯權限。 |
| 本站選型評估 | 立即返回沒有結果；標籤寫入成功不是實體動作證據。 |
| 本站建議驗證 | 檢查每個回呼品質與獨立裝置回饋。 |
API / SDK / developer guide
system.db.execQuery
| 目標讀者 TA | 資料庫整合者 |
|---|---|
| 官方文件能力 | 執行 select Named Query 資源。 |
| 輸入 → 輸出 | 查詢路徑、參數及選用專案／交易 → Dataset。 |
| 執行環境 | Ignition8.3 具名查詢與設定的資料庫連線。 |
| 本站選型評估 | 此 API 接受具名查詢路徑，不是任意 SQL 文字。 |
| 本站建議驗證 | 驗證參數型別、所選專案與結果結構。 |
API / SDK / developer guide
system.historian.queryRawPoints
| 目標讀者 TA | 歷史資料分析者 |
|---|---|
| 官方文件能力 | 從設定提供者擷取原始歷史點。 |
| 輸入 → 輸出 | 歷史路徑／時間範圍 → 指定格式 Dataset。 |
| 執行環境 | 相容8.3修補版本與歷史提供者。 |
| 本站選型評估 | 8.3.9 參數有變更；returnSize 支援依提供者而異。 |
| 本站建議驗證 | 驗證精確簽章、時間戳、品質與截斷行為。 |
API / SDK / developer guide
system.alarm.queryStatus
| 目標讀者 TA | 警報儀表板團隊 |
|---|---|
| 官方文件能力 | 依篩選查詢目前警報狀態。 |
| 輸入 → 輸出 | 狀態／提供者／來源篩選 → AlarmQueryResult。 |
| 執行環境 | Ignition 範圍與設定的警報。 |
| 本站選型評估 | 狀態會結合警報事件；並非分開事件的日誌。 |
| 本站建議驗證 | 解讀零警報前記錄篩選與是否包含擱置警報。 |
API / SDK / developer guide
system.dataset.toDataset
| 目標讀者 TA | 介面／報表開發者 |
|---|---|
| 官方文件能力 | 由 Python 資料列建立 Dataset。 |
| 輸入 → 輸出 | 唯一欄名與資料列陣列 → Dataset。 |
| 執行環境 | Ignition 腳本執行環境。 |
| 本站選型評估 | 資料列須符合欄名長度，且每欄型別一致。 |
| 本站建議驗證 | 拒絕不齊資料列並驗證空資料集呈現。 |
API / SDK / developer guide
system.net.httpClient
| 目標讀者 TA | 外部服務整合者 |
|---|---|
| 官方文件能力 | 建立／重用 Java HTTP 用戶端。 |
| 輸入 → 輸出 | HTTP 方法／請求 → 回應物件。 |
| 執行環境 | Ignition 執行環境、端點存取與必要憑證。 |
| 本站選型評估 | 用戶端實例較重；8.3 亦提供共用實例用法。 |
| 本站建議驗證 | 保留憑證驗證，並區分連線逾時與回應成功。 |
API / SDK / developer guide
system.util.getLogger
| 目標讀者 TA | 維運開發者 |
|---|---|
| 官方文件能力 | 取得具名記錄器進行診斷。 |
| 輸入 → 輸出 | 記錄器名稱與訊息 → 範圍化診斷記錄。 |
| 執行環境 | Ignition 記錄設定與相關範圍。 |
| 本站選型評估 | 輸出記錄不代表交易／裝置完成。 |
| 本站建議驗證 | 使用關聯 ID 並遮蔽憑證與敏感內容。 |
API / SDK / developer guide
system.util.invokeAsynchronous
| 目標讀者 TA | 互動介面開發者 |
|---|---|
| 官方文件能力 | 在不同執行緒執行 Python callable。 |
| 輸入 → 輸出 | Callable 與參數 → 執行中的 Thread。 |
| 執行環境 | Gateway、Vision Client 或 Perspective 範圍。 |
| 本站選型評估 | Vision GUI 存取需透過後續 system.vision.invokeLater 交接。 |
| 本站建議驗證 | 分別追蹤完成／錯誤與立即執行緒建立。 |
API / SDK / developer guide
system.perspective.sendMessage
| 目標讀者 TA | Perspective 開發者 |
|---|---|
| 官方文件能力 | 將訊息送往設定的元件處理器。 |
| 輸入 → 輸出 | 訊息類型／內容與範圍 → 符合處理器活動。 |
| 執行環境 | Perspective 模組、目標工作階段／頁面與符合處理器範圍。 |
| 本站選型評估 | 這是 Perspective 訊息，不是外部裝置傳輸。 |
| 本站建議驗證 | 驗證預定處理器接收內容且不跨工作階段洩漏。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
僅為標籤／歷史資料應用契約示意；未執行 Ignition Gateway、資料庫、標籤讀寫或裝置操作。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
含品質的標籤讀取
| 輸入 | 已知展示路徑的合成 QualifiedValue。 |
|---|---|
| 預期結果 | 數值、品質與時間戳保持關聯。 |
| 驗收條件 | 品質／新鮮度驗證後才顯示為目前製程值。 |
無符合警報
| 輸入 | 有效篩選查詢回傳零筆狀態。 |
|---|---|
| 預期結果 | alarms=[]，保留篩選與擱置警報設定。 |
| 驗收條件 | 不可依篩選空結果宣稱所有設備安全。 |
標籤品質不良
| 輸入 | 讀取回傳含不良品質或過時時間戳的值。 |
|---|---|
| 預期結果 | 資料無效／過時；保留診斷品質。 |
| 驗收條件 | 不可將不良資料替換為零或標為即時。 |
非同步寫入等待回呼
| 輸入 | 已呼叫 writeAsync 但回呼未到。 |
|---|---|
| 預期結果 | pending；無已確認寫入結果或實體結果。 |
| 驗收條件 | 等待各 QualityCode，必要時驗證獨立製程回饋。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · IgnitionScripting-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "Ignition 8.3 scripting",
"status": "ok",
"input_id": "sample-001",
"data": {
"tag_path": "[default]Demo/Temperature",
"value": 23.5,
"quality": "Good (illustrative)",
"timestamp": "2026-10-08T00:00:00Z",
"physical_operation_verified": false
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
SCADA 事件匯出工具
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
先解決前置條件
安排實作前，需解決生命週期、授權、型號相容或存取條件。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 Ignition Scripting APIs 的存取、授權與支援版本。
- 準備上述樣本，針對「SCADA 事件匯出工具」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。