Accueil > Studio X8 > Utiliser des fonctions avancées > Isotools Template Language (ITL)
 

Isotools Template Language (ITL)

Description des structures objet en standard dans Isotools Studio X8

Dans cette page, nous vous décrivons les principales structures objet de l'application Isotools Studio. Vous pourrez ensuite retrouver la description de ces structures en téléchargeant les fichiers MDC.

En standard, Isotools Studio X8 contient des services dynamiques utilisant la technologie des structures orientés objet. Chaque service peut utiliser un ou plusieurs des structures de données du site qui ne sont pas exposées dans la vue Configurer.

Toutefois, pour configurer des présentations personnalisées de ces informations à l’aide d’éléments SDS, il est nécessaire de connaître les attributs de chaque structure notamment leurs noms internes. Ces noms internes, également appelés Symboles, sont regroupés dans le sous-menu contextuel du même nom disponible grâce au nouveau système d’aide à la saisie intelligent. Ce système s'active à l'aide de la fonction Expression de la barre d'outils (lorsque le contenu de la propriété est actif).

Parmi les structures de données existant en standard dans Isotools Studio, on distingue notamment :

 

Structure de données

Utilisé par ...

alb:resource

l’attribut Document partagé. Il s’agit de la structure de base de tout fichier partagé qui sera présenté dans l’album du site en ligne.

alb:image

l’attribut Image partagé. Il s’agit de la structure des documents de type image. Il s’appuie sur le modèle « alb:resource » qu’il vient enrichir d’attributs supplémentaires.

alb:private_resource

l’attribut Document. Il s’agit de la structure de base de tout fichier privé. Son caractère privé fait qu’il n’est pas présenté dans l’album du site en ligne mais uniquement uploadé dans le répertoire correspondant du site.

alb:private_image

l’attribut Image. Il s’agit de la structure des documents privés. Il s’appuie sur la structure « alb:private_resource » qu’il vient enrichir d’attributs supplémentaires. Comme l’attribut Document, son caractère privé fait qu’il n’est pas présenté dans l’album du site en ligne.

omc:stringList

l’attribut Choix dans une liste au niveau de la liste de valeurs associée.

omc:stringItem

l’attribut Choix dans une liste au niveau de chaque valeur de la liste associée.

kwd:keyword

l’attribut Mots-clés

ocs:card

toute fiche OCS car il s’agit de la structure générique d’une fiche de classeur OCS.

ocs:catalog

tout classeur de fiches car il s’agit de la structure générique d’un classeur de fiches OCS.

ocs:log

tout classeur de fiches car il s’agit de la structure de l’historique utilisé pour toutes les fiches dans le back Office de contribution en ligne.

ocsRSS:feed

tout classeur de fiches (et autres types d’informations) qui nécessitera le partage de ses données via la syndication RSS.

ocsNewsEvent:card

toute fiche OCS d’un classeur d’actualités ou d’événements en ligne car il s’agit de la structure générique utilisé par ces deux types de fiche.

ocsNewsEvent:news

toute fiche OCS d’un classeur d’actualités

ocsNewsEvent:event

toute fiche OCS d’un classeur d’événements

ocsPlp:people

toute fiche OCS d'un classeur de personnes (annuaire)

ocsHlp:faq

toute fiche OCS d'un classeur de questions / réponses

ocsCol:report

toute fiche OCS d'un classeur de comptes rendus de réunion

ocs:Ecard:card_ecard

toute fiche OCS d'un classeur de cartes postales électroniques

ocsRb:room

toute fiche OCS d'un classeur de salles

dm:card_[nom_du_classeur]

toute fiche OCS d’un classeur personnalisé

 

Structure objet ressources publiques du site en ligne (alb:resource et alb:image)

Les ressources dites publiques sont des documents ou des images ajoutés pour le remplissage d’un champ de la structure. En outre, leur caractère public induit qu’ils sont présentés dans l’album du site en ligne. Ainsi, elles ont la particularité de pouvoir être utilisées plusieurs fois dans le back Office de contribution ou le site en ligne.

