Migrace instance služby Oracle Content Management ze starší infrastruktury Cloud

Příkaz "cec migrate-site" je nový, takže bude nutné instalovat sadu nástrojů OCE Toolkit z úložiště Git webového klientu, dokonce i v případě, že jste ji předtím již stáhli a instalovali.

Podle pokynů uvedených na stránce sady nástrojů pro weby stáhněte a instalujte sadu nástrojů OCE Toolkit.

Registrujte podrobnosti připojení pro cílový server (server, na který migrujete své weby):

> cec register-server <target_server_name>
          -e http://<target_server>:<target_port>
          -u <target_username> -p <target_password>
          -t pod_ec

• Název <target_server_name> identifikuje koncový bod cíle a můžete zde zadat jakýkoli název.
• Název <target_server> a port <target_port> vytvářejí adresu URL, kterou použijete k přístupu k cílovému serveru.
• Jméno <target_username> a heslo <target_password> musí obsahovat uživatelské jméno a heslo pro osobu, která bude exportovat šablony webů ze zdrojového serveru, aby při importu šablon během migrace nedošlo k problémům s oprávněními.
• Hodnota "pod_ec" je typ cílového serveru, sloužící k identifikaci typu serveru, na kterém je instance sestavena.

Při migraci webů proveďte následující kroky:

1. Na zdrojovém serveru vytvořte šablony z každého webu, který obsahuje materiály.
2. Na zdrojovém serveru exportujte veškeré šablony. Tento krok musíte provést jako uživatel, kterého jste uvedli při registraci cílového serveru.
3. Na cílovém serveru se přihlaste jako správce úložiště (uživatel s rolí CECRepositoryAdministrator). Poté vytvořte úložiště pro materiály, které budou importovány se šablonou.
4. Pro každou staženou šablonu spusťte následující příkaz, přičemž nahraďte proměnnou <název_webu> názvem, který má web mít na cílovém serveru:

   > cec migrate-site <site_name> --template <template_path_and_name> 
   --destination <registered_target_server_name> --repository <repository_name>

5. Na cílovém serveru sdílejte odpovídajícím způsobem migrované weby a materiály.

Po migraci bude možné váš web spustit pomocí volání REST pro obsah verze 1.1. To může způsobit určité problémy, které je třeba předem vyřešit, aby web řádně fungoval. Podívejte se na následující body, které vám pomohou určit, jaké kroky je nutné provést:

• Pokud používáte sadu SDK pro obsah, budou vaše volání automaticky aktualizována na volání REST pro obsah verze 1.1.
• Pokud vaše rozvržení obsahu neposkytují podporu verze 1.1, sada SDK pro obsah také přidá položku „data“ (verze 1.0) do odpovědi, která bude jednoduše odkazovat na položku „fields“ (verze 1.1), takže vaše šablony bude možné nadále používat bez provedení změn.
• Při použití syntaxe REST pro obsah verze 1.0 "fields.type.equals=" v doplňkovém řetězci dotazu se pokusíme analyzovat a upravit tuto syntaxi na verzi 1.1, nicméně je vhodné to ověřit.
• Pokud uskutečňujete jakákoli přímá (místo prostřednictvím sady SDK pro obsah) volání REST pro obsah verze 1.0, dojde k jejich selhání. Budete muset opravit svůj vlastní kód a převést tato volání na vyšší verzi.
• Stejně tak je třeba, aby veškeré dotazy na vlastní obsah se syntaxí "fields.type.equals=" verze 1.0 měly syntaxi 'q=(type eq "..")'.
• „updateddate“ versus „updatedDate“: Tento konflikt je údajně odstraněn prostřednictvím CaaS, ale dokud neobdržíme sestavení EC, ve kterém rozhraní REST API verze 1.1 podporuje obě hodnoty, je nutné, abyste změnili všechny hodnoty „updateddate“ tak, aby byly hodnotami camelCase: „updatedDate“.

Jakmile bude váš web správně fungovat, je třeba zajistit, aby vyhovoval požadavkům na vícejazyčný web (MLS). Pokud jste vytvořili podnikový web na serveru External Compute, budou vyžadovány výchozí jazyk a zásady lokalizace. Vzhledem ke způsobu, jakým byl váš web zkopírován, se nejedná o web MLS, takže jej musíte k zajištění podpory budoucích funkcí upgradovat na web MLS.

Následující tabulka ukazuje rozdíly mezi weby MLS a weby, které nejsou MLS.

Než budete moci změnit svůj web na web MLS, je nutné provést následující kroky:

• Převést všechny komponenty rozvržení obsahu na vyšší verzi, aby podporovaly rozhraní REST API pro obsah verze 1.1
• Převést všechny „doplňkové řetězce dotazů“ v seznamech obsahu na webu na vyšší verzi, aby byly kompatibilní s rozhraním REST API pro obsah verze 1.1

Poté, pokud máte náhodou jakýkoli vlastní kód komponenty, který uskutečňuje volání REST pro obsah, musíte jej také převést na vyšší verzi, aby bylo možné uskutečňovat volání verze 1.1. To je neobvyklé, protože většina volání obsahu je uskutečňována z rozvržení obsahu.

Převedení rozvržení obsahu na vyšší verzi

Stanovení podporovaných verzí rozhraní REST API pro obsah

Pro rozvržení obsahu je nutné stanovit, kterou verzi rozhraní REST API pro obsah podporují. Tím je zajištěno, že příslušné volání REST pro obsah vrátí do rozvržení očekávaná data odpovědi.

Pokud nestanovíte podporu žádné z verzí, předpokládá se, že rozvržení obsahu podporuje pouze verzi 1.0.

