Modificación de los parámetros de servicio de Connector

El archivo cqconnector.properties contiene los valores de parámetros bajo los cuales se ejecutan la pasarela de ClearQuest y el programa de utilidad de línea de mandatos Synctool.
Por qué y cuándo se efectúa esta tarea

El asistente de Configuración de ClearQuest Connector actualiza el archivo cqconnector.properties file basándose en las elecciones que se han realizado en el asistente. Si tiene la intención de desplegar ClearQuest Connector en el mismo sistema donde ha ejecutado el asistente, no necesita editar el archivo cqconnector.properties. Si tiene la intención de desplegar ClearQuest Connector oen un sistema diferente, como, por ejemplo, un sistema que ejecute Linux®, copie el archivo cqconnector.properties en ese sistema y, a continuación, edite el archivo para que los nombres de vía de acceso de sistema especificados en los parámetros sean correctos.

En la siguiente tabla se describen los parámetros de ClearQuest Connector.
Tabla 1. Parámetros de ClearQuest Connector
Parámetro Descripción
com.ibm.rational.interop.pollingPeriod Periodo de sondeo, el cual controla la frecuencia con que la pasarela ClearQuest sondea los cambios en la base de datos de usuarios ClearQuest. El periodo predeterminado de sondeo es 60 segundos.
com.ibm.team.uris Identificador universal de recursos (URI) del servidor Jazz. El URI predeterminado es https://cqconnector:cqconnector@localhost:9443/jazz. Utilice signos de punto y coma (;) para separar las entradas de varios servidores Jazz. Cree un usuario de Jazz denominado cqconnector o sustitúyalo por el nombre de otro usuario de Jazz. El usuario de Jazz (cqconnector u otro) debe tener una licencia de Jazz ClearQuest Connector o de desarrollador. Si utiliza cqconnector como ID de usuario, asegúrese de sustituir el valor predeterminado de la contraseña de cqconnector por otro establecido por usted.
cq.dbSetDbName Repositorio de esquemas y base de datos de usuarios ClearQuest. El repositorio de esquemas predeterminado es sample_schema_repo. La base de datos de usuarios predeterminada es SAMPL. El formato es nombre-conexión-repositorio-esquema/nombre-base-datos-usuario.
cq.orderedProperties.tipo-registro Una lista de campos separados por una coma que indica el orden en el que ClearQuest Connector debe establecer los valores de esos campos durante las operaciones de sincronización. Puede establecer el parámetro de cada tipo de registro que tenga una regla de sincronización. Los campos que no especifique en la lista se procesarán después los que están en ella. Es posible que necesite especificar el orden si los tipos de registro de ClearQuest contienen ganchos que establecen dependencias entre campos.

Otra forma de especificar el orden es utilizar la propiedad Campos dependientes de web de los campos de definición de formulario en ClearQuest Designer. Si especifica la propiedad Campos dependientes de web y el parámetro cq.orderedProperties, el ClearQuest Connector utilizará el orden especificado con el parámetro cq.orderedProperties.

cq.password Contraseña para iniciar una sesión en la base de datos de usuarios ClearQuest. La pasarela ClearQuest y la herramienta de importación utilizan esta contraseña y el nombre de usuario que haya especificado con el parámetro cq.userId para iniciar una sesión en la base de datos de usuarios ClearQuest y recuperar los registros que desea importar en un repositorio de Jazz. El valor predeterminado es cqconnector. Asegúrese de cambiar el valor predeterminado de la contraseña por otro valor.
cq.userId Nombre de usuario para iniciar una sesión en la base de datos de usuarios ClearQuest. La pasarela ClearQuest y la herramienta de importación utilizan este nombre de usuario y la contraseña que haya especificado con el parámetro cq.password para iniciar una sesión en la base de datos de usuarios ClearQuest y recuperar los registros que desea importar en un repositorio de Jazz. El valor predeterminado es cqconnector. Este usuario debe tener un permiso de editor SQL.
cq.queryTreeRoot Nombre de la vía de acceso completa de la carpeta raíz que contiene la carpeta o carpetas específicas de área de proyecto de las consultas que se utilizan para filtrar los registros que se van a sincronizar con elementos de Rational Team Concert. Puede especificar una consulta por cada tipo de registro que sincronice por área de proyecto. Debe escribir las consultas de forma que no seleccionen ningún registro de ClearQuest para sincronizarlo con más de un área de proyecto en el mismo servidor Jazz Team Server.

