Avaliação da Qualidade
A funcionalidade de Avaliação da Qualidade do ValiAssistant analisa os textos dos Requisitos selecionados com base num conjunto de regras 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 é escrita em duas colunas específicas que podem ser ativadas nas tabelas de Requisitos, denominadas Quality Assessment Comment e Quality Assessment Score. As informações sobre a Qualidade global dos Requisitos também serão destacadas nos Insights Dashboards no Módulo de Requisitos.
É possível aceder à funcionalidade de Avaliação da Qualidade a partir do Módulo de Requisitos da seguinte forma:
-
Clicando no botão
no canto superior direito, selecionando a opção Quality Assessment na lista pendente da janela Choose Action que é aberta, e clicando no botão
.
-
Clicando no ícone de três pontos na coluna Identifier de um requisito e selecionando o comando ValiAssistant » Quality Assessment nos menus principais.
Dependendo da localização a partir da qual se acede, o contexto do objeto enviado para avaliação irá variar.
Para mais informações sobre como aceder ao ValiAssistant, consulte a página ValiAssistant.
A Avaliação da Qualidade também pode ser iniciada a partir dos Insights Dashboards ao nível da Especificação, clicando no ícone
no canto superior direito da região Quality Assessment Ao aceder à funcionalidade desta forma, todos os Requisitos da Especificação atualmente selecionada serão analisados.
Depois de aceder ao processo de Avaliação da Qualidade, será informado sobre quantos Requisitos serão analisados.
Clique em
para continuar. Assim que o processo terminar, a janela seguinte irá informá-lo de que a avaliação da qualidade foi concluída com sucesso.
As colunas Quality Assessment Score e Quality Assessment Comment na tabela da especificação irão fornecer informações adicionais sobre a qualidade do texto do seu requisito.
Os resultados também serão apresentados no gráfico Quality Assessment no Insight Dashboard.
Scoring Criteria
-
Score: 0-20 / 1 (Nível 1 - Inadequado)
-
Critérios: O texto do requisito viola várias normas INCOSE. Não tem 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 texto é 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.
-
INCOSE Rules was taken into Consideration for Assessment
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 de barra oblíqua ("/"), exceto em unidades, ou seja, 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 conjuntos explicitamente 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 à qual a necessidade ou o requisito é declarado e em relação aos quais a entidade será verificada para confirmar o 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.
).