FATTO Consultoria e Sistemas

Estimativas e Requisitos de Software

Medicao,

Analise desperdicar o
de Documento: como nao
tempo alheio
Carlos Eduardo Vazquez1 , Guilherme Siqueira Simoes
2

Resumo
O tempo das partes interessadas disponvel para eventos de levantamento e um dos principais e mais escassos recursos

para a engenharia de requisitos. Quanto mais alto o nvel na hierarquia corportativa, esse fenomeno se manifesta de

forma mais aguda. A analise de documento e uma tecnica
que permite um melhor uso desse tempo pela analise de
preliminares que provocaram a iniciacao
material existente. Material que pode tomar a forma das intencoes do projeto;
que descreve o funcionamento de procedimentos operacionais, tarefas ou regras de negocio que se aplicam no domnio

do problema. Este texto apresenta a tecnica
de analise de documento como um meio para descobrir as perguntas
apenas como uma fonte de respostas; suas aplicacoes
relevantes e nao conforme os diferentes momentos no ciclo de
vida, vantagens e desvantagens.
Keywords

analise de requisitos; gestao
de documento; elicitacao de requisitos; domnio do problema
1 FATTO Consultoria e Sistemas, carlos.vazquez@fattocs.com
2 FATTO Consultoria e Sistemas, guilherme.simoes@fattocs.com

Conteudo
engajados na engenharia de requisitos. A alegacao para
isso e a falta de respostas oferecidas pelos documentos

Introducao 1 (mal) analisados.
1 O que e a Analise
de Documentos 2 Sera que, ao menos em um primeiro momento, o mais impor-
2
Como realizar a Analise de Documentos 2 as respostas? Na obra de Douglas Adams, o Guia
tante sao
2.1 .......................... 2
Preparacao
do Mochileiro das Galaxias, solicita-se a um computador
chamado Pensador Profundo e designado para responder
2.2 ........................... 2
Execucao
qualquer pergunta, a resposta para a pergunta fundamental
2.3 .......................... 3
Finalizacao
da vida, do universo e tudo o mais. Depois de sete milhoes
3 Vantagens 3 de anos ele responde: Quarenta e dois. Qual o valor dessa
resposta sem saber qual a pergunta? Nao e por acaso que
4 Desvantagens 3

um novo projeto teve de ser comissionado naquela historia.
5
Referencias
Bibliograficas 3
De forma similar, perde-se uma oportunidade importante
para o analista adquirir conteudo
sobre o contexto abordado
acumular questoes
e tambem e duvidas
a serem abordadas

Introducao ` partes interessadas.
junto as

A dificuldade em conseguir acesso as ` partes interessadas- Outro problema identificado nesses eventos e a necessi-
chave e um dos problemas mais relatados pelos partici- dade por descobrir os requisitos implcitos de uma maneira
pantes dos treinamentos sobre Engenharia de Requisitos proativa. O analista de requisitos deve provocar a desco-
sobre essa dificul- apenas seguir a logica
berta de requisitos e nao do fast-
ministrados pelos autores. A reflexao
dade levou a` identificacao
de fatores que vao
alem
da falta food de perguntar o que mais?. Tanto para melhor com-
da abrangencia
preensao quanto para o seu
da solucao
disponibilidade de agenda dessas partes interessadas.
detalhamento. Dificilmente esgota-se o levantamento de
Durante esses treinamentos, sao usados casos reais de pro- apenas a partir de de entrevistas, aplicacao
informacoes de
jetos para diversos exerccios. Em um primeiro momento e
questionarios do trabalho em campo.
ou a observacao
sem a apresentacao dos objetivos de informacao
buscados
na engenharia de requisitos, percebe-se pouco interesse Dificilmente, porque difcil e estar inserido em um cenario
de

de alguns participantes na analise destes
da documentacao da engenharia de requisitos onde haja inovacao
aplicacao
casos onde se materializam as necessidades do negocio. total. Sempre ha algo ja documentado que deveria ser ana-
Para estes participantes, ela e uma atividade percebida
lisado primeiro para depois partir-se para outras tecnicas
E
de elicitacao. raro que nao haja qualquer necessidade
como tediosa e que entrega pouco resultado.

de negocio; haja nada relevante presente em do-
que nao
nao
Essa percepcao se restringe ao campo de uma sala de cumentos que possam enriquecer o processo de revelacao
de varios
aula, estando presente na atuacao profissionais dos requisitos, de aumentar o nvel de informacao sobre o

Analise desperdicar o tempo alheio 2/3
de Documento: como nao
a serem
domnio do problema e sobre as possveis solucoes Ele a descreve como um meio para elicitar requisitos pela
adotadas.
analise existente e identificar informacao
de documentacao
relevante para os requisitos. Estabelece que ha uma faixa
Claro que nao se espera que o analista de requisitos ne- ampla de documentos que podem ser analisados, incluindo,
cessariamente torne-se um analista funcional com conhe- mas nao se limitando a: planos de negocio, literatura
cimento especializado em um determinado domnio de de marketing, acordos, pedidos de proposta (RFP), flu-

negocio
ou processo de negocio; mas entre esse extremo xos de processos atuais, modelos da dados logicos, re-
e outro externo em que nao se usa a documentacao dis-
positorios
de regras de negocio, documentacao de software
ponvel para apoiar no processo de descoberta de requisitos, processos de negocio,
de aplicacao,
relatorios, manuais,
ha uma enorme lacuna. memorandos, documentacao de interface, casos de uso,
trata sobre o que e a analise
Esta secao de documentos, de requisitos, registros de problemas
outras especificacoes
como ela deve ser utilizada para eliminar essa lacuna em em aberto (issues), polticas, procedimentos e
ou questoes
diferentes momentos no processo de desenvolvimento dos
normas como leis, codigos ou ordens, etc.
requisitos.

2. Como realizar a Analise de
1. O que e a Analise
de Documentos Documentos

2.1 Preparacao

A analise de documentos e um meio de elicitar requisitos
pelo estudo de documentacao disponvel sobre uma solucao
Inicialmente deve-se determinar as necessidades de
de informacao
existente para identificacao relevante para o que deverao
informacao ser respondidas por esta tecnica.

desenvolvimento de uma nova solucao [IIBA, 2009]. Ela e Esses objetivos dependem do momento em que se esta no
usada se o objetivo e coletar caractersticas que necessi- ciclo de vida do projeto. Por exemplo:
tam ser includas em uma nova solucao ou que necessitam
ser atualizadas em uma solucao existente ou detalhes de Momentos preliminares quando o principal interesse
existentes, incluindo a sua interacao
solucoes com seu am- e entender melhor o domnio do problema e tornar as

biente, as regras de negocio que se aplicam, conceitos de
necessidades de negocio mais especficas: Os objeti-

negocio sobre os quais se necessita manter ou recuperar relacionados a` identificar e entender fluxos
vos estao
dados. operacionais e a organizacao da empresa; transfor-

