Page-Specific Actions Guide

This guide lists what you can do on each page of SDCStudio. Button and step names are the ones shown in the application. All pages live under /app/ on sdcstudio.axius-sdc.com.

Top navigation (every page)

  • Documentation: opens the documentation site
  • Support: opens /support/
  • Search (Ctrl/Cmd+K): search data models, uploads and documentation; Escape closes the search box
  • Notifications bell
  • Theme toggle (light or dark)
  • User menu: My Dashboard, Upload Data (opens the Data Sources page, /app/data-sources), Settings, Practitioners (funded accounts), About SDCStudio, Log Out

There is no sidebar. Pages are reached from the dashboard cards, the user menu, in-page links and breadcrumbs.

Dashboard (/app/dashboard)

  • Cards: New Project (opens /app/projects/new), New Data Model (opens the Model Wizard at /app/models/wizard), Browse Projects, Manage Components
  • Counts of projects, models and published models
  • Recent Projects and Recent Models lists with View all links; click a name to open it

The Mind Map editor at /app/models/mindmap/new is a composition canvas reachable by its address only: its Save button does not yet store a model.

Projects

Projects list (/app/projects)

  • New Project (opens /app/projects/new)
  • Click a project name to open it
  • Delete a project you own (also deletes its models)
  • Previous / Next pagination

New project (/app/projects/new)

  • Enter Name and an optional Description, then create the project

Project detail (/app/projects/:id)

  • Edit name and description, then Save Changes (owner or staff)
  • Delete the project (owner only)
  • Members panel: add a member by email with role Member or Admin, change a role, remove a member
  • New Model for this project (opens the Model Wizard with the project preselected); the smaller Advanced Form link beside it opens the single-page form
  • Click a model in the Data Models list to open it

Data models

Data Models list (/app/models)

  • New Model (opens the Model Wizard at /app/models/wizard)
  • Advanced Form (opens the single-page form at /app/models/new)
  • Filter by project and by status (Draft or Published); Clear All Filters
  • Click a model title to open it
  • Per row, as the server allows: Publish and Delete on a draft (owner, team admins and staff publish; the owner deletes), Retire on a published model (asks for a reason)

Model Wizard (/app/models/wizard)

Steps: Basics (project, title, description), Metadata (Dublin Core fields, language, encoding), Authors (author and contributors), Data & Provenance (data cluster, subject, provider, participations, protocol, workflow, audits, attestation, access control, related links), Review & Save. The last button is Create Model. The last step creates the model (500 credits).

Advanced Form (/app/models/new)

The same fields as the wizard on one page.

Mind Map editor (/app/models/mindmap/new)

  • Select a project, title and language
  • Toolbar: create a new unpublished Cluster in the data section, Undo, Redo, Validate, Save
  • Drag published components from the palette onto the tree; edit a node's label in the properties panel

The Save button does not yet store the model. Use New Model on the Data Models page for models you intend to publish.

Model detail (/app/models/:id)

Draft model, each button by what your role allows: - Publish (project owner, team admins, staff; fails until the data cluster and every component in it are published; one-time and irreversible) - Edit (project owner, team admins, staff, and any team member while it is a draft; opens the model form in place; Save Changes) - Delete (project owner only)

Published model: - Model Generation card with one Generate button (one-time) - After generation: Download Complete Package (ZIP) - Generate App (choose one): Lightweight or Enterprise, each with a Generate button, then Download App (1,500 credits the first time per model, free after); Retry if app generation fails - Copy (makes an unpublished copy titled "COPY -- ..." with lineage to the source; anyone who can view the model), Retire (owner, team admins or staff; the model stays published and resolvable) - A graph of the model's structure at the bottom of the page

Every draft model shows a Model Not Published notice with the steps to follow. There is no per-file download on this page; single artifacts are available from the public catalog (see Generating Outputs).

Components

