Guia de Uso – EP – Relatório de Processos de E&P

Nome do relatório: EP – Relatório dos processos de E&P

1. Objetivo
Gerar um relatório detalhado de um processo ou um relatório da Cadeia de Valor de E&P.

2. Descrição
A partir desde script é possível gerar dois tipos de relatórios:

2.1. Relatório de processos

Gera um relatório reunindo informações da modelagem de um processo em um formato
pré-definido.
É necessária a aplicação do Template (“Template do Relatório de Processos.dot”), para
conclusão do relatório. Esta aplicação acrescenta configurações de formato que foge à
capacidade do script, como numeração de seções, estilos de figuras entre outros.
O script contempla a possibilidade de seções opcionais permitindo a escolha das seções
que devem aparecer no relatório, algumas seções são obrigatórias e não aparecem como
opções na tela respectiva.

2.2. Relatório da Cadeia de Valor de E&P

Gera um relatório a partir de um modelo VAC da Cadeia de Valor de E&P. É possível
selecionar as gerências para visualizar os processos relacionados imediatamente ao processo
folha.

3. Referências
 Diretrizes para modelagem de processos do E&P;
 Documento esquema do relatório de processos.

4. Motivação
 Necessidade de automatizar a criação do relatório geral de processos a fim de
minimizar o esforço necessário para sua elaboração e a incidência de erros.
 Necessidade de gerar um relatório da Cadeia de Valor de E&P.

5. Manual de Uso

5.1. Execução

O script deve ser executado a partir de diagramas do tipo VAC ou EPC.

5.1.1. Premissas:
O script de geração automática do Relatório de Processos assume que:
 A geração do relatório é realizada a partir de um único diagrama do tipo
VAC ou EPC. Caso mais de um diagrama seja escolhido ao executar o script,
somente o primeiro será considerado;
  A geração possui restrições na formatação de documentos, por isso, é
preciso ainda aplicar o template (.dot) que contém os estilos de formatação
usados no relatório;
 Tanto os diagramas de processos quanto a estrutura de diretórios e os
objetos sobre os quais o script é executado devem estar de acordo com os
documentos “Regras para Modelagem de Processos de E&P” e “Estrutura de e
Diretórios no ARIS para o E&P”, divulgados no wiki da GIDSEP;
 Os objetos e modelos devem estar armazenados nos devidos diretórios
segundo o documento de diretrizes de governança do ARIS;
 A disposição dos elementos na modelagem deve ficar o mais próximo
possível do canto superior esquerdo do diagrama, para que as imagens
sejam geradas sem espaços em branco à esquerda ou acima do modelo.

5.2. Escolha do relatório

Ao executar o relatório é possível selecionar o tipo de relatório que se deseja gerar.

 5.2.1. Telas de opções do Relatório de Processos

Caso tenha sido selecionado a opção “Relatório de processos” é exibida uma tela
para seleção das seções que se deseja gerar no relatório.

Figura 1 – Tela para configuração das seções que serão apresentadas no

relatório

Como padrão, quase todos os itens vêm selecionados com exceção de “Gerar descrição
automática de Atividades”.

 Funcionalidades
“Listar descrições de atividades sem detalhamento” – refere-se à listagem das
atividades que não possuem um diagrama de detalhamento, mas têm as descrições
preenchidas. Ao marcar esta opção, o nome e a descrição destas atividades
aparecerão no relatório;
 “Redefinir figuras de diagrama de detalhamento de atividade para zoom
65%” – refere-se à redução das imagens de todos os diagramas de detalhamento
de atividade do relatório para 65% do tamanho original. Diagramas de detalhamento
muito grandes podem gerar duas imagens (o diagrama aparece cortado e dividido
em mais de uma figura) para esta opção marcada. Neste caso deve-se gerar novo
relatório com a opção desmarcada ou usar o recurso Copiar e Colar da figura direto
da ferramenta ARIS para o relatório gerado. A redução somente é aplicada a todas
as imagens dos diagramas de detalhamento de atividade.

“Gerar descrição automática de Atividades” – refere-se à geração da descrição

das atividades de forma automática. Para que esta opção funcione, as atividades
devem ter diagrama de detalhamento. O script utiliza os objetos encontrados no
diagrama de detalhamento da atividade como fonte para a construção da descrição.
 Observação: Para o melhor aproveitamento da funcionalidade Descrição
automática deve-se criar o diagrama com os devidos objetos e somente
incluir o primeiro parágrafo do atributo Descrição.

 Diagramas Gerais
