TOK (Tempo OK)
A tela TOK liga o Myria aos arquivos de previsão de vazões da Tempo OK. Com a verificação periódica ativa, o Myria baixa PREVS e DADVAZ novos dos caminhos que você indicar e os guarda no Git da organização. Esses PREVS alimentam as rodadas DECOMP criadas pelo Fast Track e podem disparar agendamentos.
Antes de começar
Cadastre a chave da Tempo OK em Perfil, na seção Integração Tempo OK (veja Perfil). Sem uma chave com acesso ativo, a verificação não baixa nada.
Configurar
-
Abra TOK no menu lateral.
-
Em Verificação periódica, marque Checagem ativa e informe o Intervalo (min), de 5 a 1440 minutos.
-
Em Arquivos para download, informe os caminhos-base na Tempo OK, um por linha. Por exemplo:
Comercializadora/Arquivos/PREVS/ETA40-GEFSav-ECENS45/ETA40-GEFSav-ECENS45-av -
Clique em Salvar.
O último trecho de cada caminho é o nome do modelo TOK, como
ETA40-GEFSav-ECENS45-av. A ordem das linhas define a prioridade entre os
modelos: entre PREVS igualmente recentes para o mesmo período, o Myria prefere
o modelo que aparece antes na lista.
O que acontece depois
O indicador no topo da tela resume o estado:
| Indicador | Significado |
|---|---|
| Checagem ativa (verde) | O Myria verifica a Tempo OK no intervalo configurado. |
| Nenhum path configurado (amarelo) | Informe ao menos um caminho em Arquivos para download. |
| Chave Tempo OK inativa (amarelo) | A chave existe, mas está sem acesso. O Myria tenta validá-la de novo a cada intervalo. |
| Chave Tempo OK não configurada (vermelho) | Cadastre a chave em Perfil. |
| Checagem desativada (vermelho) | Marque Checagem ativa e salve. |
Ao lado aparece a hora da Última checagem.
A cada verificação, o Myria procura arquivos publicados nos últimos 7 dias e
baixa só os que ainda não estão no Git. Para cada caminho, baixa também os
arquivos mensais da pasta PREVS_MENSAL e os pacotes diários da pasta
DADVAZ correspondente. Os caminhos são derivados da configuração existente;
não é necessário cadastrar uma segunda lista. Os arquivos ficam no
repositório terceiros da organização:
| Pasta | Conteúdo |
|---|---|
tok/prevs/<modelo>/<AAAA-MM>/<DD>/ | PREVS semanais |
tok/vazpast/<modelo>/<AAAA-MM>/<DD>/ | VAZPAST do pacote mensal |
tok/vazoes/<modelo>/<AAAA-MM>/<DD>/ | vazoes.dat do pacote mensal |
tok/dadvaz/<modelo>/<AAAA-MM>/<DD>/ | DADVAZ por data operativa do pacote diário |
Relação com o PREVS das rodadas
- O Fast Track e a opção PREVS da TOK pelo filtro dos agendamentos escolhem o PREVS mais recente para o período da rodada nessas pastas e usam a ordem dos modelos da tela TOK como desempate. O filtro pode fixar o modelo ou a data da captura (veja Filtros de PREVS e de cortes).
- Um agendamento com Mapa TOK capturado dispara quando chega um PREVS
novo. Com o filtro
modelo:evento captura:evento, ele usa os PREVS dessa captura em toda a sequência. - Cada PREVS da TOK tem facetas automáticas (modelo, data da captura, PMO e RV), que aparecem no grafo do estudo. Um estudo pode trocar o modelo do PREVS de todas as rodadas de uma vez (veja Trocar o modelo do PREVS).
- Com o webhook Mapas TOK baixados ligado em Perfil, sua organização recebe um aviso a cada download (veja Webhooks).
Para escolher o PREVS de uma rodada específica, use a configuração da rodada.
DADVAZ nas rodadas DESSEM
Ao criar um D+ com TOK configurada, o Myria prefere o DADVAZ da captura mais recente que contenha um arquivo para a data operativa da nova rodada. A ordem dos modelos configurados desempata capturas igualmente recentes. Sem arquivo compatível nos últimos 7 dias, a rodada usa o DADVAZ rolado.
A versão escolhida fica registrada na rodada: novos mapas não alteram rodadas já preparadas. Na aba Hidrologia da configuração da rodada, você pode trocar para DADVAZ rolado, DADVAZ da TOK ou um arquivo enviado/selecionado no Git. O ícone Tempo OK identifica a fonte aplicada quando ela vem da TOK.
Problemas comuns
O indicador fica em Chave Tempo OK inativa. Confira a chave em Perfil com Testar. Se a assinatura da Tempo OK estiver ativa e o teste falhar, fale com a Tempo OK.
Nenhum arquivo novo aparece. Confira se o caminho está escrito exatamente como na Tempo OK e se houve publicação nos últimos 7 dias. Arquivos mais antigos não são baixados.
O Fast Track escolheu o PREVS de outro modelo. O Myria prefere o PREVS mais recente. Para desempatar a favor de um modelo, coloque-o antes em Arquivos para download; para fixar um arquivo, use a configuração da rodada.