Konzola zobrazí seznam rozvržení obsahu, která jsou stále ve verzi 1.0.

Pokud chcete zajistit, aby rozvržení obsahu podporovalo další verze, přidejte do objektu rozvržení obsahu vlastnost „contentVersion“.

V uvedeném příkladu jsou podporovány všechny verze od 1.0 do méně než 2.0 (Poznámka: Verze 2.0 neexistuje, ale změny hlavní verze mohou přinést zlomové změny.).

// 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)
          {

Zpracování změn v odpovědi verze 1.1

Minimálním krokem, který bude třeba provést, je zpracování změny odpovědi rozhraní REST API pro obsah z položky „data“ na položku „fields“. Nejjednodušším řešením je přidat zpět vlastnost „data“ a poté provést odkaz na novou vlastnost „fields“.

render: function (parentObj)
          {    ...    if(!content.data) {        content.data =
          content.fields;    }

Lepší možností je změnit použití hodnoty „fields“ verze 1.1 prostřednictvím rozvržení obsahu. To bude vyžadovat aktualizaci jak kódu v jazyku JavaScript, tak kódu šablony.

K zajištění plné podpory verze 1.1 bude nutné vypořádat se s následujícími změnami rozhraní REST API pro obsah mezi verzemi 1.0 a 1.1:

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

Převedení řetězce dotazu na obsah na vyšší verzi

Možná uskutečňujete volání rozhraní API pro obsah v libovolném vlastním kódu, takže je třeba ověřit veškerý vlastní kód používaný webem, který uskutečňuje volání rozhraní REST API pro obsah.

• Vlastní komponenty: Zkontrolujte následující komponenty:
  • Rozvržení obsahu
  • Místní komponenty
  • Rozvržení sekcí
  • Vzdálené komponenty
• Témata: JavaScript: Přestože je to málo pravděpodobné, můžete mít ve svém tématu kód v jazyku JavaScript, který uskutečňuje vlastní volání rozhraní REST API pro obsah, takže je třeba ověřit i tento kód.
• Vlastnosti webu: Doplňkový řetězec dotazu: Jakmile ověříte, že proběhl přechod na vyšší verzi u veškerého vlastního kódu, který uskutečňuje volání rozhraní REST API pro obsah, měli byste provést stejný krok také pro „doplňkový řetězec dotazu“ ve všech komponentách „seznam obsahu“ na všech stránkách webu. Přestože se snažíme analyzovat a převádět za běhu, měl by být uskutečněn přechod na vyšší verzi, aby bylo dosaženo kompatibility s voláními REST pro obsah verze 1.1 k zajištění nepřetržité podpory.

Převod webu, který není MLS, na web MLS

Jakmile převedete web tak, aby plně podporoval rozhraní REST API pro obsah verze 1.1, můžete přidat podporu jazyků tím, že jej změníte na web MLS.

Pokud vyberete svůj web v uživatelském rozhraní správy webů, zobrazí se v nabídce pro obsah volba „přeložitelný“. Po výběru této volby se zobrazí dialogové okno s výzvou k výběru zásad lokalizace a výchozího jazyka pro web ze seznamu požadovaných jazyků v zásadách lokalizace. Pokud neexistují žádné zásady lokalizace, nebudete moci tento krok dokončit. Nejdříve bude nutné přejít na obrazovky správy obsahu a vytvořit zásady lokalizace s alespoň jedním požadovaným jazykem.

Po dokončení tohoto kroku proběhne generování webu ve výchozím národním prostředí. Umožní vám také přepnout na jiná národní prostředí uvedená v zásadách lokalizace.

Bude třeba ověřit, zda se web generuje očekávaným způsobem ve výchozím národním prostředí.

Registrujte podrobnosti připojení pro zdrojový a cílový server.

Registrujte zdrojový server (server, ze kterého migrujete materiály):

> cec register-server <source_server_name>
          -e http://<source_server>:<source_port>
          -u <source_username> -p <source_password>
          -t pod_ic

• Název <source_server_name> identifikuje koncový bod zdroje a můžete zde zadat jakýkoli název.
• Název <source_server> a port <source_port> vytvářejí adresu URL, kterou použijete k přístupu ke zdrojovému serveru.
• Jméno <source_username> a heslo <source_password> musí obsahovat uživatelské jméno a heslo osoby, která smí přistupovat k materiálům na zdrojovém serveru.
• Hodnota "pod_ic" je typ zdrojového serveru, sloužící k identifikaci typu serveru, na kterém je instance sestavena.

Registrujte cílový server (server, na který migrujete materiály):

> cec-install % cec register-server <target_server_name>
          -e http://<source_server>:<source_port>
          -u <target_username> -p <target_password>
          -t pod_ec

• Název <target_server_name> identifikuje koncový bod cíle a můžete zde zadat jakýkoli název.
• Název <target_server> a port <target_port> vytvářejí adresu URL, kterou použijete k přístupu k cílovému serveru.
• Jméno <target_username> a heslo <target_password> musí obsahovat uživatelské jméno a heslo osoby, která bude vlastnit materiály na cílovém serveru.
• Hodnota "pod_ec" je typ cílového serveru, sloužící k identifikaci typu serveru, na kterém je instance sestavena.

Migrujte kolekci materiálů spuštěním následujícího příkazu:

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

Materiály budou vytvořeny na cílovém serveru v určeném úložišti a budou přiřazeny kolekci a kanálu. V případě potřeby budou kolekce a kanál vytvořeny automaticky. Výchozím jazykem pro všechny migrované materiály bude výchozí jazyk, který je nastaven ve stanoveném úložišti.