Script types

Sitecore Content Hub^TM offers the following script types:

• User sign-in scripts:

  User sign-in scripts are executed every time a user logs into the application.

  

  Warning

  • The User sign-in script might lock users out when there are inconsistent user validations in the script or any other runtime errors. This includes superusers and administrators.
  • This lock-out can be resolved by de-activating the script using the REST API or SDK.

• User pre-registration scripts:

  User pre-registration scripts are executed every time a new user is created.

  

  Note

  User pre-registration scripts are executed before the new user is created.

• User post-registration scripts:

  User post-registration scripts are executed every time a new user is created.

  

  Note

  User post-registration scripts are executed after the new user is created.

• Metadata processing script:

  Metadata processing scripts are executed every time an asset is processed by the processing worker.

  

• Action scripts:

  Action scripts are the only type of scripts that can be used by Actions and Triggers. They are the most commonly used scripts due to their capacity to cover multiple use cases.

  When used with Triggers, Actions can execute Action scripts either In Process (immediately) or In Background.

  

  Warning

  In Process Action scripts should not be used for UI-related interactions or any time consuming operations.

  The In Process Action scripts can be executed during multiple phases:

  • Pre-commit:

    In this phase, Action scripts are executed before the triggering event's execution. For example, if the triggering event is 'Entity modification', the Action script is executed before the entity is modified.

    Tip

    Pre-commit Action scripts can be used to populate default values.

    Important

    The Pre-commit phase is the only phase where scripts can modify the event's data.

  • Security:

    In this phase, Action scripts are executed when the application asserts the triggering user's permissions. For example, if the triggering event is 'Entity modification', the Action script is executed when the application asserts that the triggering user is allowed to modify the entity.

    Tip

    Security Action scripts can be used to perform additional security checks and to throw a SecurityException.

  • Validation:

    In this phase,Action scripts are executed when the application validates the triggering event's data. For example, if the triggering event is 'Entity modification', the Action script is executed when the application validates the entity's modified values.

    Tip

    Validation Action scripts can be used to perform additional validations and to throw a ValidationException.

  • Audit:

    In this phase, Action scripts are executed after the triggering event's data is finalized.

    Tip

    Audit Action scripts can be used to log audit messages to internal or external logging systems.

  • Post:

    In this phase, Action scripts are executed after the triggering event is finalized.