Exibir origem

O objetivo deste guia é ajudar os desenvolvedores a entender a composição do projeto e como nos organizamos para desenvolver o TAF TSI.
A documentação disponibilizada para os clientes consta em TSI - TAF Service Integration.

Configuração

A configuração para integração com o Sonarqube pode ser encontrada no arquivo sonar-project.properties, dentro da estrutura do projeto TAF-THF.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-25-38.png$

Execução

Os procedimentos abaixo devem ser executados após publicação de nova versão da aplicação. Existem duas alternativas, utilizando os artefatos gerados na própria publicação do projeto, ou manualmente, sincronizando o repositório do servidor em sua máquina local:

Utilizando artefatos da publicação

Passo 1: Na sua plataforma de desenvolvimento, baixar/atualizar do repositório remoto a branch master do projeto TAF-THF.
Passo 2: Substituir os arquivos da pasta coverage ( Imagem 1 ) em sua máquina local com os arquivos contidos em coverage.zip ( Imagem 2 ) gerado na expedição da última versão do projeto.

Imagem 1 - Diretório coverage, localizada ao mesmo nível que a pasta do projeto TAF-THF, e que deve ser atualizada com os arquivos do coverage.zip da última publicação.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-16-12.png$

Imagem 2 - Arquivo coverage.zip da última publicação, que deve ser utilizado para substituir os arquivos no diretório coverage da sua máquina local.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2021-8-12_12-14-45.png$

Passo 3: Executar o analisador do projeto para coleta e envio das métricas ao Sonarqube ( npm run sonar ).

Caso esta operação seja realizada com sucesso, deve ser apresentado uma mensagem similar a imagem abaixo:

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-17-35.png$

Consultando Dashboard TAF do Futuro é possível analisar os dados atuais do projeto.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-31-27.png$

Sincronizando repositório do servidor

Passo 1: Na sua plataforma de desenvolvimento, baixar/atualizar do repositório remoto a branch master do projeto TAF-THF.
Passo 2: Remover as dependências ( rm -r .\package-lock.json ) e a pasta node_modules ( rm -r .\node_modules\ ).
Passo 3: Restaurar as dependências e a pasta node_modules ( npm i, npm i protheus-lib-core --registry https://npm.totvs.io, npm i angular-erp-integration --registry https://npm.totvs.io ), assim garantimos que nosso pacote local está atualizado de acordo com as dependências do repositório remoto.
Passo 4: Executar os testes automatizados ( ng test ou ng test --source-map --code-coverage --no-watch ).

Após a execução dos testes, caso sejam bem sucedidos, a pasta coverage, localizada ao mesmo nível que a pasta do projeto TAF-THF, será atualizada com os arquivos de métricas.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-16-12.png$

Passo 5: Executar o analisador do projeto para coleta e envio das métricas ao Sonarqube ( npm run sonar ).

Caso esta operação seja realizada com sucesso, deve ser apresentado uma mensagem similar a imagem abaixo:

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-17-35.png$

Consultando Dashboard TAF do Futuro é possível analisar os dados atuais do projeto.

$TOTVS Automação Fiscal > Guia Suporte \ Desenvolvimento \ TAF TSI > image2020-12-4_10-31-27.png$