Todas as opções referem-se à exibição ou não dos diagramas dos tipos listados, cada
um em uma seção específica no relatório.

 Elementos de Apoio
É possível escolher se será exibida uma seção para cada tipo de objeto. No caso dos
objetos dos tipos Cluster, Indicador e Ponto Crítico, é possível o tipo de detalhamento a ser
exibido no relatório, como Tabela Única ou Tabela Detalhada.

 Tabela de Executores
É possível selecionar qual tipo de executor será exibido na Tabela de Executores do
relatório. Dentre as opções possível estão os tipos de objeto: Conjunto de Unidades
Organizacionais, Equipe, Posição Unidade Organizacional e Terceiro.

 Específico da seção de Clusters

É possível escolher se os clusters serão listados em uma tabela única mostrando
somente os nomes e descrições destes elementos ou se serão listados em tabelas
detalhadas, com uma tabela para cada item existente nos diagramas ou se não serão
exibidos. As tabelas detalhadas podem ainda ser configuradas para exibir ou não o diagrama
conceitual de dados correspondente àquele objeto.

 Específico da seção de Ponto Crítico

É possível escolher se os pontos críticos serão listados em uma tabela única mostrando
somente os nomes e descrições destes elementos ou se serão listados em tabelas
detalhadas, com uma tabela para cada item existente nos diagramas ou se não serão
exibidos.

 Específico da seção de Indicadores

É possível escolher se os indicadores serão listados em uma tabela única mostrando somente
os nomes e descrições destes elementos ou se serão listados em tabelas detalhadas, com
uma tabela para cada item existente nos diagramas ou se não serão exibidos.

Clicar em OK para prosseguir.

Escolha de Processos

1) Caso seja executado em Processos em desenvolvimento:

Escolha dos processos do diagrama VAC ou EPC inicial que serão detalhados na seção
que recebe o nome do processo principal do relatório (figura 12). Os processos selecionados
serão detalhados até o nível mais detalhado modelado.

Como padrão a lista à direita, “Diagramas Escolhidos”, vem preenchida com todos os
diagramas encontrados. A ordem em que os processos aparecerão no relatório depende da
opção marcada:
 “Respeitar Ordem Sequencial” – a ordem de sequenciamento dos
processos/atividades nos diagramas será a usada no relatório. Em caso de bifurcação
de caminhos, possíveis em EPCs e VACs, a preferência é pelo próximo elemento
posicionado mais acima e mais à esquerda.
  “Respeitar Ordem Alfabética” – os processos/atividades serão listados em ordem
alfabética.
 “Respeitar Ordem Geométrica” – a ordem de disposição dos elementos no diagrama
será usada no relatório.

Observação: Caso a ordem sequencial seja selecionada, o script pode levar alguns
minutos até apresentar a próxima tela, o que causa a impressão de mau funcionamento.
Isso acontece porque o script deve considerar todos os caminhos possíveis a serem
percorridos dentro de um diagrama EPC para descobrir a sequência correta. Quanto maior o
número de operadores lógicos (E, E/OU, XOU) existentes no diagrama, maior será o tempo
de execução. Aconselha-se usar a ordem alfabética em casos onde existam muitos
operadores dentro de um modelo EPC.

Para continuar a execução do script, clicar em “OK”.

2) Caso seja executado em Processos ativos:

Neste caso é exibido o botão “Selecionar gerências” que permite a seleção das gerências
de ativos.
 Somente serão exibidos no relatório os modelos ativos de E&P e os processos que gestão
das gerências solicitadas. Caso nenhuma gerência seja selecionada todos os processos serão
exibidos.

Cadeia de Valor

Escolha dos diagramas VAC que serão exibidos na seção “Cadeia de Valor” do relatório.
Os diagramas relacionados como opções são aqueles que possuem ocorrências de objetos
superiores do processo escolhido, ou seja, objetos com assignment para o processo
escolhido, e o objeto superior do diagrama superior os que possuírem ocorrências dos
objetos superiores destes, e assim por diante até que seja encontrado um diagrama sem
objeto superior, ou seja, a Cadeia de Valor do E&P.
 Observação: Caso o processo escolhido tenha mais de uma opção de diagrama superior,
como por exemplo, as atividades críticas que são EPCs que são chamados por vários
processos, esta seção será omitida.

Dica: Para que todos os diagramas sejam relacionados corretamente, é preciso que os
assigments entre cada um deles e seu respectivo processo no diagrama superior, estejam
definidos corretamente.

Como padrão a lista à direita, “Diagramas Escolhidos”, vem preenchida com todos os
diagramas encontrados.

