Importer des exigences

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

Importateur d’exigences assisté par IA

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 sujette aux erreurs. Afin d’accélérer le processus de capture des exigences dans Requirements Portal, vous pouvez tirer parti des capacités de l’IA pour importer des exigences depuis des 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 est activé par défaut. Si nécessaire, il peut être désactivé par un administrateur Workspace à 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é, consultez la section Importateur hérité ci-dessous.

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 de 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. La manière d’utiliser l’importateur hérité est décrite ci-dessous sur cette page.

À l’étape suivante, vous pouvez charger 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 à charger est de 100 Mo.

Bien que le fichier chargé puisse être non structuré, vous pouvez utiliser le lien Excel template pour télécharger un fichier *.xlsx qui peut être utilisé pour capturer les exigences de manière structurée. Vous pouvez également utiliser ce lien pour télécharger le fichier.

Une fois le fichier chargé avec succès, son entrée s’affichera dans la fenêtre. Vous pouvez le supprimer 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 chargé. Une fois le processus terminé, les données extraites seront présentées sous la forme d’un tableau d’exigences suggérées. Vous pouvez sélectionner les exigences que vous souhaitez importer en cochant les cases situées à 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 souhaitée à partir de 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 apparaîtra.

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 causes des problèmes détectés. 

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

Importateur hérité

Lors de l’ouverture de l’importateur (en savoir plus), vous pouvez choisir de poursuivre avec l’outil d’importation hérité pour charger 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ésumé 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 d’importation cible :

  • 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 démarré dans le contexte d’une spécification ou d’une section, celle-ci apparaîtra comme présélection pour la destination d’importation.

  • Dans le cas où 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.

Charger

À cette étape du Import Wizard, vous pouvez charger 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 chargé avec succès, une notification s’affiche dans la fenêtre.

 
  • Seuls les fichiers Excel (.xls, .xlsx) et 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 chargé, un message d’erreur vous en informera.

  • Lorsqu’un fichier est chargé, vous pouvez soit poursuivre le processus d’importation, soit charger un nouveau fichier (en remplaçant le précédent).

Vérifier

À cette étape du Import Wizard, vous pouvez vérifier les résultats de l’importation des données du fichier chargé, configurer les options du fichier et mapper les données du fichier aux champs d’exigence.

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

La zone File options fournit 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 dupliqué 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 décider d’utiliser la ligne d’en-tête du fichier chargé 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 chargé.

  • 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 en bas de la fenêtre Import Requirements, vous voyez un aperçu du fichier chargé 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 mappés automatiquement. Cependant, 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

    • Balises

    • Conformité

    • Commentaire de conformité

    • Méthodes de V&V

    • Applicabilité

    • Blocs applicables

    • Propriétaire

    • Balises

    • Colonnes personnalisées

  • Les champs Enfants, Méthodes de V&V, Applicabilité, Blocs applicables et Balises peuvent être importés avec plus d’une valeur pour chaque exigence. Pour cela, 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 balise importé(e) n’existe pas actuellement dans Requirements Portal, il/elle sera automatiquement créé(e) lors de 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, Text, Date, Number.

  • 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é

    • Balises

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

Rapport d’exécution

Une fois le processus d’importation terminé, si l’importation a réussi, un message de réussite ainsi que les modifications effectuées s’affichent. Si l’importation échoue, un message d’échec s’affichera. 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

  • La balise 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 (réussite) ou Try again (échec), ce qui vous ramènera à l’étape 1 (Specification).

Une fois l’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 de détecter d’éventuels paramètres quantifiables à convertir en Valis dans l’exigence.

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

AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Entréepour nous envoyer vos commentaires.
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.

Contenu