Importer des exigences

Vous pouvez rapidement et facilement téléverser vos données d’exigences existantes dans Requirements Portal à l’aide du Import Wizard disponible dans le module Requirements.

AI Assisted Requirements Importer

L’ingénierie des exigences commence souvent par la rédaction des exigences des parties prenantes dans des documents tels que des PDF et des feuilles de calcul Excel, où les données ne sont pas bien structurées. L’extraction manuelle des données d’exigences à partir de ces documents non structurés peut être fastidieuse et source d’erreurs. Afin d’accélérer le processus de capture des exigences dans Requirements Portal, vous pouvez exploiter les capacités de l’IA pour importer des exigences à partir de fichiers PDF, Excel, Word et CSV non structurés.

La fonctionnalité d’importateur assisté par IA est actuellement en version bêta.

Les champs suivants peuvent être importés dans les exigences à l’aide de l’importateur assisté par IA :

  • Identifiant

  • Texte

  • Méthodes

  • Blocs applicables

  • Titre

  • Justification

  • Parents

  • Enfants

  • Type

  • État

  • Conformité

  • Commentaire de conformité

  • Propriétaire

  • Balises

  • Chemin vers la section

Accéder à l’importateur

L’importateur assisté par IA peut être activé ou désactivé par un administrateur à l’aide de l’option External Provider sur la page Settings – ValiAssistant (accessible en cliquant sur l’icône en bas à gauche, en sélectionnant Settings dans le menu qui apparaît, puis en sélectionnant ValiAssistant dans la liste du volet de gauche).

Lorsque l’option External Provider est désactivée, seul l’importateur hérité est accessible et utilisable. Pour en savoir plus sur l’importateur hérité, reportez-vous à la section Importateur hérité ci-dessous.

Lorsqu’il est activé, l’importateur assisté par IA est accessible depuis le module Requirements () en cliquant sur le bouton  en haut à gauche de la page, puis en sélectionnant Create Requirement dans le menu qui apparaît. Sinon, lorsque la spécification actuellement affichée ne contient aucune exigence, l’importateur peut être ouvert en cliquant sur le bouton Import sur la page.

Flux d’importation

Une fois l’importateur ouvert, la fenêtre Document Import s’affiche. Pour continuer avec l’importateur assisté par IA, cliquez sur le bouton .

Dans cette fenêtre, si vous le souhaitez, vous pouvez choisir d’utiliser l’importateur hérité en cliquant sur le lien open the legacy importer here. L’utilisation de l’importateur hérité est décrite ci-dessous sur cette page.

À l’étape suivante, vous pouvez téléverser un fichier d’un type pris en charge (*.pdf, *.docx, *.xlsx ou .*csv). Pour ce faire, faites glisser-déposer le fichier dans la zone correspondante de la fenêtre ou cliquez sur le contrôle select from your computer pour parcourir le disque dur et sélectionner le fichier.

La taille maximale du fichier téléversé est de 100 Mo.

Bien que le fichier téléversé puisse être non structuré, vous pouvez utiliser le lien Excel template pour télécharger un fichier *.xlsx pouvant servir à capturer les exigences de manière structururée.

Une fois le fichier téléversé avec succès, son entrée s’affiche dans la fenêtre. Vous pouvez le retirer de la fenêtre en cliquant sur l’icône . Sinon, faites glisser-déposer un autre fichier dans la fenêtre pour remplacer le fichier existant.

Cliquez sur le bouton  pour continuer. L’importateur traitera le fichier téléversé. Une fois le traitement terminé, les données extraites seront présentées sous forme de tableau d’exigences suggérées. Vous pouvez sélectionner les exigences que vous souhaitez importer en cochant les cases à gauche des lignes correspondantes.

Par défaut, les exigences extraites seront importées dans la spécification qui était affichée lorsque l’importateur a été ouvert. Vous pouvez sélectionner la spécification requise dans la liste déroulante en haut de la fenêtre de l’importateur, ou créer une nouvelle spécification en sélectionnant l’entrée As new (creates new specification) dans la liste déroulante et en définissant le nom de la nouvelle spécification à l’aide du champ Specification name qui apparaît dans la fenêtre.

