.. _anatem13-arvore:

.. only:: html

   .. image:: /img/anatem_13.png
      :alt: Anatem 13

**************
Árvore do Caso
**************

.. only:: latex

   .. image:: /img/anatem_13.png
       :alt: Anatem 13
       :width: 100%

A **Árvore do Caso** mostra como o STB ou STBX aberto é formado. Ela reúne o
caso principal, os arquivos incluídos e os códigos encontrados em cada arquivo,
na ordem em que são lidos.

Use a árvore para localizar rapidamente onde um dado foi declarado, acompanhar
as inclusões do caso e abrir a linha correspondente no editor.

Abrir a Árvore do Caso
======================

Use o botão **Árvore do Caso**, no grupo final da barra de ferramentas, ou o
comando **Exibir > Árvore do Caso**. O painel pode ser redimensionado, ocultado
e restaurado sem fechar os arquivos abertos.

Cada STB ou STBX aberto possui uma raiz própria. Quando houver vários casos
abertos, selecione a raiz correspondente ao caso que deseja examinar.

Como a árvore é organizada
==========================

`Caso principal`
    É a raiz da árvore e mostra o nome do STB ou STBX aberto.

`Arquivo incluído`
    Aparece como ramo no ponto em que é chamado pelo caso. Expandir o ramo
    mostra os códigos e as demais inclusões existentes naquele arquivo.

`Código`
    Aparece como uma ocorrência dentro do arquivo, acompanhado de sua linha.
    Quando houver uma descrição disponível, ela ajuda a distinguir ocorrências
    do mesmo código.

`Aviso estrutural`
    Identifica problemas como arquivo ausente ou ilegível, inclusão cíclica,
    arquivo alcançado por mais de um caminho ou caminho que não pôde ser
    resolvido.

A posição dos ramos acompanha a ordem de leitura. O mesmo arquivo ou código
pode aparecer mais de uma vez quando houver mais de uma ocorrência no caso.

Arquivos de resultado, como OUT, LOG, PLT, CSV, SAV e HIS, não aparecem como
ramos de entrada. Eles continuam disponíveis pelas ações próprias de resultado
da interface.

Navegar para um arquivo ou código
=================================

* Selecione um código para abrir seu arquivo e posicionar o editor na linha
  correspondente.
* Dê duplo clique no nome de um arquivo para abri-lo no editor.
* Expanda ou recolha os ramos para deixar visível somente a parte do caso que
  está sendo investigada.
* Quando o mesmo arquivo aparecer em mais de um ponto, use o ramo que
  corresponde ao caminho de leitura desejado.

A navegação apenas muda o arquivo e a linha em foco. O conteúdo do caso não é
alterado.

Atualização após uma edição
===========================

A árvore representa a última versão salva dos arquivos. Enquanto houver uma
alteração ainda não salva, ela pode ser indicada como desatualizada.

Depois do salvamento, a árvore atualiza os arquivos, inclusões e códigos
afetados. Os ramos abertos são preservados sempre que possível. Em casos
grandes, a interface mostra o progresso da atualização e permite cancelá-la.

Problemas na estrutura do caso
==============================

Um aviso na árvore indica onde a leitura da estrutura foi interrompida ou ficou
ambígua. Selecione o aviso para abrir o arquivo relacionado e verificar o
caminho ou a inclusão.

Esses avisos tratam da organização dos arquivos. Mensagens produzidas durante a
crítica ou a simulação permanecem no OUT e no Relatório Interativo.

.. figure:: ../anatem_13/img/anatem_13_arvore.png
   :alt: Árvore do Caso aberta no Anatem
   :width: 100%
   :name: fig-anatem13-arvore

   Árvore do Caso com o STB aberto, os arquivos incluídos e os códigos
   reconhecidos em cada arquivo.