Components list (/app/components)

  • Create Component (opens the Component Wizard at /app/components/wizard; 100 credits when the component is created); on the Clusters list (/app/clusters) the same button reads New Cluster and opens the Cluster Wizard at /app/clusters/wizard
  • Quick Create (choose a Component Type in a dialog, then Create Component takes you to that type's form)
  • Search by label; filter by type, project, status (All, Published, Unpublished, Retired) and revision (Latest or All revisions); Clear All Filters
  • Click a component to open its detail page
  • Badges: Published, Public, Retired

Typed lists at /app/clusters, /app/parties, /app/audits, /app/attestations and /app/participations are the same page filtered to one type.

Component Wizard (/app/components/wizard)

Steps: Choose Type; Basic Information (Project first, required; Label; Description; Language; Public); the type's own step name (for example String Constraints, Boolean Values, Temporal Configuration, Party Details; optional, information only, for Cluster, Party, Participation, Audit and Attestation); Advanced Settings (Xd data types only: Sequence Number, Hard Validate, UI Type, ACT, VTB, VTE, TR, MOD and Location flags); Semantic Linking (optional: move items between Available RDF Objects and Selected RDF Objects, create a new RDF Object, or search vocabularies); Review & Save. The last button is Create Component.

Cluster Wizard (/app/clusters/wizard)

Steps: Basics (project, label, description), Add Components (every component you can see, grouped into Data Types, List Types and Nested Clusters, with the project named for components from another project), Review & Save. The last button is Create Cluster (100 credits). Semantic links are added later in the cluster's edit form.

Component forms (/app/<type>s/new)

One form per type: xdstrings, xdbooleans, xdcounts, xdtemporals, xdquantities, xdfloats, xddoubles, xdordinals, xdlinks, xdfiles, xdtokens, intervals, the eight list types (xdbooleanlists, xdstringlists, xdtokenlists, xddecimallists, xddoublelists, xdintegerlists, xdnonnegativeintegerlists, xdpositiveintegerlists), units, referenceranges, simplereferenceranges, parties, audits, attestations, participations, and clusters.

Each form uses the same steps as the wizard without Choose Type: Basic Information, Constraints, Advanced Settings (Xd types), Semantic Linking, Review & Save. In the Review step the buttons are Save and Save & Publish. On a new component's form Save & Publish is shown to everyone and the server refuses it to anyone who may not publish in the project; on an existing component's form it is shown only to those who may publish (owner, team admins, staff).

Quantified types (Count, Quantity, Float, Double) have a Units selector with a Create new Units button, and a reference range selector with a Create new Reference Range button. Both open the matching form in a new page; return to the parent form when done.

Component detail (/app/<type>s/:id)

  • Edit (unpublished components only; opens /app/<type>s/:id/edit; on a cluster the button reads Edit Cluster)
  • Copy (published, unretired components; anyone who can view; makes an unpublished copy labeled "COPY -- ..." in a project you choose, with lineage to the source; refused when the source is retired)
  • Retire (published components, owner or admin; asks for a reason; the component stays resolvable but is no longer listed)
  • Back to Components (clusters: All Clusters)
  • Clusters list their Included Components; each links to that component's page

Published components cannot be edited, unpublished or deleted.

Component edit (/app/<type>s/:id/edit)

Same steps as the form. Every step is reachable from the stepper. Finish on Review & Save with Save or Save & Publish.

RDF Object detail (/app/predobjs/:id)

Read-only view of a predicate-object pair: Name, Project, Predicate, Object URI and Status. Back to Components returns to the Components list.

Upload and processing

Upload (/app/upload)

  • Select Project (required; the project description and your preferred ontologies are shown as the context the analysis will use)
  • File Type: CSV or Markdown dataset template
  • Choose a file (click or drag and drop; .csv and .md only; 50 MB limit)
  • Upload File; after a successful upload you are taken to Data Sources. Each new component or cluster the upload creates is 100 credits, charged when processing completes

Data Sources (/app/data-sources)

  • Filter by project, file type (CSV, Markdown) and status
  • Upload New Data
  • Per row: View Details (processing details dialog), Trigger Processing (status uploaded) or Retry Processing (status agent_error), Review Metadata (completed)
  • This page does not refresh on its own; reload it to see new statuses

Ontologies

Ontologies list (/app/ontologies)

  • Upload Ontology (opens /app/ontologies/upload)
  • Filter by status (In Triplestore, Error) and access level (Private, Team, Corporate, Public)
  • Click an ontology to open it; Reprocess; Delete (owner)

Upload Ontology (/app/ontologies/upload)

  • Choose a .ttl, .owl, .rdf, .n3 or .nt file
  • Namespace abbreviation, namespace URI, description, organization, access level
  • Upload

Ontology detail (/app/ontologies/:id)

  • Download the file, Reprocess, Delete (owner)

Settings (/app/settings)

Six tabs:

  • Profile: first name, last name, organization, intended usage; Change Password
  • Preferences: Theme, Language, Items per page, email notifications; Modeler Information (modeler name and email, default project, which every account has from the start, named after the Modeler and private until you say otherwise; preferred ontology service, preferred ontologies with Manage Ontologies)
  • Teams Management: create a team, invite by email with role Member or Admin
  • Wallet: balance, Add Funds (choose a pack and pay), Auto-Reload with Save Settings, Transaction History filtered by type
  • Practitioner: exam, capstone submission, credential card with Download SVG, Download PNG and Copy verify link
  • API Keys: Create key with a name, Scopes (Read always on, Build, Spend), an optional Spending limit (credits) and Expires in (days); the key starts with sdcs_ and is shown once; the table shows each key's Scopes and Spending; Rotate Key and Revoke Key; use it as Authorization: Token <key>

Documentation (/app/docs)

Short in-app overview with links to the documentation site, the GitHub organization, the newsletter and contact@axius-sdc.com.

Keyboard

  • Ctrl/Cmd+K opens search; Escape closes it; arrow keys and Enter move through results

Common workflows

Create a data model from a CSV

  1. Upload the file at /app/upload with the target project selected
  2. Watch /app/data-sources until the status is completed
  3. On its row, click View Details, then View Data Model
  4. Review and edit components; publish each one with Save & Publish
  5. On the model page click Publish, then Generate, then Download Complete Package (ZIP)

Create a component by hand

  1. On /app/components click Create Component
  2. Choose the type, select the project, fill the label and description
  3. Set the constraints, advanced settings and semantic links
  4. Create Component, then open it and use Edit until it is final
  5. Save & Publish when it is final; publishing cannot be undone

Group components in a cluster

  1. On /app/components click Create Component and choose Cluster, or open /app/clusters/wizard
  2. Add the components in Add Components
  3. Create Cluster; add semantic links in the cluster's edit form if needed
  4. Publish the members, then the cluster, then the model