Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Image Added

O TOTVS CodeAnalysis é uma ferramenta desenvolvida para permitir aos clientes efetuarem uma verificação em seus fontes customizados, afim de certificar a qualidade dos mesmos. Através de regras pré-determinadas, a ferramenta possibilita que os requisitos indicados sejam corrigidos evitando um maior impacto em atualizações.

...

O serviço consiste no cadastro de um projeto no site do CodeAnalysis, envio de um arquivo compactado (em .zip apenas) com os fontes a serem analisados, e agendamento da análise desses fontes. Ao final, é exibida uma tela com o resultado da análise, apontando o que precisa ser corrigido ou melhorado nos fontes.

...

- Será exibida na tela um aviso de que a senha temporária foi enviada por e-mail (se por acaso o e-mail não for recebido, clique em Esqueceu sua senha e insira o e-mail para enviar novamente)



- Acesse o e-mail, copie a senha temporária enviada, e na tela de login do CodeAnalysis, digite o e-mail que foi cadastrado, insira a senha temporária enviada e clique em Entrar



...

- Será exibida uma tela para a inclusão de Projetos, que é o local onde iremos agendar o envio dos fonts fontes e análise dos mesmos. Clique em +Projeto



...

Tipo de acesso dos arquivos: define como os fonts fontes serão enviados para análise. Para o nosso exemplo, utilizaremos a opção Upload

Usuários: Selecione os usuários que terão acesso a este projeto. Por padrão o usuário inicial já está criado e pode ser selecionado. Se quiser adicionar outros usuários, utilize o menu lateral Usuários

Obs.:
Formato dos arquivos e pastas: os arquivos e pastas não devem conter espaços e/ou acentos em seus nomes.

ADVPL Include: Se o projeto tiver includes adicionais aos padrões do Protheus, a pasta dele deve ser indicada neste campo. O formato de digitação da pasta é baseado nas pastas que devem conter no arquivo compactado (em .zip) e também na linguagem, que é Case Sensitive. Obrigatoriamente o arquivo compactado deve conter uma pasta chamada src na raiz do zip, que conterá os fontsfontes, e se tiver includes, uma pasta para eles. No nosso exemplo, o arquivo compactado contém a pasta pasta my_include e  e a pasta src dentro de uma pasta principal chamada projeto_exemplopasta src na raiz do zip, conforme imagem abaixo:Image Removed




Image Added


- Após preencher as informações, clique em Confirmar

...

- Será exibida uma janela para o carregamento do arquivo compactado. Clique em Selecionar arquivo, selecione o seu arquivo compactado, e clique em Iniciar envio
Image Removed
- Após aparecer o sinal de verificado, conforme imagem abaixo, clique em Agendar



- Será exibida uma mensagem de Agendamento efetuado, confirmando o envio dos fontsfontes



- Ao enviar o seu Projeto para a análise, ele entrará em uma fila de execução, e assim que verificado, será exibida a informação de Status de Executado. Para verificar, no menu lateral, clique em Agendamentos



...

- Nesta tela serão exibidas as informações analisadas. Para verificar as regras da Totvs, clique no menu Rules e use o filtro ADVPL


Classificação dos tipos de Bugs apontados pelo CodeAnalysis

Todos os bugs devem ser observados, uma vez que são impeditivos para o bom funcionamento do sistema (todos são problemas).

Classificação dos bugs:

Blocker: é o bug mais crítico
Minor: bug menos crítico.
CodeSmell: é uma recomendação de correção (nada impede que no futuro um CodeSmell torne-se um bug).

Os bugs podem ou não ser por performance, essa informação vem acompanhada na descrição de cada issue.


Informações

Para dúvidas e comentários referentes a ferramenta, favor consultar o Dev Fórum:

https://devforum.totvs.com.br

...