Para continuar a execução do script, clicar em “OK”.

Visões Adicionais do Negócio

Escolha dos diagramas de visões adicionais do negócio que serão exibidos no relatório.
Os diagramas de visões adicionais de negócio relacionados à esquerda “Diagramas
Encontrados” como candidatos a serem exibidos, são encontrados pelo script da seguinte
forma:

 Para o caso de processos ativos, o script busca na visão de processos da gerência.

 Para o caso de processos em desenvolvimento, depende do momento em que se
encontra o projeto:
 Processo em andamento: O script busca na visão de processos do projeto;
  Processo em análise de qualidade parcial: O script busca na visão processos da
pasta auditoria básica;
 Processo em análise de qualidade completa: O script busca na visão processos da
pasta auditoria completa.

Como padrão, a lista à direita, “Diagramas Escolhidos”, vem preenchida com todos os
diagramas encontrados. Caso nenhum diagrama seja encontrado, esta tela não será exibida.

Para continuar a execução do script, clicar em “OK”.

Estrutura Organizacional

Escolha dos diagramas organograma que serão exibidos na seção “Estrutura

organizacional” do relatório.
As opções existentes na lista à esquerda, “Diagramas Encontrados”, são diagramas que
possuem ocorrências de objetos do tipo unidade organizacional com relacionamento do tipo
desempenha no diagrama escolhido.
Os diagramas de detalhamento de grupos, tipo de posto de trabalho e tipo de unidade
organizacional aparecem numa seção destacada independente da seleção do usuário.
A ordem de aparição dos diagramas no relatório será a mesma da lista à direita,
“Diagramas Escolhidos”.
Para continuar a execução do script, clicar em “OK”.
 Diagrama de Interação

Escolha dos diagramas de interação (foco em eventos e em informações) que serão

exibidos no relatório.
Os diagramas de interação relacionados à esquerda “Diagramas Encontrados” como
candidatos a serem exibidos, são encontrados pelo script da seguinte forma:

 Para o caso de processos ativos, o script busca na visão de processos da gerência.

 Para o caso de processos em desenvolvimento, depende do momento em que se
encontra o projeto:
 Processo em desenvolvimento: O script busca na visão de processos do projeto;
 Processo em análise de qualidade parcial: O script busca na visão processos da
pasta auditoria básica;
 Processo em análise de qualidade completa: O script busca na visão processos da
pasta auditoria completa.

Como padrão, a lista à direita, “Diagramas Escolhidos”, vem preenchida com todos os
diagramas encontrados. Caso nenhum diagrama seja encontrado, esta tela não será exibida.

Para continuar a execução do script, clicar em “OK”.

 Estrutura Funcional (Árvore de Funções)

Escolha dos diagramas de árvore de funções que serão exibidos no relatório. Os

diagramas de árvore de funções relacionados à esquerda “Diagramas Encontrados” como
candidatos a serem exibidos, são encontrados pelo script da seguinte forma:

 Para o caso de processos ativos, o script busca na visão funcional da gerência.

 Para o caso de processos em desenvolvimento, depende do momento em que se
encontra o projeto:
 Processo em desenvolvimento: O script busca na visão funcional do projeto;
 Processo em análise de qualidade parcial: O script busca na visão funcional da
pasta auditoria básica;
 Processo em análise de qualidade completa: O script busca na visão funcional da
pasta auditoria completa.

Como padrão a lista à direita, chamada “Diagramas Escolhidos”, vem preenchida com
todos os diagramas encontrados. Caso nenhum diagrama seja encontrado, esta tela não será
exibida.

Para continuar a execução do script, clicar em “OK”.

 Diagrama de Localidades

Escolha dos diagramas de localidades que serão exibidos no relatório, com exceção ao
diagrama de localidades “Brasil” que não é tratado como opcional e é exibido no relatório
independente da escolha do usuário, como informa o lembrete na própria tela.

Somente diagramas encontrados no diretório “02.Visão organizacional\Localidades” de

“Processos Ativos” são relacionados na lista de opções “Diagramas Encontrados”. Caso
nenhum diagrama seja encontrado, esta tela não será exibida.

Para continuar a execução do script, clicar em “OK”.

 Diagrama de Objetivos de Área

Escolha dos diagramas de objetivos de área que serão exibidos no relatório. Os

diagramas de objetivos de área relacionados à esquerda, “Diagramas Encontrados”, como
candidatos a serem exibidos, são encontrados pelo script da seguinte forma:

 Para o caso de processos ativos, o script busca na visão funcional da gerência.

 Para o caso de processos em desenvolvimento, depende do momento em que se
