開發 JavaScript 以根據條件封鎖分析

每當使用者嘗試執行分析時，Oracle Analytics 都會呼叫 validateAnalysisCriteria 函數。您可以自訂 validateAnalysisCriteria 以根據自己的特定條件來驗證與封鎖查詢。如果函數傳回 true，則會執行查詢。如果函數傳回 false 或顯示訊息，則會封鎖查詢。

例如，下列簡單的 JavaScript 程式碼名為 myblocking.js。

// This is a blocking function. It ensures that users select what 
// the designer wants them to.
function validateAnalysisCriteria(analysisXml)
{
   // Create the helper object
   var tValidator = new CriteriaValidator(analysisXml);
   // Validation Logic
   if (tValidator.getSubjectArea() != "Sample Sales")
      return "Try Sample Sales?";
   if (!tValidator.dependentColumnExists("Markets","Region","Markets","District"))
   {
      // If validation script notifies user, then return false
      alert("Region and District are well suited, do you think?");
      return false;
   }
   if (!tValidator.dependentColumnExists("Sales Measures","","Periods","Year"))
   return "You selected a measure so pick Year!";
   if (!tValidator.filterExists("Sales Measures","Dollars"))
   return "Maybe filter on Dollars?";
   if (!tValidator.dependentFilterExists("Markets","Market","Markets"))
   return "Since you are showing specific Markets, filter the markets.";
   var n = tValidator.filterCount("Markets","Region");
   if ((n <= 0) || (n > 3))
      return "Select 3 or fewer specific Regions";
   return true;
}

如果函數傳回 false 以外的任何結果，則會將條件視為有效並且執行分析。此函數同時會用於驗證預覽與儲存作業的條件。