Nesta lição você aprenderá como modificar arquivos de configuração
de dados XML. O arquivo de configuração de dados XML contém informações sobre
a origem e a estrutura dos dados usados para ETL e é usado pelo driver ODBC XML
no tempo de execução. Nesta lição, você incluirá novos atributos e recursos em
um arquivo de configuração de dados XML.
Por Que e Quando Desempenhar Esta Tarefa
Para esta lição, você usará o arquivo clearquest.xdc como um ponto inicial
e modificará este arquivo para atender os objetivos da lição. Você incluirá uma entidade
de componente e a tornará uma propriedade do registro de defeito.
Nesta lição,
você:
- Modificará as informações de conexão do grupo de recursos para correspondência
com o servidor de serviços de dados implementado em seu ambiente
- Modificará a tabela de dados de defeitos e incluirá novos atributos e mapeamentos de valores
- Incluirá um novo recurso e a tabela de dados para o componente
- Incluirá vários projetos em uma categoria de recursos
Configurar as conexões do servidor para o grupo de recursos- Inicie a Configuração de Dados XML.
- Clique em . Geralmente, o arquivo está localizado no
diretório [rational_insight_installation_directory]/dataconfig/configs/configurations.
- Expanda o nó Configuração de Dados XML para listar
os grupos de recursos. Clique duas vezes em CQEnterprise. Geralmente, CQEnterprise está localizado em .
- No editor de grupo de recursos, altere a URL dos Serviços de Dados para
correspondência com a URL do servidor de serviços de dados implementado em
seu ambiente, e altere o tipo de autenticação, o nome do usuário e a senha
para correspondência com as configuração de autenticação em seu servidor de serviços de dados.
Nota: Um
grupo de recursos deverá definir uma URL base para um conjunto de documentos XML. O escopo recomendado
para os grupos de recursos por produtos é o seguinte:
- Rational ClearQuest:
URL para um banco de dados do usuário
- Rational RequisitePro:
URL para um projeto RequisitePro
- Rational ClearCase:
URL para um VOB ClearCase
- Microsoft Project:
URL para um arquivo de projeto
- Rational QualityManager:
URL raiz para o serviço REST do RQM
- Rational TestManager:
URL para um projeto TestManager
- Salve a configuração.
Agora você modificou as informações de conexão do arquivo clearquest.xdc
para correspondência com o servidor de serviços de dados implementado em seu ambiente.
Incluir
colunas em uma tabela de dados- Expanda o nó para listar as tabelas de dados.
Nota: O nó ENTDefect representa o documento (recurso) XML
para todos os registros de defeitos retornados juntando a URL definida no grupo de recursos-pai
ao caminho relativo designado ao recurso.
- Clique duas vezes na tabela de dados ENTDefect.
- Clique na guia Colunas, selecione a linha para a coluna Prioridade e,
em seguida, clique no link Mapeamento de Valor no canto
superior direito do editor.
Nota: Com um mapa de valores você pode transformar os valores
da instância de origem em um novo valor durante o processo de extração. Este é um método
conveniente para padronização em um definição comum para os dados de várias origens.
Por exemplo, se sua empresa usa Alto, Médio e Baixo para definir prioridade e alguns
grupos dentro da empresa usam P1, P2 e P3, você poderá definir um mapa de valores
para padronizar esta definição.
- Na janela Mapeamento de Valores, especifique
os seguintes valores:
Tecla |
Valor |
P1 |
Alto |
P2 |
Médio |
P3 |
Baixo |
Salve a tabela de dados.
- Para abrir o modelo da tabela de dados associado, na guia Colunas,
clique no link Modificar no canto superior direito. Selecione a definição
de linha Prioridade destacada em vermelho, selecione
a coluna BusinessPriority na seção de esquema XML e
clique em Atualizar XPath.
Nota: A Configuração de Dados XML
automaticamente valida o esquema retornado do serviço de dados com os mapeamentos de
colunas existentes. Todos os mapeamentos inválidos são destacados. Nesta situação,
o esquema customizado possui as mesmas informações que a coluna Prioridade atual,
mas em um atributo diferente. Nesta etapa, você remapeou o XPath /Priority predefinido
inválido para o XPath /BusinessPriority válido.
- Na seção Mapeamento de Colunas, expanda o nó-raiz Defeito sob
a seção do esquema XML para listar os atributos sob Defeito.
Nas
próximas etapas, você criará novos mapeamentos de colunas de tabelas a partir da origem
XML. A estrutura da árvore à esquerda representa os nós-filho contidos no nó expansível
associado à tabela de dados.
- Clique em Status e, em seguida, clique em Criar.
Certifique-se de que o nome da coluna de tabela seja Status e que o Tipo SQL seja
Varchar. Salve o modelo de tabela.
- Na seção Mapeando Colunas, expanda o nó-raiz Defeito
sob a seção do esquema XML para listar os atributos sob Defeito.
Selecione o nó .
- Clique em dbid e, em seguida, clique em Criar.
Certifique-se de que o nome da coluna da tabela seja Component_dbid e o Tipo SQL
seja Integer. Salve o modelo de tabela.
Nota: No esquema Enterprise customizado
para este tutorial, é necessário fornecer informações suficientes para o processo
ETL para criar um relacionamento do registro Defeito com o registro Componente.
Você fará isso expondo o atributo dbid do Componente (a chave exclusiva para
registros ClearQuest).
- Retorne para o editor da tabela de dados ENTDefect. Quando solicitada a atualização,
clique em OK.
- Selecione as duas novas colunas Status e Component_dbid e clique em Carregar.
Nota: Uma definição
de tabela de dados pode conter um subconjunto de mapeamentos de colunas no modelo
de tabela de dados associado. Com o recurso Carregar/Descarregar, você pode controlar
a visibilidade das colunas para os clientes ODBC.
- Salve a tabela de dados.
Agora você modificou a tabela de dados de defeitos incluindo novos atributos e mapeamentos de valores.
A seguir, você definirá uma nova tabela de dados para exposição dos dados
do componente da origem XML. A primeira etapa é definir um novo recurso para representar
o documento XML contendo as informações do componente.
Criar uma tabela
de dados- Clique com o botão direito do mouse no grupo de recursos CQEnterprise, selecione
e
selecione Localizar usando serviço de dados.
Nota: Se você não
souber a URL do recurso, poderá usar Localizar usando serviço de
dados para definir o recurso.
- Especifique o nome como ENTComponent e clique em Avançar.
- Expanda o nó e, na
seção Atributos de Elementos, selecione a caixa de opção href e
clique em Avançar.
Agora você está usando o assistente para recuperar
o esquema para o documento XML retornado do nível de grupo de recursos. As
pastas PersonalQueries e PublicQueries contêm as consultas relevantes definidas no
banco de dados do usuário ClearQuest.
A pasta RecordQueries contém consultas geradas dinamicamente do serviço de
dados ClearQuest
que retornarão todos os registros de um determinado tipo. Com a página do assistente,
você pode restringir seu foco em todos os registros possíveis sem precisar ver os dados
reais.
- Selecione uma URL que termine com /Record+Queries/Component.
Todas as instâncias do nó que foi selecionado por meio da página de assistente
anterior são exibidas. Clique em Concluir.
- Clique com o botão direito do mouse no recurso recém-criado e selecione
e
especifique o nome como ENTComponent. Clique em Avançar.
- Especifique o nó expansível como /Query/results/Component.
Clique em Avançar.
- Selecione Criar um novo modelo. Digite um nome e uma descrição
para a tabela de dados e clique em Avançar.
Na próxima etapa,
você selecionará os nós na árvore XML que deseja como colunas da tabela.
- Selecione os seguintes nós:
- dbid como tipo SQL integer
- Componente como tipo SQL VARCHAR
Clique em Concluir.
Agora você definiu as tabelas de dados necessárias no grupo de recursos
CQEnterprise. No momento, elas são apenas para um único banco de dados
ClearQuest. Entretanto,
você pode extrair dados de vários grupos de recursos sob uma única categoria de recursos.
Para conseguir fazer isso, é necessário criar grupos de recursos para cada
banco de dados ClearQuest
sob a categoria de recursos.
Nas próximas etapas, você criará um novo grupo de recursos
sob a categoria de recursos ClearQuest
Enterprise.
Para isso, você usará o grupo de recursos CQEnterprise como o ponto
inicial.
Criar um grupo de recursos para outros projetos- Arraste o grupo de recursos CQEnterprise e solte-o na
categoria de recursos ClearQuest Enterprise.
- Clique em Copiar.
- Selecione o grupo de recursos duplicado e modifique-o alterando a URL para correspondência com a URL dos serviços de dados para
o banco de dados do usuário ClearQuest para
um outro projeto. Na primeira seção deste tutorial, você aprendeu como fazer isso.
Nota: No ETL,
você pode carregar vários grupos de recursos com configurações idênticas em um modo em lote
organizando os grupos de recursos em categorias.
- Selecione Link para grupo de recursos existente, selecione CQEnterprise,
clique em OK e salve as alterações.
Nota: Um grupo de recursos pode ser vinculado a um grupo de recursos
existente. O novo grupo de recursos criado possui seu próprio nome
e informações de conexão, mas ele compartilha todos os recursos e tabelas
de mapeamentos de dados definidas no grupo de recursos existente CQEnterprise.
Isso significa que apenas uma cópia dos recursos e tabelas de mapeamentos de dados será mantida.
Se você alterar CQEnterprise, todos os grupos de recursos vinculados
automaticamente usarão os recursos e as tabelas de mapeamentos de dados atualizados.