Configure suas métricas de investimento como widgets

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Configure as métricas de investimento com base em seus requisitos de negócio. Essas métricas aparecem como widgets na página do Portal de investimentos.

    Antes de Iniciar

    Função necessária: pps_admin

    Procedimento

    1. Navegar até Administração de Projeto > Widgets do Portal de investimentos.
    2. Clique em Nova.
    3. No formulário, preencha os campos:
      Tabela 1. Formulário do widget do quadro do portal
      Campo Descrição
      Nome Nome exclusivo para o widget que você está configurando.
      Ordem

      A ordem em que os widgets aparecem no Quadro de investimentos e na página do Portal de investimentos. Números mais baixos são colocados à frente de números mais altos.

      Por exemplo, um widget com uma ordem definida como 100 aparece antes de um widget com uma ordem definida como 200.

      Tipo agregado Tipo de agregação aplicado ao cálculo do widget de investimento: Soma, Média, Mínimo, Máximoe Contagem.

      Por exemplo, você está agregando o custo real de três projetos, A, B e C, exibidos por um filtro. Os custos reais são 1000 para o projeto A, 2000 para o projeto B e 3000 para o projeto C.

      Se a soma for selecionada como o tipo agregado, o valor da métrica de custo real será 6000. Se a média for selecionada como o tipo agregado, o valor da métrica de custo real será 2000. Se o mínimo for selecionado como o tipo agregado, o valor da métrica de custo real será 1000. Se máximo for selecionado como o tipo agregado, o valor da métrica de custo real será 3000. Se a contagem for selecionada como o tipo agregado, o valor da métrica de custo real será 3.

      Com script Caixa de seleção para especificar um script para o cálculo do widget de investimento.
      Mostrar rótulo Caixa de seleção para exibir o rótulo ou o indicador de cor.

      Se você desmarcar a caixa de seleção, o campo Cor será exibido, o que permite definir a cor.

      Ativo Caixa de seleção para indicar que o widget de investimento está ativo.
      Exibir no quadro Caixa de seleção para exibir o widget de investimento no quadro de investimentos.
      Widget primário Widget primário para este widget de métrica de investimento. Um widget primário pode ter até três widgets secundários.
      Incluir por padrão Caixa de seleção para mostrar um widget de investimento ativo por padrão em:
      • novos quadros
      • quadros existentes que não têm a seleção de widget configurada
      A caixa de seleção está marcada por padrão.

      Para obter mais informações sobre como configurar widgets em um quadro de investimento, consulte Configuração de widget.

      Descrição resumida Breve descrição sobre o widget de investimento.
      Script Script escrito para o cálculo dinâmico do widget de investimento. Este campo é exibido somente quando a caixa de seleção Com script está marcada.

      O script a seguir retorna uma cadeia de caracteres que contém a saída desejada a ser exibida no widget. Cinco variáveis (que são introduzidas programaticamente no script) estão disponíveis:

      • projectFilter: filtro de projeto do quadro do Portal de investimentos.
      • demandaFilter: filtro de demanda do quadro do Portal de investimentos.
      • projectClass: classe de projeto do quadro do Portal de investimentos que é usada durante a avaliação de valor dos espaços das equipes. Ele retorna tsp1_project para o Quadro do Portal do Teamspace1.
      • demandaClass: classe de demanda do quadro do Portal de investimentos que é usada durante a avaliação de valor dos espaços de equipe. Retorna tsp1_demand para o Quadro do Portal do Teamspace1.
      • boardSysId: SysId do quadro do Portal de investimentos. Ele fornece acesso a mais informações no quadro do Portal de investimentos quando necessário.
      Amostra de widget com script para custo do projeto
      totalProjectCost();
      
      function totalProjectCost() 
      {
          var totalCost = 0;
          
          if(!JSUtil.nil(projectClass) && !JSUtil.nil(projectFilter))
      { 
              var projectGa = new GlideAggregate(projectClass);
              projectGa.addEncodedQuery(projectFilter);
              projectGa.setGroup(false);
              projectGa.addAggregate('SUM', 'cost');
      
              projectGa.query();
      
              if(projectGa.next()) 
      {
                  if(projectGa.getAggregate('SUM', 'cost'))
                  totalCost += parseFloat(projectGa.getAggregate('SUM', 'cost'));
              }
          }
          return PPMCurrencyHelper.defaultCurrencySymbol() + PPMCurrencyHelper.getFormattedAmount(totalCost);
      }
      Projeto
      Coluna agregada do projeto A agregação é aplicada na coluna selecionada da tabela Projeto [pm_project].
      Tabela do projeto Tabela da qual os projetos estão sendo filtrados.
      Filtro de projeto Critérios aplicados para filtrar projetos da tabela Projeto.
      Demanda
      Coluna agregada de demanda A agregação é aplicada na coluna selecionada da tabela Demanda [dmn_demand].
      Tabela de demanda Tabela da qual as demandas estão sendo filtradas.
      Filtro de demanda Critérios aplicados para filtrar demandas da tabela Demanda.
    4. Clique em Enviar.