Mise à jour de scripts et retrait de fonctions obsolètes

Pour créer un portail virtuel ayant le même contenu que le portail à partir duquel vous avez effectué la migration, vous devez préconfigurer le contenu par défaut. Vous devez également retirer ou remplacer les références aux fonctions obsolètes.

Pourquoi et quand exécuter cette tâche

Lorsque vous migrez un portail virtuel, HCL traite toutes les pages du portail comme du contenu personnalisé créé par le client. De ce fait, si le portail virtuel contient des pages associées à des fonctions indisponibles dans la nouvelle version installée, HCL migre quand même ces pages.

Par exemple, si vous migrez un portail virtuel contenant une page de bibliothèques de documents, HCL conserve cette page. Vous pouvez supprimer ces pages manuellement après avoir effectué la migration du portail virtuel.

Procédure

Enregistrez le fichier filename.xml que vous utilisiez dans le système précédent afin de préconfigurer le contenu par défaut pour créer le portail virtuel.
Remarque : Le nom du fichier peut varier en fonction de la version et des éditions du portail que vous utilisez. Ci-dessous quelques exemples de noms de fichier ; "InitVirtualContentPortal.xml, InitAdminVirtualPortal.xml."

Important : Si vous effectuez une migration vers HCL 8.5, groupe de correctifs CF04 ou de niveau supérieur, vous pouvez ignorer les étapes suivantes.

Utilisez la console WebSphere® Integrated Solutions Console pour mettre à jour les scripts XML relatifs aux portails virtuels et supprimer les références au portlet Balise Person dynamique.
Remarque : Votre script peut contenir des références à un portlet de balise de personne dynamique. Ce portlet n'est plus disponible et toute référence à ce portlet entraîne un échec de votre script.
1. Accédez à la console WebSphere® Integrated Solutions Console.
2. Click Applications > Application Types > Assets.
3. Sélectionnez VirtualPortal.zip, puis cliquez sur Exporter.
4. Retirez la séquence web-app qui inclut la balise <web-app...> d'ouverture et la balise</web-app> de fermeture, ainsi que tous les éléments inclus entre ces balises.
  Consultez l'exemple ci-dessous pour savoir comment le portlet est défini dans une séquence web-app :
```
<web-app action="locate" uid="com.ibm.wkplc.people.portal.portlet.dynamicpersontag.web.app">
  <portlet-app action="locate" uid="com.ibm.wkplc.people.portal.portlet.dynamicpersontag.portlet.app">
    <portlet action="locate" name="Dynamic Person Tag" objectid="3_CGAH47L008DE402BK8543I1O47"></portlet>
  </portlet-app>
</web-app>
```
5. Retirez la page Balise Person qui inclut la balise <content-node...> d'ouverture et la balise </content-node> de fermeture, ainsi que tous les éléments inclus entre ces balises. L'objet ids, les éléments portletrefs, sharerefs, ainsi que d'autres références illustrées dans cet exemple peuvent varier en fonction de votre installation.
  Consultez l'exemple suivant de la page qui est définie dans la séquence de noeud de contenu.
```
<content-node type="page" uniquename="ibm.portal.Person.Tag">
  <supported-markup markup="html" update="set"></supported-markup>
  <localedata locale="en">
<title>Person Tag</title>
<description>Person Tag portlet, which enables live names and information for names in IBM Portal</description>
  </localedata>
</content-node>
```
6. Sélectionnez VirtualPortal.zip, puis cliquez sur Mettre à jour.
7. Sélectionnez la valeur par défaut Remplacer la totalité de l'actif.
8. Localisez le fichier mis à jour et téléchargez le fichier.

Utilisez la console WebSphere® Integrated Solutions Console pour mettre à jour les scripts XML relatifs aux portails virtuels et supprimer les références aux portlets CAI/TAI. Par exemple, les portlets sont définis dans une séquence web-app comme les exemples ci-après.

Remarque : Votre script peut contenir des références à un portlet CAI/d'intercepteur de relations de confiance (TAI). Ces portlets ne sont plus disponibles et toute référence à ces portlets entraîne l'échec du script.

<web-app action="locate" uid="com.ibm.workplace.community.portal">
  <portlet-app action="locate" uid="com.ibm.workplace.community.portal.1">
    <portlet action="locate" name="Community" objectid="Z3_CGAH47L0008270I7MOUHLP18C5"/>
  </portlet-app>
</web-app>

