Jos käytät aiemmassa Cloud Infrastructure -ympäristössä Oracle Content Management -instansseja, joita laskutetaan käyttäjäperusteisesti, Oracle suosittelee, että siirrät instanssit uuteen alkuperäiseen Oracle Cloud Infrastructure (OCI) -ympäristöön eli toisen sukupolven OCI -ympäristöön (toisin sanoen käytät Infrastructure Console -konsolia palveluinstanssien hallintaan). Näin varmistat, että voit hyödyntää Oraclen pilviympäristön edut ja edistysaskeleet tulevaisuudessa.
Jotta voisit aloittaa siirron, sinun on suoritettava joitain siirtoa edeltäviä vaiheita ja ajoitettava siirto yhteistyössä Oracle-tuen kanssa.
Tässä taulukossa kuvataan Oracle Content Management -palvelun oikeusryhmien ja OCI-sovellusroolien vastaavuusmäärityksiä.
Oracle Content Management -palvelun oikeusryhmä | OCI-sovellusrooli |
---|---|
DocumentsServiceUser | CECStandardUser |
DocumentsServiceAdmin | CECServiceAdministrator |
SitesServiceVisitor | CECSitesVisitor |
SitesServiceAdmin | CECSitesAdministrator |
ContentAdministratorRole | CECContentAdministrator |
CECSStandardUser | CECStandardUser |
CECSEnterpriseUser | CECEnterpriseUser |
Huomautus::
Jos IDCS-kohdetoimialue sisältää jo käyttäjän, jolla on sama käyttäjätunnus, käyttäjälle määritetään Oracle Content Management -palvelun oikeusryhmiä vastaavat OCI-sovellusroolit.Kun olet valmis suorittamaan siirron, käynnistä siirto lähettämällä siirtopyyntö:
Kun Oracle-tuki vastaanottaa siirron palvelupyynnön, se ajoittaa siirron toivomasi päivämäärän mukaisesti. Palvelupyyntöön päivitetään päivämäärä ja aika, jolloin siirto alkaa.
Palvelupyyntöön tehdään päivityksiä, jotka osoittavat, miten siirto edistyy. Tietojen siirto suoritetaan taustajärjestelmässä. Sinulta ei edellytetä muita toimia kuin palvelupyynnön päivitysten seuraaminen sekä siirron tarkistus sen valmistuttua.
Seuraavat asiat tapahtuvat siirron aikana:
Tärkeää:
Tässä vaiheessa vanhaan instanssiin (lähde) ei saa tehdä muutoksia. Siirron alkamisen jälkeen tehtyjä muutoksia ei siirretä uuteen instanssiin.Huomautus::
Vanha instanssi on yhä käynnissä, jotta voit käyttää sitä tarkistukseen. Sinun on myös siirrettävä sisältöä käyttävät sivustot ja siirrettävä muu sisältö, joka ei sisältynyt siirtoon.Jos vanha instanssi oli integroitu muiden palveluiden tai sovellusten kanssa tai yhteydessä niihin suoraan tai REST API -kutsujen kautta, siirron jälkeen on ehkä suoritettava tehtäviä.
Seuraavat seikat koskevat koko palvelua:
Vanhojen URL-osoitteiden malli oli seuraava:
https://<palvelun-nimi>-<tilin-nimi>.<alue>.oraclecloud.com/documents
Uusien URL-osoitteiden malli on seuraava:
https://<palvelun-nimi>-<tilin-nimi>.<palvelun-tyyppi>.ocp.oraclecloud.com/documents
Integrointi | Siirron jälkeen tehtävät asiat |
---|---|
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 -kutsut |
|
Työaseman SDK/CLI-käyttö |
|
Liittimet |
|
Huomautus::
Vanhan instanssin sisältöön viittaavat kirjanmerkit eivät enää toimi, koska uuden instanssin URL-osoite on muuttunut.Sivustot, joilla ei ole sisältöä, siirretään automaattisesti. Sivustot, joilla on sisältöä, vaativat kuitenkin ylimääräisiä vaiheita, jotta ne toimisivat uudessa Oracle Content Management -instanssissa.
"cec migrate-site"-komento on uusi, joten OCE Toolkit on asennettava web-työaseman git-tietovarastosta, vaikka olisit noutanut ja asentanut sen aiemmin.
Nouda ja asenna OCE Toolkit sites toolkit -sivun ohjeiden mukaan.
Rekisteröi kohdepalvelimen yhteyden tiedot (palvelin, johon sivustot siirretään):
> cec register-server <target_server_name> -e http://<target_server>:<target_port> -u <target_username> -p <target_password> -t pod_ec
Siirrä sivustot suorittamalla seuraavat vaiheet:
<site_name>
nimellä, jonka haluat antaa sivustolle kohdepalvelimessa:
> cec migrate-site <site_name> --template <template_path_and_name> --destination <registered_target_server_name> --repository <repository_name>
Kun olet siirtänyt sivuston, se toimii version v1.1 sisällön REST-kutsujen kautta. Tämä voi aiheuttaa joitakin ongelmia, jotka on ratkaistava, jotta sivusto toimisi oikein. Tutustu seuraaviin kohtiin ja selvitä, mitä sinun pitäisi tehdä:
Kun sivusto toimii oikein, siitä on tehtävä MLS-yhteensopiva. Jos luot yrityssivuston ulkoiseen laskentapalvelimeen, se tarvitsee oletuskielen ja lokalisointikäytännön. Koska sivustosi kopioitiin, se ei ole MLS-sivusto. Se on siis päivitettävä MLS-sivustoksi, jotta tulevia toimintoja voidaan tukea.
Seuraavassa taulukossa näytetään, miten MLS-sivustot eroavat muista sivustoista.
Sivusto-objekti | MLS-sivusto | Sivusto, joka ei ole MLS-sivusto |
---|---|---|
Sisältökohteet | Sisältökohteen kieliversio näytetään sivulle pudotetun sisältökohteen sijaan. Kieli voi vaihtua sivuston muodostuksen aikana pyydetyksi kieleksi. | Sivulle pudotettu sisältökohde näytetään aina. |
Sisällön asettelut | Sisällön asettelujen on tuettava version v1.1 API-liittymiä. Jos ne eivät tue sitä, sisältökohde ei näy ja varoitus näytetään. Tämä johtuu siitä, että kaikkiin version v1.1 API-kutsuihin lisätään "locale"-arvo, jota ei tueta version v1.0 API-liittymissä. | Sisällön asettelujen versio voi olla joko v1.0 tai v1.1. Jos sisällön asettelu tukee vain versiota v1.0, ContentSDK lisää vastaukseen "fields"-merkintää vastaavan "data"-merkinnän. Muita ongelmia voi silti esiintyä, joten tämä ei ole tuettu toiminto, jonka avulla voisi välttää sisällön asettelun päivityksen. |
Sisältölistat | Vain sisältökohteet, jotka ovat käytettävissä pyydetyssä kieliversiossa, näytetään. | Kaikki sisältökohteet näytetään kielestä riippumatta. Käyttäjä voi valita, että sisältölista rajoittaa tulokset tiettyyn kieleen. Sivulla voi siis olla kaksi sisältölistaa, joissa näytetään tulokset eri kielille. Asetuspaneelin kielivalinta ei ole käytettävissä MLS-sivustoissa. |
defaultLocale | MLS-sivustoilla on sivuston oletusalue. Tämä tarkoittaa sitä, että kaikki sisältökyselyt palauttavat vain tähän alueeseen kuuluvat sisältökohteet (tai sisältökohteet, joita ei käännetä). | Muilla kuin MLS-sivustoilla ei ole oletusaluetta, joten sisältökysely palauttaa kaikki sisältökohteet kielestä riippumatta. |
Lokalisointikäytäntö |
Määrittää sivuston käytettävissä olevien kielten listan. Luontiohjelmassa on avattava valikko, josta voi valita näitä kieliä. Hallintakäyttöliittymässä on myös avattava kielivalikko, jonka avulla voit avata tai esikatsella sivuston pyydetyllä kielellä. |
Koska lokalisointikäytäntöä ei ole, avattava kielivalikko poistetaan luontiohjelmasta. Hallintakäyttöliittymässä ei luetella kieltä, eikä myöskään oletuskieltä ole. Näin voit erottaa MLS-sivuston muista sivustoista hallintakäyttöliittymässä. |
Käännös/käännettävä | Hallintakäyttöliittymän kontekstivalikko sisältää Käännä-valinnan. Sen avulla voit luoda käännöstyön sivuston kääntämistä varten. |
Hallintakäyttöliittymän kontekstivalikko sisältää Käännettävä-valinnan. Muu kuin MLS-sivusto ei käytännössä ole käännettävä, joten siitä on tehtävä käännettävä (MLS) sivusto, ennen kuin sen voi kääntää. Näin voit päivittää sivuston MLS-sivustoksi. Huomautus: Tämä on yksisuuntainen toiminto. Et voi palauttaa sivustoa ei-käännettäväksi. |
Tee seuraavat asiat ennen kuin muunnat sivuston MLS-sivustoksi:
Jos käytät räätälöityä komponentin koodia, joka tekee sisällön REST-kutsuja, koodi on myös päivitettävä tekemään version v1.1 kutsuja. Tämä on harvinaista, sillä useimmat sisältökutsut tehdään sisällön asetteluista.
Sisällön asettelujen päivitys
Tuettujen sisällön REST API -liittymän versioiden määritys
Sisällön asettelujen on määritettävä, mitä sisällön REST API -liittymän versiota ne tukevat. Tämä varmistaa, että asianmukainen sisällön REST-kutsu tehdään ja odotetut vastaustiedot palautetaan asetteluun.
Jos et määritä mitään tuettua versiota, sisällön asettelun oletetaan tukevan vain versiota v1.0.
Konsolissa luetellaan sisällön asettelut, jotka käyttävät edelleen versiota v1.0.
Jos haluat sisällön asettelun tukevan muita versioita, lisää "contentVersion"-ominaisuus sisällön asettelun objektiin.
Tässä esimerkissä asettelu määritetään tukemaan kaikkia versioita versiosta v1.0 versioon 2.0. (Huomautus: versiota 2.0 ei ole, mutta pääversion muutokset voivat sisältää toiminnan estäviä muutoksia)
// 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) {
Version v1.1 vastausten muutosten käsittely
Vähimmäisvaatimus on käsitellä sisällön REST API -liittymän vastauksessa tapahtunut muutos "data"-merkinnästä "fields"-merkintään. Yksinkertaisin tapa tehdä tämä on palauttaa "data"-ominaisuus ja osoittaa uuteen "fields"-ominaisuuteen
render: function (parentObj) { ... if(!content.data) { content.data = content.fields; }
Parempi vaihtoehto on siirtyä käyttämään version v1.1 "fields"-arvoa kaikissa sisällön asetteluissa. Tämä vaatii sekä JavaScript- että mallipohjakoodin päivitystä.
Version v1.1 täydellinen tukeminen edellyttää, että seuraavat sisällön REST API -liittymän muutokset versioiden v1.0 ja v1.1 välillä käsitellään:
Sisällön REST API -liittymän muutos | v1.1 | v1.0 |
---|---|---|
"fields" ja "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-muotoiset ominaisuuksien nimet | "updatedDate" | "updateddate" |
kyselymuoto | /items?q=(type eq "Starter-Blog-Author") | /items?fields.type.equals="Starter-Blog-Author" |
API-versio | /content/management/api/v1.1/items | /content/management/api/v1/items |
kielikohtaiset kyselyt | /content/management/api/v1.1/items?q=((type eq "Promo") ja (language eq "en-US" or translatable eq "false")) |
Ei tueta. Kaikki räätälöidyt version v1 kutsut on siirrettävä siten, että ne sisältävät "language"-valinnan. Tämä varmistaa, että tulokset ovat yhdenmukaiset MLS-sivustolle palautettujen tulosten kanssa, kun sivustoa katsellaan tietyllä kielellä. |
Sisällön kyselymerkkijonon päivitys
Mikä tahansa räätälöity koodi saattaa tehdä sisällön API-liittymän kutsuja, joten tarkista kaikki sivustosi käyttämä räätälöity koodi, joka tekee sisällön REST API -liittymän kutsuja.
Muun kuin MLS-sivuston muuntaminen MLS-sivustoksi
Kun olet muuntanut sivuston tukemaan täysin version v1.1 sisällön REST API -liittymiä, voit lisätä kielituen muuttamalla sivuston MLS-sivustoksi.
Jos valitset sivustosi sivustojen hallintakäyttöliittymässä, näet sisältövalikossa Käännettävä-valinnan. Jos valitset tämän valinnan, näyttöön avautuu valintaikkuna, jossa pyydetään valitsemaan sivustolle lokalisointikäytäntö ja oletuskieli. Oletuskieli valitaan lokalisointikäytännön pakollisten kielten listasta. Jos lokalisointikäytäntöjä ei ole, et voi viimeistellä tätä vaihetta. Siirry ensin sisällön hallintanäyttöihin ja luo lokalisointikäytäntö, jossa on ainakin yksi pakollinen kieli.
Kun tämä vaihe on valmis, sivusto muodostetaan nyt oletusalueelle. Voit myös vaihtaa alueeksi jonkun muun lokalisointikäytännössä määritetyn alueen.
Tarkista, että sivusto muodostetaan odotetulla tavalla oletusalueelle.
Siirrettäviin sivustoihin liittyvät tiedot siirretään, kun sivustot siirretään. Jos sisältöä ei kuitenkaan ole liitetty sivustoihin, se on siirrettävä erikseen.
Huomioi seuraavat asiat ennen siirron aloitusta:
Siirrä sisältö suorittamalla seuraavat vaiheet:
Rekisteröi lähde- ja kohdepalvelimien yhteyksien tiedot:
Rekisteröi lähdepalvelin (palvelin, josta sisältö siirretään):
> cec register-server <source_server_name> -e http://<source_server>:<source_port> -u <source_username> -p <source_password> -t pod_ic
Rekisteröi kohdepalvelin (palvelin, johon sisältö siirretään):
> cec-install % cec register-server <target_server_name> -e http://<source_server>:<source_port> -u <target_username> -p <target_password> -t pod_ec
Voit siirtää sisältökokoelman suorittamalla seuraavan komennon:
> 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>
Sisältö luodaan kohdepalvelimeen määritettyyn tietovarastoon, ja se liitetään kokoelmaan ja kanavaan. Kokoelma ja kanava luodaan tarvittaessa automaattisesti. Kaiken siirretyn sisällön oletuskieli on tietovarastossa määritetty oletuskieli.