Conexões do Clarity – integrações do Rally

ccppmop1592
As organizações podem usar a integração nova e aprimorada entre
Clarity
-Rally para garantir que os dados sejam transmitidos sem interrupção entre os dois aplicativos.
A integração nova e aprimorada entre
Clarity
-Rally é:
  • Fácil de ser ampliada e configurada: é possível mapear objetos e atributos entre o
    Clarity
    e o Rally para garantir que a integração atenda às suas necessidades específicas.
  • Simples de ser mantida: a integração pode ser configurada e mantida pelos administradores do
    Clarity
    que têm conhecimento básico do PPM clássico.
  • Validada e suportada pela Broadcom: não é necessário executar o teste de regressão depois de cada release.
Vamos analisar algumas etapas importantes que você precisa executar para aproveitar essa integração.
Linked
  1. Concluir os pré-requisitos relevantes para configurar a integração.
  2. Criar um objeto de integração para integrar o
    Clarity
    a uma instância específica do Rally.
  3. Criar um mapeamento de integração.
  4. Executar a rotina para importar o mapeamento de integração, a fim de buscar todos os objetos do tipo de item de portfólio do Rally e seus atributos associados.
  5. Definir os mapeamentos de objeto válidos.
  6. Definir os mapeamentos de campo válidos.
  7. Especificar um investimento do
    Clarity
    que poderia ser mapeado para um objeto no Rally.
  8. Executar a rotina de informações mapeadas sincronizadas para sincronizar dados entre o
    Clarity
    e o Rally.
  9. Revisar a tabela de armazenamento temporário do
    Clarity
    para entender as alterações a serem enviadas do Rally para o
    Clarity
    .
Revisar cada uma dessas etapas detalhadamente.
2
Pré-requisitos de integração
Você precisa executar as etapas a seguir para poder configurar a nova integração entre
Clarity
-Rally.
  1. Atribua o direito de acesso Mapeamento de integração - Ir para aos administradores que configurarão a integração entre
    Clarity
    -Rally. Os usuários com o direito Mapeamento de integração - Ir para poderão visualizar e acessar o bloco Integrations (Beta) na página Administração. Para saber mais sobre esse direito de acesso, consulte a documentação de direitos de acesso.
  2. Certifique-se de que a versão mais recente do complemento de conteúdo Acelerador de PMO esteja instalada. Com a versão mais recente do Acelerador de PMO instalado, o
    Clarity
    incluirá os atributos de ID de objeto do Rally e de mapeamento de integração para configuração em Projetos, Ideias e Investimentos personalizados.
Criando um objeto de integração no PPM clássico
Você pode configurar a nova integração entre
Clarity
-Rally criando um objeto de integração. É possível criar um objeto de integração na página Integrações do Classic PPM, que é o local para definir e manter todas as informações de integração.
Linked
As informações necessárias para criar um objeto de integração são:
  • URL de integração
  • Instância de integração
  • Chave da API de integração
  • Porta do proxy
Siga estas etapas:
  1. Efetue logon no PPM clássico.
  2. Clique em
    Administração
    ,
    Configurações gerais
    ,
    Integrações
    .
  3. Clique em
    Novo
    .
  4. Preencha os campos a seguir e clique em
    Salvar
    .
Nome de campo
Descrição
Áreas
O aplicativo de software ou a área de negócios do fornecedor (por exemplo, Agile).
Fornecedor
O nome da empresa à qual o
Clarity
está se integrando (por exemplo, Rally).
Fornecedor
O nome da empresa que está implementando a integração (por exemplo, Broadcom).
URL de integração
O URL para a instância de integração (por exemplo, o URL da instância do Rally).
Chave da API de integração
A chave usada para acessar e recuperar dados do Rally
Instância de integração
A ID do espaço de trabalho do Rally
Criar um mapeamento de integração no
Clarity
Depois de criar um objeto de integração, crie um mapeamento de integração.
Linked
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em
    Administração
    e selecione a guia
    Integrations (Beta)
    para abrir a página Integrações.
  3. Clique em Adicionar linha e insira o nome do mapeamento de integração.
    Nessa release, não é possível usar caracteres especiais ao especificar o nome do mapeamento de integração. Se você usar um caractere especial como "&", a rotina que sincroniza as informações mapeadas será concluída com um erro e a rotina de importação de tabelas de armazenamento temporário falhará.
  4. Na coluna Integração, selecione o objeto de integração relevante.
  5. O mapeamento de integração agora está disponível.
