在 ServiceMax 中更新已安裝產品記錄
常見的使用案例為︰透過 ThingWorx 中的事件或屬性更新，進而驅使在 ServiceMax 中執行某些簡單更新。雖然此範例主要說明已安裝產品記錄的更新，但可以套用至任何相關的 ServiceMax 物件類型。
收集下列一般資訊：
• 您想要更新 ServiceMax 物件的 Salesforce 之「API 名稱」。
• ServiceMax 企業金鑰，或識別專屬物件的金鑰。
已安裝的產品具備 SVMXC__Installed_Product__c 的 API 名稱。
已安裝產品的專屬企業金鑰，也因客戶而有所不同。常用欄位包含：
|
Salesforce 標籤 (預設)
|
API 欄位
|
|---|---|
|
已安裝的產品 ID
|
Name
|
|
產品名稱
|
SVMXC__Product_Name__c
|
|
序號 / 批號
|
SVMXC__Serial_Lot_Number__c
|
|
資產標籤
|
SVMXC__Asset_Tag__c
|
一旦決定您的 API 物件名稱與企業金鑰的欄位名稱，就能透過下列方法執行更新作業：
• PTC.SCA.SCO.AssetService.ServiceMaxUtils FindIdByKeys：此服務方法將使用企業金鑰來尋找 Salesforce 物件的 Salesforce 金鑰 (ID)，進而提供協助。如此可確保 Salesforce 金鑰具唯一性，而且如果沒有任何記錄或有多個記錄，均會失敗。此將傳回 Salesforce ID 用以更新記錄。
• PTC.SCA.SCO.AssetService.Connector.ServiceMaxConnector UpdateResources：此服務則用以更新 Salesforce 中的物件。有許多方面均可呼叫以服務，但針對此情況僅需下列參數：
◦ salesforceObjectType：想要更新的物件之 API 名稱。
◦ objects：應更新的資料之資料負載。這可以是欄位的部分組合，但必須包括 ID。ID 欄位就是主要金鑰，且為更新作業所必須。
範例：
使用上方所提方式的完整範例服務方式，均可至 PTC.SCA.SCO.AssetService.ServiceMaxUpdates 中找到：
• UpdateInstalledProductStatus
• UpdateInstalledProductStatusByModeISN
• UpdateInstalledProductStatusViaDataShape
您可檢視這些方法的建構實例，依照您自己的需要建立類似方法。
