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 a menudo comienza 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; 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 mediante 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

AI Assisted Importer está habilitado de forma predeterminada. Si es necesario, un administrador del Workspace puede deshabilitarlo 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, consulte la sección Legacy Importer a continuación.

Se puede acceder a 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 presenta 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 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.

El tamaño máximo del archivo que se puede cargar 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. También puede usar este enlace para descargar el archivo.

Una vez que el archivo se haya cargado correctamente, su entrada se mostrará en la ventana. Puede eliminarlo 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 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. Puede seleccionar la especificación requerida eligiéndola en la lista desplegable situada en 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 los motivos 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 (más información), 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 un administrador deshabilita la opción External Provider en la configuración de Requirements Portal.

El proceso lo guía a través de tres etapas principales: Specification, Upload y Review. Al completar la importación de una especificación, tambié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 Specification o una Section, esta aparecerá preseleccionada como destino de importación.

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

  • En la definición del nombre de la nueva Specification, deben cumplirse 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 hacerlo, 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). No se admiten archivos de macros de Excel (.xlsm).

  • 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 desde el archivo cargado, configurar opciones del archivo y asignar los datos del archivo a 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 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 deben comenzar a recopilarse 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 campos en Requirements Portal. Esto le permite definir cómo se corresponderán los datos del archivo con 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 asignarán automáticamente. Sin embargo, puede anular o ajustar esta asignación automática si es necesario.

  • Los siguientes campos se pueden seleccionar para la asignación:

    • Identificador

    • Texto

    • Título

    • Justificación

    • Padres

    • Hijos

    • Ruta a la sección

    • Tipo

    • Estado

    • Etiquetas

    • Conformidad

    • Comentario de conformidad

    • Métodos de V&V

    • Aplicabilidad

    • Bloques aplicables

    • Propietario

    • Etiquetas

    • Columnas personalizadas

  • Hijos, Métodos de V&V, Aplicabilidad, Bloques aplicables y Etiquetas se pueden importar 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, conformidad 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

    • Conformidad

    • 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á 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 menores, también se mostrarán (). Los posibles errores menores 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 conformidad 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 situado 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