Ir para o conteúdo principal

Integração com Painel Gerencial da CODE

OBJETIVO

Descrever o processo de análise e indicar a melhor alternativa para implantação da USER STORY “Eu, como gestor, preciso dos dados do Pipefy persistidos em um banco de dados”.

JUSTIFICATIVA

Após realização de diversas reuniões com gestão, os mesmos solicitaram que os dados gerados pelo fluxo de trabalho da SETIC-CODE dentro da ferramenta Pipefy fossem persistidos em  um banco de dados próprio, permitindo aos mesmos a criação de relatórios para a avaliação e tomada de decisões.

RESULTADOS ESPERADOS

  1. Relatório contendo a análise da melhor maneira de realizar a implantação da demanda
  2. Lista dos Pipes que serão utilizados para atender a demanda;
  3. Lista de equivalência dos campos personalizáveis dos Cards que serão persistidos no banco;
  4. Atender ao SPIKE "Planejamento da estrutura do banco de dados do Pipefy".

ENVOLVIDOS

  • Rodrigo Kreuzberg (Scrum Master)
  • Tiago Silveira (Product Owner)
  • Baymax (BI Team)

GLOSSÁRIO

  • API - Interface de Programação de Aplicações é o conjunto de rotinas e padrões estabelecidos por um software para a utilização de suas funcionalidades.
  • PIPEFY - ferramenta de controle de demandas e fluxo de trabalho atualmente utilizada pela SETIC.
  • GraphQL - sintaxe que descreve uma maneira de solicitar dados.

PREMISSAS

  1. Consultas no Pipefy deverão utilizar GraphQL;
  2. Relatórios podem conter dados de mais de um time;
  3. Relatórios serão gerados pela gerência, sendo necessária a coleta do máximo de subsídios o possível.

MAPEAMENTO

Após avaliação prévia, foi identificada a necessidade de mapear quais Pipes e Campos serão utilizados para atender a demanda. As informações estão descritas a seguir.

Pipes Mapeados

Pipes de Desenvolvimento

PIPE ID PIPE NAME PIPE URL
725642 Caveiras https://app.pipefy.com/pipes/725642
786310 Defensores https://app.pipefy.com/pipes/786310
451637 Guardiões https://app.pipefy.com/pipes/451637
451635 Vingadores https://app.pipefy.com/pipes/451635
877708 Esquadrão Suicída https://app.pipefy.com/pipes/877708
979418 Tambaqui https://app.pipefy.com/pipes/979418
961531 Baymax https://app.pipefy.com/pipes/961531
786390 Black Ops https://app.pipefy.com/pipes/786390
301411216 AC/DC https://app.pipefy.com/pipes/301411216

Pipes de Demandas

PIPE ID PIPE NAME PIPE URL
1158684 Demandas https://app.pipefy.com/pipes/1158684
1158790 Projetos https://app.pipefy.com/pipes/1158790
451374 Produtos https://app.pipefy.com/pipes/451374
735403 Dark Souls https://app.pipefy.com/pipes/735403
1083563 Amazonas https://app.pipefy.com/pipes/1083563
1263167 300 https://app.pipefy.com/pipes/1263167
Campos Mapeados

Pipes de Desenvolvimento

PROPRIEDADE TIME DE PARA
Sprint Caveiras    sprint
Defensores  
Guardiões field_37_connector
Vingadores  
Esquadrão Suicida  
Tambaqui  
Baymax  
Black Ops  
AC/DC  
Time Caveiras   time
Defensores  
Guardiões field_36_connector
Vingadores  
Esquadrão Suicida  
Tambaqui  
Baymax  
Black Ops  
AC/DC  
Planejado na Sprint? Caveiras field_9_string planejado
Defensores  
Guardiões field_31_string
Vingadores field_30_string
Esquadrão Suicida field_9_string
Tambaqui field_10_string
Baymax field_9_string
Black Ops field_5_string
AC/DC field_7_string
Necessidade Caveiras field_15_connector necessidade
Defensores  
Guardiões field_34_connector
Vingadores field_34_connector
Esquadrão Suicida  
Tambaqui field_8_connector
Baymax field_5_connector
Black Ops field_4_connector
AC/DC  
Projeto Caveiras field_14_connector projeto
Defensores  
Guardiões field_33_connector
Vingadores field_33_connector
Esquadrão Suicida field_5_connector
Tambaqui field_7_connector
Baymax field_4_connector
Black Ops field_6_connector
AC/DC  
Produto Caveiras field_11_connector produto
Defensores  
Guardiões field_31_connector
Vingadores field_28_connector
Esquadrão Suicida field_1_connector
Tambaqui field_5_connector
Baymax field_1_connector
Black Ops field_5_connector
AC/DC  
Tipo de Atividade Caveiras field_1_label_select atividade
Defensores  
Guardiões field_25_label_select
Vingadores field_20_label_select
Esquadrão Suicida field_1_label_select
Tambaqui field_1_label_select
Baymax field_1_label_select
Black Ops field_1_label_select
AC/DC field_1_label_select
Pontos de História Caveiras field_5_number pontos
Defensores field_5_number
Guardiões field_6_number
Vingadores field_3_number
Esquadrão Suicida field_1_number
Tambaqui field_1_number
Baymax field_2_number
Black Ops field_3_number
AC/DC field_1_number

MODELO DE CONSULTA

Para a obtenção dos dados necessários, é possível utilizar a seguinte consulta GraphQL:

{
  allCards(pipeId: #PIPEID) {
    edges {
      node {
        id
        title
        current_phase {
          id
          name
        }
        fields {
          date_value
          datetime_value
          filled_at
          float_value
          indexName
          name
          report_value
          updated_at
          value
        }
      }
    }
  }
}

As consultas podem ser testadas no link https://app.pipefy.com/graphiql, logando com a conta dashboardsetic.

RESULTADOS

Após análise dos Pipes, assim como seus campos, foi identificada a necessidade de implantação do projeto em algumas etapas, sendo elas: 

# ETAPA PREVISÃO CONCLUSÃO
1 Estudo de viabilização da implantação dos Pipes de Desenvolvimento 25/11/2020 17/11/2020
2 Implantação dos Pipes de Desenvolvimento; 11/12/2020  
3 Estudo de viabilização da implantação dos Pipes de Demandas;    
4 Implantação dos Pipes de Demandas;    

CONCLUSÃO

Conforme demonstrado, o projeto será implantado em etapas, descritas no parágrafo anterior. A utilização do GRAPHQL foi definida anteriormente, sendo documentada no link a seguir https://documentos.sistemas.ro.gov.br/books/pipefy/page/ferramentas-de-integra%C3%A7%C3%A3o-do-pipefy .

RECOMENDA-SE a adoção dos campos Sprint e Time, atualmente utilizado pelos Guardiões e Defensores, nos Pipes de TODOS os times de Desenvolvimento.

REFERÊNCIAS

Documentação - Ferramentas de Integração Pipefy - https://documentos.sistemas.ro.gov.br/books/pipefy/page/ferramentas-de-integra%C3%A7%C3%A3o-do-pipefy