Oracle Oracle Content Management -instanssin siirto aiemmasta Cloud Infrastructure -ympäristöstä

"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

• <target_server_name>-arvo määrittää kohdepäätepisteen, ja se voi olla mikä tahansa valitsemasi nimi.
• <target_server>- ja <target_port>-arvot muodostavat URL-osoitteen, jolla käytät kohdepalvelinta.
• <target_username>- ja <target_password>-arvojen on vastattava sen henkilön käyttäjätunnusta ja salasanaa, joka vie sivuston mallipohjat lähdepalvelimesta. Näin voit välttää oikeusongelmat, kun mallipohjat tuodaan siirron aikana.
• "pod_ec"-arvo on kohdepalvelimen tyyppi, joka määrittää, minkätyyppiseen palvelimeen instanssi on luotu.

Siirrä sivustot suorittamalla seuraavat vaiheet:

1. Luo mallipohjat lähdepalvelimessa jokaiselle sivustolle, jolla on sisältöä.
2. Vie jokainen mallipohja lähdepalvelimessa. Varmista, että suoritat tämän vaiheen käyttäjänä, johon viittasit kohdepalvelimen rekisteröinnin aikana.
3. Kirjaudu sisään kohdepalvelimeen tietovaraston pääkäyttäjänä (käyttäjänä, jolla on CECRepositoryAdministrator-rooli). Sen jälkeen luo tietovarasto sisällölle, joka tuodaan mallipohjan mukana.
4. Suorita jokaiselle noudetulle mallipohjalle seuraava komento. Korvaa <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>

5. Jaa siirretyt sivustot ja sisältö kohdepalvelimessa asianmukaisesti.

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ä:

• Jos käytät ContentSDK:ta, kutsut päivitetään automaattisesti käyttämään version v1.1 sisällön REST-kutsuja.
• Jos sisällön asettelut eivät Ilmoita tukevansa versiota v1.1, ContentSDK lisää vastaukseen "data"-merkinnän (v1.0), joka yksinkertaisesti osoittaa "fields"-merkintään(v1.1). Mallipohjasi siis toimivat edelleen ilman muutoksia.
• Jos käytät lisäkyselymerkkijonossa version v1.0 sisällön REST-kutsujen syntaksia "fields.type.equals=", syntaksi yritetään jäsentää ja muokata v1.1-syntaksin mukaiseksi. Tarkista kuitenkin muokkauksen toimivuus.
• Jos teet suoria version v1.0 sisällön REST-kutsuja (eli ei ContentSDK:n kautta), nämä kutsut epäonnistuvat. Sinun on korjattava räätälöity koodi ja päivitettävä nämä kutsut.
• Sinun on myös päivitettävä räätälöidyt sisältökyselyt, joissa käytetään version v1.0 "fields.type.equals="-syntaksia. Muuta ne käyttämään 'q=(type eq "..")'-syntaksia.
• "updateddate" ja "updatedDate": CaaS ilmeisesti korjaa tämän ongelman, mutta "updateddate"-arvot pitää muuttaa camelCase-muotoon eli "updatedDate"-arvoiksi, kunnes saatavilla on EC-koontiversio, jossa sisällön REST API -liittymän versio v1.1 tukee molempia arvoja.

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.

Tee seuraavat asiat ennen kuin muunnat sivuston MLS-sivustoksi:

• Päivitä kaikki sisällön asettelun komponentit tukemaan sisällön REST API -liittymien versiota v1.1
• Päivitä sivuston sisältölistojen lisäkyselymerkkijonot yhteensopiviksi sisällön REST API -liittymän version v1.1 kanssa

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:

"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"        }    },

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.

• Räätälöidyt komponentit: tarkista seuraavat komponentit:
  • Sisällön asettelut
  • Paikalliset komponentit
  • Osan asettelut
  • Etäkomponentit
• Teemat: JavaScript: Teeman JavaScript-koodi saattaa tehdä räätälöityjä sisällön REST API -liittymän kutsuja, vaikka se onkin epätodennäköisempää. Myös nämä kutsut on tarkistettava.
• Sivuston ominaisuudet: lisäkyselymerkkijono: Kun olet tarkistanut päivittäneesi kaiken räätälöidyn koodin, joka tekee sisällön REST API -kutsuja, päivitä myös sivuston sivuilla olevien Sisältölista-komponenttien Lisäkyselymerkkijono-kohta. Nämä kohdat yritetään jäsentää ja muuntaa ajon aikana, mutta ne pitäisi muuntaa yhteensopiviksi version v1.1 sisällön REST-kutsujen kanssa, jotta niiden tuki jatkuisi.

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.

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

• <source_server_name>-arvo määrittää lähdepäätepisteen, ja se voi olla mikä tahansa valitsemasi nimi.
• <source_server>- ja <source_port>-arvot muodostavat URL-osoitteen, jolla käytät lähdepalvelinta.
• <source_username>- ja <source_password>-arvojen on oltava sellaisen henkilön käyttäjätunnus ja salasana, joka voi käyttää lähdepalvelimessa olevaa sisältöä.
• "pod_ic"-arvo on lähdepalvelimen tyyppi, joka määrittää, minkätyyppiseen palvelimeen instanssi on luotu.

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

• <target_server_name>-arvo määrittää kohdepäätepisteen, ja se voi olla mikä tahansa valitsemasi nimi.
• <target_server>- ja <target_port>-arvot muodostavat URL-osoitteen, jolla käytät kohdepalvelinta.
• <target_username>- ja <target_password>-arvojen on oltava sen henkilön käyttäjätunnus ja salasana, josta tulee sisällön omistaja kohdepalvelimessa.
• "pod_ec"-arvo on kohdepalvelimen tyyppi, joka määrittää, minkätyyppiseen palvelimeen instanssi on luotu.

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.