Si tiene instancias de Oracle Content Management que se ejecuten en una infraestructura de Cloud Infrastructure heredada con una suscripción no medida, Oracle le recomienda migrar estas instancias al nuevo entorno de Oracle Cloud Infrastructure (OCI) nativo, OCI Gen 2 (es decir, utilizando la consola de Infrastructure para gestionar las instancias de servicio). Esto le garantizará el poder disfrutar de las ventajas y avances de la plataforma de Oracle en la nube en el futuro.
Para iniciar la migración, deberá realizar algunos pasos previos a la migración y trabajar con los Servicios de soporte Oracle para programarla.
En la siguiente tabla se describe la asignación de grupos de permisos de Oracle Content Management a roles de aplicación de OCI.
Grupo de permisos de Oracle Content Management | Rol de aplicación de OCI |
---|---|
DocumentsServiceUser | CECStandardUser |
DocumentsServiceAdmin | CECServiceAdministrator |
SitesServiceVisitor | CECSitesVisitor |
SitesServiceAdmin | CECSitesAdministrator |
ContentAdministratorRole | CECContentAdministrator |
CECSStandardUser | CECStandardUser |
CECSEnterpriseUser | CECEnterpriseUser |
Nota:
Si el dominio de IDCS de destino ya contiene un usuario con el mismo nombre de usuario, se asignarán al usuario los roles de aplicación de OCI correspondientes a los grupos de permisos de Oracle Content Management del usuario.Cuando esté lista para la migración, debe enviar una solicitud de servicio para que se inicie el proceso:
Una vez que los Servicios de Soporte Oracle reciban la solicitud de servicio de migración, programaremos su migración en función de la fecha de la solicitud, y la solicitud de servicio se actualizará con la fecha y la hora de inicio de la migración.
Se realizarán actualizaciones en la solicitud de servicio para mostrar el avance de la migración. La migración de datos se realizará en el backend; no es necesario que realice ninguna acción más allá de mantener actualizadas las solicitudes de servicio, así como validar la migración una vez finalizada.
Aquí se detalla lo que sucede durante la migración:
Importante:
En este momento, no debe realizar ningún cambio en la instancia antigua (de origen). Cualquier cambio realizado tras el inicio de la migración no se migrará a la instancia nueva.Nota:
La instancia antigua seguirá estando activa para que pueda volver a hacer referencia a ella para la validación. También la necesitará para migrar todos los sitios que utilizan activos y para migrar cualquier otro activo que se hubiera excluido durante la migración.Si la instancia antigua se ha integrado o comunicado con otros servicios o aplicaciones, directamente o través de las llamadas de API de REST, puede que tenga que realizar tareas posteriores a la migración.
Los siguientes elementos se aplican en todo el servicio:
Las URL antiguas usaban el siguiente patrón:
https://<nombre-servicio>-<nombre-cuenta>.<región>.oraclecloud.com/documents
Las URL nuevas usan el siguiente patrón:
https://<nombre-servicio>-<nombre-cuenta>.<tipo-servicio>.ocp.oraclecloud.com/documents
Integración | Acciones que realizar tras la migración |
---|---|
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 |
|
Llamadas de la API de REST |
|
Uso de SDK/CLI de cliente |
|
Conectores |
|
Nota:
No funcionará ningún marcador de contenido de la instancia antigua porque la URL de la instancia nueva ha cambiado.Los sitios que no incluyen activos se migrarán automáticamente, pero los sitios que sí incluyen activos requieren algunos pasos adicionales para hacer que funcionen en su nueva instancia de Oracle Content Management.
El comando "cec migrate-site" es nuevo, por lo que deberá instalar OCE Toolkit desde el repositorio de Git del cliente web incluso si ya lo ha descargado e instalado anteriormente.
Siga las instrucciones de la página de Sites Toolkit para descargar e instalar OCE Toolkit.
Registre los detalles de conexión para el servidor de destino (el servidor al que va a migrar los sitios):
> cec register-server <target_server_name> -e http://<target_server>:<target_port> -u <target_username> -p <target_password> -t pod_ec
Para migrar sus sitios, realice los siguientes pasos:
<site_name>
por el nombre que desee que tenga el sitio en el servidor de destino:
> cec migrate-site <site_name> --template <template_path_and_name> --destination <registered_target_server_name> --repository <repository_name>
Una vez que haya migrado el sitio, este se ejecutará utilizando llamadas de REST de contenido v1.1. Esto puede causar algunos problemas que deben resolverse para que el sitio se ejecute correctamente. Revise los siguientes puntos para determinar qué debe hacer:
Una vez que el sitio se está ejecutando correctamente, debe hacer que sea compatible con MLS. Si se disponía a crear un sitio de empresa en un servidor de cálculo externo, este precisaría un idioma y una política de localización por defecto. Debido a que el sitio se ha copiado, este es un sitio distinto de MLS, por lo que debe cambiar la versión a un sitio MLS para garantizar que podrá soportar una funcionalidad posterior.
En la siguiente tabla se muestran las diferencias entre sitios MLS y distintos de MLS.
Objeto de sitio | Sitio MLS | Sitio distinto de MLS |
---|---|---|
Elementos de contenido | Se mostrará la variante de idioma del elemento de contenido, en lugar del elemento de contenido soltado en la página. El idioma puede cambiar en función del idioma solicitado cuando se representa el sitio. | El elemento de contenido soltado en la página se mostrará siempre. |
Diseños de contenido | Los diseños de contenido deben soportar las API versión 1.1. De lo contrario, no aparecerá el elemento de contenido y se mostrará una advertencia en su lugar. Esto se debe a que todas las llamadas a la API versión 1.1 tendrán una "locale" agregada que no está soportada en la API versión1.0. | Los diseños de contenido pueden ser de la versión 1.0 o 1.1. Si el diseño de contenido solo soporta la versión 1.0, el ContentSDK agregará una entrada "data" en la respuesta para coincidir con la entrada "fields". Pueden presentarse otros problemas, por lo que no debe considerarse una "función soportada" por no cambiar la versión del diseño de contenido. |
Listas de contenido | Solo se mostrarán los elementos de contenido disponibles en la variante de idioma solicitada. | Se mostrarán todos los elementos de contenido independientemente del idioma. En la lista de contenido, el usuario tiene la posibilidad de adjuntar los resultados a un idioma específico para que pueda disponer de dos listas de contenido en la página que muestren los resultados en dos idiomas. Esta opción del panel de configuración para elegir un idioma no está disponible para los sitios MLS. |
defaultLocale | Los sitios MLS tienen una configuración regional del sitio por defecto. Esto significa que todas las consultas de contenido solo devolverán los elementos de contenido que están en dicha configuración regional (o que no son traducibles). | No hay ninguna configuración regional por defecto en un sitio distinto de MLS, por lo que la consulta de contenido utilizada devuelve todos los elementos de contenido independientemente del idioma. |
Política de localización |
Define la lista de idiomas disponibles para el sitio. Estos se incluirán en una lista desplegable en el creador. También en la interfaz de usuario de gestión se incluirá una lista desplegable de idiomas para que pueda abrir u obtener una vista previa del idioma solicitado. |
Debido a que no hay ninguna política de localización, se eliminará la lista desplegable para cambiar de idioma del creador. En la interfaz de usuario de gestión, no hay ninguna lista de idiomas ni ningún idioma "por defecto". Así es como puede reconocer los sitios distintos de MLS y los sitios MLS en la interfaz de usuario de gestión. |
Traducción/traducible | El menú contextual de la interfaz de usuario de gestión contiene "Traducir" como una opción. Esta le permite crear un trabajo de traducción para traducir el sitio. |
El menú contextual de la interfaz de usuario de gestión tendrá una opción "Traducible". De forma eficaz, un sitio distinto de MLS no es traducible, por lo tanto debe convertirlo primero en traducible (MLS) para poder traducirlo. Así es como se "cambia la versión" de un sitio de no MLS a MLS. Nota: Esta acción solo se puede realizar en un sentido. No se puede cambiar la versión a no traducible. |
Para poder convertir el sitio en un sitio MLS, debe realizar lo siguiente:
A continuación, si tiene algún código de componente personalizado que realiza llamadas de REST de contenido, también debe cambiar su versión para que realice llamadas de la versión 1.1. Esto no es común ya que la mayoría de las llamadas de contenido se realizan desde diseños de contenido.
Cambio de versión de diseños de contenido
Especificación de las versiones de la API de REST de contenido soportadas
Los diseños de contenido deben especificar qué versión de la API de REST de contenido soportan. Esto es para garantizar que se realiza la llamada de REST de contenido adecuada para devolver los datos de respuesta esperados en el diseño.
Si no especifica ningún soporte de versión se asume que el diseño de contenido solo soporta v1.0.
La consola mostrará los diseños de contenido que aún están en v1.0.
Para permitir que el diseño de contenido soporte otras versiones, agregue la propiedad "contentVersion" al objeto de diseño de contenido.
En este ejemplo, se indica que soporta otras versiones entre v1.0 y la anterior a la 2.0 (Nota: la 2.0 no existe, pero un cambio de versión importante puede introducir cambios que pueden causar fallos)
// 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) {
Gestión de cambios de respuesta en v1.1
Lo mínimo que tiene que hacer es gestionar el cambio de respuesta de API de REST de contenido de "data" a "fields". La manera más simple de hacerlo es volver a agregar la propiedad "data" y apuntar a la nueva propiedad "fields"
render: function (parentObj) { ... if(!content.data) { content.data = content.fields; }
Una opción mejor es cambiar el uso del valor "fields" de la v1.1 en todos los diseños de contenido. Esto implicará actualizar el código de plantilla y JavaScript.
Para soportar totalmente la v1.1, debe gestionar los siguientes cambios en la API de REST de contenido entre la v1.0 y la v1.1:
Cambio de la API de REST de contenido | v1.1 | v1.0 |
---|---|---|
"fields" vs. "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" } }, |
nombres de la propiedad camelCase | "updatedDate" | "updateddate" |
formato de consulta | /items?q=(type eq "Starter-Blog-Author") | /items?fields.type.equals="Starter-Blog-Author" |
Versión de API | /content/management/api/v1.1/items | /content/management/api/v1/items |
consultas específicas del idioma | /content/management/api/v1.1/items?q=((type eq "Promo") y (language eq "en-US" or translatable eq "false")) |
No soportado. Debe migrar todas las llamadas personalizadas v1 para incluir la opción "language". Esto garantiza que los resultados sean consistentes con los que se devuelven para el sitio MLS cuando se visualizan en un idioma específico. |
Cambio de versión de la cadena de consulta de contenido
Es posible que esté realizando llamadas a la API de contenido en un código personalizado, por lo que debe validar todo el código personalizado utilizado por el sitio que esté realizando llamadas a la API de REST de contenido.
Conversión de un sitio distinto de MLS a MLS
Una vez que haya convertido el sitio para soportar totalmente las API de REST de contenido v1.1, puede agregar soporte para idiomas cambiándolo a un sitio MLS.
Si selecciona el sitio en la interfaz de usuario de gestión del sitio, se mostrará una opción de menú de contenido "translatable". La selección de esta opción abrirá un cuadro de diálogo que solicita que se seleccione la política de localización y un idioma por defecto para el sitio en la lista de idiomas necesarios de la política de localización. Si no hay ninguna política de localización, no podrá completar este paso y tendrá que ir primero a las pantallas de administración de contenido para crear una política de localización con al menos un idioma necesario.
Después de completar este paso, el sitio se representará en la configuración regional por defecto. También le permitirá cambiar a otras configuraciones regionales especificadas en la política de localización.
Debe validar que el sitio se representa como se esperaba en la configuración regional por defecto.
Los activos que están asociados a los sitios se migrarán cuando migre sus sitios, pero los activos que no están asociados a los sitios deben migrarse por separado.
Antes de iniciar la migración, tenga en cuenta los siguientes puntos:
Para migrar sus activos, realice los siguientes pasos:
Registre los detalles de conexión de los servidores de origen y destino.
Registre el servidor de origen (el servidor desde el que va a migrar los activos):
> cec register-server <source_server_name> -e http://<source_server>:<source_port> -u <source_username> -p <source_password> -t pod_ic
Registre el servidor de destino (el servidor al que va a migrar los activos):
> cec-install % cec register-server <target_server_name> -e http://<source_server>:<source_port> -u <target_username> -p <target_password> -t pod_ec
Migre una recopilación de activos ejecutando el siguiente comando:
> 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>
Los activos se crearán en el servidor de destino en el repositorio especificado y se asociarán a la recopilación y al canal. Si es necesario, la recopilación y el canal se crearán automáticamente. El idioma por defecto de todos los activos migrados será el idioma por defecto que se defina en el repositorio especificado.