encontra o projeto:
 Processo em andamento: O script busca na visão funcional do projeto;
 Processo em análise de qualidade parcial: O script busca na visão funcional da
pasta auditoria básica;
 Processo em análise de qualidade completa: O script busca na visão funcional da
pasta auditoria completa.

Como padrão a lista à direita, “Diagramas Escolhidos”, vem preenchida com todos os
diagramas encontrados. Caso nenhum diagrama seja encontrado, esta tela não será exibida.

Para continuar a execução do script, clicar em “OK”.

 5.2.2. Tela de opção do Relatório de Cadeia de Valor de E&P

Caso a opção “Relatório de processos da Cadeia de Valor de E&P” seja selecionada, a

tela de seleção das gerências é exibida.

A seleção dessas gerências permite a exibição do diagrama da gerência relacionado

imediatamente após o processo folha da Cadeia de Valor de E&P.
 5.3. Aplicação do Template

O relatório gerado pelo script não pode ser considerado concluído antes de
passar por uma formatação adequada. Algumas formatações não são contempladas
na linguagem dos scripts, e por isso foram disponibilizadas num arquivo de
template do MSWord®, chamado “Template do Relatorio de Processos.dot”. Este
template pode ser baixado da wiki da GIDSEP.
Conforme citado anteriormente, quando não se desmarca a opção “Display
Result” o script abre o documento gerado automaticamente no aplicativo MSWord®
do servidor. Neste caso, o documento deve ser fechado.
Antes de aplicar o template, é necessário abrir localmente o arquivo gerado e
salvá-lo como um documento do MSWord® (“.doc), Isto é necessário porque
apesar da extensão do arquivo gerado ser “.doc”, o formato real é em Rich Text
(“.rtf”). Para tanto, deve-se clicar menu “Arquivo”, escolher “Salvar como...” e no
campo “Salvar como tipo:” selecionar “Documento do Word (*.doc)”.

O MSWord® avisa que o formato do arquivo será alterado. Clicar na opção

“Sim”.

Após converter o relatório para o formato do MSWord®, pode-se aplicar o

template. No Word 2007 em diante, deve-se clicar na aba “Desenvolvedor” e no
ícone “Modelo de Documento” da subseção “Modelos”. Na janela que aparece a
seguir, deve-se clicar em “Adicionar...” e selecionar o arquivo de modelo do script.
Após clicar na opção “Atualizar estilos automaticamente”, o template será aplicado
no documento.

Para versões mais antigas do Word, deve-se seguir o seguinte roteiro: No

relatório já salvo em (*.doc) clicar no menu “Ferramentas” e escolher “Modelos e
Suplementos...”, clicar em “Anexar” na janela aberta, escolher o template, marcar
a opção “Atualizar estilos automaticamente” e clicar em “OK”.

Menu de aplicação do template Opções de aplicação do template

 Depois de aplicado o template no MSWord® é necessário gerar o índice analítico
na seção de Sumário. Para criar o índice, selecionar o menu “Inserir”, escolher
“Referência”, clicar em “Índices...”.

Inserção de Índice

Na janela aberta escolher a aba “Índice analítico“ e clicar em “OK”.

Criação do Índice analítico

Boa Prática: No caso em que o texto referencie imagens de diagramas e esses

não estiverem na mesma página, é uma boa prática formatar o parágrafo de forma
que o texto e o diagrama fiquem na mesma página. No caso do texto ou a imagem
do diagrama ser muito grande não será necessário realizar esse alinhamento. Para
isso selecionar a imagem do diagrama juntamente com o parágrafo anterior para
verificar se estes estão agrupados. Selecionar o menu “Formatar”, escolher
“Parágrafo”, selecionar a aba “Quebras de linha e de página” e verificar que a opção
“Manter com o próximo” deverá estar desmarcada. Se estiver marcada, desmarcar
e clicar em “OK”. Depois selecionar novamente o texto juntamente com a imagem
do diagrama a que o mesmo se refere e selecionar a opção “Manter com o
próximo”.

Seleção da opção “Quebras de linha e de

Seleção de parágrafo página”

5.4. Resultado

Abaixo uma descrição sucinta das seções do relatório:

Capa

Gerada automaticamente, exibindo o nome do modelo escolhido, a marca

Petrobras.

Histórico

Tabela que contém o registro das alterações realizadas no documento. Ao

gerar o relatório o script cria uma tabela em branco.

Sumário
 Só deve ser criado após a aplicação do template no documento, o script
