Migration Mapping Rules

For DCEG, see DCEG Migration Rules

Things to Discuss:

• How will inline templates get migrated/mapped? For example, how will an inline image (right/left, small/medium etc.) get properly migrated onto the page in Drupal?

Site Section Migration Rules

RULES:

• For Cgov - if there is a nav landing page set in a navon, make that the site section landing page.
• For DCEG - if there is no pretty URL for a page, it should become the landing page for that folder.
• For a section nav root, this is true if the source navon has a section nav content item slotted into the section nav slot.
• For Cgov - if hide_in_section_nav is true, and there is not another piece of page-level content in the folder, do not create site section.

These still need to be discussed/vetted:

1. If the navon Nav Label (Section Name) is set, make that the Section Name
2. If navon Nav Label (Section Name) is not set, use the short title of the nav landing page
3. If there is no navon Nav Label (Section Name) set, and no nav landing page slotted into the navon, use the System Title (that actually is the folder name)

The issue is that IAs are finding these may not be detailed enough for Section Name in Drupal without the folder structure to provide context. These rules work for the most part, but not in all cases. Need to determine how IAs can provide Section Name Overrides.

Pretty URLs

• These should all migrate in as lower case pretty URL name

Descriptions

• Meta-description goes to field_page_description (meta description)
  • If meta-description is empty, push long description to field_page_description
• Short description goes to field_feature_card_description
• Long description goes to field_list_description
• Exclude from Search goes to Search-Engine-Restrictions
• Keywords goes to Syndication Keywords

Titles

• Browser Title should be required Display Rules:
• Card Title - display card title. If no card title, display browser title.
• Browser Title - display browser title (this is now required)
• OG: Title - display Browser Title

Percussion	Migration Rule
Short Title	Short --> Browser
Short Title & Browser Title	Short --> Card & Browser --> Browser
Short Title & Card Title	Short --> Browser & Card --> Card
Short Title, Browser Title, & Card Title	Browser --> Browser & Card --> Card

Infographic

• For infographics - there are currently glo images slotted to the infographics for the different crops. These will migrate to promotional image field on the infographic.

Images

• If a glo image that has been slotted into image slot has an article image in that field, then the glo image is migrated to the Lead Image field.
• If a glo image that has been slotted into image slot does not have an article image in that field, or the content type does not have a lead image field, then the glo image is migrated to the Promotional Image field.
• When migrating the glo image into Drupal, if there is no article crop, use the feature card crop to populate this required field. This rule has no impact on the first two bullets above — this glo image should still be migrated to the Promotional Image field.

cgov_image

Percussion	Drupal
img1 (if no img3)	field_media_image
img2	field_override_thumbnail
img3	field_media_image
img4	field_override_feature
img5	field_override_panoramic
img6	field_override_social

cgov_contextual_image

Percussion	Drupal
img1 (if no img3)	field_media_image
img3	field_media_image

Translation Images

• English image and Translated Spanish image migrate into Drupal with a single image file, with the separate caption/alt text/credit, according to language.
• If the image in percussion is in gloImage only Spanish, check file name to see if it's the same as English.
• If the file name is different,
  • English Images --> EN
  • Spanish Images --> ES

Banner Images - Mini Landing & Blog Series

• In Percussion, Topic Page and Blog Series banners are added to a content block, and the content block is added to the Cancergov Body Header slot. This should map to field_banner_image in Drupal on Mini Landing Page and Blog Series.
• Note: home/landing page banners + taglines will be added manually during the content freeze CGOV-9272

Videos

• For all video pages, we will need to append the youtube URL to the YouTube ID that has been provided in percussion when we migrate the youtube ID field to youtube URL field
  • This should be appended before the YouTube ID: https://www.youtube.com/watch?v=

Related Resources

Custom Links

• If a custom link has been slotted into related resources, that custom link's title field need to be mapped to override title

External Links

• If an external link has been slotted into related resources, that external link's title field should be mapped to the title and the URL field mapped to the link.

Card Fallback Rules

• Feature Cards:
  • override card title > card title > short title
  • override card description > feature card description > nothing
• Thumbnail cards
  • Override card title > card title > short title
  • Override card desc > listing description > nothing

Topic to Mini Landing Rules

• Anything in the intro text field should be mapped to a content block at the top of the page.
• Any items slotted into Primary Feature Card Slot should be mapped to the two item feature card row (field_two_item_row_cards)
• Anything in the body field should be mapped to a content block. This content block appears below field_two_item_row_cards.
• Items slotted into Thumbnail Slot should be mapped to list with images
• Items slotted into the Body Slot should be mapped to list in Drupal:

Percussion	Drupal
(No List Title) LI Desc Img	list with images, do not display list title
(No List Title) LI Desc No Img	list without images, do not display list title
LI Desc Img	list with images, display list title
LI Desc No Img	list without images, display list title
Compact List	compact list

Links (Home/Landing, Mini-Landing)

Cgov_Card_Internal

• Cgov_Primary_feature_row
  • field_row_cards
• Cgov_two_item_row
  • field_two_item_row_cards
• Cgov_Secondary_feature_row
  • field_row_cards
• Cgov_Blog
  • field_recommended_content
• Cgov_multimedia_row
  • field_one_card

Cgov_Card_External

• Cgov_list
  • Cgov_list_items
• Cgov_* (article, blog post, press release...)
  • field_related_resources
• Cgov_cthp_guide_card
  • field_view_more_information
• Cgov_research_page
  • field_list_items

Search Restrictions

• If the "exclude from search" is selected in Percussion, then the dropdown value in field_search_engine_restrictions in Drupal should be set to "exclude from search".
• If the "exclude from search" is not selected in Percussion, then the dropdown value in field_search_engine_restrictions in Drupal should be "Include in search"