DEV TOOLS

Developer actions on the AWF Setuppage for testing the trial/license mechanisms in sandbox environments.

Prerequisite

The DEV TOOLS are located on the page AWF Setup 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 Override in IsolatedStorage. 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 deactivation of the app and all templates.

Typical test scenarios

Test trial mode

1. Enter Trial Mode click
2. Activate a workflow template and start a workflow
3. Check: the trial counter increases, the status stays "Trial Active"

Test trial expiry

1. Enter Trial Mode 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 in IsolatedStorage 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) must be removed before release.