La carpeta raíz puede estar en cualquier nivel de la jerarquía de carpetas bajo Consultas Públicas o Consultas Personales, pero su jerarquía debe ser la siguiente: carpeta-raíz/carpeta-nombre-área-proyecto. Las consultas deben almacenarse directamente en las carpetas de área de proyecto. Puede tener varias carpetas de área de proyecto. El nombre de cada una de esas carpetas debe coincidir con su nombre de área de proyecto correspondiente en el Jazz.

Debe especificar un valor para este parámetro. La carpeta de consultas raíz que especifique debe existir y contener una carpeta de cada área de proyecto con la que tenga previsto sincronizar registros y elementos de trabajo. Si una carpeta de área de proyecto no contiene ninguna consulta para un tipo de registro que tenga una regla de sincronización, ClearQuest Connector intentará sincronizar todos los registros de este tipo.

   

Para modificar los parámetros:

  1. Navegue hasta la carpeta directorio-instalación\gateway. Abra el archivo cqconnector.properties.
  2. Modifique los valores de parámetro según proceda para que se ajusten a su entorno.
    1. Edite el valor del parámetro com.ibm.team.uris para que señale a la ubicación del servidor o servidores Jazz. De forma predeterminada, la pasarela ClearQuest intenta iniciar una sesión en el servidor Jazz como el usuario cqconnector. Cree un usuario de Jazz denominado cqconnector o sustitúyalo por el nombre de otro usuario de Jazz. El usuario de Jazz (cqconnector u otro) debe tener una licencia de Rational Team Concert ClearQuest Connector o de desarrollador. Para especificar un usuario diferente, inserte nombre_usuario[:contraseña]@ delante del nombre de host. Por ejemplo: https://chris:chris_pw@localhost:9443/jazz. Utilice signos de punto y coma (;) para separar las entradas de varios servidores Jazz.
    2. Edite el valor del parámetro cq.dbSetDbName para identificar el repositorio de esquemas y la base de datos de usuarios.
    3. Edite el valor del parámetro com.ibm.rational.interop.pollingPeriod si desea cambiar el periodo de sondeo predeterminado, que es de 60 segundos.
    4. Para filtrar los registros de ClearQuest que se van a sincronizar, cree consultas para cada tipo de registro que tenga una regla de sincronización. Almacene las consultas en carpetas específicas de área bajo la carpeta raíz. Edite el parámetro cq.queryTreeRoot para identificar el nombre de la vía de acceso completa de la carpeta raíz. Por ejemplo: Consultas públicas/CQ Connector de Jazz. Aunque no desee filtrar registros, debe crear una carpeta raíz y una carpeta de área de proyecto para cada área con la que tenga previsto sincronizar registros y elementos de trabajo.
    5. Especifique los nombres de usuario y las contraseñas de inicio de sesión en ClearQuest con los parámetros cq.userId y cq.password. El usuario que especifique con el parámetro cq.userId debe tener privilegios de editor SQL.
    6. Si alguno de los campos de los tipos de registro de ClearQuest que tiene previsto sincronizar poseen ganchos que establecen dependencias con otros campos, y no desea utilizar la propiedad Campos dependientes de web en la definición de formularios de ClearQuest para especificar el orden en el que deben establecerse los valores de los campos, establezca el parámetro cq.orderedProperties.record-type. Un gancho asociado con un campo podría utilizar el valor que especifique un usuario en ese campo para determinar cómo establecer el valor de otro campo. En este escenario, debe identificar el orden en el que deberán ejecutarse los ganchos durante las operaciones de sincronización para asegurarse de que se establecen los valores correctos en los campos de registro de ClearQuest. Por ejemplo: cq.orderedProperties.Defect=Headline, Type, Product, Component. Este ejemplo especifica que el campo Titular del tipo de registro Defecto debe establecerse primero, seguido de los campos Tipo, Producto y Componente.

      Si especifica la propiedad Campos dependientes de web y el parámetro cq.orderedProperties, el ClearQuest Connector utilizará el orden especificado con el parámetro cq.orderedProperties.

    7. Cierre y guarde el archivo cqconnector.properties.
Qué hacer a continuación
Nota: dado que el archivo cqconnector.properties contiene nombres y contraseñas de inicio de sesión para cuentas de usuario de ClearQuest y Jazz, asegúrese de establecer los permisos de ese archivo para que solo puedan leerlo los usuarios autorizados.

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error