RPD Vaktari Hub · Manual de utilização

01O que é e o que faz

O RPD Vaktari Hub mostra numa só página o Vaktari Machine de várias máquinas. Cada máquina tem um mosaico, e dentro do mosaico está o seu painel inteiro, reduzido para caber: o estado, os contadores, a linha temporal e tudo o resto.

Ecrã do Vaktari Hub com cinco máquinas — **Fig. 1** · Cinco máquinas numa página: duas em funcionamento, uma parada por erro, uma parada sem erro e uma que não responde.

O Hub não lê nenhum ficheiro nem calcula nada. Cada mosaico é uma janela para o Vaktari Machine que corre no computador dessa máquina, e tudo o que nele se vê é explicado no manual do Vaktari Machine. Este manual só explica o que é próprio do Hub.

	Vaktari Hub	Vaktari Live Counters
O que mostra de cada máquina	o painel inteiro do Machine: estado, disponibilidade, paragens, erros e produção	o contador do lote e o estado, em grande
Para que serve melhor	seguir algumas máquinas em pormenor a partir de um computador	um monitor de parede que se lê de longe, com avisos de objetivo
O que precisa	o Vaktari Machine a funcionar em cada máquina	acesso à pasta de cada máquina

02Abrir o Hub

O Hub não tem programa próprio nem janela preta: é uma página que se abre diretamente.

Faça duplo clique em vaktari_hub.html, ou no atalho que aponte para ele. Abre-se no navegador.
Vale a pena guardá-lo nos favoritos ou deixar um atalho no ambiente de trabalho.

O que tem de estar a funcionar

O Hub só mostra. Para que um mosaico tenha conteúdo, no computador dessa máquina tem de estar o Vaktari Machine arrancado, e o computador a partir do qual se consulta tem de conseguir chegar a ele pela rede.

Não é preciso atualizar a página

Cada painel atualiza-se sozinho, como quando se abre o Machine diretamente. Além disso, o Hub verifica a cada 30 segundos se cada máquina responde; quando uma que não respondia volta, o seu mosaico recarrega-se sozinho.

Mais de um Hub

Podem ter-se vários Hubs, por exemplo um por tipo de máquina. Cada um é uma pasta com a sua lista de máquinas e o seu título, e abre-se com o seu vaktari_hub.html.

03O cabeçalho

Cabeçalho do Vaktari Hub com chamadas numeradas — **Fig. 2** · O cabeçalho.

1: Marca e módulo.
2: O título deste Hub. Serve para o distinguir se houver mais de um; também aparece no separador do navegador. Define-se no ficheiro de máquinas; se não houver, não aparece.
3: O resumo: quantas máquinas respondem, do total.
4: Colunas Quantos mosaicos há em cada linha, de 1 a 4. Veja a secção 5.
5: Recarregar tudo Volta a carregar todos os mosaicos e verifica de novo todas as máquinas.
6: Idioma Catalão, espanhol, inglês, basco, francês e português. Muda o idioma do Hub e o de todos os painéis ao mesmo tempo.
7: Tema Escuro ou Claro, também para o Hub e para todos os painéis.

O navegador lembra-se do idioma, do tema e do número de colunas.

04Os mosaicos

Um mosaico do Hub com chamadas numeradas — **Fig. 3** · Um mosaico: a faixa de cima é do Hub, o resto é o painel da máquina.

1: O ponto de ligação. Verde se o computador da máquina responde, vermelho se não, ocre enquanto se verifica.
2: O nome da máquina, o que foi posto no ficheiro de máquinas.
3: O endereço do Vaktari Machine dessa máquina.
4: A ligação, por extenso: Ligada, Sem resposta ou A verificar…
5: Ampliar Abre esta máquina em toda a janela.
6: Recarrega só este mosaico.
7: Abre num novo separador o Vaktari Machine desta máquina, fora do Hub.
8: O painel da máquina. É o Vaktari Machine verdadeiro, não uma imagem: pode clicar-se nele, mudar de separador, passar o rato pela linha temporal ou escolher um período.

Ligada não significa em funcionamento O ponto e a palavra Ligada dizem que o computador da máquina responde. Se a máquina produz ou está parada, di-lo o painel de dentro, com a sua cor: verde em funcionamento, vermelho parada por erro, ocre parada sem erro.

Quando uma máquina não responde

Mosaico de uma máquina que não responde — **Fig. 4** · O ponto vermelho, Sem resposta e um aviso em vez do painel.

Significa que o Hub não consegue chegar ao Vaktari Machine dessa máquina: o computador está desligado, o Machine não está arrancado ou a rede não chega lá. Os outros mosaicos não são afetados. Não é preciso fazer nada no Hub: volta a tentar a cada 30 segundos e, quando a máquina volta, o mosaico recarrega-se sozinho.

05Ampliar uma máquina e escolher as colunas

Ampliar

Uma máquina ampliada a toda a janela — **Fig. 5** · Uma máquina ampliada. O botão de cima à direita diz agora Voltar à grelha.

Na grelha, os painéis veem-se reduzidos e as letras pequenas custam a ler. Ampliar põe uma máquina em toda a janela, em tamanho real, para a ver com calma ou trabalhar nela: mudar de separador, escolher datas, exportar. Para voltar, Voltar à grelha ou a tecla Esc.

Se o que pretende é ter uma máquina aberta à parte, use o botão de abrir num novo separador.

Colunas

Com Colunas escolhe-se quantos mosaicos há em cada linha. Quanto menos colunas, maior se vê cada painel e mais é preciso descer para os ver todos. O número fica guardado para cada Hub em separado.

06Idioma e tema

