基準に基づいて分析をブロックするJavaScriptの開発

ユーザーが分析を実行しようとするたびに、Oracle Analyticsは関数validateAnalysisCriteriaを呼び出します。独自の基準に基づいて問合せを検証してブロックするように、validateAnalysisCriteriaをカスタマイズできます。関数がtrueを返すと、問合せは実行されます。関数がfalseを返すかメッセージを表示すると、問合せはブロックされます。

たとえば、次に示すのは、myblocking.jsという名前のJavaScriptプログラムのサンプル・コードです。

// 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以外を返すと、基準が有効とみなされて、分析が実行されます。この関数を使用して、プレビューや保存の操作の基準を検証することもできます。