mar necessidades ainda vagas e genericas em objeti-
Ela tambem onde um especialista
se aplica em situacoes vos organizacionais a serem atingidos de forma que
no assunto para a solucao nao esta mais presente na o seu sucesso possa ser validado.
ou nao
organizacao, estara disponvel ao longo do desen-
Explorar o alcance da solucao
e dos componentes de
volvimento dos requisitos, o que inviabiliza por exemplo

software que a compoem: relacio-
Os objetivos estao
por entrevistas.
elicitacao
nados a` quais tarefas ou, se nao
houver informacao


O termo documentacaoneste caso deve ter um significado suficiente para isso, quais macroprocessos devem
dos requisitos da solucao,
mais amplo que as especificacoes ser explorados em maior profundidade.
e incluir documentos sobre o domnio do problema que Detalhar o escopo buscando maior aprofundamento
permitam alcancar os objetivos de informacao presentes rela-
de uma tarefa em particular: Os objetivos estao

em momentos iniciais do ciclo de vida e com importancia cionados a` descoberta de quais regras de negocio
se
estruturante para todo o ciclo de vida. Esses objetivos de aplicam, quais os dados que devem ser informados
sao
informacao dois:
pelo usuario, devem ser apresen-
quais informacoes
tadas pelo software, quais dados devem ser armaze-
Identificar as necessidades de negocio
(oportunida- nados e quais dados devem se recuperados.
des a aproveitar, problemas a resolver, objetivos a

alcancar e metricas de sucesso); e A partir da determinacao destas necessidades de
deve-se elaborar questoes
informacao, que buscam aten-
Identificar, inicialmente, as partes interessadas chave
der estas necessidades, avaliar quais os documentos mais
e, em seguida, as demais (chave ou nao).

adequados para a analise
e como torna-los disponvel.
[Sommerville, 2006] cita como instrumento para ajudar com Vale lembrar que nem sempre todos os documentos a se a
com partes interessa-
a descoberta de requisitos a interacao identificados no incio do projeto. A` medida
analisar ja estao

das por meio de entrevistas e observacoes; podendo incluir flui, outros documentos podem
que o trabalho de elicitacao

cenarios
e prototipos. [Pressman, 2014], nesse particular,
ser identificados para serem objeto desta analise.
entra em mais detalhes apenas citando Sommerville. O
nao
motivo talvez seja o significado de requisito nessas impor-

2.2 Execucao
tantes obras estar limitado a` especificacao
da solucao
ea
utilizacao
nao de uma estrutura de requisitos mais abran-
A analise de documentos consiste entao em estudar a
gente, onde se apresentam os requisitos de negocio e das selecionada com o objetivo de responder
documentacao
partes interessadas. ` questoes
as formuladas inicialmente. Durante este pro-
cesso, novas duvidas

(questoes)
podem surgir e talvez nao

O corpo de conhecimento da gerencia de projeto do PMI

sejam respondidas no proprio processo.

(PMBoK) descreve a analise de documentos como uma das

ferramentas da Gerencia de Escopo do Projeto, mais especi- devem ser incorporadas ao con-
Neste caso, estas questoes
ficamente ao descrever o processo de Coleta de Requisitos. para que sejam tratadas posteriormente e
trole de questoes

c FATTO Consultoria e Sistemas - www.fattocs.com
Copia licenciada para: WALLACE-RODRIGUES-FERREIRA
Proibida a reproduca o total ou parcial sem a permissao dos autores por escrito.

Analise desperdicar o tempo alheio 3/3
de Documento: como nao

eventualmente respondidas por outras tecnicas
de elicitacao.
considerar se o documento em analise se limita a` pers-
nao
E possvel tambem
que nao
se encontre respostas a todas pectiva do estado das coisas atual (as-is).
formuladas inicialmente. Elas tambem
questoes deverao ser comum em muitas empresas que os nveis de ma-
E
para resolucao
mantidas no controle de questoes posterior.
turidade da gestao de conhecimento sejam baixos e a
documentacao existente fique desatualizada ou mesmo