Executar a rotina de importação do mapeamento de integração no PPM clássico
A rotina de importação do mapeamento de integração no PPM clássico permite que o
Clarity
recupere os objetos do tipo de item de portfólio e os atributos suportados do espaço de trabalho configurado do Rally. Uma vez importados, os objetos e campos são disponibilizados na guia Objetos do Rally no
Clarity
.
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em
    Página inicial
    ,
    Relatórios e rotinas
    e
    Rotinas
    para abrir a guia Rotinas.
  3. Certifique-se de ter selecionado
    Rotinas disponíveis
    na lista suspensa e abra a rotina
    Import Integration Mappings
    .
  4. Selecione o mapeamento de integração relevante e clique em
    Enviar
    para executar a integração imediatamente. Também é possível programar essa rotina para ser executada em uma data posterior.
Depois que a rotina for executada com êxito, execute as etapas a seguir para ver os vários objetos de tipo de item de portfólio no Rally.
Linked
  1. Efetue logon no
    Clarity
    .
  2. Clique em Administração e selecione a guia
    Integrations (Beta)
    para abrir a página Integrações.
  3. Abra o mapeamento de integração relevante e selecione Objetos do Rally para ver os vários objetos importados do Rally.
Definir mapeamentos de objeto no
Clarity
Linked
É possível mapear investimentos (Projetos, Ideias e Investimentos personalizados) selecionados do
Clarity
para itens selecionados de portfólio do Rally.
Considere um exemplo em que uma organização tenha finalizado sua estratégia e usado investimentos personalizados no
Clarity
para criar temas, epopeias comerciais e resultados comerciais. Esses investimentos podem ser mapeados para temas, epopeias e recursos no Rally. Se a organização tiver criado projetos individuais no
Clarity
, ela também poderá mapeá-los para um tipo de item de portfólio relevante, como um projeto no Rally.
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em
    Administração
    e selecione a guia
    Integrations (Beta)
    para abrir a página Integrações.
  3. Abra o mapeamento de integração relevante e vá para a guia
    Mapeamentos do objeto
    .
  4. Clique no ícone Adicionar linha e insira os seguintes detalhes
    1. Nome: forneça o nome do mapeamento do objeto
    2. Objeto do Rally: selecione o objeto do Rally que deseja mapear para o investimento do
      Clarity
    3. Direção: selecione
      Clarity
      para Rally. Nessa release, a integração permite que você crie e atualize uma instância de um tipo de item de portfólio no Rally, associado a um investimento no
      Clarity
      . Isso significa que será criado um recurso no Rally associado a um investimento no
      Clarity
      . No entanto, se você criar um recurso ou qualquer outra instância do tipo de item de portfólio no Rally, a integração não permitirá a criação de um investimento no
      Clarity
      .
