從舊版雲端基礎架構移轉 Oracle Content Management 執行處理

"cec migrate-site" 是新的命令，因此您將需要從 Webclient Git 儲存區域安裝 OCE 工具程式，即使您先前已下載且已安裝也是如此。

依照Sites 工具程式頁面中的指示下載並安裝 OCE 工具程式。

註冊目標伺服器的連線詳細資訊 (要將網站移轉至該伺服器)：

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

• <target_server_name> 主要用於識別目標端點，可以是選擇的任意名稱。
• <target_server> 和 <target_port> 構成供用於存取目標伺服器的 URL。
• <target_username> 和 <target_password> 必須是將從來源伺服器匯出網站樣板之人員的使用者名稱和密碼，如此在移轉期間匯入樣板時才不會發生權限問題。
• "pod_ec" 值是目標伺服器類型，用來識別建置執行處理的伺服器類型。

若要移轉您的網站，請執行下列步驟：

1. 在來源伺服器上，從每個包含資產的網站建立樣板。
2. 在來源伺服器上，匯出每個樣板。請確定以您註冊目標伺服器時所參照的使用者身分執行此步驟。
3. 在目標伺服器上，以儲存區域管理員 (具備 CECRepositoryAdministrator 角色的使用者) 身分登入。然後，為將與樣板一起匯入的資產建立儲存區域。
4. 針對每個下載的樣板，執行下列命令，並將 <site_name> 取代為您希望網站在目標伺服器上的名稱：

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

5. 在目標伺服器上，適當地共用移轉的網站和資產。

移轉您的網站後，將會使用 Content REST v1.1 呼叫來執行網站。這可能會導致一些問題，需要先解決這些問題才能正確地執行網站。請查看下列幾點事項來判斷您需要執行的作業：

• 如果您使用的是 ContentSDK，您的呼叫將會自動更新為使用 v1.1 Content REST 呼叫。
• 如果您的內容版面配置沒有顯示支援 v1.1，ContentSDK 將會在回應中新增只會指向 "fields" 項目 (v1.1) 的 "data" 項目 (v1.0)，因此您的樣板可以繼續作業，不會有任何變更。
• 如果您在其他查詢字串中使用 "fields.type.equals=" v1.0 Content REST 語法，我們會嘗試剖析並將此語法修改為 v1.1 語法，但您應該加以驗證。
• 如果您進行任何直接 (而不是透過 ContentSDK) Content REST v1.0 呼叫，將會失敗。您將需要修正自訂程式碼並升級這些呼叫。
• 同樣地您也需要自訂內容查詢，將 "fields.type.equals=" v1.0 語法修改為 "q=(type eq "..")" 語法。
• "updateddate" 與 "updatedDate"：CaaS 應該會修正這類內容，但您需要將 "updateddate" 值變更為 camelCase 的 "updatedDate" 值，直到我們取得 Content REST v1.1 支援這兩個值的 EC 建構為止。

您的網站正確執行之後，接著需要讓您的網站符合 MLS。若要在外部運算伺服器中建立企業網站，則需要預設語言和本地化規定。由於是將您的網站整個複製，它並不是 MLS 網站，因此您需要將網站升級為 MLS 網站，以確保網站能夠支援未來的功能。

下列表格顯示 MLS 和非 MLS 網站的差異。

您需要執行下列作業，才能將網站設為 MLS 網站：

• 將所有內容版面配置元件升級以支援 Content REST API v1.1
• 升級網站中所有內容清單的「其他查詢字串」，以便與 Content REST API v1.1 相容

接者，如果您碰巧擁有可進行 Content REST 呼叫的自訂元件程式碼，也需要將其升級以進行 v1.1 呼叫。這不是常見的狀況，因為大部分情況都是從內容版面配置進行內容呼叫。

升級內容版面配置

指定支援的 Content REST API 版本