<web-app action="locate" uid="com.ibm.workplace.builder.parameterPortlet.ParamConfigPortlet.40b0885181fd00171b3b9587aea11c02">
  <portlet-app action="locate" uid="com.ibm.workplace.builder.parameterPortlet.ParamConfigPortlet.40b0885181fd00171b3b9587aea11c02.1">
    <portlet action="locate" name="Parameters" objectid="Z3_CGAH47L0008270I7MOUHLP18O5"/>
  </portlet-app>
</web-app>

<web-app action="locate" uid="com.ibm.workplace.policystatus.PolicyStatus">
  <portlet-app action="locate" uid="com.ibm.workplace.policystatus.PolicyStatus.1">
    <portlet action="locate" name="Policy Status Portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18S5"/>
  </portlet-app>
</web-app>

<web-app action="locate" uid="com.ibm.workplace.builder.propertiesPortlet.portal">
  <portlet-app action="locate" uid="com.ibm.workplace.builder.propertiesPortlet.portal.1">
    <portlet action="locate" name="Properties portlet" objectid="Z3_CGAH47L0008270I7MOUHLP1845"/>
  </portlet-app>
</web-app>

<web-app action="locate" uid="com.ibm.workplace.builder.manageroles.ManageRoles.50047239651b0018123cdeae474aa5c4">
  <portlet-app action="locate" uid="com.ibm.workplace.builder.manageroles.ManageRoles.50047239651b0018123cdeae474aa5c4.1">
    <portlet action="locate" name="Roles portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18K5"/>
  </portlet-app>
</web-app>

<web-app action="locate" uid="com.ibm.workplace.cdo.portal">
      <portlet-app action="locate" uid="com.ibm.workplace.cdo.portal.1">
        <portlet action="locate" name="Application Catalog" objectid="Z3_CGAH47L00OJ790IAH1AFAN1067"/>
      </portlet-app>
    </web-app>

<web-app action="locate" uid="com.ibm.workplace.tai.tc">
      <portlet-app action="locate" uid="com.ibm.workplace.tai.tc.1">
        <portlet action="locate" name="Template Catalog Manager" objectid="Z3_CGAH47L00OJ790IAH1AFAN1060"/>
      </portlet-app>
    </web-app>

Pages qui référencent ces portlets dans des séquences telles que les exemples suivants.

<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18M7" ordinal="100" skinref="undefined" type="control" width="undefined">
  <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18E0" portletref="Z3_CGAH47L0008270I7MOUHLP18C5" shareref="Z5_CGAH47L0008270I7MOUHLP18E0"/>
</component>

<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18I0" ordinal="100" skinref="undefined" type="control" width="undefined">
  <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18I4" portletref="Z3_CGAH47L0008270I7MOUHLP18O5" shareref="Z5_CGAH47L0008270I7MOUHLP18I4"/>
</component>

<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18U4" ordinal="100" skinref="undefined" type="control" width="undefined">
  <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18U2" portletref="Z3_CGAH47L0008270I7MOUHLP18S5" shareref="Z5_CGAH47L0008270I7MOUHLP18U2"/>
</component>

<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP18Q6" ordinal="100" skinref="undefined" type="control" width="undefined">
  <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP18Q1" portletref="Z3_CGAH47L0008270I7MOUHLP1845" shareref="Z5_CGAH47L0008270I7MOUHLP18Q1"/>
</component>

<component action="update" active="true" deletable="false" domain="rel" modifiable="undefined" objectid="Z7_CGAH47L0008270I7MOUHLP1865" ordinal="100" skinref="undefined" type="control" width="undefined">
  <portletinstance action="update" domain="rel" objectid="Z5_CGAH47L0008270I7MOUHLP1863" portletref="Z3_CGAH47L0008270I7MOUHLP18K5" shareref="Z5_CGAH47L0008270I7MOUHLP1863"/>
</component>

L'attribut portletref de la balise portletinstance correspond à l'un des attributs objectid des balises de portlet dans la section web-app.

<portlet action="locate" name="Roles portlet" objectid="Z3_CGAH47L0008270I7MOUHLP18K5"/>
<portletinstance portletref="Z3_CGAH47L0008270I7MOUHLP18K5" ... />

Prenez soin de retirer la séquence web-app qui inclut la balise <web-app...> d'ouverture et la balise </web-app> de fermeture, ainsi que tous les éléments inclus entre ces balises. Retirez également les composants qui font référence aux portlets. Cela inclut notamment la balise <component ...> d'ouverture et la balise </component> de fermeture, ainsi que tous les éléments inclus entre ces balises. Les éléments object ids, portletrefs, sharerefs, ainsi que d'autres références illustrés dans cet exemple peuvent varier en fonction de votre installation.