Depois de definir o mapeamento do objeto, você estará pronto para mapear os campos do
Clarity
e Rally. O mapeamento de campo ajuda a gerenciar como os dados serão trocados entre o
Clarity
e o Rally.
Definir mapeamentos de campo no
Clarity
Linked
Os mapeamentos de campo definidos especificam como os dados são trocados entre investimentos/campos do
Clarity
e itens/campos de portfólio do Rally. Os mapeamentos de campo são sempre associados a um mapeamento do objeto. Considere as seguintes técnicas de mapeamento de objeto e campos:
  • Revise a tabela de compatibilidade Tipo de dado para garantir que você esteja mapeando tipos de campo suportados.
    • A tabela está disponível na guia Compatibilidade do tipo de dado e pode ser acessada na página Integrações.
      Linked
  • Especifique a direção do fluxo de dados ao definir o mapeamento. Você pode definir um mapeamento no qual os dados fluem de um campo no
    Clarity
    para um campo no Rally.
    • Também é possível definir um mapeamento no qual os dados fluem de um campo no Rally para um campo no
      Clarity
      .
    • No entanto, nessa release, a integração bidirecional não é suportada.
    • Isso significa que, se você criou um mapeamento para atualizar a data de início planejada no Rally com o campo Início no
      Clarity
      , não será possível configurar outro mapeamento para atualizar o campo Início no
      Clarity
      se a data de início planejada no Rally for atualizada.
    • Além disso, não é possível incluir o mesmo campo em vários mapeamentos.
  • Selecione a opção de sincronização relevante.
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em
    Administração
    e selecione a guia
    Integrations (Beta)
    para abrir a página Integrações.
  3. Abra o mapeamento de integração relevante e vá para a guia Mapeamentos do objeto.
  4. Selecione o Mapeamento do objeto relevante, clique em
    DETALHES
    e selecione a guia
    Mapeamentos de campo
    .
  5. Clique em Expandir para abrir a janela
    Mapeamentos de campo
    .
  6. Insira os seguintes detalhes:
    1. Direção – selecione
      Clarity
      para Rally ou Rally para
      Clarity
      , de acordo com as suas necessidades.
    2. Campo do
      Clarity
      – selecione o campo relevante do
      Clarity
      . Esse campo é associado ao investimento identificado durante o mapeamento do objeto.
    3. Campo do Rally – selecione o campo do Rally a ser mapeado para o campo do
      Clarity
      . Certifique-se de que você esteja seguindo as diretrizes de compatibilidade de tipo de dado ao mapear os campos.
    4. Opção de sincronização – selecione dentre as opções Criar, Atualizar, Criar e Atualizar. Para saber mais sobre essas opções, consulte a rotina para executar a sincronização de informações mapeadas.
  7. Quando o
    Clarity
    valida o mapeamento de campo, as colunas Tipo de dado são preenchidas e salvas.
  8. Será exibida uma mensagem de erro se:
    1. Os campos que estiverem sendo mapeados não forem compatíveis
    2. Um dos campos já tiver um mapeamento
Selecionar investimentos do
Clarity
para sincronização com o Rally
Agora que você configurou a integração e definiu os mapeamentos relevantes, é possível selecionar quais investimentos específicos do
Clarity
serão sincronizados com o Rally. Nessa release, é possível selecionar ideias, projetos e investimentos personalizados específicos do
Clarity
para sincronização com o Rally.
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Vá para a página de investimento relevante e selecione o layout de grade.
  3. Use o seletor de coluna para adicionar à grade os atributos de objeto do Rally e mapeamento de integração.
  4. Selecione o mapeamento de integração relevante que deseja associar ao investimento.
Após a execução da rotina de informações mapeadas sincronizadas para sincronizar com êxito os dados entre o
Clarity
e o Rally, o campo Objeto do Rally será preenchido automaticamente.
Executar a rotina de sincronização de informações mapeadas
A rotina de sincronização de informações mapeadas no PPM clássico permite que os administradores sincronizem as informações mapeadas entre o
Clarity
e o Rally. Dependendo da direção configurada e da opção de sincronização, a rotina pode executar as seguintes operações:
Direção
Opção de sincronização
Comportamento esperado
Clarity
para Rally
Criar
Se o objeto mapeado não existir no Rally, essa rotina:
  1. Criará e preencherá objetos e campos mapeados do Rally
  2. Preencherá as tabelas de armazenamento temporário do
    Clarity
  3. Atualizará as tabelas de objetos (e campos) do Rally no
    Clarity
Clarity
para Rally
Criar e atualizar
Se o objeto mapeado não existir no Rally, essa rotina:
  1. Criará e preencherá objetos e campos mapeados do Rally
  2. Preencherá as tabelas de armazenamento temporário do
    Clarity
  3. Atualizará as tabelas de objetos (e campos) do Rally no
    Clarity
    .