preenche o espaço destinado a esta seção com um texto elucidativo para a
criação.

Introdução

Preenchida com um texto padrão combinado com o nome do modelo.

Notação

Tabela contendo nome, descrição e exemplos dos símbolos usados para a

representação gráfica nos modelos.

Modelo de Objetivos

Os modelos de objetivos de área e os relacionados ao processo.

Estrutura Organizacional

Diagramas organizacionais que detalham os papéis ou unidades

representadas nos diagramas de atividades acompanhados de sua descrição. O
último diagrama da lista é acompanhado de um detalhamento dos elementos
existentes nele.
Oferece a possibilidade de configuração pelo usuário. Tipos de papéis são
agrupados e exibidos em diferentes sub-seções.

Estrutura Funcional

Exibe as árvores de funções relacionadas ao processo. Oferece a

possibilidade de configuração pelo usuário. Esta seção é opcional.

Modelo de Localização

Preenchida obrigatoriamente com o diagrama de localização que representa

o Brasil, e opcionalmente com outros diagramas do mesmo tipo. Oferece a
possibilidade de configuração pelo usuário

Cadeia de Valor

Preenchida com cadeias de valor cujo detalhamento envolve o modelo

escolhido. Começando com a cadeia de valor principal, e exibindo a cadeia
correspondente aos processos recursivamente até que se atinja o modelo
selecionado pelo usuário. Oferece a possibilidade de configuração. Divide-se em
duas subseções para representar a cadeia sob o ponto de vista da E&P e a cadeia
sob o ponto de vista da unidade de negócio envolvida no processo.

Visão Adicional do Negócio

Preenchida com os modelos de nível superior até o modelo “Gerir E&P”, caso
o processo em execução esteja ligado a Cadeia de Valor de E&P.

Diagrama de Interface (foco em eventos)

Diagrama de interface localizado no mesmo diretório do modelo, ou no

subdiretório deste, nomeado como “Detalhamento do processo”. Esta seção é
opcional.
 Diagrama de Interface (foco em informações)

Diagrama de interface localizado no mesmo diretório do modelo, ou no

subdiretório deste, nomeado como “Detalhamento do processo”. Esta seção é
opcional.

Macro-processo

Exibe nome, descrição e o detalhamento dos processos, sub-processos e

atividades que pertencem ao processo do diagrama escolhido. Uma atividade não
se repete no detalhamento de um mesmo processo, o mesmo ocorre analogamente
com um sub-processo. Cada diagrama é detalhado em uma sub-seção separada. As
figuras de diagramas de atividades são opcionais. Elementos dos tipos “Riscos”,
“Regras de Negócio”, “Telas” e “Requisitos de Negócio” encontrados nos diagramas
são relacionados em tabelas na sub-seção deste diagrama.
Atividades críticas (diagramas do tipo EPC associados a uma atividade de
outro diagrama do mesmo tipo) podem ser colocadas numa seção separada. O
detalhamento das atividades em FADs também aparecerá nesta seção. A separação
das atividades críticas ocorre somente mediante configuração do usuário.

Elementos de Apoio ao Processo

Cada tipo do elemento de apoio aparece numa sub-seção própria, como

descrito abaixo:
 Regras de Negócio, Produtos, Documentos, Documentos Eletrônicos, Bancos
de Dados, Requisitos de Negócio, Telas e Termos técnicos (Glossário) –
tabela com nome e descrição de cada elemento;
 Riscos – tabela específica de riscos, com três colunas: “Aspecto”, “Impacto”
e “Recomendação”;
 Indicadores – tabela para cada indicador, exibindo diversos atributos do
elemento, cadastrados durante a modelagem;
 Informações – o usuário pode escolher entre uma única tabela com nome e
descrição de todos os elementos ou uma tabela para cada um, exibindo
diversos atributos e o modelo associado a este elemento;
 Sistemas – uma sub-seção para cada sistema encontrado contendo seu
modelo, sua ficha, e de acordo com seleção do usuário, uma tabela de
requisitos e outra de telas deste sistema. Além das sub-seções, exibe uma
tabela para registrar as interfaces entre os sistemas;
 Modelo Conceitual de Dados – exibe todos os modelos de dados existentes
no mesmo diretório do modelo escolhido e para cada modelo uma tabela
com suas entidades e outra com seus relacionamentos e agregações.

Todas as sub-seções podem ser descartadas ou exibidas de acordo com a

seleção do usuário, excetuando o glossário que é obrigatório. Caso nenhum
elemento de um tipo seja encontrado em FADs, a respectiva seção não aparece.