NESSUN ICONEstoing: Comportamenti, Scripting

• Tutorial

Tutorial

Questo capitolo presenta i meccanismi di scripting Beholder per modificare il comportamento Attrezzatura e applicazione. Copre la creazione di Workspace, Controller, I diversi tipi di script disponibili e come sono associati ai dispositivi.

Lo scripting è un modo potente, semplice e particolarmente efficace per modificare il comportamento dell'osservatore.

Modificare il comportamento delle apparecchiature in risposta ai dati recuperati dalla rete, modificare l'interfaccia utente per semplificare le azioni degli utenti, accedere alle API o effettuare l'elaborazione? Lo scripting è una risposta adeguata a qualsiasi tipo di evoluzione del Beholder senza chiedere ai tuoi utenti Aggiorna i loro strumenti.

In questo articolo discuteremo:

• Creare uno spazio di lavoro
• Creazione di un controller
• Controllori di parametrizzazione
• Controllori di scripting per apparecchiature
• Controllori di scripting applicativo
• Controllori di traduzione

Creare uno spazio di lavoro

Il Spazi di lavoro rappresentare un insieme di Controllori che agirà sull'ergonomia e rappresentazione dei dati. In particolare, sono usati principalmente per definire profili diversi che accedono all'applicazione o semplicemente applicazioni diverse.

Gli utenti possono avere accesso a uno o più Spazi di lavoro, tuttavia, al lancio del Beholder, durante la sessione sarà attivo solo uno spazio di lavoro.

Per creare un nuovo Worspace, clicca su Crea un nuovo Workspace. Il pannello di creazione del Worspace si apre a destra dell'interfaccia, inserisci il suo nome, descrizione (opzionale) e convalidare la creazione.

Una volta creato lo Workspace, ora appare nell'elenco degli Workspace nel tuo ambiente. Basta cliccare su uno degli Workspace per accedere al suo file dettagliato.

Le diverse sottoparti di un foglio Workspace permettono di:

• Modifica delle proprietà dello spazio di lavoro
• Accesso all'elenco dei controller associati allo Workspace, con la possibilità di aggiungere o rimuovere un link
• Modificare i diritti di sicurezza dello Workspace per permetterne l'accesso a un gruppo di utenti.
• Rimozione dello spazio di lavoro

Per associare un Controller allo Workspace, clicca su "Modifica l'elenco dei controller dello Workspace" e clicca sul pulsante toggle link nella linea Controller. Nel seguente esempio, sarà attivo solo il Controller "Semaforo".

Creazione di un controller

Un Controller rappresenta uno script che verrà eseguito dall'Osservatore. Esistono diversi tipi di controller che verranno interpretati in modo differente, ognuno con un obiettivo specifico.

Attualmente, i diversi tipi di controller sono:

• Controllori di parametrizzazione
  • Utilizzo: Configura le impostazioni del beholder al lancio.
  • Prefisso: Infos.
  • Formato: JSON
  • Regola di importazione: Non utilizzato
• Controllori di scripting per apparecchiature
  • Utilizzo: Scripting di una o più apparecchiature.
  • Prefisso: nessuna
  • Formato: Javascript
  • Regola di importazione: Il nome di una famiglia di equipaggiamenti, o $(Nom d’un handle)
• Controllori di scripting applicativo
  • Utilizzo: Scripting dell'osservatore nella sua interezza senza alcun collegamento a un pezzo di apparecchiatura.
  • Prefisso: App.
  • Formato: Javascript
  • Regola di importazione: Non utilizzato
• Controllori di posizione
  • Utilizzo: Aggiunte chiavi di traduzione al sistema di localizzazione.
  • Prefisso: Translation.
  • Formato: Testo
  • Regola di importazione: il linguaggio associato (ad es. fr-FR)

Per creare un nuovo controller, clicca su "Crea un nuovo controller". Il pannello di creazione del Controller si apre a destra dell'interfaccia, inserisci il suo nome, una descrizione (opzionale), la regola di importazione e convalida la creazione.

La regola di importazione dipende dal tipo di controller, consulta i diversi tutorial che descrivono ciascun tipo di controller per sapere quali regole applicare in base al caso.

Una volta creato il Controller, ora appare nella lista dei Controller nel tuo ambiente. Basta cliccare su uno dei Controller per accedere alla sua scheda dettagliata.

Le diverse sottoparti della spina di un controller permettono di:

• Modifica delle proprietà del controller
• Accesso all'elenco degli Workspace utilizzando questo Controller, con la possibilità di aggiungere o rimuovere un link
• Modifica dello script associato al controller
• Rimozione del controller

Per creare la prima versione di uno script, clicca su "Modifica script" poi su "Crea" e inserisci un numero di versione. Non è necessario inserire una nuova regola di importazione, la regola generale di importazione al Controller viene utilizzata se non viene sovrascritta nella versione script.

Nel caso in cui il Controller non abbia alcuna versione attiva, o se la versione modificata non è quella attuale, basta cliccare sul pulsante "Pubblica questa versione" per assegnarla come versione attiva.

Il contenuto dello script può essere modificato nel blocco di montaggio e salvato usando il "Salvare". La prossima volta che verrà lanciato Beholder, le modifiche applicate allo script saranno effettive se la versione viene rilasciata e il Controller è collegato allo Workspace che stai avviando.

Controllori di parametrizzazione

Un controller di tipo parametro viene utilizzato per configurare i parametri del Beholder al lancio. I parametri possono essere usati, ad esempio, per configurare la scheda da caricare, l'ambito da caricare, l'indirizzo del server (Hub).

Il contenuto dello script per un controller di parametri deve essere nel formato JSON, associando una chiave di parametrizzazione al suo valore.

Esempio di un controller di configurazione che configura l'osservatore per caricare la carta con il nome Copro, il suo ambito associato e che modifica il titolo della domanda:

{
    "DefaultMapName" : "Copro",
    "Supervision.ScopeName" : "MyBuilding",
    "Supervision.TitleName" : "Formation by Graphicstream"
}

Le impostazioni più comunemente utilizzate nei Controller sono le seguenti:

• DefaultMapName : Il nome della carta da caricare.
• DefaultLevelName : Il nome del livello da evidenziare al lancio.
• Supervision.ScopeName : Il nome/i dei mirini da caricare. Per caricare più scopi, devono essere separati da una virgola ",".
• Supervision.TitleName : Il titolo del Beholder mostrato nella barra del titolo.
• Supervision.HubAddress : L'URL per connettersi all'Hub.
• Supervision.UpdatesPeriod : La frequenza degli aggiornamenti delle chiamate al Hub. (predefinito 2 secondi)

Controllori di scripting per apparecchiature (Javascript)

Un controllore di scripting per equipaggiamento è uno script Javascript chi viene giustiziato per tutte le apparecchiature che controlla ogni volta che si verifica un evento.

Per poter associare uno script di comportamento a un dispositivo, ci sono diverse regole che possono essere configurate nella regola di importazione dello script.

Associa uno script a una famiglia di dispositivi

Il modo più semplice per associare uno script a tutti i dispositivi di una famiglia è semplicemente inserire il cognome nella regola di importazione.

Nel seguente esempio, creiamo uno script per personalizzare il comportamento di tutte le apparecchiature appartenenti alla famiglia dei "lampioni stradali".

Associa uno script a più famiglie di apparecchiature

Nel caso in cui si voglia che lo script si applichi a diverse famiglie di dispositivi, è possibile separare i diversi cognomi con il carattere "|".

Nel seguente esempio, creiamo uno script per personalizzare il comportamento di tutte le apparecchiature appartenenti alla famiglia "Lampioni stradali" o "Sensori di temperatura".

Associa uno script a tutta l'attrezzatura

In alcuni casi, vuoi che venga eseguito uno script per tutte le apparecchiature, basta inserire come regola di importazione: ".*".

Associare uno script a dispositivi con una determinata variabile

Molto utile per gli script generici, è possibile che uno script venga eseguito solo per dispositivi che hanno una variabile. Per farlo, basta circondare il nome di una variabile con "$( )".

Nel seguente esempio, lo script di documentazione verrà eseguito solo per dispositivi che hanno una variabile chiamata "Documentation Url". Così, lo script poteva aggiungere un pulsante per aprire la documentazione e usare il valore della variabile "Documentation URL" per aprire la documentazione corretta.

Ecco un esempio di script che mostra un messaggio quando si seleziona un apparecchiaturo:

// Affichage d'un message sous forme de popup lorsqu'un équipement est sélectionné
function OnSelectionChanged(equipement, isSelected)
{
  if (isSelected)
  {
    Immersive.App.ShowPopup("Message", " Hello World ! ");
  }
}