Modificando Parâmetros de Serviço do Conector

O arquivo cqconnector.properties contém as configurações de parâmetros sob as quais o ClearQuest Gateway e o utilitário de linha de comandos synctool são executados.
Por Que e Quando Desempenhar Esta Tarefa

O Assistente de Configuração do ClearQuest Connector atualiza o arquivo cqconnector.properties com base nas escolhas feitas no assistente. Se você pretende implementar o ClearQuest Connector no mesmo computador em que executa o assistente, não precisará editar o arquivo cqconnector.properties. Se você pretende implementar o ClearQuest Connector em um computador diferente, como um computador em execução em Linux®, copie o arquivo cqconnector.properties para o computador e em seguida edite-o para que os nomes de caminhos de qualquer computador especificados no parâmetro estejam corretos.

A tabela descreve os parâmetros do ClearQuest Connector.
Tabela 1. Parâmetros do ClearQuest Connector
Parâmetro Descrição
com.ibm.rational.interop.pollingPeriod Período de sondagem, que controla quão freqüentemente o ClearQuest Gateway sonda por alterações para o banco de dados do usuário do ClearQuest. O período de sondagem padrão é de 60 segundos.
com.ibm.team.uris Uniform Resource Identifier (URI) do servidor Jazz. O URI padrão é https://cqconnector:cqconnector@localhost:9443/jazz. Utilize um ponto-e-vírgula (;) para separar entradas para múltiplos servidores Jazz. Crie um usuário do Jazz chamado cqconnector ou substitua cqconnector pelo nome de outro usuário do Jazz. O usuário do Jazz (cqconnector ou outro) deve ter uma licença do Jazz ClearQuest Connector ou Developer. Se você utilizar o cqconnector com o ID do usuário, certifique-se de alterar a senha a partir do padrão de cqconnector.
cq.dbSetDbName Repositório de esquemas e banco de dados do usuário do ClearQuest. O repositório de esquemas padrão é sample_schema_repo. O banco de dados do usuário padrão é SAMPL. O formato é nome de conexão do repositório de esquemas/nome do banco de dados do usuário.
cq.orderedProperties.tipo de registro Uma lista separada por vírgulas de campos que indica a ordem na qual o ClearQuest Connector deverá configurar os valores desses campos durante as operações de sincronização de saída. É possível configurar o parâmetro para cada tipo de registro que tenha uma regra de sincronização. Os campos não especificados na lista são processados depois dos existentes na lista. Você pode precisar especificar a ordem caso seus tipos de registro do ClearQuest contenham ganchos que estabeleçam dependências entre os campos.

Outra maneira de especificar a ordem é usar a propriedade Campos Dependentes da Web em campos na definição de formulário no ClearQuest Designer. Se você especificar tanto a propriedade Campos Dependentes da Web e o parâmetro cq.orderedProperties, o ClearQuest Connector utiliza a ordem especificada com o parâmetro cq.orderedProperties.

cq.password Senha para efetuar login no banco de dados do usuário do ClearQuest. O ClearQuest Gateway e a ferramenta de Importação utilizam esta senha e o nome de usuário que você especificou com o parâmetro cq.userId para efetuar login no banco de dados do usuário do ClearQuest e recuperar registros que desejar importar em um repositório do Jazz. O valor padrão é cqconnector. Certifique-se de alterar a senha a partir do valor padrão.
cq.userId O nome de usuário para login no banco de dados do usuário do ClearQuest. O ClearQuest Gateway e a ferramenta de Importação utilizam este nome de usuário e a senha especificados com o parâmetro cq.password para efetuar login no banco de dados do usuário do ClearQuest e recuperar registros que você deseja importar em um repositório do Jazz. O valor padrão é cqconnector. Este usuário deve ter permissão de editor SQL.
cq.queryTreeRoot O nome do caminho completo da pasta-raiz que contém a pasta ou pastas de consultas específicas da área do projeto que você usa para filtrar registros a serem sincronizados com os itens do Rational Team Concert. É possível especificar uma consulta para cada tipo de registro que você sincroniza por área de projetos. Grave as consultas de uma forma que elas não selecionem um registro do ClearQuest a ser sincronizado com mais de uma área de projetos no mesmo Jazz Team Server.

