Logo

Start

  • Before you start
  • Key ideas in plain words
  • A tour of Atlas
  • Your first mapping in 15 minutes

Map

  • Bring your material in
  • Start mapping a template
  • Connect models: slots, links, references
  • Edit mappings in the Workspace
  • Write FHIR and openEHR paths
  • Map only when… (conditions)
  • Fixed values, codes and manual pairs

Check

  • See your mapping in action
  • Find what isn’t mapped yet
  • Fix problems
  • Validate against FHIR profiles

Codes and profiles

  • Translate codes
  • Manage ConceptMaps
  • Use FHIR profiles and IG packages
  • Add a FHIR extension

Ship

  • Ship: versions, reviews, releases
  • Connect a Git repository
  • History, blame and restoring
  • Push, pull and conflicts
  • Submit for review
  • Release a template
  • Compare two versions
  • Export and move mappings

Operate

  • Understand a conversion (Insights)
  • Connect your system to the API

Reference

  • Screens
  • Problems
  • Messages and notices A–Z
  • Keyboard shortcuts
  • Paths and conditions cheat sheet
  • Links you can share
    • Workspace
    • Engine state
    • Terminology
    • Versioning
    • Insights
    • Other pages
    • Related
  • What Atlas remembers
  • Access and permissions
  • Glossary

What we offer

  • Ways to use openFHIR and Atlas
  • Dedicated instances
  • More from the engine
  • Support

About

  • Release notes
openFHIR Atlas
  • Links you can share
  • View page source

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.

templateId

The template’s overview (its original id, as shown on Engine state).

modelName

That model of the template (its metadata.name), opened in the editor. Needs templateId.

mapping

The mapping selected in the outline, given as its chain of names from the top level down: one mapping= per level. Needs modelName.

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 mapping selects 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