.. _anatem13-navegacao-referencias:

.. only:: html

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

***************************
Navegação entre referências
***************************

.. only:: latex

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

A navegação entre referências liga uma menção ao local em que o elemento foi
declarado no caso. Ela permite sair de um arquivo, linha ou diagnóstico e abrir
diretamente o destino relacionado.

O que pode ser uma referência
==============================

`Arquivo`
    Abre o arquivo relacionado. Quando a referência inclui uma linha, o editor
    também posiciona o cursor nessa linha.

`Declaração do caso`
    Leva à linha que define um CDU, modelo, topologia, parâmetro, condição ou
    outro elemento utilizado em uma ocorrência.

`Referência do OUT`
    Leva ao arquivo de entrada, declaração ou variável relacionada a um
    diagnóstico reconhecido no Relatório Interativo.

Como navegar
============

As referências disponíveis ficam sublinhadas. Ao manter o ponteiro sobre uma
delas, a interface mostra o tipo da referência e o destino.

Para abrir o destino:

* use **Ctrl+clique** sobre a referência; ou
* abra o menu de contexto e escolha **Ir para definição**.

Quando houver mais de um destino possível, escolha um deles na lista
apresentada. A navegação abre o arquivo ou a seção correspondente; ela não
modifica o conteúdo.

Relações dentro do caso
=======================

Além de arquivos, a interface reconhece relações entre registros do caso.
Entre as relações disponíveis estão:

* o CDU usado por `DMAQ`, `DFNT`, `DCER` ou `DCNE`;
* o modelo `DMDG` associado a uma máquina;
* o modelo `DMCE` associado a um compensador estático;
* a condição `DCST` usada por um modelo;
* a ligação entre `ACDU`, `DCDU`, `DTDU` e parâmetros definidos pelo
  usuário.

Variáveis usadas em `DCDU` seguem essas relações dentro do caso. O destino é a
declaração correspondente, e não uma página do manual.

Quando uma definição ocupa mais de uma linha, todas as partes relacionadas são
destacadas e a navegação abre a primeira linha do registro.

Definições repetidas ou ausentes
================================

A referência é resolvida no ponto em que ela é usada, respeitando a ordem dos
arquivos do caso.

`Um destino`
    A navegação é direta.

`Mais de um destino`
    A interface apresenta os candidatos para escolha.

`Destino ausente`
    A referência permanece destacada e o problema informa a origem e o tipo de
    elemento que não foi encontrado.

`Arquivo fora do caso`
    O arquivo pode ser aberto, mas não passa a fazer parte do caso apenas por
    ter sido consultado.

Navegação a partir do Relatório Interativo
==========================================

Diagnósticos reconhecidos podem apresentar referências independentes para o
dado de entrada, o arquivo, o código, o CDU, o bloco, a variável, o modelo ou o
equipamento mencionados.

Quando uma mensagem cita vários elementos, cada um recebe sua própria ação de
navegação. Números que fazem parte apenas do texto da explicação permanecem
como texto.

Ajuda do registro no manual
===========================

A abertura do manual é uma ação separada da navegação entre declarações. Na
Entrada Assistida, **Ver no manual · F1** abre a documentação do registro e da
variante selecionados.

Por exemplo, com `DPLT VOLT` selecionado, a ajuda abre a seção de plotagem de
barras CA. Isso não significa que um `VOLT`, `FREQ`, `FCMS` ou `FMAQ` escrito
em qualquer ponto do editor seja um atalho para o manual.

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

As referências acompanham a última versão salva dos arquivos do caso. Enquanto
houver alterações não salvas, a interface pode indicar que os destinos estão
desatualizados. Depois do salvamento, as relações afetadas são atualizadas sem
misturar as referências de outros casos abertos.

.. figure:: ../anatem_13/img/anatem_13_link.png
   :alt: Navegação entre referências no editor do Anatem
   :width: 100%
   :name: fig-anatem13-navegacao-referencias

   Referência de modelo em DMAQ com o destino DMDG identificado antes da
   navegação.