20R1 CLM Content Display Change for large iPads

With the 20R1 release, Veeva CRM will take full advantage of iPads with screen sizes greater than 10.2”. However, users will see a behavior change when viewing HTML content in the CLM Media Library. 

By default, all HTML content will display ‘framed’ by a black border. The content will display as if it’s 1024 x 768 pixels, the logical screen resolution of standard 9.7” iPads. This is to ensure all content displays and functions properly.

Customers can optionally change the default to improve the content display for specific scenarios described below. Veeva provides three options:

  • Scale_to_1024x768 (default option). Content will display letterboxed in a virtual 1024 x 768 pixel window. 
  • Default for Device (aka Native Resolution). Content will display in the device's default resolution. This is the recommended option when content is built using modern ‘responsive’ web content standards. (If the content is not responsive, it will probably display positioned to the upper left with a white border on the right and bottom edges.)
  • Scale to Fit. This option simulates how content displayed prior to 20R1. This will scale up (zoom) content to fill the available screen real estate. This option should only be evaluated for older content that is designed using a 1024 x 768 fixed pixel layout. After launching a presentation, the content may briefly display in its original size before scaling up. We DO NOT recommend this option for responsive content designed to use the native device resolution. We cannot guarantee that all content will scale properly, and this option should only be used after thorough testing. We cannot evaluate content defects when using this option. 

Example showing all options for legacy fixed layout 1024 x 768 content

Example showing all options for responsive content

How can customers quickly evaluate existing HTML content?

  • Install the Veeva CLM Evaluation app to test HTML content. (No CRM configuration is required, and the app can co-exist with Veeva CRM on iOS) Install the WKWebView Eval version https://tinyurl.com/ybn8pkdp
  • Content displays in the default option - Scale_to_1024x768
  • To change the CLM display option, go to iOS Settings app->Scroll down to CLM Eval->tap iOS Resolution Option->select an option.
  • Return to CLM Eval app, and select a presentation to view. The selected display option will be used

Content Expectations

  • The configuration only apples to HTML CLM content (images, PDF, videos are not impacted)
  • Work with your content partners to determine the best option for your content
  • We believe most HTML content is built with a fixed 1024  x 768 layout, and the Scale_to_1024x768 (default) or Scale to Fit options will work best. But your content partner will know best.
  • Responsive HTML content should probably use the Default for Device option

If I want to change the default option, how can I do that?

  • This can be done after 20R1 is available in production. Configuration instructions are in CRM Help Documentation
  • A new picklist field Key_Message_vod.ios_resolution_vod must be set and visible to end users
  • If using Vault to manage content, a new Document Field iOS Resolution must be set on the Multichannel Presentation Slide doctype
  • The CLM-Vault integration mapping must be updated to sync the Vault iOS Resolution field value to CRM Key_Message_vod.ios_resolution_vod

Why the change? 

Prior to 20R1, on large screen iPads (most noticeable on 11” and 12.9” iPad Pros) Veeva CRM would display ‘scaled up’ to fill as much of the screen as possible, and content was also scaled up to fit. Veeva CRM emulated the display of classic 9.7” iPad with a 1024 x 768 pixels. 

Most customers today use large screen iPads for some or all of their field forces, and this is increasing rapidly. Customers have requested this change so their users can work more effectively on large iPads. Content partners have also requested this so they can deliver content suited for the larger displays.

In 20R1, Veeva CRM natively uses all pixels available on large iPads. This allows more page layout rows to be displayed vertically. However, most legacy content is specifically coded by partners to only use 1024 x 768 pixels, and cannot take advantage of the additional display pixels. As a result, we default to display all content in a 1024 x 768 window framed with black borders, which is a compromise to ensure all content renders properly.

Which iPad models are impacted?

  • iPad Pro 12.9” (A1584 A1652 A1670 A1671 A1876 A1895 A2014 A1983)
  • iPad Pro 10.5” (A1701 A1709)
  • iPad Pro 11” (A1980 A1934 A2013 A1979)
  • iPad Air 2019 10.5” (A2152 A2123 A2153 A2154)
  • iPad 2019 10.2” (A2197 A2200 A2198)

Comments not allowed