Em execuções subsequentes, essa rotina:
  1. Atualizará objetos e campos mapeados do Rally
  2. Preencherá as tabelas de armazenamento temporário do
    Clarity
  3. Atualizará as tabelas de objetos (e campos) do Rally no
    Clarity
    .
Clarity
para Rally
Atualizar
Se o objeto mapeado existir no Rally, essa rotina:
  1. Atualizará objetos e campos mapeados do Rally
  2. Preencherá as tabelas de armazenamento temporário do
    Clarity
  3. Atualizará as tabelas de objetos (e campos) do Rally no
    Clarity
Rally para
Clarity
Criar
Não suportado
Rally para
Clarity
Criar e atualizar
Não suportado
Rally para
Clarity
Atualizar
Se o objeto mapeado existir no
Clarity
, essa rotina:
  1. Atualizará objetos e campos mapeados do
    Clarity
  2. Preencherá as tabelas de armazenamento temporário do
    Clarity
  3. Atualizará as tabelas de objetos (e campos) do Rally no
    Clarity
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em
    Página inicial
    ,
    Relatórios e rotinas
    e
    Rotinas
    para abrir a guia Rotinas.
  3. Certifique-se de ter selecionado Rotinas disponíveis na lista suspensa e abra a rotina
    Synchronize Mapped Information
    .
  4. Selecione o mapeamento de integração relevante e clique em Enviar para executar a integração imediatamente.
Depois que a rotina for executada com êxito, o
Clarity
executará automaticamente a rotina de importação de tabelas de armazenamento temporário para mover os dados da tabela de armazenamento temporário para o
Clarity
.
Você pode programar a sincronização de informações mapeadas para ser executada regularmente. No entanto, se a rotina de sincronização de informações mapeadas for disparada manualmente, as rotinas programadas não serão executadas simultaneamente.
Revisar a tabela de armazenamento temporário no
Clarity
Linked
Cada mapeamento de integração tem uma tabela de armazenamento temporário associada no
Clarity
. A tabela de armazenamento temporário pode ser acessada somente por membros do grupo Administrador de sistemas do PMO. Se desejar fornecer acesso manualmente à tabela de armazenamento temporário, você poderá atribuir os seguintes direitos de acesso a um usuário ou grupo:
  • <Nome do mapeamento de integração> - Criar
  • <Nome do mapeamento de integração> - Excluir tudo
  • <Nome do mapeamento de integração> - Editar tudo
  • <Nome do mapeamento de integração> - Visualizar tudo
  • <Nome do mapeamento de integração> - Acesso ao Xog
Nessa release, a tabela de armazenamento temporário pode ser usada para:
  • Revisar todos os dados copiados do Rally para o
    Clarity
    após a execução bem-sucedida da rotina de sincronização das informações de mapeamento.
  • Revisar as mensagens de erro caso a sincronização de dados falhe.
Siga estas etapas:
  1. Efetue logon no
    Clarity
    .
  2. Clique em Administração e selecione a guia Integrations (Beta) para abrir a página Integrações.
  3. Abra o mapeamento de integração relevante e vá para a guia Tabela de armazenamento temporário. Os registros dessa tabela serão exibidos somente se você tiver os direitos de acesso pertinentes.
  4. Adicione as colunas relevantes ao layout da grade para revisar o status dos registros que foram processados. Algumas colunas importantes que podem ser adicionadas são:
    1. ID de execução da rotina
    2. Status
    3. Clarity
      Objeto
    4. Clarity
      Nome do objeto
    5. Objeto do Rally
    6. Objeto do Rally
    7. Nome
    8. Mensagem de erro
