儲存共用商業物件的服務

服務變數

儲存服務範例

• givenName (字串): 客戶的名字
• surname (字串): 客戶的姓氏
• address (地址): 客戶的地址
• dateOfBirth (日期): 客戶的出生日期
• status (字串): 客戶的狀態，例如 new、gold 或 platinum
• creditScore (小數): 客戶的信用評分

範例: 驗證變數未變更

您可能想要驗證共用商業物件中的變數 (例如出生日期) 在起始設定之後未變更。 您可以在儲存服務中使用伺服器 Script 來進行驗證。

範例 Script 會反覆運算變更清單。 如果 dateOfBirth 變數的值已變更， Script 會檢查舊值是否不是空值。 如果不是 null，則使用者已變更變數，並將驗證錯誤新增至 validationErrors 變數。

for(var i = 0; i < tw.local.changes.listLength; i ++) {
    var change = tw.local.changes[i];
    if(change.property == "dateOfBirth" && change.oldValue != null) {
        if(tw.local.validationErrors == null) {
            tw.local.validationErrors = new tw.object.listOf.BPMBOValidationError();
        }

        var validationError = new tw.object.BPMBOValidationError();
        validationError.property = change.property;
        validationError.errorText = "The date of birth must not be changed.";
        tw.local.validationErrors[tw.local.validationErrors.listLength] = validationError;
    }
}

範例: 驗證使用者許可權

您的共用商業物件中可能有只能由一組特定使用者變更的變數。 在此情況下，儲存服務必須檢查進行變更的使用者是否已獲授權執行此動作。 例如，只有團隊領導人才能變更客戶的狀態。

下列範例伺服器 Script 顯示如何檢查使用者許可權。 Script 會判斷現行使用者是否為團隊領導人團隊的成員。 如果使用者不是團隊成員， Script 會反覆運算變更清單。 如果有 status 變數的項目，則該值已由非團隊領導人變更，並將驗證錯誤新增至 validationErrors 變數。

// check if current user is team lead
var teamLeadTeam = tw.system.org.findTeamByName("Team Lead");
var isTeamLead = tw.system.user.isInTeam(teamLeadTeam);

if(!isTeamLead) {
    for(var i = 0; i < tw.local.changes.listLength; i ++) {
        var change = tw.local.changes[i];
        if(change.property == "status" && (change.oldValue != null || change.newValue != "new")) {
            if(tw.local.validationErrors == null) {
                tw.local.validationErrors = new tw.object.listOf.BPMBOValidationError();
            }

            var validationError = new tw.object.BPMBOValidationError();
            validationError.property = change.property;
            validationError.errorText = "The status must only be changed by a team lead.";
            tw.local.validationErrors[tw.local.validationErrors.listLength] = validationError;
        }
    }
}

注意: 儲存共用商業物件時，系統會以導致儲存發生之使用者的許可權來啟動儲存服務。 如果直接在系統作業中對共用商業物件進行變更，則使用者是技術使用者。

範例: 合併資料

您可以使用 baseVersion 及 latestVersion 變數，將自訂合併邏輯新增至儲存服務，以偵測共用商業物件的過期版本何時更新。

下列範例伺服器 Script 會檢查 baseVersion 與 latestVersion 值是否不同。 如果不同，則會合併更新項目。 然後， Script 會從共用商業物件的不同版本中擷取不同的狀態值。 會檢查 status 變數的值，以判定該值在這兩個版本中是否已變更，以及最新狀態是否為 "platinum"。 如果是這樣，則會施行白金級狀態，以防止從該層次降級客戶。

// check if a merge happened because an outdated version was updated
if(tw.local.baseVersion != tw.local.latestVersion) {
    var baseStatus = tw.local.baseVersion.status;
    var latestStatus = tw.local.latestVersion.status;
    var newStatus = tw.local.object.status;

    // check if the status was updated and merged
    if(newStatus != baseStatus && baseStatus != latestStatus) {
        // Make sure a downgrade from platinum does not happen
        if(latestStatus == "platinum") {
            tw.local.object.status = "platinum";
        }
    }
}

範例: 在儲存服務中包括計算

在儲存服務中，您可以將修改套用至共用商業物件變數的值。 例如，您可以呼叫巢狀服務，以計算您傳入客戶資訊 (例如客戶地址) 之客戶的信用評分，並將傳回的信用評分對映至 tw.local.object.creditScore 內容。

錯誤處理

如果未在活動或步驟上捕捉到錯誤，則會將它延伸到母項實例。 如果完全未捕捉到錯誤，則會捨棄所有更新項目，並將實例標示為「失敗」。

發生驗證錯誤的共用商業物件會從自動同步化中排除，直到進行另一項變更，且使用者儲存共用商業物件或自動儲存它為止。

錯誤處理範例

範例: 在用戶端人工服務中向使用者顯示錯誤資訊

下列範例顯示您可以新增至錯誤事件處理程式的邏輯，以將儲存服務中的驗證錯誤對映至可在 Coach 中顯示的資料結構。 錯誤事件處理程式會將驗證錯誤對映至用戶端人工服務中的 sharedBOSaveError 變數。 變數屬於 BPMBOSaveFailedError 類型。

  tw.system.coachValidation.populateFromBPMBOSaveFailedError(tw.local.sharedBOSaveError);

如需相關資訊，請參閱 處理用戶端人工服務中的錯誤。