Report Services Document Creation Guide Troubleshooting Documents C
Troubleshooting during document execution
I cannot open a document.
If a document has embedded Transaction Services, the document does not open. Instead, a message is displayed, indicating that transaction-enabled documents are not supported in MicroStrategy Developer. Open the document in MicroStrategy Web.
I executed a document and received an error about an incomplete or inconsistent object definition.
The document uses a Freeform SQL report as a dataset. Save this kind of document before you execute it.
I have two lines with the same line weight, but they show different thicknesses in the PDF.
Typically, this viewing problem can be alleviated by using the Zoom In feature (increase the Zoom%) on the PDF. The lines display with the same thickness on the screen. This will not affect the printed output. All lines will print as defined, even if they display differently when viewing an Adobe PDF.
If I see an image in Design View, why doesn’t it show up when I view the document as PDF?
Make sure the image is in .bmp, .jpg, .jpeg, or .gif format. It must be accessible by both the Intelligence Server machine that runs the document and the user who is designing the document.
For example, use a Web server machine to which designers have access and to which the Intelligence Server machine has access. For more information, see
Inserting images in a document, page 152
.
My PDF has an extra page, with a smudge on the left. What happened?
You moved your controls too far to the right. In Design View or Design Mode, move the controls to the left of the vertical page separator, which is represented by a dashed line.
© 2015 MicroStrategy, Inc.
Troubleshooting during document execution
615
C
Troubleshooting Documents Report Services Document Creation Guide
My document contains a link to a prompted report. Answers to the prompts are passed using both the originMessageID and promptsAnswerXML parameters. When I drill on the link, I am prompted, even though the information should have been passed in the link parameters.
Your destination report must contain nested prompts, since the combination of prompt XML and message ID does not work in this case.
A nested prompt is where the definition of one prompt depends on the answer to another prompt. For example, the first prompt is for category, and the second is for subcategory. The list of subcategories for the second prompt depends on the answer to the category prompt. If you use both prompt XML and message ID in this case, when you click the link, the answer to the subcategory prompt is not passed to the destination. You are re-prompted for subcategory.
My document contains 10 reports, and the Jobs per user parameter in the
Project Configuration Editor is set to 5. The document does not finish executing.
The second five reports on the document do not wait until the first five reports execute, so the document cannot finish executing. To execute a document with ten reports, set the Jobs per user and Jobs per user
session
parameters to at least ten. For more information on these Project
Configuration Editor parameters, see the System Administration Guide.
Be cautious increasing these parameters, as you do not want to have multiple users running many jobs simultaneously, which can overwhelm Intelligence Server or your database.
An image does not display in PDF View, when exported to PDF, or in
MicroStrategy Mobile.
Ensure that the image is saved in one of the image types listed below; other image types cannot be displayed in PDF View, when exported to PDF, or in
MicroStrategy Mobile.
•
bmp
•
jpg
•
jpeg
•
gif
616
Troubleshooting during document execution © 2015 MicroStrategy, Inc.
Report Services Document Creation Guide Troubleshooting Documents C
If the image file path is using an http reference to a central Web Server machine, such as http://microstrategy/Test/myimage.jpg, ensure that the URL does not contain any spaces. You can remove the space from the image name or replace the space with %20.
For more information about inserting images into documents, see
Inserting images in a document, page 152
.
Troubleshooting common Flash Mode issues
This section describes some common issues you may encounter as you use
Flash Mode while viewing a document. The issues described in this section are not necessarily issues related to defects in the software itself, but rather notes about how Flash Mode is designed to work.
I cannot switch to Flash Mode in MicroStrategy Web; it is not an option in the
View menu.
To display a document in Flash Mode in MicroStrategy Web, Flash Mode must be enabled for the document, the user, and the project, as described below.
•
A user with the appropriate privileges can enable Flash Mode for a document using either MicroStrategy Web or MicroStrategy Developer.
The steps below are for Web; for steps in MicroStrategy Developer, see the MicroStrategy Developer help (formerly the MicroStrategy Desktop
help).
a In MicroStrategy, Web, open the document in Design or Editable
Mode.
b From the Tools menu, select Document Properties. The Properties dialog box opens.
c From the left, select Document.
d In the Available Display Modes list, select the Flash check box. e You can specify that this document always opens in Flash Mode when it is initially opened in Web. To do this, select Flash from the Run by
default as
drop-down list. f Click OK to apply your changes and return to the document.
© 2015 MicroStrategy, Inc.
Troubleshooting during document execution
617
C
Troubleshooting Documents Report Services Document Creation Guide
•
Enable Flash Mode in your User Preferences in MicroStrategy Web.
a Click the MicroStrategy icon at the top of any page and select
Preferences
.
b On the left, click Report Services. c Select the Enable Flash Mode check box. d Click Apply.
•
In MicroStrategy Web, a project administrator can enable Flash Mode for a project, using the project default preference. Contact your project administrator to enable it.
In MicroStrategy Web, a graph displays in Interactive Mode but does not display properly in Flash Mode.
Some graph styles are not supported in Flash Mode. You may also encounter issues with other aspects of graph formatting which are not supported in
Flash Mode. If issues such as these occur, you must change the graph style of the report to a supported style.
The following graph styles are the graph styles supported in Flash Mode:
Graph Style
Vertical Bar
Horizontal Bar
Vertical Line
Horizontal Line
Graph Sub-type
• Clustered
• Absolute
• Percent
• Stacked
• Dual-axis Clustered
• Dual-axis Absolute
• Dual-axis Stacked
• Clustered
• Absolute
• Percent
• Stacked
• Dual-axis Clustered
• Dual-axis Absolute
• Absolute
• Percent
• Stacked
• Dual-axis Absolute
• Dual-axis Stacked
• Absolute
• Dual-axis Absolute
618
Troubleshooting during document execution © 2015 MicroStrategy, Inc.
Report Services Document Creation Guide Troubleshooting Documents C
Graph Style Graph Sub-type
Vertical Area
Stock
Scatter
• Absolute
• Percent
• Stacked
• Dual-axis Absolute
• Dual-axis Stacked
Horizontal Area • Absolute
• Dual-axis Absolute
Pie • Pie
• Ring Pie
• Multiple Proportional Pies
• Multiple Proportional Ring Pies
Note: Pie graphs may appear slightly larger in Flash Mode than they do in other display modes. The Proportional styles are not displayed proportionally in Flash Mode.
• Hi-Low-Open-Close
• X-Y Scatter
• Dual-axis X-Y Scatter
Bubble
Combination graphs
These graphs use a combination of two graph types
• Bubble
• Dual-axis Bubble
Note: The minimum, maximum, and interval settings for the Bubble graph may not be displayed in Flash Mode exactly as they do in other display modes.
• Bar Area
• Bar Line
• Area Line
• Dual-axis Bar Area
• Dual-axis Bar Line
• Dual-axis Area Line
Note: The alignment of the Y-axis labels can appear differently in Flash
Mode than they do in other display modes.
Other display issues include the following:
•
Nested labels in graphs are not displayed in Flash Mode. If the graph currently uses nested labels, switch to another label type before opening the graph in Flash Mode.
•
If a graph legend is positioned manually rather than automatically, the graph legend may not be displayed in exactly the same position in Flash
Mode.
•
Donut bevel effects for circular data markers in a graph may appear different in Flash mode. For a more consistent look across modes, consider using a different bevel effect, such as Sphere or Smooth Edge.
© 2015 MicroStrategy, Inc.
Troubleshooting during document execution
619
C
Troubleshooting Documents Report Services Document Creation Guide
For complete details on working with graphs, see the Advanced Reporting
Guide.
In MicroStrategy Web, an image displays in Interactive Mode but does not display in Flash Mode.
The image file path may be incorrect or unsupported in Flash Mode. The file location of the image must use an HTTP-based path, not a network or local image path. For information about adding images to documents and using
the correct image path, see
Inserting images in a document, page 152
.
620
Troubleshooting during document execution © 2015 MicroStrategy, Inc.