A pasta-raiz pode estar em qualquer nível da hierarquia de pastas sob Consultas Públicas ou Consultas Pessoais, mas sua hierarquia deve estar da seguinte forma: pasta-raiz/pasta do nome da área de projetos. As consultas devem ser armazenadas diretamente nas pastas da área de projetos. É possível ter múltiplas pastas de áreas de projetos. O nome de cada pasta de área de projetos deve corresponder ao nome da área de projetos no Repositório do Jazz.

Especifique um valor para este parâmetro. A pasta de consulta-raiz especificada deve existir e conter uma pasta para cada área de projetos com a qual planejar sincronizar registros e itens de trabalho. Se uma pasta de área de projetos não contiver uma consulta de tipo de registro que tenha uma regra de sincronização, o ClearQuest Connector tenta sincronizar todos os registros desse tipo de registro.

   

Para modificar os parâmetros:

  1. Navegue para a pasta diretório de instalação\gateway. Abra o arquivo cqconnector.properties.
  2. Modifique os valores de parâmetros conforme necessário para corresponderem ao seu ambiente.
    1. Edite o com.ibm.team.uris valor do parâmetro para apontar para o local do servidor ou servidores Jazz. Pelo padrão, o ClearQuest Gateway tenta efetuar login no servidor Jazz como o usuário cqconnector. Crie um usuário do Jazz chamado cqconnector ou substitua cqconnector pelo nome de outro usuário do Jazz. O usuário do Jazz(cqconnector ou outro) deve ter uma licença do Rational Team Concert ClearQuest Connector ou Developer. Para especificar um usuário diferente, insira nome de usuário[:senha]@ antes do nome do host. Por exemplo: https://chris:chris_pw@localhost:9443/jazz. Utilize um ponto-e-vírgula (;) para separar entradas para múltiplos servidores Jazz.
    2. Edite o valor do parâmetro cq.dbSetDbName para identificar seu repositório de esquemas e o banco de dados do usuário.
    3. Edite o valor do parâmetro com.ibm.rational.interop.pollingPeriod se desejar alterar o período de sondagem padrão de 60 segundos.
    4. Para filtrar os registros do ClearQuest a serem sincronizados, crie consultas para cada tipo de registro que tenha uma regra de sincronização. Armazene as consultas em pastas específicas de área de projetos sob a pasta-raiz. Edite o parâmetro cq.queryTreeRoot para identificar o nome do caminho completo da pasta-raiz. Por exemplo: Public Queries/Jazz CQ Connector. Mesmo se não quiser filtrar registros, crie uma pasta-raiz, e crie uma pasta de área de projetos para cada área de projeto para a qual planejar sincronizar registros e itens de trabalho.
    5. Especifique os nomes de usuário e as senhas para efetuar login no ClearQuest com os parâmetros cq.userId e cq.password. O usuário que você especifica com o parâmetro cq.userId deve ter privilégios de editor SQL.
    6. Se algum dos campos nos tipos de registro do ClearQuest que você planeja sincronizar possuir ganchos que estabeleçam dependências com outros campos e você não utilizar a propriedade Campos Dependentes da Web na definição de formulário do ClearQuest para especificar a ordem na qual os valores dos campos devem ser configurados, configure o parâmetro cq.orderedProperties.tipo-de-registro. Um gancho associado a um campo pode utilizar o valor que um usuário digita nesse campo para determinar como configurar o valor de outro campo. Neste cenário, identifique a ordem na qual os ganchos devem ser executados durante operações de sincronização de saída para assegurar que os campos de registro do ClearQuest sejam configurados com os valores corretos. Por exemplo: cq.orderedProperties.Defeito=Título,Tipo,Produto,Componente. Este exemplo especifica que o campo Título no tipo de registro Defeito deve ser configurado primeiro, seguido pelos campos Tipo, Produto e Componentes.

      Se você especificar tanto a propriedade Campos Dependentes da Web e o parâmetro cq.orderedProperties, o ClearQuest Connector utiliza a ordem especificada com o parâmetro cq.orderedProperties.

    7. Feche e salve o arquivo cqconnector.properties.
O que Fazer Depois
Nota: Como o arquivo cqconnector.properties contém nomes de login e senhas para contas de usuário do ClearQuest e do Jazz, certifique-se de configurar as permissões nesse arquivo para que ele possa ser lido somente por usuários autorizados.

Feedback

Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro