Importar requisitos

Puede cargar rápida y fácilmente sus datos de requisitos existentes en Requirements Portal usando el Import Wizard disponible en el Requirements Module.

AI Assisted Requirements Importer

La ingeniería de requisitos suele comenzar con la redacción de los requisitos de las partes interesadas en documentos como PDF y hojas de cálculo de Excel, donde los datos no están bien estructurados. Extraer manualmente los datos de requisitos de estos documentos no estructurados puede requerir mucho trabajo y ser propenso a errores, y para agilizar el proceso de captura de requisitos en Requirements Portal, puede aprovechar las capacidades de IA para importar requisitos desde archivos PDF, Excel, Word y CSV no estructurados.

La funcionalidad de AI-assisted Importer se encuentra actualmente en fase Beta.

Los siguientes campos se pueden importar a los requisitos usando AI-assisted Importer:

  • Identificador

  • Texto

  • Métodos

  • Bloques aplicables

  • Título

  • Justificación

  • Padres

  • Hijos

  • Tipo

  • Estado

  • Cumplimiento

  • Comentario de cumplimiento

  • Propietario

  • Etiquetas

  • Ruta a la sección

Acceso al Importer

Un administrador puede habilitar y deshabilitar AI Assisted Importer usando la opción External Provider en la página Settings – ValiAssistant (a la que se accede haciendo clic en el icono en la parte inferior izquierda, seleccionando Settings en el menú que aparece y luego seleccionando ValiAssistant de la lista en el panel izquierdo).

Cuando la opción External Provider está deshabilitada, solo se puede acceder y usar el importador heredado. Para obtener más información sobre el importador heredado, consulte la sección Legacy Importer a continuación.

Cuando está habilitado, se puede acceder a AI Assisted Importer desde Requirements Module () haciendo clic en el botón  en la parte superior izquierda de la página y seleccionando Create Requirement en el menú que aparece. Como alternativa, cuando la especificación que se está viendo actualmente no tiene requisitos, se puede acceder al importador haciendo clic en el botón Import de la página.

Flujo de importación

Una vez que se accede al importador, se muestra la ventana Document Import. Para continuar con AI Assisted Importer, haga clic en el botón .

En esta ventana, si lo desea, puede optar por usar el importador heredado haciendo clic en el enlace open the legacy importer here. Cómo usar el importador heredado se describe a continuación en esta página.

En la siguiente etapa, puede cargar un archivo de un tipo compatible (*.pdf, *.docx, *.xlsx o .*csv). Para ello, arrastre y suelte el archivo en la región correspondiente de la ventana o haga clic en el control select from your computer para buscar y seleccionar el archivo desde el disco duro.

El tamaño máximo del archivo de carga es de 100 MB.

Aunque el archivo cargado puede no estar estructurado, puede usar el enlace Excel template para descargar un archivo *.xlsx que puede utilizarse para capturar requisitos de manera estructurada.

Una vez que el archivo se haya cargado correctamente, su entrada se mostrará en la ventana. Puede quitarlo de la ventana haciendo clic en el icono . Como alternativa, arrastre y suelte otro archivo en la ventana para reemplazar el archivo existente.

Haga clic en el botón  para continuar. El importador procesará el archivo cargado. Una vez finalizado el proceso, los datos extraídos se presentarán como una tabla de requisitos sugeridos. Puede seleccionar los requisitos que desea importar habilitando las casillas de verificación a la izquierda de las filas correspondientes.

De forma predeterminada, los requisitos extraídos se importarán a la especificación que se estaba visualizando cuando se accedió al Importer. Puede seleccionar la especificación requerida en la lista desplegable de la parte superior de la ventana del Importer o crear una nueva especificación seleccionando la entrada As new (creates new specification) de la lista desplegable y definiendo el nombre de la nueva especificación mediante el campo Specification name que aparece en la ventana.

Haga clic en el botón  para continuar. Una vez finalizada la importación, aparecerá una ventana de confirmación.

Si el importador detecta problemas en los requisitos importados, esto se indicará en la ventana (). Haga clic en el enlace para descargar un informe que detalle las razones de los problemas detectados. 

Haga clic en el botón  para volver a la etapa de carga de archivos del importador o haga clic en  para salir del importador.

Legacy Importer

Al acceder al Importer (learn more), puede optar por continuar con la herramienta de importación heredada para cargar datos de requisitos estructurados. Además, el importador heredado solo está disponible cuando la opción External Provider está deshabilitada en la configuración de Requirements & System Portal por un administrador.

El proceso le guía a través de tres etapas principales: Specification, Upload y Review. Al completar una importación de especificación, se presenta un resumen, así como la posibilidad de realizar acciones adicionales, como Valifying o importar otros archivos. Estas etapas y acciones se describen en las secciones siguientes.

Especificación

En esta etapa del Import Wizard, puede definir la especificación de importación de destino:

  • Use la región Select a specification en el lado izquierdo de la ventana Import Requirements para seleccionar una especificación existente y, opcionalmente, su sección.

  • Use la región Create a specification en el lado derecho de la ventana Import Requirements para crear una nueva especificación (y también definir la abreviatura y el bloque al que se asignará) sin salir del asistente de importación.

Haga clic en la región requerida para usar el método preferido.

 
  • Si el Import Wizard se inicia dentro del contexto de una especificación o una sección, esta aparecerá preseleccionada como destino de importación.

  • En caso de que no existan especificaciones, se debe crear una.

  • En la definición del nombre de la nueva Specification, se deben cumplir las reglas de definición de nombres: solo se permiten caracteres alfanuméricos y el carácter especial _ (guion bajo).

Carga

