Kyselyjen vahvistus ja esto analyyseissa käyttäen mukautettua JavaScriptia

Aina kun käyttäjä yrittää ajaa analyysin, Oracle Analytics käynnistää validateAnalysisCriteria-funktion. Voit mukauttaa validateAnalysisCriteria-funktiota sekä tarkistaa ja estää kyselyjä itse määrittämiesi ehtojen perusteella. Jos funktio palauttaa arvon true, kysely ajetaan. Jos funktio palauttaa arvon false tai näyttää sanoman, kysely estetään.

Seuraavaksi näytetään esimerkki myblocking.js-nimisen JavaScript-ohjelman koodista.

// 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;
}

Jos funktio palauttaa minkä tahansa muun arvon kuinfalse, ehtojen katsotaan olevan oikeita ja analyysi ajetaan. Funktion avulla myös tarkistetaan toimintojen esikatselun ja tallennuksen ehdot.

Aina kun käyttäjä yrittää syöttää sarakkeen kaavan tai muokata sitä, Oracle Analytics käynnistää validateAnalysisFormula-funktion toiminnon tarkistamiseksi. Voit mukauttaa validateAnalysisFormula-funktiota sekä tarkistaa ja estää kaavoja itse määrittämiesi ehtojen perusteella. Jos funktio palauttaa arvon true, kaava hyväksytään. Jos tarkistus epäonnistuu, funktio palauttaa arvon false, kaava hylätään ja näkyviin tulee mukautettu sanoma.

Jotta sanoma tulisi näkyviin ja käyttäjä voisi jatkaa, funktion on palautettava arvo true. Jotta kysely estetään, funktio on palautettava arvo false tai näyttää sanoma. Voit käyttää JavaScript-merkkijono- ja säännöllinen lauseke -tekniikoita funktiossa kaavan tutkimiseen ja vahvistukseen.

Käytettävissä on aputoiminnon funktioita, joten kyselynestofunktio voi tarkistaa suodattimia, sarakkeita jne. Katso kohta Tarkistuksen aputoiminnon funktiot.

Seuraava esimerkkikoodi näyttää, kuinka kysely estetään, jos käyttäjä syöttää väärän kaavan.

// This is a formula blocking function. It makes sure the user doesn't enter an unacceptable formula.
function validateAnalysisFormula(sFormula, sAggRule)
{
   // don't allow the use of concat || in our formulas
   var concatRe = /\|\|/gi;
   var nConcat = sFormula.search(concatRe);
   if (nConcat >= 0)
      return "You used concatenation (character position " + nConcat + "). That isn't allowed.";
   // no case statements
   var caseRe = /CASE.+END/gi;
   if (sFormula.search(caseRe) >= 0)
      return "Don't use a case statement.";
   // Check for a function syntax: aggrule(formula) aggrule shouldn't contain a '.'
   var castRe = /^\s*\w+\s*\(.+\)\s*$/gi;
   if (sFormula.search(castRe) >= 0)
      return "Don't use a function syntax such as RANK() or SUM().";
    return true;
}

JavaScript-tiedostossa on käytettävissä useita tarkistuksen aputoiminnon funktioita.