EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

Images with accents or spaces in names defined inside Dossiers are not exported to PDF.


Ramses Castro Cabrera

Senior Cloud Support Engineer II • MicroStrategy


Beginning in MicroStrategy 10.6, the MicroStrategy PDF Exporter (also known as New Export Engine or NEE) service has been added to support exporting from Visual Insight / Dossier to PDF format. The main purpose of this service is to generate PDF outputs from the information contained inside a dossier or report. As a side service, it counts on its own logic, components, and workflow to generate a PDF. This article intends to explain a part of the encoding issues when using special characters.

Starting with the release of Strategy ONE (March 2024), dossiers are also known as dashboards.

KB486110SYMPTOM: 

  
Images with accents or spaces in name (name of the image file itself) are not exported to pdf but the same images are visible without issues in MSTR Web or Library. 
 
Examples of this behavior would be using files with names such as <image of the day> which will not be exported but when using underscore or eliminating the spaces will work, for example <image_of_the_day>. This situation is replicated when images with accents in the names are used. 
 

REASON: 

  
As a rule, in Computer Science, it is never recommended to use accents or special characters when naming files. This fact doesn't limit to accents but also to special letters in different languages (e.g., ź, ķ, ő, etc.). The same logic applies to spaces, being recommended always to avoid separations by using '-' or '_'. This behavior will not be the same as in a normal web page or We application since the way the images are processes is different, for example in HTML when adding special characters, these will be displayed correctly almost all the time.  
 
Talking about MSTR software, but more specifically about the PDF Export Engine, it works based on a specific encoding. Each time that an image is placed or called in a dossier to be exported, the engine will follow the path of the image, browsing it based on the name of the file itself. To achieve this, a json file is generated during the export process which uses a specific type of encoding.  
 
This json file encoding will find troubles when the source images and other references contain spaces and special characters. This is the way it is programmed, along with multiple computational languages. It is expected behavior to standardize the code language worldwide.  
 

ACTION: 

 
The straightforward solution is always to change the name of the images inside the container folder to a more standard and computer-friendly name. This means that the image names should be preferably short or easy to identify but also to avoid spaces/accents in it. 
 


Comment

0 comments

Details

Knowledge Article

Published:

June 30, 2023

Last Updated:

March 21, 2024