Réglages de Flow, fichier config et dossiers

Le fichier config

Le fichier config à la racine de Flow contient les options de l’application. Celles qui comptent :

Ligne	Signification
name	le nom affiché par l’application (modifiable dans les réglages)
$api : /fapi/	l’adresse de l’API JSON
flowstream_worker : fork	chaque FlowStream s’exécute dans son propre processus
$proxytimeout : 120	secondes dont un flux dispose pour répondre à une requête HTTP
cookie, cookie_secret	générés au premier démarrage et conservés dans databases/config.json

D’autres options sont lues quand elles existent : directory (le dossier des flux ; par défaut flowstream/ à côté de l’application), flowstream_memory (une limite de mémoire par défaut pour les nouveaux flux), flowstream_sandbox et flowstream_asfiles (transmis à chaque flux), components et templates (les premières valeurs des catalogues) et backup.

Réglages dans l’application

Le super-administrateur ouvre les réglages et trouve :

• name de l’installation ;
• components et components2 : l’adresse du catalogue de composants (un fichier db.json, par défaut https://cdn.totaljs.com/flowstream/webcomponents/db.json) et un second catalogue facultatif, pour proposer vos propres composants à côté des officiels ;
• templates : le catalogue de modèles de flux (par défaut https://cdn.totaljs.com/flowstream/templates/db.json) ;
• env : dev, test ou prod. Les flux le lisent et le modifier les redémarre tous un par un ;
• backup : chaque enregistrement des flux renomme l’ancien database.json en un fichier avec la date et la minute, database_yyyyMMddHHmm.bk ;
• token : le jeton aléatoire pour /private/ (voir l’API) ;
• darkmode et notify ;
• op_reqtoken et op_restoken : les jetons d’un OpenPlatform ; quand les deux sont définis, les personnes se connectent avec cet OpenPlatform.

Les plugins peuvent ajouter leurs propres réglages au même formulaire. Le dépôt en inclut un, Bookmarks, une liste de composants enregistrés que peuvent utiliser les personnes ayant la permission bookmarks.

Variables

Chaque flux a ses propres variables et il existe un ensemble de variables globales, tous deux modifiés dans l’éditeur ou avec Variables|read et Variables|save. Un composant les lit pour éviter de mettre adresses et clés dans le design, et un changement atteint aussitôt les flux en cours d’exécution.

Composants locaux : --components--

Le dossier --components-- du dépôt contient quelques composants livrés avec l’application : checkfreespace, checklog, checkpg, checkurl, console et print. Le catalogue officiel est bien plus grand, voir le dépôt des composants.

Extensions

Une extension ajoute quelque chose à l’éditeur de chaque flux. Copiez un fichier .html dans le dossier extensions/ (le dépôt le documente dans --extensions--/ avec un exemple test.html) et Flow le charge pour chaque flux : la partie entre <script total> et </script> s’exécute avec le flux et le reste du fichier est ajouté à l’éditeur.

L’environnement d’un flux

Au démarrage de chaque flux, Flow lui donne le dossier où il garde ses fichiers (directory), les variables globales, le env de l’installation, sa limite de mémoire et le chargeur d’extensions (extensions.js). Un flux qui plante est redémarré par Flow, et ses statistiques (messages, en attente, erreurs, mémoire et identifiant de processus) sont renvoyées par Streams.