En esta etapa del Import Wizard, puede cargar un archivo de un tipo compatible. Para ello, arrastre y suelte el archivo en el lado derecho de la ventana Import Requirements o haga clic en el control Drop file para buscar y seleccionar el archivo desde el disco duro. Una vez que el archivo se haya cargado correctamente, se mostrará una notificación en la ventana.

 
  • Solo se admiten archivos de Excel (.xls, .xlsx) y de valores separados por comas (.csv). Los archivos de macros de Excel (.xlsm) no son compatibles.

  • En caso de que se cargue un archivo no compatible, un mensaje de error se lo notificará.

  • Cuando se carga un archivo, puede continuar con el proceso de importación o cargar un archivo nuevo (reemplazando el anterior).

Revisión

En esta etapa del Import Wizard, puede revisar los resultados de la importación de datos del archivo cargado, configurar las opciones del archivo y mapear los datos del archivo a los campos de requisitos.

La región Destination de la ventana Import Requirements proporciona una indicación visual de dónde se importarán los datos (en términos de la especificación o sección).

La región File options ofrece las siguientes opciones:

  • Update requirements – cuando está habilitada, cualquier requisito existente en la especificación de destino se sobrescribirá mediante la sustitución de los datos (los datos del archivo sustituyen los datos de la especificación).

    • Si la opción está deshabilitada y está importando requisitos cuyo Identificador ya existe en la especificación seleccionada como destino, Requirements Portal agregará el sufijo _import a los identificadores de los requisitos importados para diferenciarlos.

    • Si la opción está deshabilitada y está importando requisitos cuyos Identifiers ya existen en el proyecto actual pero no en la especificación seleccionada como destino, Requirements Portal agregará un icono de advertencia a los identificadores para alertar sobre un identificador duplicado en el mismo proyecto.

    • Si la opción está habilitada, se admiten valores en blanco en el archivo que se está importando; es decir, si un valor del archivo está en blanco, el valor se elimina del requisito. Esto también se aplica a los campos de selección múltiple, como Tags.

  • Use header row – puede decidir usar la fila de encabezado del archivo cargado o usar una fila de encabezado de referencia general proporcionada por Requirements Portal (es decir, encabezados de columna como A, B, C, etc.).

    Requirements Portal considera la fila de encabezado como la primera fila de cualquier archivo cargado.

  • Sheet – en caso de tener un archivo con varias hojas, puede seleccionar desde qué hoja desea importar.

  • Starting row – puede seleccionar desde qué fila del archivo importado se debe comenzar a recopilar los datos para insertarlos en Requirements Portal.

En la tabla de la parte inferior de la ventana Import Requirements, puede ver una vista previa del archivo cargado y mapear sus columnas a campos en Requirements Portal. Esto le permite definir cómo corresponderán los datos del archivo a campos específicos en Requirements Portal seleccionando el campo apropiado en la lista desplegable Map To para cada columna. Si el archivo contiene encabezados idénticos a los campos predeterminados de Requirements Portal, estos campos se mapearán automáticamente. Sin embargo, puede anular o ajustar este mapeo automático si es necesario.

  • Se pueden seleccionar los siguientes campos para el mapeo:

    • Identificador

    • Texto

    • Título

    • Justificación

    • Padres

    • Hijos

    • Ruta a la sección

    • Tipo

    • Estado

    • Etiquetas

    • Cumplimiento

    • Comentario de cumplimiento

    • Métodos de V&V

    • Aplicabilidad

    • Bloques aplicables

    • Propietario

    • Etiquetas

    • Columnas personalizadas

  • Los elementos Hijos, Métodos de V&V, Aplicabilidad, Bloques aplicables y Etiquetas pueden importarse con más de un valor para cada requisito. Para ello, cada valor debe separarse con una coma.

  • Si un método de verificación, bloque aplicable, tipo de requisito, estado, cumplimiento o etiqueta que se está importando no existe actualmente en Requirements Portal, se creará automáticamente durante la importación y se añadirá al requisito.

  • Para Aplicabilidad, los tipos de bloque compuestos pueden referenciarse con un /, por ejemplo, block_A/block_B.

  • Para las columnas personalizadas, están disponibles los siguientes tipos: Selección, Selección múltiple, Texto, Fecha, Número.

Como mínimo, debe seleccionarse la columna Identificador. De lo contrario, se mostrará un mensaje de advertencia hasta que se cumpla esa condición ().

Informe de ejecución

Una vez finalizado el proceso de importación, si la importación se completa correctamente, se mostrarán un mensaje de éxito y los cambios realizados. Si la importación falla, se mostrará un mensaje de error. A continuación se muestra un ejemplo de una importación correcta.

Si hay errores leves, también se mostrarán (). Los posibles errores leves son:

  • No se puede establecer la relación → El identificador del padre o de los hijos no existe en el proyecto

  • No se puede establecer la relación → El identificador del padre o de los hijos está duplicado en el proyecto

  • La declaración de cumplimiento del requisito no existe en el proyecto

  • El tipo de requisito no existe en el proyecto

  • El estado del requisito no existe en el proyecto

  • La etiqueta no existe en el proyecto

  • La condición de aplicabilidad no existe

Independientemente de si el importador se completa correctamente o no, puede volver a importar o realizar una nueva importación haciendo clic en Import new file (éxito) o Try again (error), lo que le llevará de vuelta a la etapa 1 (Specification).

Tras una importación correcta, también puede iniciar el proceso Valify haciendo clic en el control Check now en la parte superior de la ventana. Este proceso analizará el texto de los requisitos importados en busca de posibles parámetros cuantificables para convertirlos en Valis dentro del requisito.

Para obtener más información, consulte la página 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.

Contenido