Holarch
Chapitres du cours

Formation · Parcours 6. Migrer vers Holarch · Chapitre 6.1 sur 5

6.1 Planifier une migration 3:00

Décider où va chaque type de données dans le modèle avant de l'importer.

Montre Holarch 2.21.

Tous les chapitres · 6.2 Exigences depuis Excel et CSV →

Ce que vous allez apprendre

  • Associer chaque type de données source à une classe, une étiquette, un attribut ou une relation
  • Vérifier dans le schéma d'un projet les attributs et les étiquettes dont un import a besoin
  • Ajouter un attribut pour un champ source sans équivalent dans le schéma
  • Trouver la page Importer et exporter et nommer ses quatre étapes

Planifiez un passage à Holarch : l'exemple du Plant Inspection Drone et les fichiers qu'apporte son équipe, la correspondance des données avec les classes, étiquettes, attributs et relations LML, l'endroit où le schéma du projet montre ce qui est disponible, et ce que fait chaque import.

Fichiers de projet

  • Projet terminé (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)

La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.

Pratique

Faites-le vous-même dans Holarch, sur le projet de démonstration CubeSat EO-1.

  1. Ouvrez votre projet de démonstration EO-1 (si vous n'en avez pas, créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)).
  2. Ouvrez Paramètres → Schéma dans le rail, cliquez sur Requirement sous Classes, et listez les attributs qu'une feuille de calcul d'exigences pourrait remplir (par exemple Priority, Owner, Verification Method).
  3. Ouvrez la page Labels du schéma et trouvez où sont conservées des catégories telles que Performance Requirement.
  4. Imaginons que le suivi d'un fournisseur ait une colonne Supplier Ref sans équivalent : sur Requirement, cliquez sur + Attribut, nommez-le Supplier Ref, choisissez un type texte et cliquez sur Ajouter un attribut.
  5. Ouvrez Besoins et exigences → Importer et exporter et lisez quels formats accepte la zone de dépôt et ce que propose la carte Exporter.

C'est terminé quand Supplier Ref est le dernier de la liste des attributs de Requirement et que vous pouvez dire où irait chaque colonne d'un suivi type.

Vérifiez vos connaissances

  1. Pourquoi décider où va chaque type de données avant d'importer ?
  2. Une colonne n'a pas d'attribut correspondant. Quelles sont vos options ?
  3. Un import a mal tourné. Comment l'annuler ?
  4. Quand utiliser Gérer les projets → Importer un projet (.json)… plutôt que la page Importer ?
Afficher les réponses
  1. Pourquoi décider où va chaque type de données avant d'importer ?

    Des données qui arrivent dans les bonnes classes, étiquettes, attributs et relations fonctionnent immédiatement pour la traçabilité, les contrôles qualité et les rapports. Les corriger après l'import oblige à modifier de nombreux éléments à la main.

  2. Une colonne n'a pas d'attribut correspondant. Quelles sont vos options ?

    Ajoutez l'attribut dans Paramètres → Schéma avant l'import, ou associez la colonne à Nouvel attribut (ajouté au schéma) à l'étape Mapper.

  3. Un import a mal tourné. Comment l'annuler ?

    Appuyez une fois sur ⌘Z / Ctrl+Z : un import depuis la page Importer est une seule étape d'annulation.

  4. Quand utiliser Gérer les projets → Importer un projet (.json)… plutôt que la page Importer ?

    Pour restaurer un projet entier comme nouveau projet distinct. La page Importer fusionne les éléments d'un fichier dans le projet ouvert.

Pour aller plus loin

Transcription

Afficher la transcription (narration et contenu de l'écran)

Introduction

Welcome to Migrating to Holarch. Most teams arrive with their data in other places: requirements in spreadsheets and Word documents, specifications from suppliers, and models in other tools. This track shows how each one comes in, and what to check afterwards.

This first chapter is about planning. A little thought about where each kind of data belongs saves a lot of clean-up later.

The example

Our example is the Plant Inspection Drone, a drone system that inspects tanks and pipe racks inside a process plant. Its team brings four files.

On screen: The example card.

Map your data

Before importing, decide where each kind of data goes. Rows of a requirements list become Requirements. Section headings become Statements that hold them. Parts and systems become Assets, and functions become Actions.

On screen: Mapping card: classes.

Types such as functional or performance become labels. Fields such as status or rationale become attributes. And links such as satisfies, verified by or refines become relationships, so they can be traced later.

On screen: Mapping card: labels, attributes, relationships.

Check the schema

Create the project first. In Manage Projects, click New Project, name it Plant Inspection Drone, and click Create Project.

On screen: + New Project → Plant Inspection Drone → Create Project.

The project's schema lists every class with its attributes and labels. Open Settings at the bottom of the rail, then Schema.

On screen: Settings → Schema.

Select Requirement. Its attributes include the status, with the values Draft, In Review, Approved and Rejected. The usual kinds of requirement, such as Functional and Performance, are under Labels. If your data has a field with no home here, an owner can add an attribute or a label before the import.

On screen: Schema → Requirement → its attributes; then Labels.

One import page

All imports start on one page: Needs and Requirements, then Import and Export. Drop any file here: Word, Holarch project files, Excel and CSV, plain text, UML and SysML models, or ReqIF. Holarch detects the format from the file.

On screen: Needs & Requirements → Import and Export: the drop zone.

Each import takes four steps: File, Map, Review and Import. It gives the items new identities in your project, and the whole import is a single undo step, so you can try it and take it back. Content from files is cleaned of anything unsafe on the way in.

On screen: The Import steps.

Recap

Let's recap. You met the Plant Inspection Drone and its files, mapped their data to classes, labels, attributes and relationships, checked the schema, and found the Import and Export page.

Next, the requirements tracker comes in from Excel.