Exemples de fichiers de configuration XML

Des exemples sont fournis pour référence et pour illustrer l'utilisation de l'interface de configuration XML en vue de différentes configurations du portail. Avant de les utiliser, lisez consciencieusement les autres rubriques sur l'interface de configuration XML. De nombreux exemples doivent être modifiés avec un nom de page ou d'utilisateur valide pour pouvoir être utilisés.

Emplacement des exemples de fichiers

Les exemples de fichiers de configuration XML livrés avec le portail se trouvent dans le répertoire suivant : PortalServer_root/doc/xml-samples.

Liste des exemples de fichiers

Certains exemples de fichiers XML sont indiqués ci-dessous. Cette liste n'est pas complète. Tous les exemples se trouvent dans le répertoire indiqué dans la section précédente.
  • Export.xml
  • ExportRelease.xml
  • ExportPage.xml
  • ExportPageResult.xml
  • CreatePage.xml
    Remarque : Si vous ne souhaitez pas définir le titre de page pour tous ces environnements, vous devez au moins le définir pour l'environnement local par défaut de votre portail.
  • CreateCsaPage.xml
  • CreateLegacyPage.xml
  • CreatePageFromZip.xml
  • CreatePageFromTemplate.xml
  • DeployPortlet.xml
  • ClonePortlet.xml
  • ModifyPortlet.xml
  • ExportPortletAndPage.xml
  • ExportSubTree.xml
  • UpdateAccesscontrol.xml
  • UpdateVault.xml
  • CopyPage.xml
  • CreateURL.xml
  • CreateUser.xml
  • CreateLanguage.xml :
    Cet exemple XML ajoute une nouvelle langue pour le portail ou supprime une langue existante du portail.
    Remarque : Pour définir une nouvelle langue pour votre portail, définissez dans le fichier XML le titre de la nouvelle langue dans tous les environnements locaux pris en charge par votre portail. Si vous ne souhaitez pas définir ce titre pour tous ces environnements, vous devez au moins le définir pour l'environnement local par défaut de votre portail.
  • DeployTheme.xml
  • ExportAllPortlets.xml
  • Transaction.xml
  • MovePage.xml
    Remarque : Le déplacement effectif de la page est réalisé par les deux dernières lignes.
  • ActivatePortlet.xml

    Utilisez cet exemple pour activer ou désactiver les portlets, les applications de portlets ou les applications Web en affectant à l'attribut active de la balise appropriée la valeur true (actif) ou false (inactif). Le modèle active les ressources respectives.

  • Task.xml

    Cet exemple crée une tâche du planificateur, com.ibm.portal.datastore.task.ResourceCleanup, afin de nettoyer les ressources du portail.

  • RegisterPreDeployedEAR.xml
    Utilisez cet exemple pour installer un portlet prédéployé. Vous devrez peut-être modifier ce modèle en fonction de vos besoins.
    Notes : Pour le deploy_target_directory dans la balise url, spécifiez le répertoire dans lequel vous avez déployé le fichier EAR sur WebSphere® Application Server. Le répertoire cible par défaut est AppServer, mais lorsque vous déployez des portlets pour votre portail, il est intéressant de définir PortalServer comme répertoire cible.

    Une archive d'application d'entreprise(EAR) peut contenir plusieurs fichiers d'archives d'application Web (WAR). Pour configurer les ressources de portlet pré-déployé dans votre portail, vous devez référencer toutes les ressources d'application Web individuellement dans le script de configuration XML. Indiquez une instruction <web-app> dédiée avec les données correspondantes dans le script XML pour chaque fichier WAR contenant une application de portlet dans ce fichier EAR.

  • CleanupUsers.xml

    Vous pouvez utiliser cet exemple pour identifier des utilisateurs et groupes dans votre base de données de portail qui ont été supprimés du registre d'utilisateurs, mais pas de la base de données du portail. Pour que le fichier fonctionne bien, vous devez définir les deux attributs cleanup-users et export-users sur true . L'exécution de ce fichier modèle permet d'obtenir un fichier qui énumère ces utilisateurs et groupes et les marque pour suppression. Le fichier obtenu énumère également tous les utilisateurs qui ont été mis en sommeil, par exemple après un trop grand nombre de mauvais mots de passe. Avant de réimporter le fichier, vérifiez-le et retirez tous les utilisateurs et groupes que vous voulez conserver dans la base de données de portail. Lors de l'importation XML, tous les utilisateurs et les groupes restant répertoriés dans le fichier seront supprimés de la base de données du portail.

    Remarque : Après la suppression de ces entrées via le script XML modifié, toute les personnalisations affectant les utilisateurs et les groupes supprimés sont perdues.
  • ExportIncludingOrphanedData.xml

    Vous pouvez utiliser ce fichier modèle pour exécuter une exportation comprenant toutes les données orphelines. Cette action vise à préparer la suppression des données orphelines. Notez que cet exemple utilise le type de demande export-orphaned-data.