TattvaDocs
Workflows

Use the workspace library

Use shared sources and definitions, hide what you don't need, override a metric for your project, and propose a source for everyone.

This is the day-to-day with the Workspace Library: how to use it, and how to contribute back.

Use workspace sources

Workspace sources appear in every project automatically. You don't need to subscribe.

  1. Open Sources. Workspace sources carry a Workspace chip.
  2. Use them like any other source. Your data analysts keep them up to date; your project always sees the current version.

You cannot edit a workspace source from your project. To change one, ask your data analysts.

Hide one you don't need

  1. Open Sources → Upload.
  2. On the workspace source's row, click the eye icon ("Hide this workspace source from this project").

It disappears from your project's list. Other projects still see it. To bring it back, click Hidden sources and then Show.

Look up a shared definition

  1. Open Ontology → Make → Workspace Library.
  2. On Metrics, search by name, formula or alias.
  3. Read the Definition and Formula columns. Status shows whether it is published, a draft or deprecated.

Workspace Library

Override a metric for your project

Use this only when your project genuinely needs a different definition. You need to be a workspace admin or Ontology Admin to see the Override column.

  1. Open Ontology → Make → Workspace Library → Metrics.
  2. On the metric's row, click Override.
  3. Under "Project override for …", enter the Formula (project version) and Description (project version).
  4. Click Save override.

The override is submitted for review, and the row shows it as pending. An Ontology Admin accepts or rejects it in the Review queue. Until it is accepted, your project keeps using the library definition. Once accepted, your project uses its own version in answers; the library and every other project are unchanged.

Prefer one definition

Two projects using two definitions of net revenue will not reconcile. If your version is better for everyone, ask a data analyst to change the library definition instead.

Propose a source for every project

When a source you uploaded should be used across the company, such as a clean SKU master, ask for it to be promoted.

  1. Open Sources → Upload and select the source.
  2. Click ↑ Promote to workspace. You see this on project sources that belong to your project.
  3. In Promote as workspace-trusted, give a Reason: why this source should be shared and which projects will use it.
  4. Click Submit request.

The source shows "waiting for Data Analyst review" until someone decides.

What the data analyst does

Data analysts, and workspace admins, review requests in Ontology → Maintain → Promotion, the Promotion Inbox.

Promotion Inbox

Each request shows the source, the project it came from, who asked, when, and the reason. The reviewer clicks:

  • Approve, optionally with notes, then Confirm approve. The source becomes Workspace-trusted.
  • Reject, with a required reason, then Confirm reject.

Switch between Pending and All to see past decisions and any reviewer notes.

Tips

  • Use the workspace source first. Upload your own copy only when the data really is project-specific.
  • Promote things that compound. A source three projects will use is worth a request; a one-off export is not.
  • Review your overrides. An override written for last year's reality may no longer be needed.
Use the workspace library — Tattva Docs