Cliquez sur le bouton  pour continuer. Une fois l’importation terminée, une fenêtre de confirmation s’affiche.

Si l’importateur détecte des problèmes dans les exigences importées, cela sera indiqué dans la fenêtre (). Cliquez sur le lien pour télécharger un rapport détaillant les raisons des problèmes détectés. 

Cliquez sur le bouton  pour revenir à l’étape de téléversement du fichier de l’importateur, ou cliquez sur  pour quitter l’importateur.

Importateur hérité

Lors de l’accès à l’importateur (en savoir plus), vous pouvez choisir de poursuivre avec l’outil d’importation hérité afin de téléverser des données d’exigences structurées. De plus, l’importateur hérité n’est disponible que lorsque l’option External Provider est désactivée dans les paramètres de Requirements & System Portal par un administrateur.

Le processus vous guide à travers trois étapes principales : Specification, Upload et Review. Une fois l’importation d’une spécification terminée, un récapitulatif est présenté ainsi que la possibilité d’effectuer des actions supplémentaires, telles que la validation ou l’importation d’autres fichiers. Ces étapes et actions sont décrites dans les sections ci-dessous.

Spécification

À cette étape du Import Wizard, vous pouvez définir la spécification cible de l’importation :

  • Utilisez la zone Select a specification sur le côté gauche de la fenêtre Import Requirements pour sélectionner une spécification existante et, éventuellement, sa section.

  • Utilisez la zone Create a specification sur le côté droit de la fenêtre Import Requirements pour créer une nouvelle spécification (et également définir l’abréviation et le bloc auquel elle sera affectée) sans quitter l’assistant d’importation.

Cliquez sur la zone souhaitée pour utiliser la méthode de votre choix.

 
  • Si le Import Wizard est lancé dans le contexte d’une spécification ou d’une section, celle-ci apparaîtra comme présélection pour la destination de l’importation.

  • S’il n’existe aucune spécification, il faut en créer une.

  • Lors de la définition du nom de la nouvelle spécification, les règles de dénomination doivent être respectées : seuls les caractères alphanumériques et le caractère spécial _ (trait de soulignement) sont autorisés.

Téléversement

À cette étape du Import Wizard, vous pouvez téléverser un fichier d’un type pris en charge. Pour ce faire, faites glisser-déposer le fichier sur le côté droit de la fenêtre Import Requirements ou cliquez sur le contrôle Drop file pour parcourir le disque dur et sélectionner le fichier. Une fois le fichier téléversé avec succès, une notification s’affiche dans la fenêtre.

 
  • Seuls les fichiers Excel (.xls, .xlsx) et les fichiers de valeurs séparées par des virgules (.csv) sont pris en charge. Les fichiers Excel Macro (.xlsm) ne sont pas pris en charge.

  • Si un fichier non pris en charge est téléversé, un message d’erreur vous en informera.

  • Lorsqu’un fichier est téléversé, vous pouvez soit poursuivre le processus d’importation, soit téléverser un nouveau fichier (qui remplacera le précédent).

Révision

À cette étape du Import Wizard, vous pouvez examiner les résultats de l’importation des données du fichier téléversé, configurer les options du fichier et mapper les données du fichier aux champs des exigences.

La zone Destination de la fenêtre Import Requirements fournit une indication visuelle de l’emplacement où les données seront importées (en termes de spécification ou de section).

La zone File options propose les options suivantes :

  • Update requirements – lorsqu’elle est activée, toutes les exigences existantes dans la spécification de destination seront écrasées par substitution des données (les données du fichier remplacent les données de la spécification).

    • Si l’option est désactivée et que vous importez des exigences dont l’identifiant existe déjà dans la spécification sélectionnée comme destination, Requirements Portal ajoutera le suffixe _import aux identifiants des exigences importées afin de les différencier.

    • Si l’option est désactivée et que vous importez des exigences dont les identifiants existent déjà dans le projet actuel mais pas dans la spécification sélectionnée comme destination, Requirements Portal ajoutera une icône d’avertissement aux identifiants pour signaler un identifiant en double dans le même projet.

    • Si l’option est activée, les valeurs vides dans le fichier importé sont prises en charge, c’est-à-dire que si une valeur du fichier est vide, la valeur est supprimée de l’exigence. Cela s’applique également aux champs à sélection multiple, tels que Tags.

  • Use header row – vous pouvez choisir d’utiliser la ligne d’en-tête du fichier téléversé ou d’utiliser une ligne d’en-tête de référence générale fournie par Requirements Portal (c’est-à-dire des en-têtes de colonnes tels que A, B, C, etc.).

    Requirements Portal considère la ligne d’en-tête comme la première ligne de tout fichier téléversé.

  • Sheet – dans le cas d’un fichier comportant plusieurs feuilles, vous pouvez sélectionner la feuille à partir de laquelle vous souhaitez importer.

  • Starting row – vous pouvez sélectionner à partir de quelle ligne du fichier importé les données doivent commencer à être collectées pour être insérées dans Requirements Portal.

