Avaliação da Qualidade

A Avaliação da Qualidade é uma funcionalidade integrada no ValiAssistant. Analisa os textos dos Requisitos selecionados com base num conjunto de regras do INCOSE e fornece ao utilizador uma Pontuação de Qualidade e um Comentário de Qualidade sobre como melhorar os Requisitos, caso a pontuação seja baixa. Esta informação é registada em duas colunas específicas que podem ser ativadas nas tabelas de Requisitos, denominadas “Quality Assessment Comment“ e “Quality Assessment Score“. A informação sobre a Qualidade global dos Requisitos também será destacada nos Insights Dashboards no Módulo de Requisitos.

A Avaliação da Qualidade pode ser acedida a partir de três localizações diferentes. Dependendo da localização a partir da qual é acedida, o contexto do objeto enviado para avaliação irá variar.

Acesso através do botão ValiAssitant

Enquanto estiver numa Especificação específica ou em “All requirements”, o utilizador pode selecionar “Quality Assessment” acedendo ao ValiAssitant no canto superior direito, conforme mostrado na Figura General Quality Assessment.

Avaliação Geral da Qualidade - Acesso através do ValiAssistant

Ao aceder à Avaliação da Qualidade através do ValiAssistant, todos os Requisitos na Tabela de Requisitos atual serão analisados.

Acesso através da Coluna de Ação

A Avaliação da Qualidade pode ser acionada diretamente a partir das colunas de Ação em Requisitos individuais ou num conjunto de Requisitos selecionados em massa, conforme mostrado na Figura Individual Quality Assessment.

Avaliação Individual da Qualidade - Ao aceder à Avaliação da Qualidade através da coluna de ação, apenas os Requisitos individuais ou selecionados em massa serão considerados.

Ao aceder à Avaliação da Qualidade através da coluna de ação, serão analisados os Requisitos individuais ou o conjunto de Requisitos selecionados na Tabela de Requisitos atual.

Acesso através dos Insights

A Avaliação da Qualidade também pode ser acionada através dos Insights Dashboards ao nível da Especificação, conforme mostrado na Figura Quality Assessment Insights.

Insights da Avaliação da Qualidade - Aceder à avaliação da qualidade na secção de insights da especificação ou de “All Requirements”.

Ao aceder à Avaliação da Qualidade através dos Insights, todos os Requisitos da Especificação atualmente selecionada serão analisados.

Fluxo da Avaliação da Qualidade

Depois de acionar a Avaliação da Qualidade, o Requirements & Systems Portal indicará quantos Requisitos serão analisados.

Em seguida, o Requirements & Systems Portal informá-lo-á de que a avaliação da qualidade foi concluída com sucesso.

No final, “Quality Assessment Comment” e “Quality Assessment Score” fornecerão informações adicionais sobre a qualidade do texto do seu requisito, conforme mostrado na Fig. Additional Quality Information.
 

Informação Adicional de Qualidade - A informação é apresentada nas duas colunas aqui destacadas.

Critérios de Pontuação

• Score: 0-20 / 1 (Nível 1 - Inadequado)

  • Critérios: O texto do requisito viola várias normas do INCOSE. Carece de estrutura, utiliza voz passiva, contém termos vagos e apresenta gramática e pontuação deficientes. Não existe uma entidade responsável claramente identificada ou o requisito é ambíguo ou não acionável.

• Score: 21-40 / 2 (Nível 2 - Necessita de Melhoria)

  • Critérios: O requisito segue algumas normas, mas apresenta problemas significativos. Pode estar algo estruturado, mas continua a utilizar voz passiva, contém cláusulas de escape ou não inclui objetivos específicos e mensuráveis.

• Score: 41-60 / 3 (Nível 3 - Satisfatório)

  • Critérios: O requisito segue geralmente as normas, mas apresenta alguns problemas menores. Pode estar maioritariamente estruturado, mas inclui pequenos erros gramaticais ou não especifica unidades de medida.

• Score: 61-80 / 4 (Nível 4 - Bom)

  • Critérios: O requisito cumpre a maioria das normas. Está bem estruturado, utiliza voz ativa e objetivos específicos e mensuráveis, mas pode ter um ou dois problemas menores.

• Score: 81-100 / 5 (Nível 5 - Excelente)

  • Critérios: O requisito cumpre integralmente as normas. Está claramente estruturado, utiliza voz ativa, tem objetivos específicos e mensuráveis, não apresenta erros gramaticais e é inequívoco e acionável.

