Connecteur Jalios

Prérequis

La configuration de base des connecteurs Jalios porte sur :

1. Activation des Services Web (Open API)
2. URL de base de la plateforme Jalios, et éventuellement le préfixe du chemin des URL (par défaut jcms)
3. Information de connexion à l'API REST (clé d'authentification ou nom d'utilisateur/mot de passe)
4. ID de l'espace de travail

Pour la synchronisation de publications, il s'agit de définir le type de publication et la façon d'exploiter les données des objets en question.

Les types peuvent être (liste non exhaustive) :

• generated.BlogPost
• generated.DBWikiPage
• generated.FaqEntry
• generated.JEvent
• generated.JNewsArticle
• ou tout autre type disponible dans l'instance Jalios.

Les publications récupérées afin d'être transmises à Wikit Semantics sont transformées par le connecteur dans un format intermédiaire (HTML ou Markdown). Une expression Mustache ou Handlebars permet de configurer cette transformation, par exemple :

<h1>{{{title}}}</h1>

{{intro}}

{{content}}

Activation des Services Web

Le connecteur nécessite d'avoir l'accès à l'API REST de l'instance Jalios.

1. Se connecter avec un compte administrateur Jalios
2. Se rendre dans l'espace d'administration via l'adressse https://<domaine>/admin/
3. Dans la rubrique "Administration technique", aller dans l'édition des propriétés, via le lien "Propriétés" : https://<domaine>/admin/adminProperties.jsp
4. Activer l'interface Open API en autorisant la lecture et les opérations.

Vérification du préfixe descriptif des URL

Le préfixe descriptif est utilisé pour les URL lisibles des documents et pages dans Jalios. Par défaut, la valeur jcmsest utilisé dans Jalios, elle est modifiable dans les propriétés de l’instance.

Pour vérifier le préfixe :

1. Se connecter avec un compte administrateur Jalios
2. Se rendre dans l'espace d'administration via l'adressse https://<domaine>/admin/
3. Dans la rubrique "Administration technique", aller dans l'édition des propriétés, via le lien "Propriétés" puis le bouton “Edition avancée” : https://<domaine>/admin/properties/editor/propEditor.jsp
4. Filtrer sur la propriété descriptive-urls.prefix :

Fonctionnement des types de contenu Jalios

Jalios est une plateforme de gestion de contenu implémenté avec les technologies Java (JDK, Tomcat, Hibernate, ...) qui intègre en particulier la notion de Types de Contenu, utile pour les connecteurs de synchronisation de source de données. Les types sont organisés de façon hiérarchique, en lien avec les classes Java qui implémentent les propriétés et méthodes de ceux-ci.

Les connecteurs disponibles permettent de traiter différents types de contenu pour les synchroniser dans Wikit Semantics :

• Jalios-Publication : tout contenu qui hérite du type générique Publication en exploitant les propriétés du contenu pour la préparation des fragments
• Jalios-Document : tout contenu avec fichier attaché, qui hérite du type DBFileDocument, en exploitant le fichier en question via la propriété absDownloadUrl.

Un éditeur de Type de Contenu est disponible dans l'espace d'administration à l'URL https://<domaine>/admin/typeListEditor.jsp.

L'éditeur permet de gérer les types définis pour l'instance Jalios, ainsi que de récupérer les noms techniques utiles pour la configuration des connecteurs de publication :

• Nom Java du type (i.e. le nom de la classe Java) ;
• Nom Java des champs.

A noter que les types personnalisés sont en général préfixés par le nom de package generated., par exemple generated.MonSuperTypePerso.

Ainsi, ces noms Java sont utiles pour pouvoir préciser le type à récupérer, et les champs à exploiter dans la version transformée du contenu avant ingestion dans Wikit Semantics (cf. l'expression Mustache/Handlebars).