Links you can share
In Atlas the address bar is the selection: what a page shows is named in its URL. Copy the URL and send it, and a teammate on the same Atlas opens the same template, model and mapping. The browser’s Back and Forward buttons step through the same places.
The examples use https://atlas.example.com/ as the address of your Atlas; yours may be served under a
path such as /atlas/. Values are URL-encoded: a space becomes %20.
Note
A link opens what it names only if the other person can see it: the same Atlas, the same tenant, and the template or ConceptMap still loaded in the engine.
Workspace
/workspace?templateId=<template id>&modelName=<model name>&mapping=<name>&mapping=<child name>…
Parameter |
What it opens |
|---|---|
(none) |
The template gallery. |
|
The template’s overview (its original id, as shown on Engine state). |
|
That model of the template (its |
|
The mapping selected in the outline, given as its chain of names from the top level down: one |
Example: /workspace?templateId=Blood%20Pressure&modelName=OBSERVATION.blood_pressure.v2&mapping=systolic
opens the mapping systolic of the demo’s blood pressure model.
How it behaves:
Opening a template or a model adds a history entry, so Back returns to the previous one. Following a slot into another model does the same; the back button with the previous model’s name, in the header of the mapping pane, is the same step back.
Selecting a mapping doesn’t add an entry; it updates the current one, so each entry remembers the mapping you were on when you left it.
A model opened without
mappingselects the mapping you last had open in it in this browser tab (see What Atlas remembers).Unsaved edits: going to another template or model, by link, click or Back, first asks whether to leave your unsaved edits. Choosing to stay keeps you where you are.
A link to something that doesn’t exist shows “Template
isn’t loaded in the engine.” or “Model isn’t part of .”, and the address bar is corrected to what did open.
Engine state
/state?templateId=<template id>&mapId=<model name>&mappingName=<mapping name>
Parameter |
What it selects |
|---|---|
(none) |
The overview of all templates. If the engine names a template to select first, Atlas selects it. |
|
The template, with its model mappers listed. |
|
The model mapper opened in the explorer. After following slots it is the chain of models, separated by commas: |
|
The mapping row selected in that model, with its details. |
Every selection on Engine state adds a history entry, so Back walks back through what you
selected. The sidebar’s Engine state link and the logo open plain /state, the overview.
Terminology
/terminology?conceptmap=<canonical url of the ConceptMap>
Opens the Terminology page with that ConceptMap’s editor open. The Workspace opens this link in a new tab from the Open in ConceptMap
editor button of the translation peek and the open icon next to a mapping’s ConceptMap (“Open this
ConceptMap in the Terminology view (new tab)”). If no ConceptMap has that url, the page says
“No ConceptMap found for url:
Versioning
/versioning?tab=<tab>
|
Opens |
|---|---|
|
History |
|
Remote |
|
Reviews |
|
Releases |
|
Compare |
The Compare tab also keeps its choices in the URL:
/versioning?tab=compare&template=<template id>&from=<version>&to=<version>.
A version is a release tag, a commit SHA, any branch, tag or commit you type under Other ref…, or
engine for Now (engine). Without to, Compare uses engine; without from, it takes the newest
release (or the newest commit).
Switching tabs and changing the Compare choices rewrite the current entry instead of adding one: Back leaves the Versioning page rather than stepping through its tabs.
The Git remote settings have their own address: /settings/git-remote.
Insights
/insights?page=<n>&insightId=<insight id>
Parameter |
What it opens |
|---|---|
|
The page of the list, counted from |
|
The detail view of that insight. |
Opening an insight and paging both add history entries: Back closes the detail view or returns to the previous page.
Other pages
These have no parameters: /fhir-packages, /api-access, /integrations, /multitenancy,
/admin (admins only; others land on Engine state). An unknown address shows the error page.
Related
Support: put a link in every support request.