Dans les ressources publiques, on distingue la structure générique resource qui correspond typiquement à l’attribut Document partagé et la structure enrichie image correspondant à l’attribut Image partagée. Ce dernier utilise les attributs du premier par héritage en l’enrichissant d’attributs supplémentaires. Ces structures sont identifiées par les noms internes suivants :

  • structure alb:resource

  • structure alb:image

Ces structures de ressources publiques sont composées des attributs suivants :

 

Structure de données

Attributs de la structure

Ressource Document partagé : alb:resource

URLDir (URL du répertoire de stockage)

fileName (Nom du fichier)

extension (Format)

mimeType (Type MIME)

fileSize (Taille du fichier)

fileDate (Date de dernière modification)

creationDate (Date de création du fichier)

label() (Titre)

description (Description saisie lors de l’insertion dans l’album)

URL (URL dans le site diffusé)

absoluteURL (URL absolue dans le site diffusé)

iconURL (URL de l’icône associée lorsqu’on utilise le gestionnaire d’icône dans le site)

Ressource Image partagée : alb:image

height (Hauteur de l’image)

width (Largeur de l’image)

 

Structure objet ressources privées (alb:private_resource et alb:private_image)

Comme les ressources publiques, les ressources dites privées sont des documents ou des images. Par contre, leur caractère privé induit une utilisation unique dans le back Office de contribution ou dans le site. C’est pourquoi, elles ne sont pas exposées dans l’album du site en ligne.

Dans ces ressources, on distingue, comme dans les ressources publiques, une structure générique private_resource correspondant à l’attribut Document et une structure enrichie private_image correspondant à l’attribut Image. Ce dernier utilise les attributs du premier par héritage en l’enrichissant d’attributs supplémentaires. Ces structures sont identifiées par les noms internes suivants :

  • structure alb:private_resource

  • structure alb:private_image

Les structures de ressources privées sont composées des attributs suivants :

 

Structure de données

Attributs de la structure

Ressource Document : alb:private_resource

URLDir (URL du répertoire de stockage)

fileName (Nom du fichier)

extension (Format)

mimeType (Type MIME)

fileSize (Taille du fichier)

fileDate (Date de dernière modification)

creationDate (Date de création du fichier)

label() (Titre)

description (Description saisie lors de l’insertion dans l’album)

URL (URL dans le site diffusé)

iconURL (URL de l’icône associée lorsqu’on utilise le gestionnaire d’icône dans le site)

Ressource Image : alb:private_image

height (Hauteur de l’image)

width (Largeur de l’image)

 

Lorsque vous créerez une structure de données personnalisée contenant des attributs documents ou images, il ne sera pas nécessaire d’ajouter des attributs pour renseigner les informations sur le fichier car l’attribut les récupèrera par défaut.

Structures objet Liste de valeurs et valeur de liste (omc:stringList et omc:stringItem)

Les structures d’objet Liste de valeurs omc:stringList et Valeur de liste omc:stringItem décrivent les attributs d’une liste et ceux de chaque valeur d’une liste. Elles sont associées l’une à l’autre par le biais des attributs « list » et « item » (une valeur appartenant à une liste et une liste contenant des valeurs). Elles sont utilisées indirectement par l’attribut Choix dans une liste dont le fonctionnement dépend de son association à une liste de valeurs. Chaque liste de valeurs est créée indépendamment de la structure.

Ces structures sont donc composées des attributs suivants :

 

Structure de données

Attributs de la structure

Liste de valeurs : omc:stringList

name (identifiant de la liste)

label (libellé de la liste)

sourceOrder (critère de tri des valeurs dans la liste sous la forme rank pour Rang ou label pour Libellé)

dirOrder (direction du tri dans la liste sous la forme 0 pour l’option Par valeur descendante et 1 pour l’option Par valeur ascendante)

item (association multiple vers la liste des valeurs correspondante)

Valeur de liste : omc:stringItem

name (clé de la valeur)

abbrev (abréviation)

label (libellé de la valeur)

rank (rang dans la liste)

