< Anterior | Próximo >

Lição 1.1: Customizar os Dados de Origem Usados em Tarefas ETL

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.
Antes de Iniciar
Pré-requisitos: Antes de iniciar a lição, faça backup do arquivo clearquest.xdc. O local padrão é o diretório [rational_insight_installation_directory]/dataconfig/configs/configurations.
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
  1. Inicie a Configuração de Dados XML.
  2. Clique em Arquivo > Abrir Configuração > clearquest.xdc. Geralmente, o arquivo está localizado no diretório [rational_insight_installation_directory]/dataconfig/configs/configurations.
  3. Expanda o nó Configuração de Dados XML para listar os grupos de recursos. Clique duas vezes em CQEnterprise. Geralmente, CQEnterprise está localizado em Configuração de Dados XML > Recurso > CQEnterprise > ClearQuest Enterprise.
  4. 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
  5. 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
  1. Expanda o nó CQEnterprise > ENTDefect 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.
  2. Clique duas vezes na tabela de dados ENTDefect.
  3. 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.
  4. Na janela Mapeamento de Valores, especifique os seguintes valores:
    Tecla Valor
    P1 Alto
    P2 Médio
    P3 Baixo
    Salve a tabela de dados.
  5. 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.
  6. 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.

  7. 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.
  8. 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ó Defeito > Componente.
  9. 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).
  10. Retorne para o editor da tabela de dados ENTDefect. Quando solicitada a atualização, clique em OK.
  11. 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.
  12. 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
  1. Clique com o botão direito do mouse no grupo de recursos CQEnterprise, selecione Novo > Recurso 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.
  2. Especifique o nome como ENTComponent e clique em Avançar.
  3. Expanda o nó Banco de Dados > RecordQueries > Consultas > Consulta 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.

  4. 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.
  5. Clique com o botão direito do mouse no recurso recém-criado e selecione Novo > Tabela de Mapeamento de Dados e especifique o nome como ENTComponent. Clique em Avançar.
  6. Especifique o nó expansível como /Query/results/Component. Clique em Avançar.
  7. 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.

  8. 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
  1. Arraste o grupo de recursos CQEnterprise e solte-o na categoria de recursos ClearQuest Enterprise.
  2. Clique em Copiar.
  3. 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.
  4. 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.

Ponto de Verificação da Lição

Você modificou o arquivo de configuração de dados XML de uma origem de produto. Você incluiu novos atributos na tabela de dados e incluiu um grupo de recursos em uma categoria de recursos.
< Anterior | Próximo >