KB47283: "Custom Shapes IOError. Error reading the resource $FileName" When executing an ESRI Map with Custom Shapes in MicroStrategy 9.4.1 HF3 ASP.NET environment.

SYMPTOM:
 
An ESRI Map configured with custom areas in Strategy Web 9.4.1 HF3 might show the following error when executing the document in flash mode or the Visual Insight Dashboard:
 

"Custom Shapes IOError. Error reading the resource $FileName"

 
There are several reasons for this error to occur, however, a fiddler trace of the execution will reveal an HTTP 404 Error as shown below:
 
 

 
The Fiddler Web View for the response will show that the exact error message is an HTTP 404.3 error corresponding to a MIME type configuration as illustrated below:
 

 
CAUSE:
 
Keyhole Mark Up Language (KML) files are not pre-configured as allowed MIME types in Microsoft IIS. If the Strategy Web 9.4.1 HF3 administrator wants to enable the custom shape functionality for ESRI then the MIME type for KML has to be enabled by the Web Server Administrator.
 
ACTION:
 
To enable KML files as an allowed MIME type to be served by Microsoft IIS 7.0 follow these steps:

• In the Strategy 9.4.1 HF3 Web Server, open the Internet Information Services (IIS) Manager.
   
  
• Expand the appropriate Server, Site and select the Strategy Application as shown below:
   
   
  

•  
  Note: The Strategy Application might be named differently by the IIS Administrator.
   
  
• In the center panel for features view double-click "MIME Types" as shown below:
  

• Under "Actions" click "Add..." and populate the new window with the following entries as specified by the KML standard:
   
  
  

  
  File Name extension: .kml
  MIME type: application/vnd.google-earth.kml+xml

  
  
   
  

• Restarting the Web Server is not needed, however, the application pool will recycle in the background thus all current sessions will be lost.
  

Important Note: J2EE servers normally come with KML files pre-configured, if this problem is encountered in any other server brand contact the appropriate Web Server administrator.
KB47283