Escolar Documentos
Profissional Documentos
Cultura Documentos
Universidade de So Paulo
So Carlos
ESPECIFICAO DE REQUISITOS:
UMA INTRODUO
Maro de 1996
Este trabalho foi desenvolvido como parte das atividades do estgio supervisionado realizado no
Programa de Aperfeioamento de Ensino (PAE) no segundo semestre de 1995.
CONTEDO
1. INTRODUO.................................................................................................
2.3. Modelagem............................................................................................
10
10
12
14
5. CONCLUSES.................................................................................................
18
20
25
REFERNCIA BIBLIOGRFICA.....................................................................
26
1. Introduo
O processo de desenvolvimento de software compreende um conjunto de
atividades que engloba mtodos, ferramentas e procedimentos, com o objetivo de
produzir softwares que atendem aos requisitos especificados pelos usurios (clientes)
[May90; Pre94]. A satisfao dos requisitos especificados pelos usurios a prcondio bsica para o sucesso de um software. Um software que foi mal
especificado, certamente ir desapontar o usurio e causar problemas equipe de
desenvolvimento, que ter de modific-lo para se adequar s necessidades do usurio.
De acordo com Castro [Cas95], a especificao de requisitos serve como um padro
para testar se as fases de projeto e implementao do processo de desenvolvimento de
software esto corretas.
O objetivo principal deste trabalho mostrar como um documento de requisitos
(informal) deve ser organizado e redigido para que seja legvel, no ambguo e siga as
diretrizes propostas por padres internacionais (por exemplo, Norma ISO/IEC 9126)
quanto especificao de requisitos. Isso realizado apresentando-se uma verso de
um documento de requisitos que analisada e corrigida, dando origem a um
documento organizado dentro dos padres propostos.
Este trabalho apresenta na seo 2 uma viso geral da engenharia de requisitos,
dando nfase, principalmente, definio e ao processo de engenharia de requisitos.
Na seo 3 apresentado um exemplo de um documento de requisitos (especificao
informal) de um determinado problema. A partir de uma anlise crtica dessa
especificao, utilizando regras de estruturao de especificaes de requisitos,
apresentado na seo 4 um documento estruturado de requisitos do sistema.
Finalizando, a seo 5 contm as concluses deste trabalho.
verbos eliciar (fazer sair, extrair, trazer tona a verdade), clarear, extrair e descobrir.
Assim, uma definio sucinta de elicitao obter e tornar explcito o mximo de
informaes possveis para o conhecimento de um objeto em questo.
UdeI
ELICITAR
UdeI
Documento de Requisitos
do Sistema
ANALISAR
Decises da
Anlise
Mtodos,
Tcnicas e
Ferramentas
MODELAR
Modelo de
Anlise do
Sistema
Esse conjunto de atributos caracteriza o que o software faz para satisfazer as necessidades, enquanto
os outros conjuntos caracterizam principalmente quando e como ele faz.
7
A usabilidade deve levar em conta os vrios ambientes de usurios que o software pode afetar, que
podem abranger desde a preparao para uso at a avaliao de resultados. A usabilidade definida nesta
Norma diferente da definio do ponto de vista ergonmico, em que outras caractersticas como
eficincia e eficcia tambm so consideradas componentes da usabilidade.
8
informaes tais como: nome, local e data da publicao; autor; resumo; etc. Esse
arquivo pode ser atualizado, consultado e utilizado de diversas maneiras. Um tipo de
utilizao que o sistema deve permitir a de produzir, de forma automatizada, um
arquivo de referncias bibliogrficas relativo a um documento especfico em
elaborao. Ou seja, tendo como base o texto do documento, identificar todas as
referncias que ocorrem no texto, extrair da base bibliogrfica e armazenar, em forma
padro, em arquivo, que ser posteriormente parte integrante do documento em
elaborao. A seguir relata-se como essas atualizaes, consultas e utilizaes devem
ser efetuadas.
11
12
13
bibliografias
no
est
classificado
corretamente
dentro
da
seo
14
15
B. Requisitos Funcionais
B.1. Preparao e Manuteno dos Itens Bibliogrficos
1. O sistema deve permitir a insero, alterao e excluso de itens bibliogrficos,
mantendo uma bibliografia.
2. O sistema deve solicitar ao pesquisador os itens de informao necessrios para
inserir um item bibliogrfico na bibliografia. Os itens de informao so: ttulo,
autor(es), data(ms/ano), local, resumo da publicao, assunto, numerao fsica,
editora, peridico (volume, nmero, pginas), congresso e forma de citao.
3. O sistema deve fornecer mensagens de erro quando itens bibliogrficos
incompletos forem inseridos. Tais mensagens interrogam o pesquisador se deseja
cancelar a operao de insero, completar as informaes incompletas ou
concluir a insero assim mesmo.
4. O sistema deve, no caso de ocorrer a tentativa de insero de um item
bibliogrfico j existente, comunicar ao pesquisador a existncia deste item
bibliogrfico na bibliografia. Se, neste caso, o pesquisador confirmar a operao
de insero, o sistema deve informar que tal operao ir alterar o item
bibliogrfico existente.
5. O sistema deve gerar automaticamente a forma de citao (cdigo de citao)
seguindo o padro ABNT (Associao Brasileira de Normas Tcnicas) quando o
pesquisador inserir um item bibliogrfico na bibliografia.
6. O sistema deve fornecer facilidades para a criao e manuteno de uma lista de
sinnimos, para os seguintes itens de informao do item bibliogrfico: autor,
editora, peridico e congresso.
7. O sistema deve permitir a alterao dos itens de informao de um item
bibliogrfico da bibliografia, com exceo do cdigo de citao que gerado
automaticamente pelo sistema. O pesquisador pode acessar/recuperar um item
bibliogrfico pelos itens de informao: autor, ttulo e pelos sinnimos de autor e
ttulo, respectivamente.
8. O sistema deve permitir a excluso de um item bibliogrfico se este item existe na
bibliografia. O pesquisador pode acessar/recuperar um item bibliogrfico a ser
excludo pelos itens de informao: autor, ttulo e pelos sinnimos de autor e
ttulo, respectivamente.
9. O sistema deve permitir a insero de itens bibliogrficos importados de
bibliografias de outros pesquisadores, atravs dos itens de informao autor e
ttulo e tambm pelos sinnimos de autor e ttulo, respectivamente. O operao de
insero pode exigir ou no confirmao. A importao de itens pode ser total
16
17
18
5. Concluses
Este trabalho apresentou uma viso geral da engenharia de requisitos,
enfatizando, principalmente, sua definio e o processo de engenharia de requisitos.
De uma maneira geral, a engenharia de requisitos estabelece um processo de definio
dos requisitos com o objetivo de obter uma especificao correta e completa dos
requisitos. O produto deste processo um modelo que servir para produzir um
documento de requisitos. Este documento serve como um meio de comunicao entre
o projetista do software e o usurio a fim de estabelecer um acordo do software
pretendido.
Assim, o objetivo principal deste trabalho foi mostrar como um documento de
requisitos deve ser organizado e redigido para que seja legvel, no ambguo e siga as
diretrizes propostas por padres internacionais (por exemplo, Norma ISO/IEC 9126)
quanto especificao de requisitos. Para alcanar tal objetivo, inicialmente foi
apresentada uma verso de um documento de requisitos do Sistema de Apoio
Escrita (SAPES). Este documento foi analisado e corrigido, dando origem a um novo
documento organizado dentro dos padres propostos.
19
APNDICE I
Vocabulrio Relativo ao SAPES
Este Apndice contm termos relevantes do documento de requisitos do sistema
que formam o lxico do domnio da aplicao.
Termo
Definio
Sinnimo
Arquivo de Bibliografia
Bibliografia
Ver Tambm
Artigo
Documento
Artigo
Arquivo Texto,
Documento
com
a
referncia
bibliogrfica j pronta e
concatenada no final. um
texto j publicado pelo
pesquisador
ou
qualquer outro autor.
Bibliografia
por
Biblioteca
o conjunto de publicaes
de
um
pesquisador,
mantidos particularmente.
Citao
Referncia,
Referncia
Bibliogrfica
20
Cdigo de Citao
Documento
de
Artigo,
Arquivo Texto
Forma de Citao
pela Cdigo
ABNT, formada juntando-se Citao
as trs primeiras letras do
sobrenome do primeiro
autor, seguido do ano de
Forma
normalizada
de Citao
publicao
do
item
bibliogrfico. No caso de
duas ou mais publicaes do
mesmo autor no mesmo ano,
distinguem-se estas publicaes juntando com o ano da
21
Forma de Citao
de Citao
diante. Por
[TUR95a],
Identificao
do
Bibliogrfico
Item Bibliogrfico
Citao
Forma
de
Citao
Item
de
Informao
publicao.
22
Item de Informao
Cada
informao
armazenada em um item
As
bibliogrfico.
informaes mais comuns
so: ttulo, autor (es), data
(ms/ano),
local
da
publicao. Outras informaes adicionais podem ser:
resumo (pequena descrio
da
publicao),
assunto,
numerao fsica, editora,
congresso,
peridico
(volume, nmero, pginas) e
forma de citao da
publicao.
Numerao Fsica
Forma
de
estabelecida
classificao
pelo
Publicao
Qualquer
divulgao
meio
de
envolvendo
Um subconjunto de um item
bibliogrfico, pertencendo a
Referncia
Bibliogrfica
referncia
bibliogrfica
gerada para um determinado
documento.
23
Referncia Bibliogrfica
Sinnimo
Representao abreviada do
valor de qualquer item de
informao. Por exemplo,
ao invs de registrar o nome
completo de um autor,
digamos Jos Carlos Bento
de Saraiva, o pesquisador
registra apenas JCBS.
Trabalho
Artigo
Usurio
Pesquisador
24
APNDICE II
Diagrama do Domnio
Este Apndice contm o Diagrama do Domnio da aplicao que inter-relaciona
todos os termos apresentados no Apndice I.
Numerao Fsica
arquivado segundo
Publicao
possui
Pesquisador
composta por
uma
Artigo
Biblioteca
Bibliografia
descrita por
composta por
Item Bibliogrfico d origem a
Ficha Tcnica
representado por
Itens de Informao
redige
Documento
contm
contm
Citao se refere a
Referncia Bibliogrfica
composta por
Referncia
d origem a
segue
Forma de Citao
25
Referncia Bibliogrfica
[Aur86] Aurlio Buarque de Holanda Ferreira. Novo Dicionrio Aurlio da Lngua
Portuguesa. Segunda Edio - revista e ampliada). Editora Nova Fronteira, 1986.
[Boe89] Boehm, B.W. Software risk management. IEEE Computer Society Press:
Washington, 1989.
[Boo91] Booch, G. Object-Oriented Design with Applications. Benjamin Cummings,
CA, 1991.
[Cas95] Castro, J. F. B. Introduo engenharia de requisitos. In: XV Congresso da
Sociedade Brasileira de Computao, JAI'95, Canela, RS, Brasil, 1995, 43p.
[Col94] Coleman, D. et al. Object-Oriented Development: The Fusion Method.
Prentice Hall, 1994.
[Fio95] Fiorini, S.T.; Leite, J.C.S.P. & Soares, T.D.M. Integrando processos de
negcio elicitao de requisitos. In: IX Simpsio Brasileiro de Engenharia de
Software, SBES'95, Recife, 03-06 de outubro de 1995. p.379-394.
[IEE84] IEEE Std. 830. IEEE Guide to Software Requirement Specification. The
Institute of Electrical and Electronics Engineers. New York, 1984.
[IEE90] IEEE Std. 610.12 IEEE Standard Glossary of Software Engineering
Terminology. The Institute of Electrical and Electronics Engineers. New York,
1990.
[IEE91] IEEE Software: Measurement Based Process Improvement. july 1991,
v.11(4).
[ISO9126] ISO/IEC 9126. Information Technology - Software Product Evaluation Quality characterisitcs and guidelines for their use. 1991.
[Lei90] Leite, J.C.S.P. Validao de requisitos: o uso de pontos de vista. In: Revista
Brasileira de Computao, v.6, n.2, p.39-52, RBC, outubro/dezembro 1990.
[Lei94] Leite, J.C.S.P. Engenharia de Requisitos. In: Notas de Aula, PUC-RJ, 1994
[May90] Mayrhauser, A.V. Software Engineering: Methods and Management.
Academic Press, 1990, 864p.
[Pre94] Pressman, R.S. Software engineering: a practitioner's approach. Euopean
Edition, 1994, 801p.
26