- \n
- Node Name<\/b> : Node name should be mapped from that XML element that is :<\/span>\n
- \n
- Unique for every page in the same hierarchy<\/span><\/li>\n
- Never empty or null for any page <\/span><\/li>\n
- Contains no or minimum special characters that are not part of JCR naming restrictions. Restricted characters include : \u201c\/\u201d, \u201c:\u201d, \u201c[\u201c, \u201c]\u201d, \u201c|\u201d, \u201c*\u201d<\/span><\/li>\n
- Not language-dependent: It shouldn\u2019t contain any special characters from other languages. Preferably, it should be same in all languages so that the hierarchy of pages exactly matches in all language copies.<\/span><\/li>\n<\/ol>\n<\/li>\n
- Rich Text <\/b>: Inclusion of Rich Text in the content XML should be done after the HTML escaping is done for special characters and tags as the Package manager will show errors for characters like \u201cLess than(<), Greater than(>), Quotes(\u201c) <\/em>and Ampersand(&)<\/em>\u201d which are to be encoded as “<, >, "e; <\/em>and &”<\/em> respectively.<\/span><\/li>\n
- Tags:<\/b> While adding any Tags to content pages XML’s ‘cq:tags’ property, one should make sure that those Tags are present beforehand in the instance where the package will be installed, otherwise the Package Manager removes all those tags from the pages which are not found in the instance.<\/span><\/li>\n
- XML Formatting<\/strong> : I noticed that unformatted\u00a0XML elements sometimes lead to unsuccessful installation through Package Manager. Thus, content XMLs should be formatted before installation.<\/span><\/li>\n
- DAM Migration Packages:\u00a0<\/b>While installing large content packages like images and documents, one should keep following things in mind:\n
- \n
- Package size should be < 2GB<\/strong>: Package Manager doesn\u2019t allow package size to be over 2 GB. Thus, installation for Image and documents packages should be done in batches. This also helps reduce the performance hit on the\u00a0server.<\/li>\n
- Modes in filter.xml<\/strong>: When installing multiple packages under the\u00a0same hierarchy, Package Manager overrides the parent node and thus child nodes are deleted\/overridden from the last installed package. This is because the default ‘mode’ for filters is ‘replace’. Thus, the\u00a0value of ‘mode’ should be set to ‘merge’ or ‘update’ for the required filters in the filter.xml\u00a0to merge or update the nodes under a hierarchy.
\nYou can find more info about filter.xml and different modes here<\/a>.<\/li>\n- Images<\/b> :\u00a0<\/span>\n
- \n
- AEM provides an OOTB workflow named\u00a0DAM Update Asset,\u00a0<\/em><\/strong>which automatically creates renditions for images that are uploaded to DAM.\u00a0If you already have renditions of images from the previous CMS, before installing the migrated Images Package Manager or uploading them directly to DAM, the 2 launchers (for 2 events, created and modified) for DAM Update Asset<\/em> Workflow should be disabled which<\/span>\u00a0will help reduce the load on the server.<\/li>\n<\/ul>\n<\/li>\n
- <\/b>Documents and PDFs<\/b>\u00a0: <\/span>\n
- \n
- When a PDF is uploaded to DAM, launches the\u00a0DAM Update Asset<\/em> Workflow for Page Extraction<\/strong> and thus launching one instance of\u00a0DAM Update Asset<\/em> Workflow for each page of PDF. If individual pages are not required or you already have them from previous CMS, you should disable the 2 launchers for DAM Update Asset<\/em> Workflow.<\/li>\n
- Disabling the 2 launchers of\u00a0DAM Update Asset<\/em> Workflow will also help when you already have thumbnails<\/strong> for those PDFs from the previous CMS.<\/li>\n<\/ul>\n<\/li>\n
- Launchers can be disabled by selecting the\u00a0Launchers<\/em> tab from\u00a0\/libs\/cq\/workflow\/content\/console.html\u00a0as shown in the below picture.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n
![\"AEM](\"\/blog\/wp-ttn-blog\/uploads\/2016\/07\/Screenshot-from-2016-07-23-15-01-25.png\")
<\/p>\n- \n
- Move\/Rename Pages in Migrated Content:\u00a0<\/strong>\u00a0<\/span>\n
- \n
- Once the migration of Pages is done and you realize that any Migrated Pages are needed to be moved\/renamed, \u00a0this move should be done using Siteadmin’s Move\/Rename feature, which updates all the references to that page in other pages\/components.\u00a0<\/span><\/li>\n
- In Classic UI mode, this Move\/Rename<\/em>\u00a0feature updates a max of 150 references by default and if more references are found, it will just move\/rename the page without updating any references. Whereas in Touch UI, although it doesn’t show the references above 150, it still updates all of them.
\nThis default value can be updated by<\/p>\n- \n
- Overlaying\u00a0\/libs\/cq\/ui\/widgets\/source\/widgets\/wcm\/HeavyMoveDialog.js\u00a0and changing the value of\u00a0maxRefNo<\/strong><\/em> in Classic UI mode.<\/li>\n
- Changing the value of maxreferences<\/strong><\/em> property in\u00a0\/libs\/wcm\/core\/content\/sites\/movepagewizard\/jcr:content\/body\/content\/items\/referencesStep\/items\/references<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n
- In Classic UI mode, this Move\/Rename<\/em>\u00a0feature updates a max of 150 references by default and if more references are found, it will just move\/rename the page without updating any references. Whereas in Touch UI, although it doesn’t show the references above 150, it still updates all of them.
- Once the migration of Pages is done and you realize that any Migrated Pages are needed to be moved\/renamed, \u00a0this move should be done using Siteadmin’s Move\/Rename feature, which updates all the references to that page in other pages\/components.\u00a0<\/span><\/li>\n
- Disabling the 2 launchers of\u00a0DAM Update Asset<\/em> Workflow will also help when you already have thumbnails<\/strong> for those PDFs from the previous CMS.<\/li>\n<\/ul>\n<\/li>\n
- <\/b>Documents and PDFs<\/b>\u00a0: <\/span>\n
- Modes in filter.xml<\/strong>: When installing multiple packages under the\u00a0same hierarchy, Package Manager overrides the parent node and thus child nodes are deleted\/overridden from the last installed package. This is because the default ‘mode’ for filters is ‘replace’. Thus, the\u00a0value of ‘mode’ should be set to ‘merge’ or ‘update’ for the required filters in the filter.xml\u00a0to merge or update the nodes under a hierarchy.
- Never empty or null for any page <\/span><\/li>\n
- Unique for every page in the same hierarchy<\/span><\/li>\n