Pontos importantes a serem lembrados
:
  • A tabela de armazenamento temporário não exibe dados de saída do
    Clarity
    para o Rally.
  • Os dados da tabela de armazenamento temporário são removidos do
    Clarity
    toda vez que a rotina de sincronização das informações mapeadas é executada.
  • Após a execução da rotina de sincronização das informações mapeadas, o usuário receberá acesso automaticamente às tabelas de armazenamento temporário.
  • Os direitos de acesso global do mapeamento de integração (visualizar, editar e excluir) são automaticamente adicionados ao grupo Administrador de sistemas do PMO. Esse processo de back-end permite acesso às tabelas de armazenamento temporário.
Fluxo de sincronização de dados para integração do Rally
Quando você executa a rotina de sincronização de informações mapeadas após a configuração da integração do Rally, é feita a verificação dos investimentos do
Clarity
associados para confirmar se o campo Objeto do Rally foi atualizado.
  • Antes da criação de um novo item de portfólio do Rally pelo
    Clarity
    , o campo Objeto do Rally encontra-se vazio. Quando a rotina de sincronização é executada, o campo Objeto do Rally para o investimento relevante no
    Clarity
    é atualizado. Na próxima vez que você executar a rotina, o
    Clarity
    atualizará os campos relevantes no Rally (mapeamento
    Clarity
    para Rally). A rotina também atualiza a tabela de armazenamento temporário e os campos do
    Clarity
    (mapeamento Rally para
    Clarity
    ).
  • Se o campo Objeto do Rally não estiver vazio, o
    Clarity
    atualizará os campos relevantes diretamente no Rally (mapeamento
    Clarity
    para Rally). A rotina também atualiza a tabela de armazenamento temporário e os campos do
    Clarity
    (mapeamento Rally para
    Clarity
    ).
Principais pontos a serem considerados ao aproveitar a integração
  • Sempre que um campo do
    Clarity
    é atualizado com o valor de um campo mapeado do Rally, o usuário que executa a rotina de informações mapeadas sincronizadas é listado no log de auditoria.
  • Os clientes podem continuar usando a nova integração do Rally e as integrações de Hierarquia do item de portfólio, Investimentos ou (
    Clarity
    ) Planilha de Horas do Rally, se houver necessidade.
    • Se um cliente tiver configurado uma integração do "Agile", não haverá impacto na integração existente após a atualização
    • As novas rotinas (importação de mapeamentos de integração, sincronização de informações mapeadas e importação de tabelas de armazenamento temporário, por exemplo) são definidas como incompatíveis com as rotinas antigas (Sincronizar o Agile Central e Criar investimentos no Agile Central, por exemplo) para que elas não sejam executadas simultaneamente
  • Se a rotina de importação de mapeamento de integração não for executada após a criação de uma instância dos mapeamentos de integração, o
    Clarity
    e os Objetos do Rally não serão disponibilizados nos respectivos menus suspensos
    • Se você criar outros atributos personalizados (no
      Clarity
      ou no Rally), a rotina de importação de mapeamento de integração deverá ser executada para garantir que eles estejam disponíveis na grade de mapeamento de campo
  • Os campos do Rally não são atualizados
    • Se um campo em qualquer um dos sistemas for administrado pela lógica comercial, não será possível usar o sistema em questão como o destino
      Linked
  • A rotina de sincronização de informações mapeadas retorna apenas alterações
    • Na primeira vez que a rotina de sincronização de informações mapeadas for executada, o
      Clarity
      e o Rally estarão em sincronia
    • Após execução da rotina, um usuário do
      Clarity
      atualiza o campo % concluído (que é originado no Rally)
    • De uma perspectiva de desempenho, na próxima vez que a rotina de sincronização de informações mapeadas for executada, desde que não haja alterações no Rally, o sistema não atualizará o campo % concluído do
      Clarity
      , e dessa vez o
      Clarity
      e o Rally não estarão mais em sincronia
    • O campo % concluído do
      Clarity
      será sincronizado apenas quando o item de portfólio mapeado for atualizado no Rally
    • Até lá, esses campos mapeados continuarão fora de sincronia
  • Você pode aproveitar o log da rotina para solucionar problemas da troca de dados entre o
    Clarity
    e o Rally.
    Linked