O Hub em catalão e tema claro, com todos os painéis no mesmo idioma e tema — **Fig. 7** · Idioma e tema mudados no Hub: todos os painéis o seguem.

O idioma e o tema escolhidos no cabeçalho do Hub aplicam-se a todos os mosaicos ao mesmo tempo, de maneira que todo o ecrã se vê igual.

Manda o Hub. Cada painel tem as suas próprias listas de idioma e tema, e funcionam, mas a mudança só dura até o mosaico ser recarregado ou se voltar a mudar no Hub.
Não mexe em nada nas máquinas. Quem abrir o Vaktari Machine diretamente, na máquina ou a partir de outro computador, continuará a vê-lo com o idioma e o tema que tinha.
Os textos dos erros e os nomes das máquinas não são traduzidos.

07As máquinas do Hub

Que máquinas aparecem, com que nome e por que ordem, é dito pelo ficheiro maquines_hub.js, que está na mesma pasta do Hub. Abre-se com o Bloco de notas. Mexer nele é trabalho de quem administra a instalação.

window.VAKTARI_HUB_CONFIG = {
  title: "Linhas de enchimento",
  columns: 3,
  viewWidth: 1280,
  viewHeight: 800,
  pingSeconds: 30,
  machines: [
    { name: "Linha 1", url: "http://192.168.1.41:8761" },
    { name: "Linha 2", url: "http://192.168.1.42:8761" },
    { name: "Linha 3", url: "http://192.168.1.43:8761" }
  ]
};

Linha	O que é
`title`	o título deste Hub, tal como se escreve. Vazio (`""`), não aparece nenhum título.
`columns`	as colunas com que abre da primeira vez, de 1 a 4. Depois manda o que se escolher no cabeçalho.
`viewWidth`, `viewHeight`	o tamanho, em píxeis, a que cada painel é desenhado antes de ser reduzido. Com um valor mais baixo, as letras veem-se maiores e cabe menos conteúdo.
`pingSeconds`	de quantos em quantos segundos se verifica se cada máquina responde
`machines`	uma linha por máquina: `name` é o nome que aparece no mosaico e `url`, o endereço do seu Vaktari Machine

A ordem das linhas é a ordem dos mosaicos.
Depois de guardar o ficheiro, recarregue a página com Ctrl + F5. Não basta o botão Recarregar tudo.
Cada linha de máquina acaba com uma vírgula, exceto a última. Uma vírgula ou umas aspas a menos fazem com que o ficheiro não se consiga ler, e o Hub aparece vazio.
O endereço tem de servir a partir do computador onde se abre o Hub. localhost só vale para uma máquina que esteja nesse mesmo computador; para as restantes é preciso o seu endereço de rede.

O Hub sem nenhuma máquina definida — **Fig. 8** · O Hub quando a lista está vazia ou o ficheiro não se consegue ler.

Fazer outro Hub

Copie a pasta inteira do Hub com outro nome e mude nela o maquines_hub.js: o título e a lista de máquinas. Os quatro ficheiros da pasta (vaktari_hub.html, maquines_hub.js, i18n_hub.js e vaktari_theme.css) têm de andar sempre juntos.

08O rodapé

Rodapé do Vaktari Hub — **Fig. 9** · O rodapé.

Tem a versão do Hub, a negrito. A versão do Vaktari Machine de cada máquina aparece no rodapé do seu painel: para a ver, amplie o mosaico e desça até ao fim. São duas versões diferentes, e se tiver de comunicar uma incidência convém anotar as duas.

09Problemas frequentes

O que acontece	Porquê	O que é preciso fazer
Um mosaico diz Sem resposta	o computador dessa máquina está desligado, o Vaktari Machine não está arrancado nele ou a rede não chega lá	Confirme que o computador da máquina está ligado e que o Machine está a correr. O Hub volta a tentar sozinho.
Todos os mosaicos dizem Sem resposta	o computador a partir do qual consulta não está na rede das máquinas, ou os endereços não servem a partir daqui	Confirme a rede. Se o Hub foi copiado de outro computador, reveja os endereços com `localhost`.
Diz Ligada mas o mosaico aparece em branco	o painel ainda está a carregar, ou ficou a meio	Clique no botão de recarregar do mosaico. Se continuar, abra-o num novo separador para ver o que diz.
Nenhuma máquina definida	a lista está vazia, ou o ficheiro de máquinas tem um erro e não se consegue ler	Reveja `maquines_hub.js`: vírgulas e aspas. Veja a secção 7.
Mudei o ficheiro de máquinas e não se nota	o navegador ainda tem o ficheiro antigo	Recarregue a página com Ctrl + F5.
Um mosaico não muda de idioma nem de tema	essa máquina tem um Vaktari Machine antigo, que não entende a ordem do Hub	É preciso atualizar o Machine dessa máquina. Avise quem fez a instalação.
As letras dos painéis são demasiado pequenas	há demasiadas colunas para o tamanho do ecrã	Escolha menos Colunas, ou amplie a máquina que quer ver.
Só se vê a parte de cima de cada painel	o mosaico mostra uma altura fixa do painel	Desloque-se dentro do mosaico com a roda do rato, ou amplie-o.
O Hub aparece sem cores nem formato	falta algum ficheiro na pasta	Confirme que estão os quatro ficheiros da secção 7.
Dois Hubs partilham idioma e tema	são preferências do navegador, comuns a todos os Hubs	É assim de propósito. As colunas, essas, ficam guardadas para cada Hub.

Se tiver de comunicar uma incidência, anote a versão do Hub e a do Machine da máquina afetada, e faça uma captura do ecrã inteiro.