How to use Admin: scenarios
Versions analytical scenarios, required inputs, tools and output contract.
What this section is for
Versions analytical scenarios, required inputs, tools and output contract.
Before you start
You need access to IAM.Docs, the correct tenant/workspace and permission to change this configuration. Prepare a non-sensitive example value such as contract-review-demo.
Buttons and forms
| Control | What it does |
|---|---|
| Create scenario | Opens the creation flow. The object is not persisted until the final save action. |
| Validate | Performs the action named in the interface. Review the resulting state or message before continuing. |
| Test | Runs a check or dry run so the result can be reviewed before production use. |
| Publish | Performs the action named in the interface. Review the resulting state or message before continuing. |
| Archive | Performs the action named in the interface. Review the resulting state or message before continuing. |
Primary path in the interface
- Open the application link above and sign in with the least-privileged role required for this section.
- Select the intended tenant or workspace. Do not continue while the header shows a different tenant.
- In the navigation, click Admin: scenarios. The expected address is https://app.iamdocs.ru/admin?tab=scenarios.
- Click Create scenario. Enter the documented safe values:
contract-review-demo. Do not paste a production secret into a free-text field. - Review every field before the final Save, Run, Publish or Confirm action. If a preview or validation control exists, run it first.
- Review the validation message or changed row. The result must match this purpose: Versions analytical scenarios, required inputs, tools and output contract.
- Only then continue to the next dependent section. Copy the request/correlation ID when the interface shows one.
Second path: direct link and CLI/API
- Open the deep link https://app.iamdocs.ru/admin?tab=scenarios instead of navigating through the sidebar.
- Confirm the tenant/workspace after the page loads; a deep link must not silently switch scope.
- Before automating the API path, run this product-specific read-only or validation command. It proves reachability but does not bypass application permissions:
export IAM_DOCS_API=https://api.iamdocs.ru
curl --fail --silent --show-error "$IAM_DOCS_API/health"
How to verify the result
The draft passes validation, the published version is pinned and a test session uses its ID.
If it did not work
| Symptom | What to do |
|---|---|
| 401 / sign-in screen | Sign in again, then return to this page. Do not put a session token in a URL. |
| 403 | Check the selected tenant and request the documented role; retrying with the same role will not help. |
| 404 | Verify the exact path and whether the feature is enabled in this environment. |
| 409 | Search for an object named contract-review-demo; continue with it or choose a unique name. |
| 422 / validation error | Correct only the highlighted fields. Keep identifiers lowercase unless the form explicitly allows otherwise. |
| 429 | Wait for the displayed retry interval or reduce the request scope; do not start parallel retries. |
| 5xx / timeout | Refresh once after the server has recovered; do not repeat a destructive action while its result is unknown. Save the correlation ID and timestamp for support. |