list (association simple vers la liste d’appartenance de la valeur)

 

Structure objet Mots-clés (kwd:keyword)

La structure d’objet Mots-clés kwd:keyword est utilisée par l’attribut Mots-clés. Elle est composée des attributs suivants :

  • gid (attribut interne Isotools),

  • identifier (identifiant du mot-clé utilisé pour spécifier une racine de mots-clés),

  • allLabels() ou Labels() (libellé du mot-clé).

Structure objet générique des fiches OCS (ocs:card)

La structure d’objet générique des fiches OCS ocs:card correspond à la structure de base utilisée par toute fiche OCS indépendamment du classeur auquel elle appartient. Elle se compose des attributs suivants :

  • ocsStatus (attribut interne Isotools),

  • ocsCompiledStatus (renvoi l’état de la fiche sous la forme 0 pour En rédaction, 1 pour A valider,  2 pour Publiée et 3 pour Archivée),

  • ocsValidated (Fiche dont l’état est « Publiée »),

  • ocsCompiledVisibilityRights (booléen true / false qui est à true si l’utilisateur a le droit de voir la fiche),

  • ocsCreationDate (date de création de la fiche),

  • ocsCreationLogin (login du créateur de la fiche),

  • ocsModificationDate (date de dernière modification de la fiche),

  • ocsModificationLogin (login du dernier modificateur de la fiche),

  • ocsCatalog (classeur d’appartenance de la fiche),

  • ocsVisibility (attribut interne Isotools),

  • ocsLogs (association multiple vers une liste d’entrée d’historique ou log. Il nécessite de spécifier l’information souhaitée par l’ajout d’une méthode).

Structure objet générique aux classeurs de fiches OCS (ocs:catalog)

Comme pour les fiches OCS, il existe une structure de données pour les classeurs de fiches : ocs:catalog. Elle comprend les attributs suivants :

  • name (libellé du classeur),

  • urlBackoffice (URL du classeur dans le back Office de contribution en ligne),

  • backOfficeAccessRights (droits d’accès au classeur dans le back Office de contribution en ligne),

  • redactionRights (droits de rédaction dans le classeur),

  • validationRights (droits de validation dans le classeur),

  • useValidation (booléen true / false indiquant si l’on utilise le cycle de validation dans le classeur),

  • useXRM (booléen true / false indiquant si l’on utilise le serveur de personnalisation dans le classeur).

Structure objet d’une entrée d’historique de fiche de classeur OCS (ocs:log)

Dans le back Office de contribution, chaque fiche à un historique dont les entrées suivent la structure ocs:log. Pour toute entrée dans l’historique, cette structure se compose des attributs suivants :

  • card (association simple vers la fiche),

  • date (date de l’entrée d’historique),

  • comment (note d’historique),

  • userLogin (login de l’utilisateur ayant enregistré la fiche quelle que soit la modification effectuée),

  • cardStatus (état de la fiche lors de son enregistrement entraînant la création de l’entrée d’historique sous la forme 0 pour En rédaction, 1 pour A valider, 2 pour Publiée et 3 pour Archivée).

Structure objet d’un flux RSS (ocsRSS:feed)

Dans le site, vous pouvez définir des flux RSS pour la syndication des fiches d’actualités ou d’événements. Chaque flux utilise une structure de données ocsRSS:feed dont les attributs sont les suivants :

  • name (libellé du flux),

  • visibilityRights (attribut interne Isotools).

Structure objet générique aux fiches de classeur d’actualités et d’événements (ocsNewsEvent:card)

La structure objet générique aux fiches de classeur d’actualités ou d’événements ocsNewsEvents:card contient les attributs utilisés dans toute fiche de classeur d’actualités ou d’événements tels que :

  • title (titre de la fiche),

  • catchLine (accroche de la fiche affichée généralement dans un sommaire),

  • summary (résumé de la fiche),

  • body (corps de texte de la fiche),

  • copyright (copyright),

  • author (auteur de la fiche)

  • startVisibilityDate (date de début de visibilité),

  • endVisibilityDate (date de fin de visibilité),

  • writingDate (date de rédaction de la fiche),

  • image (illustration principale de la fiche),

  • keywords (association multiple vers la liste des mots-clés du gestionnaire de mots-clés du site. Il nécessite donc de spécifier l’information souhaitée par l’ajout d’une méthode).

