Ha az Oracle Content Management örökölt Cloud infrastruktúrán futó, nem forgalmi díjas előfizetésű példányaival rendelkezik, az Oracle azt javasolja, hogy telepítse át ezeket a példányokat az új, eredeti 2. generációs Oracle Cloud Infrastructure (OCI) környezetbe (ez a szolgáltatáspéldányok kezeléséhez az Infrastructure Console használatát jelenti). Ez biztosítja, hogy a jövőben élvezhesse az Oracle felhőalapú platformja által nyújtott előnyöket.
Az áttelepítés elindítása előtt végre kell hajtania néhány lépést, és együtt kell működnie az Oracle terméktámogatási szolgálatával az áttelepítés ütemezése érdekében.
A táblázat az Oracle Content Management engedélycsoportjainak OCI alkalmazási szerepkörökre történő leképezését ismerteti.
Oracle Content Management engedélycsoport | OCI alkalmazási szerepkör |
---|---|
DocumentsServiceUser | CECStandardUser |
DocumentsServiceAdmin | CECServiceAdministrator |
SitesServiceVisitor | CECSitesVisitor |
SitesServiceAdmin | CECSitesAdministrator |
ContentAdministratorRole | CECContentAdministrator |
CECSStandardUser | CECStandardUser |
CECSEnterpriseUser | CECEnterpriseUser |
Megjegyzés:
Ha a célul kitűzött IDCS-tartomány már tartalmaz egy ugyanolyan felhasználónévvel rendelkező felhasználót, az OCI alkalmazási szerepkörök annak megfelelően lesznek a felhasználóhoz rendelve, hogy a felhasználó milyen engedélycsoportokkal rendelkezik az Oracle Content Management szolgáltatásban.Amikor készen áll az áttelepítésre, a folyamat elindításához el kell küldenie egy áttelepítési kérelmet:
Miután az Oracle terméktámogatási szolgálata megkapta az Ön áttelepítési szolgáltatásigénylését, az Ön által kért dátum alapján beütemezzük az áttelepítést, és a szolgáltatásigénylés az áttelepítés kezdő dátumával és időpontjával frissül.
A szolgáltatásigénylés az áttelepítés előrehaladásának megfelelően folyamatosan frissülni fog. Az adatok áttelepítése a háttérben fog végbemenni. Önnek egyetlen teendője a szolgáltatásigénylés frissüléseinek követése, és az áttelepítés érvényesítése, miután az befejeződött.
Az áttelepítés során a következő történik:
Fontos:
Ennél a pontnál Önnek nem kell végeznie semmilyen módosítást a régi (forrás) példányában. Az áttelepítés elindítása után végzett módosítások nem lesznek áttelepítve az új példányba.Megjegyzés:
A rendszer megőrzi a régi példányt arra az esetre, ha ellenőrzés céljából meg akarna benne keresni valamit. Továbbá, szüksége lesz rá a forrásanyagokat használó webhelyek áttelepítéséhez és minden olyan más forrásanyag áttelepítéséhez, amely ki volt zárva az áttelepítés során.Ha a régi példánya más szolgáltatásokkal vagy alkalmazásokkal van integrálva vagy kommunikál akár közvetlenül, akár REST API-hívásokon keresztül, lehet, hogy áttelepítés utáni feladatokat kell végrehajtania.
A következő elemek a teljes szolgáltatásra vonatkoznak:
A régi URL-címek a következő mintát használták:
https://<szolgáltatásnév>-<fióknév>.<régió>.oraclecloud.com/documents
Az új URL-címek a következő mintát használják:
https://<szolgáltatásnév>-<fióknév>.<szolgáltatástípus>.ocp.oraclecloud.com/documents
Integráció | Áttelepítés utáni teendők |
---|---|
Oracle Integration |
|
Oracle Commerce Cloud |
|
Oracle Process Cloud Service |
|
Oracle Eloqua Cloud Service |
|
Oracle Intelligent Advisor |
|
Oracle Cobrowse Cloud Service |
|
Responsys |
|
Visual Builder Cloud Service (VBCS) |
|
CDN/Akamai |
|
REST API-hívások |
|
Az ügyfél SDK/CLI-használata |
|
Csatlakozók |
|
Megjegyzés:
A régi példányában lévő tartalomhoz fűzött könyvjelzők többé nem fognak működni, mivel az új példány URL-címe megváltozott.A rendszer automatikusan áttelepíti a forrásanyagokat nem tartalmazó webhelyeket, viszont a forrásanyagokat tartalmazó webhelyek esetében további lépéseket kell végrehajtani azért, hogy működjenek az Oracle Content Management új példányában.
A "cec migrate-site" parancs új, ezért telepítenie kell az OCE Toolkit szolgáltatást a WebClient GIT adattárából akkor is, ha korábban már letöltötte és telepítette azt.
Kövesse a Sites Toolkit oldalon megjelenő utasításokat, majd töltse le és telepítse az OCE Toolkit szolgáltatást.
Regisztrálja a célkiszolgáló kapcsolódási adatait (az a kiszolgáló, amelyikre a webhelyeit áttelepíti):
> cec register-server <target_server_name> -e http://<target_server>:<target_port> -u <target_username> -p <target_password> -t pod_ec
A webhelyek áttelepítéséhez végezze el a következő lépéseket:
<site_name>
értékét arra a névre cserélve, amelyet a célkiszolgálón szereplő webhelynek szeretne adni.
> cec migrate-site <site_name> --template <template_path_and_name> --destination <registered_target_server_name> --repository <repository_name>
Miután áttelepítette a webhelyét, az 1.1-es verziójú Content REST-hívások használatával fog futni. Ez bizonyos problémákat okozhat, amelyeket a webhely megfelelő futása érdekében meg kell oldani. Az alábbiak figyelembe vételével határozza meg, hogy mit kell tennie:
Ha a webhelye megfelelően fut, át kell alakítania többnyelvű webhelynek (MLS) megfelelővé. Ha vállalati webhelyet kell létrehoznia egy külső számítási kiszolgálón, ahhoz szüksége van egy alapértelmezett nyelvre és honosítási alapszabályra. Mivel a webhelye át lett másolva, nem MLS webhely. Ezért frissítenie kell MLS webhelyre, hogy biztosan támogathassa a jövőbeni működőképességét.
A következő táblázat az MLS és a nem MLS webhely közötti különbségeket foglalja össze.
Webhelyobjektum | MLS webhely | Nem MLS webhely |
---|---|---|
Tartalomelemek | A tartalomelem nyelvváltozata fog megjelenni, nem pedig az oldalra áthelyezett tartalomelem. A nyelv attól függően változtatható, hogy a webhely megjelenítésekor milyen nyelvet kérnek. | Az oldalra áthelyezett tartalomelem mindig meg fog jelenni. |
Tartalomelrendezések | A tartalomelrendezéseknek az 1.1-es verziójú API-kat kell támogatniuk. Ha nem, a tartalomelem nem fog megjelenni, helyette figyelmeztetés lesz látható. Ennek oka, hogy az összes 1.1-es verziójú API-híváshoz egy olyan "nyelvi-területi beállítás" lesz hozzáadva, amelyet az 1.0-s verziójú API nem támogat. | A tartalomelrendezések verziója vagy 1.0-s, vagy 1.1-es lehet. Ha a tartalomelrendezés csak az 1.0-s verziót támogatja, akkor a ContentSDK a válaszban egy "adat" bejegyzést fog hozzáadni, hogy megfeleljen a "mezők" bejegyzésnek. Ezenkívül még más problémák is adódhatnak, ezért ezt nem kell "támogatott funkcióként" tekinteni, és nem frissíteni a tartalomelrendezést. |
Tartalomlisták | Csak a kért nyelvváltozatban elérhető tartalomelemek fognak megjelenni. | Az összes tartalomelem meg fog jelenni, a nyelvtől függetlenül. A felhasználónak lehetősége van arra, hogy a tartalomlistán belül egy adott nyelvhez rögzítse az eredményeket, így az oldalon két tartalomlista szerepelhet, amelyek különböző nyelveken jelenítik meg az eredményeket. A beállítási panelnek ez a nyelvválasztási lehetősége MLS webhelyek esetében nem érhető el. |
defaultLocale | Az MLS webhelyek egy alapértelmezett webhelyi nyelvi-területi beállítással rendelkeznek. Ez azt jelenti, hogy az összes tartalomlekérdezés csak azokat a tartalomelemeket fogja visszaadni, amelyek az adott nyelvi-területi beállításban szerepelnek (vagy nem fordítandók). | A nem MLS webhelyek nem rendelkeznek alapértelmezett nyelvi-területi beállítással, ezért a használt tartalomlekérdezés a nyelvtől függetlenül az összes tartalomelemet visszaadja. |
Honosítási alapszabály |
A webhelyhez elérhető nyelvek listáját definiálja. Ezek egy legördülő listában fognak megjelenni a szerkesztőben. A kezelési felhasználói felületen is lesz egy nyelveket tartalmazó legördülő lista, amely lehetővé teszi az adatok megnyitását és előzetes megtekintését a kért nyelven. |
Mivel nincs honosítási alapszabály, a nyelvek közötti váltásra szolgáló legördülő listát eltávolították a szerkesztőből. A kezelési felhasználói felületen nincsenek felsorolt nyelvek, így "alapértelmezett" nyelv sincs. A kezelési felhasználói felületen a következőképpen lehet felismerni, hogy nem MLS vagy MLS webhellyel van-e dolgunk. |
Fordítás/lefordítható | A kezelési felhasználói felületen található helyi menü lehetőségként tartalmazza a "Fordítás" elemet. Ez lehetővé teszi, hogy létrehozzon egy fordítási feladatot a webhely lefordítására. |
A kezelési felhasználói felületen található helyi menü tartalmaz egy "Lefordítható" lehetőséget is. Gyakorlatilag egy nem MLS webhelyet nem lehet lefordítani, ezért ahhoz, hogy lefordíthassa, előbb át kell alakítania lefordítható (MLS) webhellyé. Ezzel tulajdonképpen "frissít" egy nem MLS webhelyet MLS webhellyé. Megjegyzés: Ez a művelet csak egy irányban végezhető el. A lefordíthatót nem alakíthatja át nem lefordíthatóvá. |
Mielőtt a webhelyét MLS webhellyé alakíthatná, a következőket kell elvégeznie:
Ezután, ha esetleg olyan egyéni összetevőkóddal rendelkezik, amely a Content REST-hívásokat végzi, akkor azt is frissítenie kell, hogy 1.1-es verziójú hívásokat végezzen. Ez nem általános dolog, mivel a legtöbb tartalomhívást a tartalomelrendezésekből végzik.
Tartalomelrendezések frissítése
A támogatott Content REST API-verziók megadása
A tartalomelrendezéseknek meg kell adniuk, hogy a Content REST API melyik verzióját támogatják. Erre azért van szükség, hogy biztosan a megfelelő Content REST-hívást végezzék el, és a várt válaszadatok térjenek vissza az elrendezéshez.
Ha nem határozza meg egyik verzió támogatását sem, a rendszer feltételezi, hogy a tartalomelrendezés csak az 1.0-s verziót támogatja.
A konzol felsorolja azokat a tartalomelrendezéseket, amelyek még az 1.0-s verzióban szerepelnek.
Ha azt szeretné, hogy a tartalomelrendezése más verziókat is támogasson, adja hozzá a "contentVersion" tulajdonságban a tartalomelrendezési objektumhoz.
A következő példában minden verziót támogat az 1.0-s és a 2.0-s közé esik, de az utóbbitól kisebb (Megjegyzés: a 2.0-s verzió nem létezik, de a legtöbb verziómódosítás kompatibilitástörő módosítást okozhat)
// Content Layout definition.ContentLayout.prototype = { // Specify the versions of the Content REST API that are supported by the this Content Layout. // The value for contentVersion follows Semantic Versioning syntax. // This allows applications that use the content layout to pass the data through in the expected format. contentVersion: ">=1.0.0 <2.0.0", // Main rendering function: // - Updates the data to handle any required additional requests and support both v1.0 and v1.1 Content REST APIs // - Expand the Mustache template with the updated data // - Appends the expanded template HTML to the parentObj DOM element render: function (parentObj) {
1.1-es verziójú válaszok módosításának kezelése
Minimális követelményként el kell végeznie a Content REST API-válaszok "data" értékről "fields" értékre történő módosításának kezelését. Ennek legegyszerűbb módja, ha az értéket hozzáadja a "data" tulajdonsághoz, és rámutat az új "fields" tulajdonságra
render: function (parentObj) { ... if(!content.data) { content.data = content.fields; }
Jobb megoldás, ha áttér az 1.1-es verziójú "fields" érték használatára minden tartalomelrendezésnél. Ez magában foglalja a JavaScript- és a sablonkód módosítását is.
Az 1.1-es verzió teljes mértékű támogatásához kezelnie kell Content REST API következő módosításait az 1.0-s és az 1.1-es verzió között:
A Content REST API módosítása | 1.1-es verzió | 1.0-s verzió |
---|---|---|
"fields" vagy "data" |
"items": [{ "type": "Starter-Blog-Author", "name": "Alex Read", "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63", "fields": { "starter-blog-author_bio": "Alex's bio", "starter-blog-author_name": "Alex Read" } }, |
"items": [{ "type": "Starter-Blog-Author", "name": "Alex Read", "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63", "data": { "starter-blog-author_bio": "Alex's bio", "starter-blog-author_name": "Alex Read" } }, |
camelCase tulajdonságnevek | "updatedDate" | "updateddate" |
lekérdezés formátuma | /items?q=(type eq "Starter-Blog-Author") | /items?fields.type.equals="Starter-Blog-Author" |
API-verzió | /content/management/api/v1.1/items | /content/management/api/v1/items |
nyelvfüggő lekérdezések | /content/management/api/v1.1/items?q=((type eq "Promo") és (language eq "en-US" or translatable eq "false")) |
Nem támogatott. Az összes egyéni 1-es verziójú hívást át kell telepítenie a "language" lehetőség szerepeltetéséhez. Ez biztosítja, hogy az eredmények konzisztensek legyenek az MLS webhelynek visszaküldött eredményekkel, ha egy adott nyelven tekintik meg őket. |
A tartalomlekérdező karakterlánc frissítése
Content API-hívásokat hajthat végre bármilyen egyéni kódban, ezért a webhelye által használt minden olyan egyéni kódot ellenőriznie kell, amelyik Content REST API-hívásokat hajt végre.
Nem MLS webhely átalakítása MLS webhellyé
Miután átalakította úgy a webhelyét, hogy teljes mértékben támogassa az 1.1-es verziójú Content REST API-kat, ha MLS webhellyé alakítja, támogatást biztosíthat a nyelvek számára.
Ha kijelöli a webhelyét a webhely kezelési felhasználói felületén, megjelenik egy "lefordítható" tartalom menüelem is. Ha kiválasztja ezt a lehetőséget, megjelenik egy párbeszédpanel, amely arra kéri, hogy válasszon ki egy honosítási alapszabályt és egy alapértelmezett nyelvet a webhely számára a honosítási alapszabályban meghatározott kötelező nyelveket tartalmazó listából. Ha nem létezik honosítási alapszabály, akkor nem fogja tudni végrehajtani ezt a lépést, és először a tartalomadminisztrálási képernyőkre kell lépnie, és létre kell hoznia egy legalább egy kötelező nyelvet tartalmazó honosítási alapszabályt.
A lépés végrehajtása után a webhelye az alapértelmezett nyelvi-területi beállításnak megfelelően fog megjelenni. Ez azt is lehetővé teszi, hogy a honosítási alapszabályában meghatározott más nyelvi-területi beállításokra váltson.
Ellenőriznie kell majd, hogy a webhelye az elvárásoknak megfelelően jelenik-e meg az alapértelmezett nyelvi-területi beállításban.
Amikor webhelyeket telepít át, a webhelyekhez társított forrásanyagok szintén áttelepülnek, viszont a webhelyekhez nem társított forrásanyagokat külön kell áttelepíteni.
Az áttelepítés megkezdése előtt vegye figyelembe a következőket:
A forrásanyagok áttelepítéséhez végezze el a következő lépéseket:
Regisztrálja a forrás- és a célkiszolgáló kapcsolódási adatait.
Regisztrálja a forráskiszolgálót (azt a kiszolgálót, amelyikről az adatait áttelepíti):
> cec register-server <source_server_name> -e http://<source_server>:<source_port> -u <source_username> -p <source_password> -t pod_ic
Regisztrálja a célkiszolgálót (azt a kiszolgálót, amelyikre az adatait áttelepíti):
> cec-install % cec register-server <target_server_name> -e http://<source_server>:<source_port> -u <target_username> -p <target_password> -t pod_ec
A következő parancs futtatásával telepítsen át egy forrásanyag-gyűjteményt:
> cec migrate-content <source_collection_name> --server <source_server_name> --destination <target_server_name> --repository <target_repository_name> --collection <target_collection_name> --channel <target_channel_name>
A forrásanyagok a célkiszolgálón fognak létrejönni a megadott adattárban, és a gyűjteményhez és a csatornához lesznek társítva. Ha szükséges, a rendszer automatikusan létrehozza a gyűjteményt és a csatornát. A megadott adattárban beállított alapértelmezett nyelv lesz az összes áttelepített forrásanyag alapértelmezett nyelve.