Após uma Avaliação da Qualidade, a pontuação global da qualidade será comunicada ao Insight Dashboard e representada com base na pontuação como “Low“ (pontuação inferior a 50), “Medium“ (pontuação entre 50 e 70) e “High“ (pontuação superior a 70), conforme mostrado na Figura Insights Quality Score.

Pontuação de Qualidade dos Insights - Painel de pontuação da Qualidade global para os Requisitos analisados.

Regras do INCOSE consideradas na Avaliação

R1 - Utilizar uma frase estruturada e completa: sujeito, verbo, objeto. 
R2 - Utilizar a voz ativa na estrutura principal da frase da necessidade ou da declaração do requisito, com a entidade responsável claramente identificada como sujeito da frase. 
R3 - Garantir que o sujeito e o verbo da declaração da necessidade ou do requisito são adequados à entidade a que a necessidade ou o requisito se refere. 
R5 - Utilizar o artigo definido “the” em vez do artigo indefinido “a”.
R6 - Utilizar unidades adequadas ao indicar quantidades. Todos os números devem ter unidades de medida explicitamente indicadas.
R7 - Evitar a utilização de termos vagos como “some”, “any”, “allowable”, “several”, “many”, “a lot of”, “a few”, “almost always”, “very nearly”, “nearly”, “about”, “close to”, “almost” e “approximate”. 
R8 - Evitar cláusulas de escape como “so far as is possible”, “as little as possible”, “where possible”, “as much as possible”, “if it should prove necessary”, “if necessary”, “to the extent necessary”, “as appropriate”, “as required”, “to the extent practical” e “if practicable”. 
R9- Evitar cláusulas abertas como “including but not limited to”, “etc.” e “and so on”. 
R10 - Evitar infinitivos supérfluos como “be designed to”, “be able to”, “be capable of”.  
R12, 13, 14 - Utilizar gramática, ortografia e pontuação corretas.
R15 - Utilizar uma convenção definida para expressar expressões lógicas como “[X AND Y]”, “[X OR Y]”, [X XOR Y]”, “NOT[X OR Y]”.
R16 - Evitar a utilização de “not” 
R17 - Evitar a utilização do símbolo oblíquo ("/"), exceto em unidades, por exemplo km/hr
R18 - Escrever uma única frase que contenha uma única ideia, condicionada e qualificada por subcláusulas relevantes.
R19 - Evitar combinadores que unem cláusulas, como “and”, “or”, ”then”, ”unless”, ”but”, ”as well as”, ”but also”, ”however”, ”whether”, ”meanwhile”, ”whereas”, ”on the other hand” ou ”otherwise”. 
R20 - Evitar expressões que indiquem a finalidade da necessidade ou do requisito. 
R21 - Evitar parênteses e colchetes que contenham texto subordinado.
R22 - Enumerar explicitamente conjuntos em vez de utilizar um nome coletivo para designar o conjunto. 
R24 - Evitar a utilização de pronomes e pronomes indefinidos.
R26 - Evitar a utilização de absolutos inatingíveis como 100'%' reliability, 100'%' availability, all, every, always, never, etc.
R28 - Expressar explicitamente a natureza proposicional de uma condição para uma única ação, em vez de apresentar listas de ações para uma condição específica.
R29 - Classificar as necessidades e os requisitos de acordo com os aspetos do problema ou do sistema que abordam. 
R31 - Ao definir entradas de conceção, evitar indicar uma solução, a menos que exista uma justificação para restringir a conceção. Concentrar-se no problema “what” em vez da solução “how”. 
R32 - Utilizar “each” em vez de “all”, “any" ou “both” quando se pretende quantificação universal. 
R33 - Definir quantidades com um intervalo de valores adequado à entidade a que se aplicam e em relação ao qual a entidade será verificada ou validada.
R34 - Fornecer objetivos de desempenho específicos e mensuráveis adequados à entidade para a qual a necessidade ou o requisito é declarado e em relação aos quais a entidade será verificada quanto ao cumprimento.
R35 - Definir explicitamente dependências temporais em vez de utilizar palavras-chave temporais indefinidas como “eventually”, “until”, “before”, “after”, “as”, “once”, “earliest”, “latest”, “instantaneous”, “simultaneous”, “at last”.
R38 - Evitar a utilização de abreviaturas.