Structure objet des fiches d’un classeur d’actualités (ocsNewsEvent:news)

La structure objet des fiches d’un classeur d’actualités ocsNewsEvent:news s’appuie essentiellement sur la structure générique des fiches de classeurs d’actualités et d’événements (ocsNewsEvent:card). En effet, l’objectif visé par la conception d’une structure supplémentaire repose sur la volonté de permettre l’enrichissement de cette structure à partir d’Isotools Builder. Elle contient donc tous les attributs précédemment cités.

Structure objet des fiches d’un classeur d’événements (ocsNewsEvent:event)

La structure objet des fiches d’un classeur d’événements ocsNewsEvent:event s’appuie sur la structure générique des fiches de classeur d’actualités et d’événements qu’elle enrichit des attributs suivants :

  • location (lieu de l’événement),

  • period (complément d’informations sur la période de l’événement en dehors de ses dates),

  • startDate (date de début de l’événement),

  • endDate (date de fin de l’événement).

Structure objet des fiches d’un classeur de personnes (ocsPlp:People)

La structure objet des fiches d’un classeur de personnes d'un annuaire ocsPlp:People se compose des attributs suivants :

  • civility (salutation),

  • firstName (Prénom),

  • lastName (Nom),

  • birthDate (Date d'anniversaire),

  • fonction (Fonction),

  • address (Adresse postale),

  • city (Ville),

  • postalCode (Code postal),

  • phoneNumber (Téléphone),

  • fax (Télécopie,

  • mobileNumber (Mobile),

  • email (Adresse email),

  • photograph (Photo d'identité),

  • letterAssociated (Lettre pour le classement par ordre alphabétique),

  • filter (Mots-clés).

Structure objet des fiches d’un classeur de questions / réponses (ocsHlp:faq)

La structure objet des fiches d’un classeur de questions / réponses ocsHlp:faq se compose des attributs suivants :

  • question (Question),

  • answer (Réponse),

  • filter (Mots-clés utile au regroupement des questions par thème).

Structure objet des fiches d’un classeur de comptes rendus de réunion (ocsCol:report)

La structure objet des fiches d’un classeur de comptes rendus de réunion ocsCol:report se compose des attributs suivants :

  • title (Libellé),

  • groupName (Nom du groupe),

  • meetingType (Type de réunion),

  • meetingDate (Date de la réunion),

  • place (Lieu),

  • attendees (Personnes présentes),

  • absentees (Personnes absentes),

  • presidentName (Nom du président),

  • secretaryName (Nom du secrétaire),

  • agenda (Ordre du jour),

  • document (Document),

  • filter (Mots-clés).

Structure objet des fiches d’un classeur d'images de cartes postales électroniques (ocs:Ecard:card_ecard)

La structure objet des fiches d’un classeur de cartes postales électroniques ocsEcard:card_ecard se compose des attributs suivants :

  • cardimg (Image de carte postale),

  • title (Légende),

  • keywords (Mots-clés).

Structure objet des fiches d’un classeur de salles (ocsRb:room)

La structure objet des fiches d’un classeur de salles ocsRb:room se compose des attributs suivants :

  • name (Nom),

  • capacity (Capacité),

  • area (Surface),

  • description (Description),

  • picture (Photo),

  • location (Localisation),

  • document (Plan d'accès),

  • windows (Fenêtres),

  • disabled_access (Accès handicapé),

  • bookable (Réservable),

  • managerValidation (Validation par le gestionnaire),

  • startHour (Heure de début),

  • endHour (Heure de fin),

  • minSpan (Durée minimum),

Pour : Isotools Studio X8

Publiée le 01/01/2011 | ID : KB_2010ITL_STRUC10

>> Evaluez cette documentation

Image Captcha