Skip to main content

DEV TOOLS

No longer present in released versions

DeveloperThe developer/sandbox override actions previously documented here have been removed from the shipping product. They were internal testing tools located in the DEV TOOLS action group on the AWF Setup page and were only intended for testing the trial/license mechanisms in sandbox environments.environments before release.

Prerequisite

The DEVfollowing TOOLSactions are located onand the pageunderlying mechanism AWFno Setuplonger in the action group DEV TOOLS. Since in SaaS sandbox environments the entire trial logic is normally disabled (status: "Sandbox"), the DEV TOOLS internally set a Sandbox Overrideexist in IsolatedStorage.released This causes IsSandboxEnvironment() throughout the app to return false -- the app then behaves as in a production environment.

Actions

Enter Trial Mode

  • Sets the sandbox override (active)
  • Deactivates the license: TrialMode = true
  • If the trial limit is already reached: the app is deactivated (Activated = false), all templates are deactivated

Result: Status shows "Trial Active" (or "Trial Limit Reached" if the limit is already reached)

Activate License

  • Clears the sandbox override (back to normal sandbox behavior)
  • Activates the license: TrialMode = false, Activated = true

Result: Status shows "Licensed" (or "Sandbox" after reloading the page, since the override is removed)

Reset Trial Counter

  • Sets the sandbox override (active)
  • Sets the trial counter to 0

Result: Workflow Runs Used shows "0 / 50"

Set Runs to 1 Remaining

  • Sets the sandbox override (active)
  • Sets the trial counter to MaxTrialRuns - 1 (e.g. 49 of 50)

Result: The next completed workflow reads the trial limit and leads to deactivationversions of the app and all templates.app:

Typical test scenarios

Test trial mode

    • Enter Trial Mode click
    • Activate a workflow template and start a workflowLicense
    • Check: the trial counter increases, the status stays "Trial Active"

Test trial expiry

  1. EnterReset Trial ModeCounter click
  2. Set Runs to 1 Remaining click
  3. Start and complete a workflow
  4. Check: status switches to "Trial Limit Reached", app deactivated, all templates deactivated
  5. Check: no new template can be activated (error message)
  6. Check: standard BC workflows continue to work

Reset after testing

  1. Activate License click -- restores the normal licensed state and removes the sandbox override
  2. Alternatively: Reset Trial Counter + Enter Trial Mode to test again from the start

Notes

  • The sandbox override is stored ininternal IsolatedStorageSandbox Override and affects all codeunit instances (event subscriber, workflow engine). It persists even after reloading the page.
  • Activate License is the only action that removes the override again.
  • All DEV TOOLS (code, actions, IsolatedStorage key AWF-DevSandboxOverride) mustthat forced IsSandboxEnvironment() to return false

As originally noted, these DEV TOOLS had to be removed before release.release; that removal has been completed. There are no developer/sandbox override actions in the released product.

Back to top