Skip to main content
Home  › ... Razor

Formulas Tutorials

Tutorial Home › Formulas
Formulas using Parameters
#6 Advanced Formula APIs
Hybrid Razor - Code which Runs on Dnn and Oqtane
Requirements
Resources

Advanced Formula APIs

In this tutorial you'll learn some of the advanced APIs such as:

  • Detect if features are enabled new in v14
  • Ability to stop formulas from running new in v16
  • Get user information about the current user new in v16

Important: Now using Formulas V2 🆕 in 2sxc 16

Formulas V2 has intellisense, stoppability, support for promises and more.

Most formulas will run on every change.

Special formulas such as these returning a promise will auto-stop (unless stop: false). 

But if you want to stop running your formula at any time, you can also return a value with stop: true. 

todo

    todo todo


    Click on the (Σ) button above to see the edit-UI with the formula.

    Formulas of FormulaStop.Title

    Field.Value (Formula-Target: Field.Value)

    v2((data, context) => {
  alert("you will see this alert once, after this the formula won't run any more.");
  return {
    value: "this is a new title",
    stop: true,
  };
});

    Try it:

      Show a warning or info based on the feature GoogleTranslate being enabled. 


      Click on the (Σ) button above to see the edit-UI with the formula.

      Formulas of FormulasFeatures.GoogleTranslateWarning

      Field.Settings.Visible (Formula-Target: Field.Settings.Visible)

      v2((data, context) => {
  return !context.features.isEnabled("EditUiTranslateWithGoogle");
});

      Formulas of FormulasFeatures.GoogleTranslateInfo

      Field.Settings.Visible (Formula-Target: Field.Settings.Visible)

      v2((data, context) => {
  return context.features.isEnabled("EditUiTranslateWithGoogle");
});

      Try it:

        This formula shows information about the user and shows a warning if the user is not logged in.


        Click on the (Σ) button above to see the edit-UI with the formula.

        Formulas of FormulasUser.UserInformation

        Field.Settings.Notes (Formula-Target: Field.Settings.Notes)

        v2((data, context) => {
  return data.default
    .replace('[name]', context.user.name ?? "unknown")
    .replace('[userid]', context.user.id)
    .replace('[isanonymous]', context.user.isAnonymous)
    .replace('[issiteadmin]', context.user.isSiteAdmin);
});

        Formulas of FormulasUser.WarningAnonymous

        Field.Settings.Visible (Formula-Target: Field.Settings.Visible)

        v2((data, context) => {
  return context.user.isAnonymous;
});

         

        Formulas using Parameters
        #6 Advanced Formula APIs
        Hybrid Razor - Code which Runs on Dnn and Oqtane