Siempre que un usuario intenta ejecutar un análisis, Oracle Analytics llama a la función validateAnalysisCriteria. Puede personalizar validateAnalysisCriteria para validar y bloquear consultas según sus propios criterios específicos. Si la función devuelve true, se ejecuta la consulta. Si la función devuelve false o muestra un mensaje, se bloquea la consulta.
Por ejemplo, a continuación se incluye un código de ejemplo para un programa JavaScript denominado 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;
}
Si la función devuelve una salida distinta de false, se considera que los criterios son válidos y se ejecuta el análisis. La función también se utiliza para validar criterios para operaciones de vista previa y guardado.