Premiers pas avec SCENARIbuilderGlossaire
A-B
- appMakeConstructeur d'application
Pour transformer vos modèles en applications autonome, on utilise un fichier
.appMake: un constructeur d'application. Son usage est décrit sur la page du wiki appMake.AtelierProjet WorkspaceEnvironnement de travail, rassemblant l'ensemble des données. constituants les documents.
Deux ateliers sont hermétiques entre eux, ils ne peuvent partager aucune donnée.
Axisaxe de transformationLe rôle des axis est de définir plusieurs versions d'un même transformer, qui peuvent publier la même donnée de plusieurs manières différentes. Autrement dit : Un axis est une variante d'un transformer, il permet de parcourir un .model dans un contexte particulier.
C-D
- Code
Un code est une chaîne de caractères alphanumériques non accentués, sans espace ni caractères spéciaux.
Exemple : "legalBlock" mais pas "Bloc réglementaire".
Contenu externalisédésigne un contenu faisant l'objet d'un item distinct de l'item utilisé pour structurer un document. L'item correspondant apparaît dans le volet d'exploration et peut être réutilisé dans le document en cours ou dans un autre document.
Contenu internalisédésigne un contenu saisi et enregistré dans la grille de saisie d'un item structurant un document.
dataFormPrimitive de MétadonnéesPermet de créer des modèles de champs de données structurées. Se rapproche de la représentation d’un formulaire.
E
- Écran de contrôle
La vue
Contrôlesdu.wspdefpermet de contrôler les points techniques critiques sources de dysfonctionnement d'un modèle : les erreurs de modélisation, de paramétrage des publications.EspaceRépertoire DossierUn espace permet de classer des items, de les hiérarchiser. Il est possible d’inclure des espaces dans d’autres espace, cela forme alors ce qu’on appelle une arborescence.
externe (item)Un item externe est un contenu faisant l'objet d'un item autonome, apparaissant dans le système de fichiers.
F-I
- Générateur.generator
Un générateur est un ensemble d'instances de primitives permettant de spécifier les règles de publication d'un support dans un format donné.
Pour chaque entrée souhaitée dans les vues
Publication, on crée en un générateur.generator, du type de sortie que l’on souhaite avoir : web/xhtml ou openDocument.Générateurs (Les)Si vous créez un modèle sans générateurs, les auteurs vont pouvoir écrire du contenu, mais il ne sortira jamais de sa forme "source XML". Pour transformer les données saisies, l'auteur utilise les générateurs intégrés au modèle. Vous devez créer ces générateurs dans SCENARIbuilder, les lier et les adapter à la structure de votre modèle.
interne (contenu)Un contenu interne est une structure logique comprise dans la structure de son item parent.
itemun item est un objet de la chaîne éditoriale respectant un certain schéma de données, pouvant être réutilisé dans plusieurs documents.
Il est matérialisé dans le volet d’exploration.
J-M
- keyWspclé de l'atelier
Sous forme de code, est l’identifiant de votre modèle documentaire au sein de la sphère des modèles Scenari.
Il est associé à un nom d’affichage, le name, qui apparaîtra pour l’auteur lorsqu’il créera un atelier, pour définir la liste des modèles documentaires qui lui seront proposés.
modelitem de modélisation .modelComme dans toute application Scenari, un atelier contient des items et chaque item a : un nom de fichier, un type.
L’item de modélisation doit entre autres définir :
- un code : identifiant utilisé en interne par le système SCENARI. Cela doit être une suite de caractères alphabétiques, courte de préférence, où il est d'usage de le faire correspondre au nom du fichier (sauf cas particulier).
- un name : le nom tel que l'auteur peut le lire dans l'interface d'édition. Il peut contenir des espaces et des caractères accentués.
Cet item sert à spécifier quels champs ou paragraphes de données seront disponibles à l'intérieur de l'éditeur, de les paramétrer et de choisir comment ils seront organisés entre eux (et implicitement quel sera la structure XML des documents écrits par l'auteur lorsqu'ils sont enregistrés).
ModeletsBriques de modèlesEnsembles d'items SCENARI récurrents
- binaries : ressources (image, vidéo, ...);
- showPhoto : album photos avec effets visuels.
Les modelets sont des bibliothèques d'items préfabriqués, des listes de fichiers (.model ou .transf...) qui permettent à un modélisateur d'avoir des éléments prêts à être intégrés dans le modèle, ce qui est plus pratique que de commencer avec un atelier totalement vide.
N-R
- namespace et prefix
Dans les cas courants, vous allez déclarer toujours le même namespace et préfixe pour tous les fichiers d'un atelier builder. L'intérêt principal de ces informations est de permettre à différents modélisateurs de partager des modèles avec le même nom. Ces noms sont utilisés en interne dans les fichiers de contenu que l'auteur va enregistrer par les éditeurs Scenari. Le préfixe doit être court et ne pas commencer par la lettre "s" qui est réservée (s pour scenari).
publicClassesClasses publiquesTypes d'items externes que peut créer l'auteur.
RacineUne racine d'un modèle documentaire est un .model pointé par un générateur.
La racine principale n'a pas de modèle "parent", elle porte la structure du document.
S-Z
- StandaloneAutonome
On dit d'une application qu'elle est standalone lorsqu'elle peut s'executer sans avoir besoin qu'une autre application soit lancée.
Les SCENARIapp sont des applications standalone. Un modèle diffusé sous forme de
wsppackn'est pas standalone parce qu'il nécessite l'utilisation de SCENARIchain ou du couple SCENARIserver/SCENARIclient pour être lancé. SCENARIdiscovery est une application standalone. Opale et OpaleSup existent à la fois en version standalone ET en version wsppack.stylesCréer un style, c'est appliquer une charte graphique aux éléments de contenu et du template. Techniquement, le style est constitué d'un fichier
.skin.odtpour les générateurs OpenOffice ou un ensemble de fichiers.csspour les générateurs HTML.TemplateodTemplate (Papier) uiTemplate (Web)Le template permet de poser la structure des pages : en-têtes et pieds de page par exemple.
Pour les publications papier, il joue le rôle d'item transverse, alors que pour les publications web c'est l'uiFrame qui joue ce rôle.
Les templates définissent les propriétés du document publié (pour les publications OpenOffice) ou d'un type de page publiée (pour les publications HTML), et posent tous les blocs définis en dehors des transformeurs, à un niveau "au dessus" du contenu.
TransformerTransfUn transformer (
.transf) est une règle de publication d'un modèle (
.model) dans un format donné (html, odt, xml etc).Ils sont utilisés pour traduire une donnée écrite par l'auteur en donnée à l'intérieur d'un document publié. Dans les cas les plus simples, on doit en créer un par
.modelet par générateur. Ils sont référencés par des listes de transformers (fichiers.transflist) pour pouvoir être exploité par le générateur.VersionmajorVersion, mediumVersion, minorVersion : par exemple, nous créons le modèle helloworld version 0.0.1. Le changement de version peut avoir des conséquences sur les mises à jours lors de la diffusion du modèle.
wspDefItem permettant de définir un atelier (workspace) de SCENARIchain :
- les classes d'items autorisées,
- le code par défaut de l'atelier,
- la gestion des versions
- le nom du
wsppackqui sera créé - ...
projet.wspdef
