Visión general de tareas de adaptador

Este tema se ocupa de todas las tareas necesarias para crear un adaptador de código fuente, vincularlo a un proyecto con un enlace de adaptador y ejecutar el proyecto con el adaptador enlazado en modalidad de prueba.

Crear un adaptador seleccionando una plantilla

Para crear un adaptador seleccionando una plantilla:

  1. Seleccione Proyectos > Adaptadores.
  2. Pulse Añadir adaptador.
  3. En Nombre, introduzca un nombre único para el adaptador. El nombre del adaptador debe ser único entre todos los nombres de adaptadores y no puede contener espacios.
  4. En Tipo, seleccione el tipo de adaptador.
  5. En Plantilla, seleccione la plantilla. La lista contiene las plantillas de adaptador instaladas con el producto Build Forge. Los adaptadores de ClearCase y ClearQuest no requieren una clave de licencia por separado. Otros adaptadores obtienen la licencia por separado a través del Adaptor Toolkit.
  6. En Acceso, seleccione un grupo de acceso. La posibilidad de ver o editar el adaptador está restringida a estos miembros del grupo.
  7. Pulse Guardar adaptador.

Crear un entorno vacío

Para crear un entorno vacío:

  1. Seleccione Proyectos > Entornos.
  2. Pulse Añadir entorno.
  3. En Nombre, introduzca el nombre del entorno. Asigne un nombre que describa el cometido del entorno.
  4. En Acceso, seleccione un grupo de acceso. La posibilidad de ver o editar el entorno está restringida a estos miembros del grupo.
  5. Pulse Guardar entorno.

Agregar adaptadores a proyectos

Para añadir el adaptador a un proyecto:

  1. Seleccione Proyectos > Enlaces de adaptador.
  2. Pulse Añadir enlace de adaptador.
  3. En Adaptador, seleccione el adaptador (y plantilla de adaptador) que creó.
  4. En Proyecto, seleccione el proyecto. En la lista se muestran los proyectos que aún no han sido enlazados a un adaptador.
  5. En Estado, seleccione Activo.
  6. En Entorno, seleccione el entorno vacío que creó para el enlace de adaptador.
  7. En Llenar entorno, seleccione . Las variables de entorno de aplicación de la plantilla de adaptador se añadirán al entorno.
  8. Pulse Guardar para enlazar el adaptador al proyecto. El adaptador y el proyecto se añaden a la lista de enlaces de adaptadores.

Editar variables de entorno

Para editar variables de entorno:

  1. Seleccione Entornos.
  2. Para el entorno que creó, pulse el icono Editar icono Editar, lápiz. El panel muestra las variables de entorno del adaptador que se han añadido automáticamente al entorno.
  3. Revise los valores predeterminados para las variables de entorno que proporcionó la plantilla de adaptador.
  4. Cambie los valores predeterminados para su aplicación de código fuente en la medida en que sea necesario para ejecutar el proyecto de adaptador.

Atributo de condición

El atributo de condición permite que se apliquen condiciones a determinadas propiedades de adaptador utilizando operadores de comparación de Perl. Puede utilizar literales de series, números o variables para la comparación.

La sintaxis del atributo de condición es:

condition="true(<valorIzq> <operador> <valorDer>)"
condition="false(<valorIzq> <operador> <valorDer>)"
condition="hastext(variable)"
condition="isempty(variable)"

Especifique uno de los siguientes cuatro tipos:

Tipo Descripción
true La evaluación es satisfactoria si valorIzq y valorDer son iguales.
false La evaluación es satisfactoria si valorIzq y valorDer son distintos.
hastext La evaluación es satisfactoria si la longitud del valor es mayor de 0.
isempty La evaluación es satisfactoria si la longitud del valor es 0.
valorIzq y valorDer pueden ser series, números o variables que contengan series o números. El operador de condición es cualquier operador de condición compatible con Perl. Hay operadores de condición de serie y número. Debe utilizar el operador correspondiente o recibirá resultados imprevisibles.
Operadores de serie Operadores numéricos
eq ==
ne !=
gt >
lt <
ge >=
le <=

Utilizar operadores numéricos con series no devolverán resultados numéricos, y lo mismo es cierto para operadores de comparación de series en valores numéricos.

Por ejemplo: condition="true("PASS"=="FAIL")

La condición anterior siempre devolverá true, lo cual no es correcto.

Ejemplos de condiciones:
  • condition="true($BF_SERVER eq "TEST_BOX") - Ejecuta el elemento sólo si la variable del servidor de compilación contiene TEST_BOX.
  • condition="false($BF_BID <=141) - Ejecuta la compilación sólo si la condición de compilación es mayor que 141 o no inferior a 141.
Propiedades del adaptador que admiten condiciones:
  • adduser
  • bom
  • run
  • setenv
Compruebe la DTD de la instalación actual de Build Forge de información actual en la que las propiedades dan soporte al atributo de condición.

Podrá ver una entrada similar a la siguiente para las condiciones de soporte de propiedades:

<!ATTLIST adduser condition CDATA #IMPLIED>

La DTD del adaptador se encuentra en %BF_HOME%\interface en Windows y $BF_HOME/Platform/interface en UNIX en el archivo interface.dtd.

Ejecutar adaptadores en modalidad de prueba

Para ejecutar el adaptador en modalidad de prueba:

  1. Seleccione Administración > Sistema.
  2. En la lista de parámetros de configuración del sistema, seleccione Enlazar modalidad de depuración.
  3. En Enlazar modalidad de depuración, seleccione .
  4. Pulse Guardar.
  5. Seleccione Trabajos > Iniciar.
  6. En la lista de proyectos, seleccione el proyecto con adaptador enlazado que creó de la página Iniciar proyecto.
  7. Pulse Ejecutar.

Ver estado de trabajos y registros

Para ver el estado del trabajo y la información de registro para el proyecto de adaptador:
  1. Abra Trabajos.
  2. En la lista de proyectos, localice el proyecto con adaptador enlazado para ver el estado de éxito/anomalía del trabajo.
  3. Para ver los registros de trabajo:
    • Seleccione el Nombre de código del proyecto de adaptador para acceder a la información del registro de trabajo.
    • Seleccione la Lista de materiales para acceder al informe BOM.

Comentarios