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. Aprovechando la extracción impulsada por IA, puedes importar requisitos desde archivos PDF, Word, Excel y CSV no estructurados, lo que reduce el tiempo y el esfuerzo necesarios para transferir manualmente los datos de requisitos y te ayuda a capturar los requisitos con mayor precisión y eficiencia.

En esta página se describe una iteración más reciente del Asistente de importación (actualmente en Beta). Si no tienes acceso a ella en tu instancia de Requirements Portal, se utiliza una iteración anterior del Importador (consulta la sección desplegable Previous Iteration of the Importer para obtener más información).

Acceso al Importador

Se puede acceder al Importador 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 actualmente visible no tiene requisitos, se puede acceder al Importador haciendo clic en el botón Import de la página.

Carga de un archivo

Se abrirá la ventana Import Requirements. En esta 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 en el disco duro.

Los archivos en formatos *.pdf y *.docx solo pueden importarse usando el importador con IA, que está habilitado de forma predeterminada. Si es necesario, un administrador del Workspace puede deshabilitarlo mediante la opción External Provider en la página Settings – ValiAssistant (a la que se accede haciendo clic en el icono  en la esquina 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 pueden importar archivos en formatos *.xlsx y *.csv usando el importador clásico. En este caso, se mostrará un mensaje correspondiente en la parte superior de la ventana Import Requirements ().

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 this link para descargar el archivo.

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

  • Si se carga un archivo no compatible, un mensaje de error te lo notificará.

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 .

Para un archivo *.xlsx o *.csv cargado, puedes optar por continuar usando el importador clásico habilitando la opción Classic Import (Non-AI) en la parte inferior izquierda de la ventana.

Revisión de los datos extraídos

Una vez cargado el archivo requerido, haz clic en el botón  para continuar. Los datos extraídos se presentarán como una tabla de requisitos sugeridos para que los revises.

La interfaz de usuario de la página de revisión del importador con IA

La interfaz de usuario de la página de revisión del importador clásico

 

De forma predeterminada, los requisitos sugeridos se importarán a la especificación que estaba abierta cuando se accedió al Importador. Puedes seleccionar la especificación requerida en la lista desplegable en la parte superior de la ventana o crear una nueva especificación seleccionando la entrada + Add specification de la lista desplegable y definiendo el nombre de la nueva especificación mediante el campo de nombre de especificación que aparece ().

Al crear una nueva especificación, se deben cumplir las reglas de definición de nombres. El nombre de la especificación no puede contener los siguientes caracteres: \ / ? % * : | " < >. Además, se ignorarán los espacios iniciales y finales.

Habilita la opción Update requirements para sobrescribir cualquier requisito existente en la especificación de destino mediante sustitución de 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 agregará el sufijo numérico (_1, _2, _3, etc.) a los identificadores de los requisitos importados para diferenciarlos.

  • Si la opción está deshabilitada y estás importando requisitos cuyos Identificadores 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, ese valor se elimina del requisito. Esto también se aplica a los campos de selección múltiple, como Tags.

Habilita la opción Parametrize values para comprobar si los requisitos sugeridos contienen posibles parámetros cuantificables y convertirlos en Valis.

Al usar el importador clásico, también están disponibles las siguientes opciones:

  • Starting row – puedes seleccionar desde qué fila del archivo importado se debe comenzar a recopilar la información para insertarla en Requirements Portal.

  • Sheet – en caso de tener un archivo con varias hojas, puedes seleccionar qué hoja deseas importar.

Puedes seleccionar los requisitos que deseas importar activando las casillas de verificación a la izquierda de las filas correspondientes.

Asignación de datos

Puedes definir cómo se corresponderán los datos del archivo cargado con campos específicos en Requirements Portal. Si el archivo contiene encabezados idénticos a los campos predeterminados de Requirements Portal, esos campos se asignarán automáticamente. Sin embargo, puedes reemplazar o ajustar esta asignación automática si es necesario. Haz clic en el encabezado de una columna y selecciona el campo requerido en la lista desplegable.

Como alternativa, puedes asignar los datos de la columna a una columna nueva y personalizada escribiendo el nombre requerido en el campo Search/Add custom de la lista desplegable y luego seleccionando <custom_column_name> (Create new) en la lista.

También puedes seleccionar None en la lista desplegable para no asignar los datos del archivo a ninguna columna (es decir, estos datos no se importarán).

Como mínimo, deben seleccionarse las columnas Identifier y Text. De lo contrario, se mostrará un mensaje de advertencia hasta que se cumpla esa condición ().

Los siguientes campos se pueden importar a los requisitos usando el Importador:

  • Identifier

  • Text

  • Title

  • Rationale

  • Children

  • Parents

  • Section

  • Path to Section

  • Applicable Block

  • Compliance Comment

  • Type

  • State

  • Compliance

  • V&V Status

  • V&V Methods

  • Applicability

  • Owner

  • Tags

  • Columnas personalizadas

  • Children, V&V Methods, Applicable Blocks, Applicability y Tags pueden importarse con más de un valor por requisito. Para ello, cada valor debe estar separado por 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 Applicability, se pueden hacer referencias a tipos de bloque compuestos con un /; por ejemplo, block_A/block_B.

  • Para las columnas personalizadas, están disponibles los siguientes tipos: Select, Multiselect, Text, Date, Number.

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

  • Type

  • State

  • Compliance

  • Tags

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 revisados los datos que se van a importar y configuradas las opciones según sea necesario, haz clic en el botón  para continuar. Cuando termine 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. Los casos posibles son:

  • Un intento de importar un requisito con relaciones a identificadores que no existen en el proyecto ni en otros requisitos del archivo importado.

  • Un intento de importar un requisito con relaciones a un identificador de requisito que pertenece a más de un requisito, ya sea en el proyecto o dentro del archivo importado.

  • Un intento de importar un requisito con una declaración de cumplimiento que no está definida actualmente en Requirements Portal.

  • Un intento de importar un requisito con un tipo que no está definido actualmente en Requirements Portal.

  • Un intento de importar un requisito con un estado que no está definido actualmente en Requirements Portal.

  • Un intento de importar un requisito con una etiqueta que no está definida actualmente en Requirements Portal.

  • Un intento de importar un requisito con una condición de aplicabilidad que no está definida actualmente en Requirements Portal.

  • Un intento de importar un requisito con un método que no está definido actualmente en Requirements Portal.

  • Un intento de importar un requisito con un bloque aplicable que no está definido actualmente en Requirements Portal.

  • Un intento de importar un propietario que no está definido actualmente en Requirements Portal.

  • Un intento de importar más de un propietario, estado o tipo que no está definido actualmente en Requirements Portal.

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.

Iteración anterior del Importador

Cuando no tienes acceso a la iteración más reciente del Importador descrita anteriormente, se utiliza su iteración anterior. Consulta la sección desplegable a continuación para obtener más información.

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 de qué hoja desea importar.

  • Starting row – puede seleccionar a partir de qué fila del archivo importado se deben empezar 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 asignar sus columnas a los campos de Requirements Portal. Esto le permite definir cómo los datos del archivo se corresponderán con campos específicos de Requirements Portal seleccionando el campo adecuado en el menú desplegable Map To para cada columna. Si el archivo contiene encabezados idénticos a los campos predeterminados de Requirements Portal, estos campos se asignarán automáticamente. Sin embargo, puede reemplazar o ajustar esta asignación automática si es necesario.

    • Se pueden seleccionar los siguientes campos para la asignación:

      • 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

    • Children, V&V Methods, Applicability, Applicable Blocks y Tags 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 Applicability, se puede hacer referencia a tipos de bloques compuestos con un /, por ejemplo, block_A/block_B.

    • Para las columnas personalizadas, están disponibles los siguientes tipos: Select, Multiselect, Text, Date, Number.

    • Debe seleccionarse al menos la columna Identifier. 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:

      • Type

      • State

      • Compliance

      • Tags

      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 (iteración anterior)

    Una vez finalizado el proceso de importación, si la importación se completa correctamente, se mostrará un mensaje de éxito junto con los cambios realizados. Si la importación falla, se mostrará un mensaje de error.

    Si hay errores no críticos, también se mostrarán. Los posibles errores no críticos 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 de parametrización 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.

    AI-LocalizedLocalizado por IA
    Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
    Disponibilidad de funciones

    Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

    Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

    Contenido