2.3 Finalizacao nao
reflita informacoes
validas.
Neste caso a analise
desta documentacao torna-se pouco util
ou pode introduzir
As respostas as` questoes
iniciais devem ser documentadas erroneas
informacoes nos requisitos.
em uma memoria de levantamento, que deve ser subme-
` partes interessadas especialistas no assunto e com
tida as Deve-se avaliar tambem o custo benefcio associado a`
a autoridade para confirmar a sua validade. Obrigatoria-
analise muito extensa para necessidades
de documentacao
mente esta memoria de levantamento deve citar em suas pontuais. Pode ser demorado demais ou te-
de informacao

referencias os documentos analisados. Caso as questoes
dioso. Neste caso outra tecnica pode cumprir
de elicitacao

iniciais estejam registradas no controle de questoes, cabe o objetivo de maneira mais eficiente.
associar os itens respondidos a` memoria
de levantamento
para manter a rastreabilidade.

5. Referencias
Bibliograficas
Em um projeto o volume de documentos analisados pode
ser grande. Por exemplo, todo documento que foi utilizado
[Adams, 2004] Adams, Douglas. (1979). O Guia do Mochi-
para fundamentar respostas as ` questoes formuladas ini-

leiro das Galaxias. Ed. Sextante, 2004
3a. Edicao.

cialmente deveria ser guardado no repositorio do projeto,
pois provavelmente outras consultas ao documento serao [IIBA, 2009] IIBA - International Institute of Business Analy-

necessarias. Logo, deve-se organizar os documentos co- sis (2005). A Guide to the Business Analysis Body of
letadas de forma que possam mais facilmente ser recupe- Knowledge R (BABOK R Guide). Versao 2.0.
rados como, por exemplo, na figura 1. Nela, o tipo indica
[Sommerville, 2006] Sommerville, Ian (1982). Software
para o documento usado na analise
a classificacao como,
Pearson Education, 2006.
Engineering. 8a Edicao.

por exemplo, um termo de referencia, um manual de pro-
cedimentos, um organograma. A localizacao indica onde [Pressman, 2014] Pressman, Roger S. e Maxim, Bruce
o documento pode ser recuperado (preferencialmente em (2000). Software Engineering: A Practitioners Approach, 8a
meio digital como parte da biblioteca do projeto). O nome McGraw-Hill, 2014.
Edicao.
permite qualificar especificamente a que se refere aquele
documento e a memoria de levantamento o documento com [PMI, 2013] PMI - Project Management Institute (2013).
especficos daquela analise
os objetivos de informacao e as A Guide to the Project Management Body of Knowledge
respostas encontradas com o seu estado atual indicando se (PMBOK R Guide). 5a. Edic
ao.
ja foram confirmadas ou nao.

Figura 1. Quadro de resumo da analise de documentos.

3. Vantagens

A principal vantagem da analise de documentos e que nao

se trata de um trabalho iniciado do zero, ja que ela aproveita
material existente para descobrir ou validar requisitos. Por
isto e geralmente uma das primeiras tecnicas
a
de elicitacao
complementa ou ajuda a planejar ou-
se aplicar. Ela tambem
com outras tecnicas
tras atividades de elicitacao (por exem-
plo, entrevistas). E mesmo quando uma area
de negocio
diz que nao existe nada documentado para se analisar, as
ferramentas de pesquisa da Internet ja facilitam bastante
um nivelamento preliminar do domnio do problema.

4. Desvantagens

Para processos novos e mais difcil ter documentacao

dis-
ponvel. Sem duvida
que pode haver documentacao sobre
uma visao de futuro; contudo, deve-se tomar cuidado ao

c FATTO Consultoria e Sistemas - www.fattocs.com
Copia licenciada para: WALLACE-RODRIGUES-FERREIRA
Proibida a reproduca o total ou parcial sem a permissao dos autores por escrito.