內容版面配置需要指定他們所支援的 Content REST API 版本。這是為了確保會進行適當的 Content REST 呼叫，以便將預期回應資料傳回給版面配置。

如果您未指定支援的任何版本，系統將假設內容版面配置僅支援 v1.0。

主控台會列出仍使用 v1.0 的內容版面配置。

若要讓您的內容版面配置支援其他版本，請將 "contentVersion" 特性新增至內容版面配置物件。

在以下範例中，它顯示支援 v1.0 且小於 2.0 的所有版本 (備註：2.0 並不存在，主要版本變更可能會引進重大變革)

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

處理 v1.1 回應變更

您至少需要將處理 Content REST API 回應從 "data" 變更為 "fields"。最簡單的方式就是加回 "data" 特性，並指向新的 "fields" 特性：

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

更好的方式是在內容版面配置中全部改用 v1.1 "fields" 值。這將與更新 JavaScript 和樣板程式碼有關。

若要完整支援 v1.1，您將需要處理下列 v1.0 和 v1.1 之間的 Content REST API 差異：

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

升級內容查詢字串

您可能會以任何自訂程式碼進行 Content API 呼叫，因此您需要驗證網站中用來進行 Content REST API 呼叫的所有自訂程式碼。

• 自訂元件：檢查下列元件：
  • 內容版面配置
  • 本機元件
  • 區段版面配置
  • 遠端元件
• 主題：JavaScript：雖然可能性不大，不過您的主題可能具有進行自訂 Content REST API 呼叫的 JavaScript，因此也需要驗證這些 JavaScript。
• 網站特性：其他查詢字串：確認您已經將所有進行 Content REST API 呼叫的自訂程式碼升級之後，也需要將網站中任何頁面之任何「內容清單」元件中的「其他查詢字串」升級。當我們在程式實際執行嘗試剖析及轉換這些字串時，這些字串也應升級為與 v1.1 Content REST 呼叫相容以繼續取得支援。

將非 MLS 網站轉換為 MLS 網站

當您已將網站轉換為完整支援 v1.1 Content REST API，您可以藉由變更為 MLS 網站來新增語言支援。

如果在網站管理 UI 中選取您的網站，您將會看到「可翻譯」內容功能表選項。選取此選項將會顯示一個對話方塊，要求您從本地化規定的必要語言清單中選擇網站的本地化規定與預設語言。如果沒有任何本地化規定，您將無法完成此步驟，且您必須先前往內容管理畫面，然後至少使用一個必要語言建立本地化規定。

完成此步驟之後，您的網站現在將會以預設地區設定呈現。也能讓您切換至本地化規定中指定的其他地區設定。

您需要確認網站是否如預期以預設的地區設定呈現。

註冊來源與目標伺服器的連線詳細資訊。

註冊來源伺服器 (要從該伺服器移轉資產)：

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

• <source_server_name> 主要用於識別來源端點，可以是選擇的任意名稱。
• <source_server> 和 <source_port> 構成供用於存取來源伺服器的 URL。
• <source_username> 和 <source_password> 必須是可以存取來源伺服器上資產之人員的使用者名稱和密碼。
• "pod_ic" 值是來源伺服器類型，用來識別建置執行處理的伺服器類型。

註冊目標伺服器 (要將資產移轉至該伺服器)：

> 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> 主要用於識別目標端點，可以是選擇的任意名稱。
• <target_server> 和 <target_port> 構成供用於存取目標伺服器的 URL。
• <target_username> 和 <target_password> 必須是將擁有目標伺服器上資產之人員的使用者名稱和密碼。
• "pod_ec" 值是目標伺服器類型，用來識別建置執行處理的伺服器類型。

執行以下命令移轉資產的集合：

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

資產將會在指定儲存區域中的目標伺服器上建立，並會與集合和通道建立關聯。如有必要，將會自動建立集合和通道。所有移轉資產的預設語言將會是指定儲存區域中設定的預設語言。