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 Requirements Module.

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 laborieuse et source d’erreurs. Afin d’accélérer le processus de saisie des exigences dans Requirements Portal, vous pouvez tirer parti des capacités d’IA pour importer des exigences à partir de fichiers PDF, Excel, Word et CSV non structurés.

La fonctionnalité d’importation assistée 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

  • Étiquettes

  • Chemin vers la section

Accès à l’importateur

L’AI Assisted Importer 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 haut à droite, 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 Legacy Importer ci-dessous.

Lorsqu’il est activé, l’AI Assisted Importer est accessible depuis le Requirements Module () 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 de la page.

Flux d’importation

Une fois l’importateur ouvert, la fenêtre Document Import s’affiche. Pour poursuivre avec l’AI Assisted Importer, cliquez sur le bouton .

Dans cette fenêtre, vous pouvez, si vous le souhaitez, choisir d’utiliser l’importateur hérité en cliquant sur le lien open the legacy importer here. La manière d’utiliser 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 à saisir les exigences de manière structurée. Vous pouvez également utiliser ce lien pour télécharger le fichier.

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 à 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’affichera.

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.

Legacy Importer

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 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 située à gauche de la fenêtre Import Requirements pour sélectionner une spécification existante et, éventuellement, sa section.

  • Utilisez la zone Create a specification située à droite 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 dans la partie droite 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 Comma Separated Values (.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 (en remplaçant 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 en cours 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 situé en 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 V&V

    • Applicabilité

    • Blocs applicables

    • Propriétaire

    • Étiquettes

    • Colonnes personnalisées

  • Les champs Enfants, Méthodes 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 ou 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 ().

  • Les champs suivants sont sensibles à la casse :

    • Type

    • État

    • Conformité

    • Étiquettes

    Par exemple, si l’étiquette TBD existe déjà dans Requirements Portal et que l’étiquette tbd est en cours d’importation, une nouvelle étiquette tbd sera créée et importée avec l’exigence.

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 le contrôle 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