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. Aprovechando la extracción impulsada por IA, puede 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 le 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 fase Beta). Si no tiene acceso a ella en su instancia de Requirements Portal, se utilizará una iteración anterior del importador (consulte 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 que se muestra actualmente 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, puede cargar un archivo de un tipo compatible (*.pdf, *.docx, *.xlsx*.csv). Para hacerlo, 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.

Los archivos en formatos *.pdf y *.docx solo se pueden importar 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 (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 pueden importar archivos en formatos *.xlsx y *.csv mediante 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 ser no estructurado, puede usar el enlace Excel template para descargar un archivo *.xlsx que puede utilizarse para capturar requisitos de manera estructurada. También puede usar este enlace 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 le notificará al respecto.

Una vez que el archivo se haya cargado correctamente, su entrada se mostrará en la ventana. Puede eliminarla de la ventana haciendo clic en el icono .

Para un archivo cargado *.xlsx o *.csv, puede 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, haga clic en el botón  para continuar. Los datos extraídos se presentarán como una tabla de requisitos sugeridos para su revisión.

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 se estaba visualizando cuando se accedió al importador. Puede seleccionar la especificación requerida desde 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, deben cumplirse 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.

Habilite la opción Update requirements para sobrescribir cualquier requisito existente en la especificación de destino mediante 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 Identifier 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á 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 en el 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.

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

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

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

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

Puede seleccionar los requisitos que desea importar habilitando las casillas de verificación a la izquierda de las filas correspondientes.

Asignación de datos

Puede definir cómo los datos del archivo cargado se corresponderán con campos específicos en Requirements Portal. 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. Haga clic en un encabezado de columna y seleccione el campo requerido en la lista desplegable.

Como alternativa, puede 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 desplegable.

También puede 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 mediante 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

  • Custom columns

  • Children, V&V Methods, Applicable Blocks, Applicability y Tags se pueden importar con más de un valor por 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, 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: 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, haga clic en el botón  para continuar. Cuando la importación finalice, 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. Los casos posibles son:

  • Un intento de importar un requisito con relaciones a identificadores que no existen en el proyecto ni entre 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 entre otros requisitos del archivo importado.

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

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

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

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

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

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

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

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

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

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.

Iteración anterior del importador

Cuando no tiene acceso a la iteración más reciente del importador descrita anteriormente, se utiliza su iteración anterior. Consulte 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 desde qué fila del archivo importado se debe comenzar a recopilar la información para insertarla 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 campos de Requirements Portal. Esto le permite definir cómo los datos del archivo corresponderán a campos específicos de 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 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:

      • Identifier

      • Text

      • Title

      • Rationale

      • Parents

      • Children

      • Path to Section

      • Type

      • State

      • Tags

      • Compliance

      • Compliance comment

      • V&V Methods

      • Applicability

      • Applicable Blocks

      • Owner

      • Tags

      • Custom Columns

    • Children, V&V Methods, Applicability, Applicable Blocks y Tags pueden importarse con más de un valor por cada 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 agregará al requisito.

    • Para Applicability, se pueden referenciar 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.

    • 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á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 del hijo no existe en el proyecto

    • No se puede establecer la relación → El identificador del padre o del hijo 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 (fallo), 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-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