Sandbox

Le bac à sable vous permet de créer un environnement de développement dédié aux librairies présentées dans cette documentation.
La présence de MainLib vous donne la possibiité d'envoyer votre projet à Manager.
Les bacs à sables sont très utiles si vous souhaitez partager ou tester des fonctionnalités nouvelles, ou pour illustrer des exemples de codes.

Accéder au bac à sable

StackBlitz

Afin de fonctionner, le bac à sable utilise les WebContainers de StackBlitz afin de créer un serveur node.js directement dans le navigateur.

Les WebContainers peuvent être un peu capricieux à démarrer sur des navigateurs restrictifs.
WebContainers StackBlitz

Tailwind

Pour construire vos vues WinCC, le bac à sable embarque avec lui TailwindCss.
Vous avez donc accès à toutes les classes de Tailwind pour positionner vos éléments.

Tailwind

Autorisations

Il est recommandé de créer un profil dédié aux bacs à sables dans Manager, et de limiter les autorisations à l'obtention des données d'authentification, de matériel et les requêtes de compilations pour automate et hmi.

Il est fortement déconseillé d'accorder un rôle SuperAdmin à un bac à sable.
Même si celui-ci n'entravera pas le fonctionnement de Manager, le bac à sable vous enverra un messsage d'avertissement si il a trop de privilèges.

Index.ts

Le fichier index.ts est le point d'entrée du bac à sable, il ne peut être ni fermé, ni supprimé.
Lorsque vous appuyez sur Run, le bac à sable envoi tous vos fichier au serveur de dévellopement, cependant seul les exports définis dans index.ts seront affichés.

L'éditeur du bac à sable gère tout seul l'implémentation des appareils vérrouillés.

import LockedPlc from "./plc"
import LockedHmi from "./hmi"

Ces deux lignes sont toujours présentes dans le fichier index.ts et seulement dans ce fichier.
Ces importations se mettent à jour seules et possèdent des marqueurs vous informatn de l'état des appareils vérouillés.

Compilation

Vous pouvez envoyer le contenu du bac à sable à Manager afin que celui-ci tente de le compiler.
L'appui sur Compile vous affiche une fenêtre vous demandant confirmation des éléments à envoyer.

Il est nécèssaire pour UnifiedBuilder d'avoir une cible Hmi valide car le calcul des positions des éléments se fais via une simulation de cette hmi.