Création de styles ou de présentations à l'aide d'un fichier JSON

Vous pouvez ajouter de nouveaux styles ou des nouvelles présentations à la barre d'outils à l'aide d'un fichier JSON. Parfois, les composants en dehors du thème souhaitent ajouter un nouveau style ou une nouvelle catégorie sans modifier les fichiers de thème existants. Les composants peuvent facilement être ajoutés au thème par le biais d'un livrable du catalogue à l'aide de scripts et de l'utilitaire Solutions Installer.

Procédure

Créez de nouveaux styles et de nouvelles présentations.
Téléchargez les styles et les présentations sur le portail. Les exemples de style et de présentation prêts à l'emploi se trouvent dans WebDAV, dans dav:fs-type1/themes/Portal8.5/css/ et dav:fs-type1/themes/Portal8.5/layout-templates.
Créez un fichier JSON pour répertorier et définir les nouveaux styles et les nouvelles présentations. Basez le fichier JSON de style sur le format indiqué dans la rubrique Création d'un thème. Les fichiers JSON par défaut peuvent servir d'exemples ; ils se trouvent dans WebDAV sous dav:fs-type1/themes/Portal8.5/system/.
Ajoutez les nouveaux fichiers JSON au portail.

Ajoutez des métadonnées de thème pour chaque fichier JSON. Les clés de métadonnées sont ibm.portal.shelf.style.json.component et ibm.portal.shelf.layout.json.component, pour les fichiers JSON de style et de présentation, où component peut être toute chaîne identifiant de manière unique la contribution. Les valeurs des métadonnées sont des URL pointant vers l'emplacement du fichier JSON. Les valeurs qui débutent par une barre oblique ( / ) sont traitées comme des URL absolues et toutes les autres valeurs sont lues par rapport au dossier racine du thème. Par défaut, le dossier racine du thème se trouve dans WebDAV à dav:fs-type1/themes/Portal8.5/

L'exemple suivant présente les métadonnées de thème de style et de présentation pour un composant nommé myAdditions :

<parameter name="ibm.portal.shelf.style.json.myAdditions" type="string" update="set">

     <![CDATA[system/myNewStyles.json]]&gt;</parameter>

     <!-- This URL will be read relative to the theme root folder -->

<parameter name="ibm.portal.shelf.layout.json.myAdditions" type="string" update="set">

     <![CDATA[/myContextRoot/layouts/myNewLayouts.json]]&gt;</parameter>

     <!-- This is an absolute URL to a custom war file -->

Pour créer et exécuter un script d'accès XML, utilisez l'exemple suivant comme modèle.

<?xml version="1.0" encoding="UTF-8"?>
<request build="wp85" type="update" version="8.5"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:noNamespaceSchemaLocation="PortalConfig_8.5.0.xsd">
	<portal action="locate">
		<theme action="update" active="true"
			default="true" domain="rel"
			resourceroot="dynamicSpots" uniquename="ibm.portal.85Theme">
			<parameter name="ibm.portal.shelf.style.json.myAdditions" 
type="string" update="set">
       <![CDATA[system/myNewStyles.json]]&gt;</parameter> 
       <!-- This URL will be read relative to the theme root folder --> 
    <parameter name="ibm.portal.shelf.layout.json.myAdditions" type="string" update="set">
       <![CDATA[/myContextRoot/layouts/myNewLayouts.json]]&gt;</parameter>
       <!-- This is an absolute URL to a custom war file -->
		</theme>
	</portal>
</request>

Copiez le script dans PortalServer_root/bin.
Exécutez la commande XML Access : xmlaccess -user user -password password -url localhost:port/wps/config -in AddCategories.xml -out AddCategoriesOutput

Connectez-vous au portail et cliquez sur Mode édition.
Vérifiez que les nouveaux styles et les nouvelles présentations sont présents :
- Si vous disposez d'un portail avec un groupe de correctifs combinés CF08 ou de niveau ultérieur, procédez comme suit :
  1. Cliquez sur le menu contextuel pour une page dans l'arborescence du gestionnaire de site.
  2. Click Open Page Settings.
  3. Cliquez sur l'onglet Style ou Présentation pour afficher des présentations ou des styles.
- Si vous disposez d'un portail avec un groupe de correctifs combinés 7 ou de niveau antérieur, procédez comme suit :
  1. Sélectionnez l'onglet Page.
  2. Sélectionnez ensuite l'onglet Style ou Présentation.