Portál poskytuje úlohu konverzie portletov, ktorá vám umožňuje konvertovať nastavenia a inštancie portletov IBM® API na zodpovedajúce portlety štandardného rozhrania API. Je to užitočné, ak plánujete nahradiť portlety rozhrania API IBM portletmi štandardného rozhrania API.
Informácie o úlohe
Túto úlohu môžete použiť nasledovne: úloha konverzie portletu konvertuje nastavenia portletu rozhrania API IBM na preferencie portletu štandardného rozhrania API. Konvertuje tiež inštancie portletu rozhrania API IBM na inštancie portletu štandardného rozhrania API. Prispôsobené užívateľské údaje portletu, ktoré sú spojené s inštanciou portletu, sa skonvertujú na preferencie portletu štandardného rozhrania API.
Ak chcete konvertovať inštancie a nastavenia portletu rozhrania API IBM na portlet štandardného rozhrania API, vykonajte tieto kroky:
Procedúra
- Nainštalujte portlet štandardného rozhrania API, ktorým chcete nahradiť portlet rozhrania API IBM.
- Vytvorte súbor vlastností konverzie portletu, ktorý identifikuje portlet rozhrania API IBM a portlet štandardného rozhrania API. Ak to chcete spraviť, vytvorte alebo aktualizujte tento súbor:
AppServer_root/ConfigEngine/properties/portletconversion.properties
Potvrďte, že nasledujúce parametre sú nastavené, ako je uvedené, alebo ich podľa potreby upravte:
- Pre portlet rozhrania API IBM:
-
- ibmwebapp.uid
- UID webovej aplikácie, ktorá obsahuje portlet rozhrania API IBM. Táto vlastnosť je povinná.
- Parametre na identifikáciu portletu rozhrania API IBM:
- Ak chcete identifikovať portlet rozhrania API IBM, zadajte jeden z týchto troch parametrov: názov portletu, ID objektu alebo jedinečný názov portletu rozhrania API IBM:
- ibmportlet.portletname
- Názov portletu rozhrania API IBM.
- ibmportlet.uniquename
- Jedinečný názov portletu rozhrania API IBM.
- ibmportlet.objectid
- ID objektu portletu rozhrania API IBM.
- Pre štandardný portlet:
-
- jsrwebapp.uid
- UID webovej aplikácie, ktorá obsahuje portlet štandardného rozhrania API. Táto vlastnosť je povinná.
- Parametre na identifikáciu portletu štandardného rozhrania API:
- Ak chcete identifikovať portlet štandardného rozhrania API, zadajte jeden z týchto troch parametrov: názov portletu, ID objektu alebo jedinečný názov portletu štandardného rozhrania API:
- jsrportlet.portletname
- Názov portletu štandardného rozhrania API.
- jsrportlet.uniquename
- Jedinečný názov portletu štandardného rozhrania API.
- jsrportlet.objectid
- ID objektu portletu štandardného rozhrania API.
- Ďalšie parametre:
-
- pages.uniquename
- Tento
parameter je voliteľný. Zadajte zoznam jedinečných názvov stránok oddelených čiarkou. Ak zadáte tento parameter, skonvertujú sa iba portlety na týchto stránkach a ich potomkovia. Ak tento parameter necháte prázdny alebo bude chýbať, skonvertujú sa inštancie portletov rozhrania API IBM na všetkých stránkach.
- converter
- Názov triedy konvertora, ktorý zavolá úloha porltetconversion, a ktorý vykoná konverziu nastavení portletu a údajov portletu. Trieda konvertora musí implementovať rozhranie com.ibm.portal.portletconversion.Converter.
Tu môžete zadať predvolený konvertor com.ibm.wps.pe.task.DefaultConverter.
Tento konvertor vykoná základnú konverziu filtrovaním údajových položiek portletu, ktorých typ je String.
- converter.classpath
- Zoznam súborov a zložiek oddelených bodkočiarkou, ktoré sa pridajú do cesty k triedam, aby sa dala načítať trieda konvertora.
- xmlaccess.url
- Adresa URL pre servlet konfiguračného rozhrania XML portálu. Tento parameter môžete použiť na spustenie konverzií pre špecifické virtuálne portály.
Ak je tento parameter prázdny alebo chýba, na spustenie konverzie sa použije predvolený portál.
- Prejdite do adresára AppServer_root/PortalServer/ConfigEngine/
- Spustite úlohu konverzie portletu ConfigEngine convert-portlets.
- Skontrolujte konverziu kontrolou konzoly. Správa Zostavenie bolo úspešné označuje úspešnú konverziu. Ak sa po dokončení úlohy zobrazí správa Zostavenie zlyhalo, pozrite si predošlé kroky.
- Po úspešnej konverzii môžete nainštalovať portlet rozhrania API IBM.
Príklad
Príklady súborov
portletconversion.properties:
ibmportlet.objectid=3_O4C9FI930GPE90IGU02QAR0006
jsrportlet.objectid=3_O4C9FI930GPE90IGU02QAR00G3
ibmwebapp.uid=DCE:472fb1b0-3d22-1211-0000-005da8cf7ayz:2
jsrwebapp.uid=StdPortletDataTestPortlet.war.webmod
converter=com.ibm.wps.pe.task.DefaultConverter
ibmportlet.portletname=An PortletData test portlet
jsrportlet.portletname=StdPortletDataTestPortlet
ibmwebapp.uid=DCE:472fb1b0-3d22-1211-0000-005da8cf7ayz:2
jsrwebapp.uid=StdPortletDataTestPortlet.war.webmod
converter=com.ibm.wps.pe.task.DefaultConverter