關於註冊與取消註冊
註冊涉及識別適用於特定方案的特定客戶,並在客戶、方案以及安裝 (或已安裝) 一或多個可控制裝置的裝置位置 (如果適用) 之間建立關係。註冊處理的主要結果是方案訂閱,可將客戶與方案和 (在大多數情況下) 裝置位置連結。此處理也可涉及為了設定可控制裝置所執行的一或多個動作。例如,對於公用事業提供並安裝在客戶位置的裝置,註冊處理會建立工作活動,用於排定工班安裝裝置。另一個常見的裝置設定動作涉及發出「裝置狀態檢查」指令要求,控制系統會在此驗證裝置是否可從控制系統接收訊息。
取消註冊涉及從方案移除先前註冊的客戶,以及停用方案訂閱與相關可控制裝置。
註冊與取消註冊處理由下列服務任務業務物件管理:
-
數位資產註冊要求任務 (X1-DigitalAssetEnrollTask)
-
數位資產取消註冊要求任務 (X1-DigitalAssetUnenrollTask)
若要瞭解註冊與取消註冊處理,就必須瞭解這些服務任務業務物件的生命週期。下表概述上述業務物件的生命週期。註冊與取消註冊的具體描述如下。
State |
描述 |
---|---|
待處理 |
服務任務活動的初始狀態。服務任務會透過監視處理轉變為下一個狀態。 |
驗證 |
註冊:允入演算法會驗證註冊要求,包含:
取消註冊:允入演算法會驗證取消註冊要求是否包含導出要取消註冊之方案訂閱記錄的必要明細。 服務任務會透過監視處理轉變為下一個狀態。 |
驗證錯誤 |
如果服務任務在「待處理」狀態下未通過任何驗證,則會進入此狀態。處於此狀態的服務任務可以更正並重試。 |
已驗證 | 如果服務任務在「驗證」狀態下通過驗證,則會進入此狀態。 |
檢查適用性 |
允入演算法會驗證客戶是否適用於方案 (根據為方案提案定義的適用性準則),以及客戶是否符合方案資格 (根據方案的資格問題)。 僅適用於「註冊」服務任務。 |
適用性錯誤 |
如果客戶不適用於方案或不符合方案資格,則服務任務失敗並進入此狀態。處於此狀態的服務任務可以更正並重試。 僅適用於「註冊」服務任務。 |
重新評估資格 |
如果服務任務在「檢查適用性」狀態下失敗,則可以在返回「檢查適用性」狀態之前暫時進入此狀態。 僅適用於「註冊」服務任務。 |
設定註冊 |
允入演算法會建立方案訂閱 (處於「停用」狀態) 和裝置位置 (處於「現用」狀態)。 備註:如果方案之方案類型的需要位置來源欄位設為「否」,則會略過建立裝置位置。
如果「安裝方法」為「自備」,且「資產所有權」為「客戶擁有」,則也會建立可控制裝置並將其附加至裝置位置。 僅適用於「註冊」服務任務。 |
註冊設定錯誤 |
如果在「設定註冊」狀態下發生錯誤,則會進入此狀態。處於此狀態的服務任務可以更正並重試。 僅適用於「註冊」服務任務。 |
設定取消註冊 |
允入演算法會停用方案訂閱。 僅適用於「取消註冊」服務任務。 |
取消註冊設定錯誤 |
如果「設定取消註冊」狀態發生錯誤,則會進入此狀態。處於此狀態的服務任務可以更正並重試。 僅適用於「取消註冊」服務任務。 |
設定裝置 |
註冊:允入演算法會決定在數位資產註冊服務任務類型下設定的裝置設定動作,並建立設定可控裝置所需的相關設定動作。每個設定動作都會被擷取到服務要求的「裝置設定」區段 (以及服務任務的日誌) 中。 備註:如果方案之方案類型的需要位置來源欄位設為「否」,則會略過建立裝置。
取消註冊:允入演算法會決定在數位資產取消註冊服務任務類型下設定的裝置設定動作,並建立停用可控制裝置所需的相關設定動作。每個設定動作都會被擷取到服務要求的「裝置設定」區段 (以及服務任務的日誌) 中。 如需詳細資訊,請參閱下方的裝置設定動作。 |
裝置設定錯誤 |
如果無法決定一或多個裝置設定動作,要求就會轉變為此狀態。處於此狀態的服務任務可以更正並重試。 |
等待裝置設定 |
服務任務會維持此狀態,直到所有裝置設定動作完成為止。 服務任務會透過監視處理轉變為「裝置設定動作」階段,直到完成服務任務類型上設定的所有動作為止。 |
已完成 |
所有裝置設定動作順利完成後,服務任務會進入此狀態。註冊:允入演算法會將方案訂閱的狀態設為「現用」。 取消註冊:允入演算法會在「方案訂閱」上植入「結束日期/時間」,並將其「狀態」設為「停用」,且「方案訂閱」上的任何可控制裝置都會停用。 |
已捨棄 |
在先前狀態中捨棄的服務任務會進入此狀態。 |
已取消 |
在先前狀態中取消的服務任務會進入此狀態。 |
服務任務的具體內容,例如要建立的方案訂閱類型與設備位置,以及完成註冊所需的裝置設定動作類型,是由與客戶註冊 (或取消註冊) 之方案相關聯的服務任務類型所定義。如需詳細資訊,請參閱管理使用者指南中的瞭解數位資產服務任務類型。
裝置設定動作
註冊或取消註冊處理可以包含數個在註冊或取消註冊處理期間,針對安裝、調查或測試可控制裝置所執行的裝置設定動作。支援的裝置設定動作包含:
-
建立活動:建立「服務訂單管理」現場活動以執行裝置安裝或調查。
-
建立待辦事項:建立待辦事項。
-
建立工單:建立 Work and Asset Management 工單 (請參閱工作管理) 以執行裝置安裝或調查。
-
起始可控制裝置指令:建立指令並將其傳送至可控制裝置,以測試它們是否能夠與控制系統通訊。
如需有關設定裝置設定動作的詳細資訊,請參閱管理使用者指南中的瞭解數位資產服務任務類型。
註冊/取消註冊方法
Oracle Utilities Digital Asset Cloud Service 提供兩種起始客戶註冊或取消註冊處理的方法。
首先是使用處理流程入口與功能。系統提供兩種處理流程類型以支援註冊與取消註冊處理:
-
數位資產註冊處理 (X1-DIGITALASSETENROLLMENT)
-
數位資產取消註冊處理 (X1-DIGITALASSETUNENROLLMENT)
註冊/取消註冊服務任務是由處理流程根據使用者輸入的資料建立。如需有關使用處理流程入口註冊與取消註冊的詳細資訊,請參閱使用處理流程註冊與取消註冊客戶。如需處理流程功能的一般資訊,請參閱管理使用者指南中的處理流程。
Oracle Utilities Digital Asset Cloud Service 和 Oracle Utilities Digital Asset Management 也提供內送 Web 服務,以便從外部系統 (例如客戶資訊系統) 提交註冊與取消註冊要求。方案註冊 (X1-ProgramEnrollment) 內送 Web 服務提供下列作業:
-
建立方案註冊 (enrollProgram):用來建立註冊要求以將客戶註冊到方案中
-
建立方案取消註冊 (unenrollProgram):- 用來建立取消註冊要求以將客戶從方案取消註冊 (移除)
-
取得方案註冊 (getProgramEnrollment):- 用來擷取註冊資訊
-
取得方案取消註冊 (getProgramUnenrollment):- 用來擷取取消註冊資訊