Frameworks
Frameworks
Construa produtos DoDAF 2.02 e vistas UAF a partir do modelo, incluindo AV-1, o Integrated Dictionary AV-2, gráficos OV-1 a partir de um quadro branco ou de uma imagem importada com áreas clicáveis e versões, modelos de regras, matrizes, checagens de consistência e o pacote de arquitetura em Word.
Nesta página
Visão geral
O grupo Frameworks mostra o seu modelo como os produtos de dois frameworks de arquitetura:
- DoDAF (DoD Architecture Framework 2.02). O Holarch oferece:
- 57 produtos em oito pontos de vista (AV, CV, DIV, OV, PV, SvcV, SV, StdV),
- uma Descrição da arquitetura que define quais produtos estão no escopo e por quê,
- sete checagens de consistência,
- três exportações, incluindo um Pacote de arquitetura do Word.
- UAF (Unified Architecture Framework): uma grade de 15 pontos de vista por 12 aspectos. Cada entrada da grade cria uma visão.
Um produto de framework não é um desenho separado. Cada produto é registrado em uma entidade raiz do modelo e abre a visão correspondente do Holarch. Por exemplo, o SV-1 abre um diagrama de Asset, o OV-5b um diagrama IDEF0 ou de Action, o SV-5a uma matriz e o AV-1 um documento.
Quando o modelo muda, todos os produtos que o mostram mudam também. A mesma entidade tem a mesma aparência em todos os produtos.
Conceitos
Produtos, raízes e rótulos
- Criar um produto escolhe (ou cria) uma entidade raiz e registra o produto nela.
- A raiz recebe os rótulos Produto DoDAF e o código do produto (por exemplo OV-1). A raiz de uma visão UAF recebe Visão UAF mais os códigos do ponto de vista e do aspecto.
- Uma raiz pode ter vários produtos. Um produto pode existir em várias raízes, por exemplo dois modelos OV-5b para duas missões.
- As páginas de produto ficam em
dodaf/<root>/<product>euaf/<root>/<view>. - O primeiro produto (ou visão UAF) adiciona todos os rótulos do framework, com descrições, ao esquema do projeto; o aviso diz quantos (n rótulos DoDAF adicionados ao esquema.). As descrições dos rótulos de conceitos DM2 (Agreement, Architectural Description, Condition, Installation, Materiel, Rule, Vision) terminam com "A DoDAF 2.02 Meta Model (DM2) concept." Para adicionar os rótulos sem criar um produto, abra Esquema na barra lateral e depois Rótulos → Adicionar rótulos DoDAF (ou Adicionar rótulos UAF); isso também dá aos rótulos de framework já existentes sem descrição as descrições deles. Você pode então rotular entidades (Capability, Activity, Function, Organization, Project, Service, System, Standard, …) para os produtos de matriz.
Tipos de produto
| Tipo | O que a página de produto mostra |
|---|---|
| Diagrama | Uma miniatura do diagrama da raiz e Abrir <diagram> no cabeçalho da página. |
| Gráfico (OV-1, CV-1) | Um quadro ou uma moldura de quadro branco, uma imagem importada com áreas clicáveis ou um diagrama de Asset. |
| Matriz | Uma matriz editável das entidades com dois rótulos; clique em uma célula para adicionar ou remover o relacionamento. |
| Tabela de fluxo de recursos (OV-3, SvcV-6, SV-6) | Cada troca: I/O, tamanho, unidades, conduit, origem e destino. |
| Tabela de regras (OV-6a, SvcV-10a, SV-10a) | Statements de regra com o tipo e aquilo a que cada um se aplica. |
| Documento (AV-1) | Um documento de estrutura mais anexos gráficos. |
| Consulta (AV-2, StdV-1, StdV-2) | O Dicionário integrado, ou Artifacts com o rótulo Standard. |
Status
Cada produto tem um status:
- Não iniciado: não existe nenhuma instância.
- Em andamento: criado, mas vazio.
- Preenchido: tem conteúdo, como uma imagem, entidades de diagrama, vínculos de matriz, fluxos, regras, seções ou entradas.
Descrição da arquitetura
Cada projeto tem uma Descrição da arquitetura. Ela contém o Nome da arquitetura, a Finalidade dela e os produtos No escopo, cada um com a decisão ou a pergunta que apoia. As checagens e o Pacote de arquitetura se concentram nos produtos no escopo.
Como usá-lo
Quando e por quê
Use os frameworks quando um cliente ou um comitê de revisão espera uma descrição de arquitetura DoDAF ou UAF. Isso é comum em revisões de conceito e de projeto.
Trabalhe nesta ordem:
- Primeiro o modelo: requisitos, funções, ativos, interfaces e atividades operacionais. A maioria dos produtos são visões desses dados.
- Preencha a Descrição da arquitetura, para criar apenas os produtos de que a decisão precisa.
- Crie os produtos.
- Execute Checar arquitetura antes de cada entrega.
Planejar a descrição da arquitetura
- Abra Frameworks → DoDAF.
- Clique na aba Descrição da arquitetura.
- Digite o Nome da arquitetura.
- Digite a Finalidade: para que serve a arquitetura e as decisões que ela embasa.
- Marque No escopo para cada produto de que o trabalho precisa. Para encontrar produtos, use os filtros Todos os pontos de vista, Qualquer status e Mostrar todos os produtos.
- Para cada produto no escopo, preencha Apoia com a decisão ou a pergunta que ele responde.
- Clique em Criar… na coluna Instâncias de cada produto que você está pronto para criar.
Os chips de status no topo contam os produtos no escopo que estão Não iniciado, Em andamento e Preenchido. Clique em um chip para filtrar a tabela.
Criar um produto
- Clique em + Novo produto DoDAF no cabeçalho da página. (Ou clique em um produto no Catálogo de produtos DoDAF 2.02 na aba Produtos.)
Você vê Novo produto DoDAF.
- Escolha o Produto.
O texto abaixo o descreve.
- Em Raiz, digite para encontrar um item existente e escolha-o, ou digite o nome de uma nova raiz.
- Clique em Criar.
A página do produto abre.
- Para um produto de diagrama, clique em Abrir <diagram> no cabeçalho da página e construa o diagrama.
Criar um OV-1 a partir de um quadro branco
- Em Novo produto DoDAF, escolha OV-1: Gráfico de conceito operacional de alto nível.
- Mantenha Representação em Usar um quadro branco (o padrão para OV-1 e CV-1).
- Escolha o quadro branco. As opções são:
- um quadro branco existente, depois o Quadro (página) e a Área (Quadro inteiro ou uma Moldura: …),
- Novo quadro branco a partir do modelo OV-1,
- Novo quadro branco em branco.
Uma pré-visualização mostra a área selecionada.
- Dê um nome à raiz e clique em Criar.
A página do produto OV-1 abre.
- Clique em Abrir quadro branco.
- Arraste imagens do painel Clipart para o quadro: satélites, estações terrestres, aeronaves, navios ou símbolos militares. Adicione setas e rótulos.
- Selecione uma imagem e escolha Modelo → Vincular a… no inspetor.
- Escolha o ativo, o executor ou a atividade que a imagem representa.
O elemento agora está vinculado. Repita as etapas 7–8 para cada imagem.
- Volte para a página do produto.
Os elementos vinculados são áreas ativas na imagem e são listados em Elementos vinculados (n).
- Preencha Informações da visualização: Nome, Finalidade, Escopo, Período e Arquiteto.
Eles preenchem o bloco de título sob a imagem.
- Escreva a Narrativa.
Criar um OV-1 a partir de uma imagem importada
- Em Novo produto DoDAF, escolha o OV-1 e defina Representação como Importar uma imagem (PNG, JPG, SVG).
- Preencha a Raiz. As imagens importadas são armazenadas em um Artifact, então uma raiz existente deve ser um Artifact.
- Escolha o Arquivo de imagem, ou deixe para depois, e clique em Criar.
- Se você ainda não escolheu uma imagem, clique em Importar imagem… na página do produto (ou solte um arquivo na tela).
- Clique em Desenhar área ativa e arraste um retângulo sobre um elemento da imagem.
Você vê Vincular área ativa a entidade.
- Escolha a entidade que esse elemento representa.
Repita as etapas 5–6 para cada elemento.
- Escreva a Narrativa.
Para atualizar a imagem depois, clique em Substituir gráfico…. A imagem anterior é mantida em Versões, e Restaurar a traz de volta.
A terceira Representação, Construir no Holarch (diagrama de Asset), torna o OV-1 um diagrama de Asset da raiz.
Checar e exportar
- Abra a aba Checar arquitetura.
Cada checagem mostra Aprovado, Aviso ou Erro e o número de constatações dela.
- Clique em uma checagem para listar as constatações dela.
Cada constatação tem um link para a entidade e tem Abrir <product> (ou Criar <product>…).
- Corrija as constatações no modelo.
- Clique em Executar novamente.
- Escolha Exportar ▾ → Pacote de arquitetura (Word).
Você vê Construindo o pacote de arquitetura… e depois <Architecture name> Package.docx é baixado.
Exemplo prático: a demonstração CubeSat EO-1
Crie o projeto de demonstração (Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração). Depois abra Frameworks → DoDAF.
O que a demonstração contém:
- Descrição da arquitetura: a arquitetura é EO-1 Mission Architecture. A finalidade dela é Support the Critical Design Review: show the operational concept, the imaging pass and the rules that constrain operations. Quatro produtos estão no escopo, todos Preenchido: AV-1, OV-1 (Concept graphic for the CDR briefing.), OV-5b e OV-6a.
- OV-1 EO-1 High-Level Operational Concept mostra o quadro branco EO-1 Operational Concept (WB-1). Ele retrata a espaçonave fotografando terras agrícolas, as estações terrestres parceiras, o centro de operações da missão e o cliente das imagens. Elementos vinculados lista as entidades do modelo por trás das imagens: EO-1 Spacecraft, Ground Station, Mission Operations Center, o conduit IF-10 e outros.
- AV-1 Mission Architecture Overview and Summary tem todas as sete seções da estrutura preenchidas: identificação, escopo, finalidade e ponto de vista, contexto, período, ferramentas e formatos de arquivo, e constatações. As constatações dizem The power margin is at risk (TPM-2), the payload interface IF-05 is over capacity, and two qualification tests failed.
- OV-5b: a raiz é a action Run Nominal Imaging Pass.
- OV-6a Operational Rules for EO-1 contém três regras, cada uma vinculada às atividades e aos ativos aos quais se aplica:
- OR-1 Sunlit Targets Only (Action Assertion),
- OR-2 Licensed Downlink Only (Structural Assertion),
- OR-3 Imaging Energy per Orbit (Derivation).
Experimente:
- Abra o OV-1 e aponte para uma imagem.
Você vê a entidade dela. Clique na imagem para abrir o painel da entidade.
- Abra o OV-5b e clique em Abrir diagrama IDEF0.
Você vê a passagem de imageamento.
- Abra a aba Checar arquitetura.
DC-1 informa um aviso: uma atividade folha da passagem de imageamento do OV-5b não tem executor.
- Abra a constatação e vincule um executor com performed by.
- Clique em Executar novamente.
O aviso desaparece. (Depois que você adiciona um OV-2 ou OV-4, o DC-1 também checa se cada executor aparece em um deles.)
- Escolha Exportar ▾ → Pacote de arquitetura (Word).
EO-1 Mission Architecture Package.docx é baixado, com a descrição, a tabela de produtos e os quatro produtos.
Dicas e boas práticas
- Escreva o texto de Apoia para cada produto no escopo. Um produto sem uma decisão por trás fica na gaveta.
- Prefira produtos apoiados no modelo a imagens. Um OV-1 importado serve para um briefing, mas vincule as partes dele com áreas ativas para que o dicionário AV-2 e as checagens as vejam.
- Use Molduras em um quadro branco para manter o OV-1 e as notas de trabalho dele em um só quadro. Aponte o produto para a moldura.
- Rotule as entidades (Capability, Activity, Function, System, Service, Organization, Project) antes de abrir produtos de matriz. As matrizes listam entidades por rótulo.
- Dê uma descrição a cada entidade. O AV-2 mostra Sem definição — adicione uma descrição para entidades sem descrição.
Erros comuns
- Um produto de matriz está vazio (Ainda não há entidades de linha…). Nenhuma entidade tem o rótulo de linha ou de coluna. Adicione os rótulos (Visão do item ou Banco de dados → Rótulo ▾).
- Uma célula da matriz não pode ser clicada (O esquema não permite este relacionamento). O esquema não permite esse relacionamento entre as duas classes.
- A importação falha com Um gráfico importado é armazenado em um Artifact. Escolha uma raiz Artifact ou construa o produto no Holarch. Escolha um Artifact como raiz, ou outra representação.
- DC-6 Produto no escopo está vazio. Um produto está marcado como no escopo, mas não foi criado ou ainda está vazio.
- Uma área ativa mostra "A entidade vinculada foi excluída". Clique em Revincular… ao lado dela em Áreas ativas, ou remova-a com ×.
Como se conecta
- Requisitos, comportamento, arquitetura e interfaces alimentam quase todos os produtos. OV-5 e SV-4 vêm de Actions, SV-1 e OV-2 de Assets e Conduits, e OV-3 e SV-6 de Input/Outputs.
- Quadros brancos: OV-1 e CV-1 podem ser visões ao vivo de um quadro ou de uma moldura. Veja Quadros brancos e Clipart de quadro branco.
- Documentos e apresentações: uma imagem importada também é um diagrama Gráfico importado. Você pode inseri-la em documentos e slides.
- Risco e plano: as visões UAF de parâmetros de risco abrem Diagramas de Risk e burn-downs. As visões de roadmap abrem Linhas do tempo e gráficos de Gantt. Veja Riscos, problemas e decisões e Gerenciamento de projetos.
- Rastreabilidade: os produtos de matriz podem ser abertos na Matriz de rastreabilidade com Abrir na matriz de rastreabilidade.
Página DoDAF
Cabeçalho da página
| Controle | Ação |
|---|---|
| Exportar ▾ | Pacote de arquitetura (Word), Produtos DoDAF (JSON), Subconjunto DM2 PES (XML, sem validação de esquema). |
| + Novo produto DoDAF | Abre Novo produto DoDAF. |
Abas
- Produtos:
- o Catálogo de produtos DoDAF 2.02 (57 produtos). Expanda-o e clique em um produto para criá-lo.
- uma galeria com todos os produtos do projeto, com uma pílula por código de produto (OV-1, SV-4 …), pesquisa, ordenação e Mostrar mais. Vazia: Este projeto não tem produtos DoDAF.
- Descrição da arquitetura (
dodaf?tab=arch): veja Aba Descrição da arquitetura. - Checar arquitetura (
dodaf?tab=check): veja Checar arquitetura.
Páginas de produto
Toda página de produto mostra Todos os produtos no cabeçalho da página, a descrição do produto e a raiz dele. Quando definido, mostra também Apoia: …. Os demais controles dependem do tipo de produto, como descrito abaixo.
Produtos DoDAF
Todos os 57 produtos aceitos, com a representação no Holarch e a classe de uma nova raiz.
Ponto de vista geral (AV)
| Produto | Representação |
|---|---|
| AV-1: Visão geral e informações resumidas | Documento com a estrutura do AV-1 e anexos gráficos (raiz: Artifact). |
| AV-2: Dicionário integrado | Tabela de dicionário com todas as entidades usadas pelos produtos DoDAF. |
Ponto de vista de capacidades (CV)
| Produto | Representação |
|---|---|
| CV-1: Visão | Quadro branco, imagem importada ou diagrama de Asset. |
| CV-2: Taxonomia de capacidades | Diagrama de hierarquia (raiz: Action). |
| CV-3: Faseamento de capacidades | Diagrama de linha do tempo (raiz: Action). |
| CV-4: Dependências de capacidades | Matriz: Capability × Capability, has dependent. |
| CV-5: Mapeamento de capacidades para o desenvolvimento organizacional | Matriz: Capability × Organization, performed by. |
| CV-6: Mapeamento de capacidades para atividades operacionais | Matriz: Capability × Activity, decomposed by. |
| CV-7: Mapeamento de capacidades para serviços | Matriz: Capability × Service, performed by. |
Ponto de vista de dados e informações (DIV)
| Produto | Representação |
|---|---|
| DIV-1: Modelo conceitual de dados | Diagrama de classes (raiz: Asset). |
| DIV-2: Modelo lógico de dados | Diagrama de classes (raiz: Asset). |
| DIV-3: Modelo físico de dados | Diagrama de classes (raiz: Asset). |
Ponto de vista operacional (OV)
| Produto | Representação |
|---|---|
| OV-1: Gráfico de conceito operacional de alto nível | Quadro branco, imagem importada ou diagrama de Asset. |
| OV-2: Descrição de fluxos de recursos operacionais | Diagrama de I/O físico (raiz: Asset). |
| OV-3: Matriz de fluxos de recursos operacionais | Tabela de fluxo de recursos (raiz: Asset). |
| OV-4: Diagrama de relacionamentos organizacionais | Diagrama de hierarquia (raiz: Asset). |
| OV-5a: Árvore de decomposição de atividades operacionais | Diagrama de hierarquia (raiz: Action). |
| OV-5b: Modelo de atividades operacionais | Diagrama IDEF0 (raiz: Action). |
| OV-5b + OV-6c (combinados) | Diagrama de Action (raiz: Action). |
| OV-6a: Modelo de regras operacionais | Tabela de regras, regras com o rótulo Operational Rule, numeradas OR-1, OR-2, … |
| OV-6b: Descrição de transições de estado | Diagrama de State Machine (raiz: Asset). |
| OV-6c: Descrição de rastreamento de eventos | Diagrama de sequência (raiz: Action). |
Ponto de vista de projetos (PV)
| Produto | Representação |
|---|---|
| PV-1: Relacionamentos do portfólio de projetos | Matriz: Project × Organization, performed by. |
| PV-2: Cronogramas dos projetos | Diagrama de linha do tempo (raiz: Action). |
| PV-3: Mapeamento de projetos para capacidades | Matriz: Project × Capability, related to. |
Ponto de vista de serviços (SvcV)
| Produto | Representação |
|---|---|
| SvcV-1: Descrição do contexto dos serviços | Diagrama de Asset. |
| SvcV-2: Descrição de fluxos de recursos dos serviços | Diagrama de I/O físico. |
| SvcV-3a: Matriz sistemas-serviços | Matriz: System × Service, decomposed by. |
| SvcV-3b: Matriz serviços-serviços | Matriz: Service × Service, related to. |
| SvcV-4a: Árvore de decomposição da funcionalidade dos serviços | Diagrama de hierarquia (raiz: Action). |
| SvcV-4b: Modelo de funcionalidade dos serviços | Diagrama IDEF0 (raiz: Action). |
| SvcV-4 + SvcV-10c (combinados) | Diagrama de Action (raiz: Action). |
| SvcV-5: Matriz de rastreabilidade de atividades operacionais para serviços | Matriz: Activity × Service, performed by. |
| SvcV-6: Matriz de fluxos de recursos dos serviços | Tabela de fluxo de recursos. |
| SvcV-7: Matriz de medidas dos serviços | Matriz: Measure × Service, specifies. |
| SvcV-8: Descrição da evolução dos serviços | Diagrama de linha do tempo (raiz: Asset). |
| SvcV-9: Previsão de tecnologia e competências dos serviços | Diagrama de linha do tempo (raiz: Asset). |
| SvcV-10a: Modelo de regras dos serviços | Tabela de regras, Service Rule, numeradas SvR-1, … |
| SvcV-10b: Descrição de transições de estado dos serviços | Diagrama de State Machine. |
| SvcV-10c: Descrição de rastreamento de eventos dos serviços | Diagrama de sequência (raiz: Action). |
Ponto de vista de sistemas (SV)
| Produto | Representação |
|---|---|
| SV-1: Descrição das interfaces dos sistemas | Diagrama de Asset. |
| SV-2: Descrição de fluxos de recursos dos sistemas | Diagrama de I/O físico. |
| SV-3: Matriz sistemas-sistemas | Diagrama I² (raiz: Asset). |
| SV-4a: Árvore de decomposição da funcionalidade dos sistemas | Diagrama de hierarquia (raiz: Action). |
| SV-4b: Modelo de funcionalidade dos sistemas | Diagrama IDEF0 (raiz: Action). |
| SV-4 + SV-10c (combinados) | Diagrama de Action (raiz: Action). |
| SV-5a: Matriz de rastreabilidade de atividades operacionais para funções de sistemas | Matriz: Activity × Function, decomposed by. |
| SV-5b: Matriz de rastreabilidade de atividades operacionais para sistemas | Matriz: Activity × System, performed by. |
| SV-6: Matriz de fluxos de recursos dos sistemas | Tabela de fluxo de recursos. |
| SV-7: Matriz de medidas dos sistemas | Matriz: Measure × System, specifies. |
| SV-8: Descrição da evolução dos sistemas | Diagrama de linha do tempo (raiz: Asset). |
| SV-9: Previsão de tecnologia e competências dos sistemas | Diagrama de linha do tempo (raiz: Asset). |
| SV-10a: Modelo de regras dos sistemas | Tabela de regras, System Rule, numeradas SR-1, … |
| SV-10b: Descrição de transições de estado dos sistemas | Diagrama de State Machine. |
| SV-10c: Descrição de rastreamento de eventos dos sistemas | Diagrama de sequência (raiz: Action). |
Ponto de vista de padrões (StdV)
| Produto | Representação |
|---|---|
| StdV-1: Perfil de padrões | Consulta: Artifacts com o rótulo Standard; Abrir no Banco de dados. |
| StdV-2: Previsão de padrões | Consulta: Artifacts com o rótulo Standard; Abrir no Banco de dados. |
Produtos de matriz: as linhas e colunas são as entidades com os rótulos indicados. Para linhas de Measure, cada Measure é uma linha.
O texto acima da matriz nomeia a consulta, por exemplo: Linhas: label:"Activity" · Colunas: label:"Function" · Relacionamento: decomposed by. Clique em uma célula para adicionar ou remover o relacionamento.
Abrir na matriz de rastreabilidade abre as mesmas linhas, colunas e relacionamento na matriz completa.
Gráficos OV-1 e CV-1
O campo Representação em Novo produto DoDAF tem três opções para OV-1 e CV-1 (Usar um quadro branco por padrão):
| Opção | Resultado |
|---|---|
| Importar uma imagem (PNG, JPG, SVG) | A imagem é armazenada no Artifact raiz; Arquivo de imagem (opcional; você pode importá-lo depois) é opcional. |
| Construir no Holarch (diagrama de Asset) | O diagrama de Asset da raiz. |
| Usar um quadro branco | Uma visão ao vivo de um quadro ou de uma moldura de um quadro branco. Escolha um quadro existente com Quadro e Área (Quadro inteiro ou Moldura: …), Novo quadro branco a partir do modelo OV-1 (ou do modelo CV-1), ou Novo quadro branco em branco. A caixa de diálogo observa: A página do produto mostra o quadro (ou a moldura) ao vivo. Os elementos vinculados viram áreas clicáveis. |
Página de produto de quadro branco
- Cabeçalho da página: Todos os produtos, Abrir quadro branco, Alterar quadro… (Escolher o quadro branco do OV-1 e depois Usar este quadro).
- Tela: o quadro ou a moldura, com um bloco de título (OV-1: <name>, Finalidade, Escopo, Período, Arquiteto).
- Os elementos vinculados são áreas ativas. Aponte para uma para ver a entidade e a classe dela; clique nela para o painel da entidade.
- Amplie e reduza com − / + / ⤢.
- Informações da visualização: Nome, Finalidade, Escopo, Período, Arquiteto e Origem: com um link para o quadro.
- Elementos vinculados (n): todas as entidades vinculadas. Vazio: Vincule elementos do quadro a entidades do modelo (selecione um elemento e depois Modelo → Vincular a… no inspetor). Eles são listados aqui e viram áreas ativas na imagem.
- Narrativa: rich text, salvo como a descrição da raiz.
- Tela vazia: Nada para mostrar — O quadro ou a moldura está vazio, ou foi excluído. Abra o quadro branco para desenhar o conceito ou escolha outro quadro.
Página de produto de imagem importada
- Cabeçalho da página: Todos os produtos, Importar imagem… (passa a Substituir gráfico… quando já existe uma imagem), Desenhar área ativa, Baixar original, Abrir como diagrama.
- Tela: arraste para mover. Role, ou use − / + / ⤢, para ampliar e reduzir. Solte um arquivo PNG, JPG ou SVG nela para importar. Vazia: Nenhum gráfico ainda — Importe um arquivo PNG, JPG ou SVG, ou solte um aqui. Os arquivos SVG são limpos: scripts, manipuladores de eventos e links externos são removidos.
- Desenhar área ativa: arraste um retângulo e depois escolha ou crie a entidade em Vincular área ativa a entidade. As áreas ativas são contornadas na tela e deixadas de fora das exportações.
- Narrativa.
- Áreas ativas (n): cada uma com Revincular… e ×.
- Versões: a imagem atual é marcada como Atual. As anteriores têm Restaurar e ⤓ (baixar). Substituir a imagem mantém a anterior aqui.
Limpeza de SVG: na importação, o Holarch remove scripts, documentos incorporados, manipuladores de eventos, endereços javascript:, importações de estilo e referências fora do arquivo. Um aviso informa quantos itens foram removidos.
Imagens grandes: as imagens PNG e JPG são reduzidas quando muito grandes.
Diagrama Gráfico importado: a imagem também é um diagrama Gráfico importado. Ele é listado em Diagramas, e você pode inseri-lo em documentos e apresentações. O editor de diagramas dele tem Importar imagem… (ou Substituir gráfico…), Desenhar área ativa, Baixar original e Abrir página do OV-1.
Modelos de regras (OV-6a, SvcV-10a, SV-10a)
Um modelo de regras lista as regras que restringem a arquitetura. O Artifact raiz é a source of das regras. Cada regra é um Statement com o rótulo de regra do produto e um tipo de regra.
- Barra de ferramentas: + Regra, a contagem (3 regras · com o rótulo Operational Rule), Baixar CSV, Baixar XLSX. O cabeçalho da página adiciona Abrir como documento.
- Colunas:
- Número, Regra e Texto da regra,
- Tipo: —, Structural Assertion, Action Assertion ou Derivation,
- Aplica-se a: chips com ×, e + para vincular uma entidade com traced to,
- × para excluir a regra.
- Edite as células no lugar: Enter salva uma célula, ⌘ / Ctrl+Enter salva o texto da regra, e Esc cancela.
- Tipos de regra:
- Structural Assertion: um fato ou uma restrição sobre termos e como eles se relacionam.
- Action Assertion: o que deve, não deve ou pode acontecer quando uma condição vale.
- Derivation: como um valor ou fato é calculado ou inferido a partir de outros fatos.
- Vazio: Nenhuma regra ainda. Adicione uma regra, dê a ela um nome curto, escreva o texto da regra, escolha o tipo e vincule aquilo a que ela se aplica.
Tabelas de fluxo de recursos (OV-3, SvcV-6, SV-6)
Uma tabela de fluxo de recursos lista cada troca entre os ativos sob a raiz. Ela tem dois tipos de linhas:
- cada Conduit cujas pontas estão na decomposição da raiz, com cada Input/Output que ele transfere,
- fluxos derivados do comportamento: uma Action executada por um ativo gera um Input/Output que uma Action executada por outro ativo recebe.
- Colunas: Input/Output, Número, Tamanho, Unidades (editável no lugar), Conduit, Asset de origem, Asset de destino.
- Barra de ferramentas: Linhas compactas, Alinhar à esquerda / ao centro / à direita, Definir unidades para todas as linhas… (define Unidades em todas as linhas de I/O), Baixar CSV, Baixar XLSX.
- Vazio: Nenhum fluxo de recursos encontrado. Conecte Assets com Conduits que transferem entidades Input/Output (diagrama de Asset), ou faça com que Actions executadas por Assets gerem e recebam Input/Outputs.
AV-1 e AV-2
AV-1 Visão geral e informações resumidas
Criar um AV-1 adiciona uma estrutura ao documento raiz, cada seção com um texto de orientação: 1 Identificação da arquitetura, 2 Escopo, 3 Finalidade e ponto de vista, 4 Contexto, 5 Período, 6 Ferramentas e formatos de arquivo, 7 Constatações.
A página do produto mostra a miniatura do documento e Abrir documento (cabeçalho da página). Se a estrutura estiver faltando, também mostra Adicionar estrutura do AV-1 (Estrutura do AV-1 adicionada).
Anexos: + Anexar gráfico… importa um PNG, JPG ou SVG como um Artifact próprio com o rótulo AV-1 Attachment (<file> anexado).
- Cada cartão tem um link para a imagem.
- × o remove do AV-1; o Artifact permanece.
- Os anexos aparecem como figuras no Pacote de arquitetura.
AV-2 Dicionário integrado
O AV-2 lista todas as entidades usadas por qualquer produto DoDAF. Isso inclui o conteúdo dos diagramas, as linhas e colunas das matrizes, as regras e aquilo a que se aplicam, as áreas ativas, os elementos de quadro branco vinculados, os fluxos e as seções do AV-1.
Colunas: Classe, Número, Nome, Definição (a descrição) e Usado em (links para cada produto).
- Barra de ferramentas: Pesquisar nome, número, classe, definição ou produto…, a contagem de entradas, Baixar CSV e Baixar XLSX (AV-2_Integrated_Dictionary).
- Abrir Banco de dados (cabeçalho da página) mostra todas as entidades do projeto, não apenas as usadas por produtos.
- Vazio: Nenhuma entidade ainda. As entidades aparecem aqui assim que são usadas por um produto DoDAF (conteúdo de diagramas, linhas de matriz, regras, áreas ativas).
Aba Descrição da arquitetura
| Elemento | Finalidade |
|---|---|
| Nome da arquitetura | Título da arquitetura e das exportações (padrão: <project> Architecture). |
| Finalidade | Para que serve a arquitetura e as decisões que ela embasa. |
| Chips de status | Contagens dos produtos no escopo Não iniciado, Em andamento, Preenchido; clique para filtrar. |
| Todos os pontos de vista, Qualquer status, Mostrar todos os produtos | Filtros. Sem produtos no escopo, todos os produtos aparecem. |
| Tabela | No escopo (caixa de seleção), Produto, Apoia (Decisão ou pergunta que este produto apoia), Status, Instâncias (links, ou Criar…). |
Checar arquitetura
A aba executa sete checagens entre visões sobre os produtos do projeto. O cabeçalho mostra:
- n constatações (ou Nenhuma constatação),
- n de 7 checagens relatam problemas · checado em <time>,
- Executar novamente.
| Checagem | Severidade | Constatação |
|---|---|---|
| DC-1 Atividade sem executor em um OV-2 ou OV-4 | Aviso | As atividades folha em OV-5a/OV-5b devem ser executadas por um executor operacional que também apareça em um OV-2 ou OV-4. |
| DC-2 Troca do OV-3 não transportada por uma needline do OV-2 | Aviso | Toda troca de recursos em um OV-3 deve passar por uma needline (Conduit) mostrada em um OV-2. |
| DC-3 Needline do OV-2 não transporta itens trocados | Aviso | Uma needline (Conduit) em um OV-2 deve transferir pelo menos um Input/Output. |
| DC-4 Função do sistema não rastreada até uma atividade operacional | Erro | As funções em produtos SV-4 devem se relacionar com pelo menos uma atividade operacional (OV-5a/OV-5b, ou uma Action com o rótulo Activity). Estas são lacunas do SV-5a. |
| DC-5 Sistema do SV-1 não está em nenhum SV-4 | Aviso | Os sistemas em um SV-1 devem executar pelo menos uma função mostrada em um SV-4. |
| DC-6 Produto no escopo está vazio | Erro | Produtos marcados como no escopo na Descrição da arquitetura devem ser criados e preenchidos. |
| DC-7 Imagem do OV-1 / CV-1 ausente ou com vínculo quebrado | Aviso | OV-1 e CV-1 precisam de uma imagem ou de um quadro branco; cada área ativa ou elemento vinculado deve apontar para uma entidade existente. |
Notas típicas de constatações:
- Sem executor. Vincule um com “performed by”.
- Executado por …, não mostrado em um OV-2 ou OV-4.
- Nenhuma needline a transporta.
- Transportado por …, que não está em um OV-2.
- Nenhum Input/Output é transferido.
- Nenhum relacionamento com uma atividade operacional.
- Não executa nenhuma função mostrada em um SV-4.
- <product>: ainda não criado. / criado, mas vazio.
- OV-1: nenhuma imagem importada ainda.
- OV-1: uma área ativa está vinculada a uma entidade excluída.
- OV-1: o quadro branco foi excluído.
- OV-1: o quadro branco está vazio.
Exportações
Pacote de arquitetura (Word)
Um .docx chamado <Architecture name> Package.docx:
- Título, DoDAF 2.02 architecture package · <project> · <date>, e um campo Sumário (o Word oferece atualizá-lo quando o arquivo abre).
- Descrição da arquitetura: a finalidade e uma tabela de Produto, Apoia e Status.
- Uma seção por produto: os produtos no escopo, ou todos os produtos criados se nenhum estiver no escopo. Cada seção começa em uma nova página com a descrição do produto e a linha Apoia:. Os produtos não criados mostram Não iniciado. Depois, para cada instância:
- a imagem ou o diagrama como figura numerada. Os quadros brancos incluem o bloco de título e uma tabela de elementos vinculados; as imagens importadas incluem uma tabela de áreas ativas.
- os produtos de matriz e de tabela como tabelas numeradas,
- as tabelas de regras,
- as seções e os anexos do AV-1,
- o dicionário AV-2,
- a narrativa.
Produtos DoDAF (JSON)
<Architecture name> DoDAF Products.json, no formato holarch-dodaf-products. Ele contém:
- a descrição da arquitetura,
- todos os produtos, com tipo, status, raiz, entidades e dados específicos do tipo (tipo de diagrama, referência ao quadro branco e elementos vinculados, imagem com áreas ativas e número de versões, regras, fluxos, anexos),
- o dicionário.
Subconjunto DM2 PES (XML, não validado pelo esquema)
<Architecture name> DM2 PES subset.xml grava as entidades do dicionário nos termos do DoDAF Meta Model:
- Conceitos: Performer, System, Service, OrganizationType, Activity, Capability, Resource, Rule, Information.
- Associações: atividade executada por executor, atividade produz / consome recurso, regra restringe coisa, todo–parte, fluxo de recursos.
O arquivo usa o namespace próprio do Holarch. Ele não é validado em relação ao esquema DM2 PES.
UAF
Página UAF
- Cabeçalho da página: + Nova visão UAF.
- Grade UAF (ponto de vista × aspecto): os pontos de vista são as linhas e os aspectos são as colunas. Em um projeto sem visões UAF, a grade fica aberta no topo; quando o projeto tem visões, a galeria vem primeiro e a grade fica recolhida em uma linha abaixo dela (clique para abri-la).
- Cada célula lista as visões dela como botões. Clique em um para criar essa visão.
- Um número mostra quantas visões já existem na célula.
- Os pontos de vista que são um único resumo (Sm-Ov, En-Pm, Me-Pm, Rk-Pm) ocupam a linha inteira.
- Uma galeria com todas as visões UAF do projeto (pesquisa, ordenação, Mostrar mais). Vazia: Este projeto não tem visões UAF.
Nova visão UAF
- Ponto de vista (com a descrição dele).
- Aspecto (quando o ponto de vista tem aspectos).
- Visão.
- Para uma visão de diagrama, Classe raiz. Para uma matriz, Classe relacionada e Relacionamento (padrão performed by).
- Raiz: digite para encontrar um item existente e escolha-o, ou digite o nome de uma nova raiz.
- Clique em Criar.
Pontos de vista, aspectos e visões
Pontos de vista: Sm-Ov Resumo e visão geral, En-Pm Parâmetros de ambiente, Me-Pm Parâmetros de medição, Rk-Pm Parâmetros de risco, Am Gestão da arquitetura, St (Strategic) Estratégico, Op Operacional, Sv Serviços, Ps Pessoal, Rs Recursos, Sc Segurança, Pj Projetos, Sd Padrões, Ar Recursos reais, Rq Requisitos.
Os aspectos e as visões que cada um oferece:
| Aspecto | Visões |
|---|---|
| Mv Motivação | Requirements Document |
| Tx Taxonomia | Hierarquia, Árvore |
| Sr Estrutura | Asset, BDD, Camadas |
| Cn Conectividade | IBD, I/O físico, I² |
| Pr Processos | Action, Atividade, IDEF0, N² |
| St (States) Estados | State Machine |
| Sq Sequências | Sequência |
| If Informação | Spider, Classe (Am: Dicionário) |
| Pm Parâmetros (e En-Pm, Me-Pm) | Radar |
| Rk-Pm Parâmetros de risco | Diagrama de Risk, Burn-down de riscos |
| Ct Restrições | Paramétrico |
| Rm Roadmap | Linha do tempo, Gráfico de Gantt |
| Tr Rastreabilidade | Matriz |
Aspectos por ponto de vista:
| Ponto de vista | Aspectos |
|---|---|
| Sm-Ov | Documento Sm-Ov (linha inteira) |
| En-Pm, Me-Pm | Radar (linha inteira) |
| Rk-Pm | Diagrama de Risk, Burn-down de riscos (linha inteira) |
| Am | Mv, Tx, Sr, Cn, Pr, St, If (Dicionário), Pm, Ct, Rm, Tr |
| St (Strategic) | Mv, Tx, Sr, Cn, Pr, St, If, En-Pm, Me-Pm, Rk-Pm, Ct, Rm, Tr |
| Op | Tx, Sr, Cn, Pr, St, Sq, If, En-Pm, Me-Pm, Rk-Pm, Ct, Tr |
| Sv, Ps | Tx, Sr, Cn, Pr, St, Sq, En-Pm, Me-Pm, Rk-Pm, Ct, Rm, Tr |
| Rs | Tx, Sr, Cn, Pr, St, Sq, If, En-Pm, Me-Pm, Rk-Pm, Ct, Rm, Tr |
| Sc | Mv, Tx, Sr, Cn, Pr, En-Pm, Me-Pm, Rk-Pm, Ct, Tr |
| Pj | Tx, Sr, Cn, Pr, En-Pm, Me-Pm, Rk-Pm, Rm, Tr |
| Sd | Tx, Sr, En-Pm, Me-Pm, Rk-Pm, Rm, Tr |
| Ar | Sr, Cn, Tr |
| Rq | Mv |
Os aspectos En-Pm, Me-Pm e Rk-Pm de um ponto de vista são oferecidos em Nova visão UAF.
Páginas de visões
Toda página de visão tem Todas as visões no cabeçalho da página e as descrições do ponto de vista e do aspecto. Dependendo da visão:
- Visões de diagrama: uma miniatura e Abrir <diagram>.
- Visões de documento (Documento de requisitos, Documento Sm-Ov): Abrir documento.
- Dicionário (Am-If): Abrir no Banco de dados.
- Gráfico de Gantt: Abrir gráfico de Gantt (a raiz deve ser uma Task).
- Burn-down de riscos: Abrir gráficos.
- Matriz: as linhas são a decomposição da raiz, e as colunas são todas as entidades da classe do eixo Y. As células mostram o relacionamento escolhido; clique em uma célula para adicioná-lo ou removê-lo.
Uma visão que não pode ser mostrada exibe Esta visão UAF não pode ser mostrada com o problema:
- um tipo de diagrama que não pode usar a classe da raiz: Um <view> não pode usar uma raiz <class>.
- uma matriz cuja classe relacionada foi excluída: A classe relacionada desta matriz não existe mais.
- uma matriz cujo relacionamento foi excluído: O relacionamento desta matriz não existe mais.
As Checagens do modelo informam as mesmas visões na regra Global.8, uma constatação por raiz. O Corrigir dela lista as visões da raiz e abre a primeira; crie a visão novamente a partir da grade UAF com uma raiz adequada e depois remova a antiga.
Atalhos de teclado
| Teclas | Onde | Ação |
|---|---|---|
| Enter | Célula da tabela de regras | Salvar a célula. |
| ⌘ / Ctrl+Enter | Texto da regra | Salvar o texto da regra. |
| Esc | Célula da tabela de regras | Cancelar a edição. |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | Em qualquer lugar | Desfazer / refazer. Criar um produto, importar ou substituir uma imagem, restaurar uma versão e cada alteração de área ativa são uma etapa cada. |
Mensagens
| Mensagem | Significado e correção |
|---|---|
| Um gráfico importado é armazenado em um Artifact. Escolha uma raiz Artifact ou construa o produto no Holarch. | As imagens importadas precisam de uma raiz Artifact. |
| Escolha um arquivo PNG, JPG ou SVG. | Outros tipos de arquivo não podem ser importados. |
| O arquivo não é uma imagem SVG válida. / Não foi possível ler o arquivo como imagem. / Não foi possível ler o arquivo. | O arquivo está danificado ou não é uma imagem. |
| O arquivo tem <size>; o limite é <size>. | O arquivo é maior do que o limite de anexo por arquivo. |
| <file> importado. n itens SVG inseguros removidos (scripts, manipuladores de eventos ou links externos). | O SVG foi limpo. |
| Arraste um retângulo maior sobre a imagem. | Uma área ativa deve ter pelo menos 4 pixels em cada direção. |
| <name> restaurado | Uma imagem anterior volta a ser a atual. |
| Digite um nome para a raiz ou escolha um item existente. | O campo Raiz está vazio. |
| Escolha um quadro branco ou crie um novo. | Usar um quadro branco precisa de um quadro. |
| Selecione uma visão. | Nova visão UAF precisa de uma visão. |
| Uma regra não pode ser rastreada até um <class>. | O esquema não permite traced to para essa classe. |
| n rótulos DoDAF adicionados ao esquema. | O primeiro produto DoDAF (ou visão UAF) adicionou os rótulos do framework. |
| Construindo o pacote de arquitetura… | A exportação para Word está em andamento. |
| Este produto DoDAF não existe mais. / Visão UAF não encontrada | A raiz foi excluída; use Voltar ao DoDAF / Voltar ao UAF. |
| A visão de gráfico de Gantt ainda não está disponível nesta instalação. | Mostrado em uma visão de Gantt quando a página de Gantt não está disponível. |
Limites
- DoDAF: 57 produtos em oito pontos de vista; UAF: 15 pontos de vista × 12 aspectos.
- Imagens importadas: PNG, JPG e SVG, até o limite de anexo por arquivo (veja Armazenamento e limites).
- Versões de imagens: as 10 imagens anteriores mais recentes são mantidas.
- Matrizes do Pacote de arquitetura: até 40 linhas e 12 colunas por tabela de matriz.
Páginas relacionadas
- Riscos, problemas e decisões e Gerenciamento de projetos — destinos das visões UAF de risco e de roadmap.
- Interfaces — conduits e I/O por trás de OV-2, OV-3, SV-2 e SV-6.
- Armazenamento e limites — limites de tamanho de arquivo para imagens importadas.
- Ajuda: DoDAF, UAF, Criar um OV-1 para DoDAF, Quadros brancos, Clipart de quadro branco.