Importar requisitos

Puedes cargar rápida y fácilmente tus 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, puedes 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

El AI Assisted Importer puede ser habilitado y deshabilitado por un administrador 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 superior derecha, 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, consulta la sección Legacy Importer más abajo.

Cuando está habilitado, se puede acceder al AI Assisted Importer desde el 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, haz clic en el botón .

En esta ventana, si lo deseas, puedes optar por usar el importador heredado haciendo clic en el enlace open the legacy importer here. El uso del importador heredado se describe a continuación en esta página.

En la siguiente etapa, puedes cargar un archivo de un tipo compatible (*.pdf, *.docx, *.xlsx.*csv). Para ello, arrastra y suelta el archivo en la región correspondiente de la ventana o haz 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 que se puede cargar es de 100 MB.

Aunque el archivo cargado puede no estar estructurado, puedes usar el enlace Excel template para descargar un archivo *.xlsx que puede utilizarse para capturar requisitos de forma estructurada. También puedes usar este enlace para descargar el archivo.

Una vez que el archivo se haya cargado correctamente, su entrada se mostrará en la ventana. Puedes eliminarlo de la ventana haciendo clic en el icono . Como alternativa, arrastra y suelta otro archivo en la ventana para reemplazar el archivo existente.

Haz 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. Puedes seleccionar los requisitos que deseas importar activando 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. Puedes 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.

Haz 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 (). Haz clic en el enlace para descargar un informe que detalle las razones de los problemas detectados. 

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

Importador heredado

Al acceder al Importer (más información), puedes 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 Portal por un administrador.

El proceso te guía a través de tres etapas principales: Specification, Upload y Review. Al completar la importación de una 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, puedes definir la especificación de importación de destino:

  • Usa 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.

  • Usa 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.

Haz clic en la región requerida para usar el método que prefieras.

 
  • Si el Import Wizard se inicia dentro del contexto de una Specification o una Section, 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 nomenclatura: solo se permiten caracteres alfanuméricos y el carácter especial _ (guion bajo).

Cargar

En esta etapa del Import Wizard, puedes cargar un archivo de un tipo compatible. Para ello, arrastra y suelta el archivo en el lado derecho de la ventana Import Requirements o haz 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 te lo notificará.

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

Revisar

En esta etapa del Import Wizard, puedes 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ás importando requisitos cuyo Identificador ya existe en la especificación seleccionada como destino, Requirements Portal añadirá el sufijo _import a los identificadores de los requisitos importados para diferenciarlos.

    • Si la opción está deshabilitada y estás importando requisitos cuyos Identifiers ya existen en el proyecto actual pero no en la especificación seleccionada como destino, Requirements Portal añadirá un icono de advertencia a los identificadores para alertar de 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 – puedes 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, puedes seleccionar de qué hoja deseas importar.

  • Starting row – puedes 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, puedes ver una vista previa del archivo cargado y mapear sus columnas a campos de Requirements Portal. Esto te permite definir cómo corresponderán los datos del archivo a campos específicos de Requirements Portal seleccionando el campo adecuado 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, puedes 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

  • 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, se puede hacer referencia a tipos de bloque compuestos 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 ().

  • Los siguientes campos distinguen entre mayúsculas y minúsculas:

    • Tipo

    • Estado

    • Cumplimiento

    • Etiquetas

    Por ejemplo, si la etiqueta TBD ya existe en Requirements Portal y se está importando la etiqueta tbd, se creará una nueva etiqueta tbd y se importará con el requisito.

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 la importación se realiza 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 nuevo 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