Dans le tableau au bas de la fenêtre Import Requirements, vous voyez un aperçu du fichier téléversé et mappez ses colonnes aux champs de Requirements Portal. Cela vous permet de définir comment les données du fichier correspondront à des champs spécifiques dans Requirements Portal en sélectionnant le champ approprié dans la liste déroulante Map To pour chaque colonne. Si le fichier contient des en-têtes identiques aux champs par défaut de Requirements Portal, ces champs seront automatiquement mappés. Toutefois, vous pouvez remplacer ou ajuster ce mappage automatique si nécessaire.

  • Les champs suivants peuvent être sélectionnés pour le mappage :

    • Identifiant

    • Texte

    • Titre

    • Justification

    • Parents

    • Enfants

    • Chemin vers la section

    • Type

    • État

    • Étiquettes

    • Conformité

    • Commentaire de conformité

    • Méthodes de V&V

    • Applicabilité

    • Blocs applicables

    • Propriétaire

    • Étiquettes

    • Colonnes personnalisées

  • Les champs Enfants, Méthodes de V&V, Applicabilité, Blocs applicables et Étiquettes peuvent être importés avec plusieurs valeurs pour chaque exigence. Pour ce faire, chaque valeur doit être séparée par une virgule.

  • Si une méthode de vérification, un bloc applicable, un type d’exigence, un état, une conformité ou une étiquette importé(e) n’existe pas actuellement dans Requirements Portal, il/elle sera automatiquement créé(e) pendant l’importation et ajouté(e) à l’exigence.

  • Pour l’applicabilité, les types de blocs composés peuvent être référencés avec un /, par exemple, block_A/block_B.

  • Pour les colonnes personnalisées, les types suivants sont disponibles : Select, Multiselect, Texte, Date, Nombre.

Au minimum, la colonne Identifiant doit être sélectionnée. Sinon, un message d’avertissement s’affichera jusqu’à ce que cette condition soit remplie ().

Rapport d’exécution

Une fois le processus d’importation terminé, si l’importation s’est déroulée avec succès, un message de réussite ainsi que les modifications effectuées sont affichés. Si l’importation échoue, un message d’échec s’affiche. Un exemple d’importation réussie est présenté ci-dessous.

S’il y a des erreurs mineures, elles seront également affichées (). Les erreurs mineures possibles sont les suivantes :

  • La relation ne peut pas être établie → l’identifiant du parent ou de l’enfant n’existe pas dans le projet

  • La relation ne peut pas être établie → l’identifiant du parent ou de l’enfant est dupliqué dans le projet

  • La déclaration de conformité de l’exigence n’existe pas dans le projet

  • Le type d’exigence n’existe pas dans le projet

  • L’état de l’exigence n’existe pas dans le projet

  • L’étiquette n’existe pas dans le projet

  • La condition d’applicabilité n’existe pas

Que l’importation réussisse ou non, vous pouvez réimporter ou effectuer une nouvelle importation en cliquant sur Import new file (succès) ou Try again (échec), ce qui vous ramène à l’étape 1 (Specification).

Après une importation réussie, vous pouvez également lancer le processus Valify en cliquant sur la commande Check now en haut de la fenêtre. Ce processus analysera le texte des exigences importées afin d’identifier d’éventuels paramètres quantifiables à convertir en Valis dans l’exigence.

Pour plus d’informations, consultez la page Valify Requirements.

AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Contenu