MicroStrategy Analytics Desktop User Guide
Importing Data into Analytics Desktop   
2
© 2014  MicroStrategy, Inc.
Importing data from a database   
87
two tables. The column used to join tables should keep the records unique, to 
ensure that the records are combined accurately.
For example, you have a City_ID attribute that uniquely identifies each city 
in your data source. If your first table contains City_ID and Revenue 
columns, and the second table contains City_ID and Profit columns, you can 
relate the data in the tables by creating a join between the two City_ID 
columns. This allows you to create a dashboard that shows both Revenue and 
Profit for each city.
Creating a join is important to avoid a cartesian product, or cross join, when 
MicroStrategy automatically generates the SQL to retrieve data from your 
database tables.
Follow the steps below to create a join between the columns in two database 
tables and to select additional options for the join, such as the join type and 
join operator.
For a detailed explanation of joins, see the Advanced Reporting Guide.
Prerequisite
• The steps below assume that you are importing data from a database and 
have added at least two database tables to the Editor panel. For steps to 
import data from a database, see Importing data from a database, 
page 76.
To define a join between the columns of two tables
1 In the Editor panel of the Database page, click and drag the name of the 
column from the first table onto the column from the second table. An 
inner join is created and a line representing the join is displayed in the 
Editor panel, running from the column in the first table to the column in 
the second table.
2 You can specify additional options for the join, such as the join type or 
join operator. Click the line representing the join, then select one of the 
following:
• To only include records in which the joined columns from both tables 
satisfy the join condition, select Inner Join.
Pdf rotate single page and save - rotate PDF page permanently in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Users to Change the Rotation Angle of PDF File Page Using C#
pdf rotate single page; save pdf rotated pages
Pdf rotate single page and save - VB.NET PDF Page Rotate Library: rotate PDF page permanently in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
PDF Document Page Rotation in Visual Basic .NET Class Application
how to change page orientation in pdf document; rotate pages in pdf
Importing Data into Analytics Desktop
MicroStrategy Analytics Desktop User Guide
2
88
Importing data using a Freeform script
© 2014  MicroStrategy, Inc.
• To include all records from the column in the first table and only those 
records from the column in the second table in which the join 
condition is satisfied, select Left Outer Join.
• To include all records from the column in the second table and only 
those records from the column in the first table in which the join 
condition is satisfied, select Right Outer Join.
• To include all records from both tables, select Outer Join.
• To select an operator to use to compare columns, select More 
Options. The Join Options dialog box opens. Do the following:
a In the Join area, select the join type, such as Inner Join or Left 
Outer Join, as described above.
b In the Join Operator area, select the operator used to compare 
columns in the join, such as greater than (<) or equals (=).
c Click OK to apply your changes.
• To delete the join, select Delete.
Related topic
• Importing data from a database, page 76
Importing data using a Freeform script
A Freeform script is a MicroStrategy feature that allows you to write your 
own database queries to retrieve data from a relational database, giving you 
full control over accessing your data. You can import data using a Freeform 
script directly into Analytics Desktop, for use in creating dashboards. For 
example, you can import data from a database using SQL, from third-party 
web services using XQuery, from Salesforce.com using SOQL, or from a 
Hadoop database using HiveQL. You can:
• Import data while creating a dashboard. Your imported data is saved and 
can be used immediately in the dashboard.
• Import and save the Freeform script results to a folder location. If 
desired, you can create a dashboard immediately from the imported data.
VB.NET PDF Page Delete Library: remove PDF pages in vb.net, ASP.
this RasterEdge XDoc.PDF SDK, you can simply delete a single page from a PDF document using VB.NET or remove any page from a PDF document and save to local
rotate individual pdf pages reader; rotate pdf page
C# PDF Page Delete Library: remove PDF pages in C#.net, ASP.NET
How to delete a single page from a PDF document. PDFDocument doc = new PDFDocument(filepath); // Detele page 2 (actually the third page).
rotate one page in pdf; rotate pdf pages and save
MicroStrategy Analytics Desktop User Guide
Importing Data into Analytics Desktop   
2
© 2014  MicroStrategy, Inc.
Importing data using a Freeform script   
89
At a high level, the steps to connect to a database and import data consist of 
the following:
1 Define a connection to a database: While you are importing data from a 
database, you can choose to create a new database connection, or use an 
existing connection. For steps to create a database connection, see 
Connecting to a data source, page 70.
2 Import data. Specific steps are below.
Prerequisites
• Read Best practices: Importing data into Analytics Desktop, page 60.
• The steps below assume that you have created a database connection. For 
steps to create a database connection, see Connecting to a data source, 
page 70.
• The maximum amount of data that can be imported at one time with a 
Freeform script is 1 GB.
• To prepare your data for displaying on a map-based visualization, during 
the data import process you assign geo roles to your data. A geo role 
associates geographical information, such as city or longitude, with a data 
column, allowing you to integrate your data with the Map, Density Map, 
or Map with Areas visualizations. If Image Layout visualizations are 
enabled, a shape key allows you to associate your data with the shape files 
that are displayed in an Image Layout visualization. For more details 
about geo roles and shape keys, see Preparing your data to display on 
maps: Geo roles and shape keys, page 93. Steps are included below to 
assign a geo role or shape key to a data column.
To import and save data using a Freeform script
1 Do one of the following:
• To import data into an existing dashboard to use as a dataset:
a Click the name of the dashboard to run it.
b From the toolbar, click the arrow next to the Add Dataset icon 
, and then select Database.
C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net
Both single page and multi-page Tiff image files String inputFilePath = Program.RootPath + "\\" 1.pdf"; PDFDocument doc = new PDFDocument(inputFilePath
rotate all pages in pdf file; pdf expert rotate page
C# Create PDF from Tiff Library to convert tif images to PDF in C#
Similarly, Tiff image with single page or multiple pages is supported. Description: Convert to PDF and save it on the disk. Parameters:
pdf rotate page and save; how to rotate just one page in pdf
Importing Data into Analytics Desktop
MicroStrategy Analytics Desktop User Guide
2
90
Importing data using a Freeform script
© 2014  MicroStrategy, Inc.
• To import data without immediately adding it to an existing 
dashboard: From any folder page, click Import on the left, and then 
click Data.
Select the data source
2 From the Select Your Data Source panel on the left, click Freeform.
3 From the Database Connections panel on the left, select the name of the 
database connection that contains the data to import. A list of the 
database tables in the selected database is displayed in the Available 
Tables panel.
You can create a new connection to a database while importing 
your data. For steps to create a new database connection, see 
Connecting to a data source, page 70
4 If your database source supports multiple namespaces, you can select a 
namespace from the drop-down list to display only the database tables 
within a selected namespace. To search for a namespace, type the 
namespace in the field. The choices in the drop-down list are filtered as 
you type.
5 To expand the name of a table and view a list of columns in the table, click 
the Expand icon next to the table name. Each column in the table is 
displayed, along with its data type. You can filter the list of database 
tables by typing the name of a table in the search field. The list of tables is 
updated automatically as you type.
By default, MicroStrategy creates a cache of the database’s tables 
and columns when a database connection is first used. To view a 
tooltip containing the time the cache was created, hover the cursor 
over the Information icon  . You can click the Refresh icon to 
update the list of available tables. The list of namespaces available 
in the namespace drop-down list is also updated.
6 You can type a Freeform script to select data from the database, or 
automatically generate the Freeform script you want to use to select data. 
Do one of the following:
• To select data from the database by typing a Freeform script, type 
your script in the Editor panel. If you type a multi-pass SQL 
statement, the data returned will be from the last SELECT pass that 
you typed in the Editor panel.
• To automatically generate a Freeform script to select the data from all 
of the columns in a table, double-click the name of the table in the 
C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
file to the end of another and save to a Remarkably, all those C#.NET PDF document page processing functions and then saved and output as a single PDF with user
how to rotate pdf pages and save; pdf save rotated pages
C#: XDoc.HTML5 Viewer for .NET Online Help Manual
Office 2003 and 2007, PDF. 4. -. 8. rotate page. In the mode of single page view, click to rotate file page 90 degrees in clockwise.
rotate pdf page permanently; pdf rotate all pages
MicroStrategy Analytics Desktop User Guide
Importing Data into Analytics Desktop   
2
© 2014  MicroStrategy, Inc.
Importing data using a Freeform script   
91
Available Tables panel. The Freeform script is automatically added to 
the Editor panel. You can edit the Freeform script as desired. If you 
have already typed text in the Editor panel, the automatically-added 
Freeform script is treated as the last SELECT pass, and the data 
returned will be from this pass.
• To automatically generate a Freeform script to select the data in a 
column, double-click the name of the column in the Available Tables 
panel. The Freeform script is automatically added to the Editor panel. 
You can edit the Freeform script as desired. If you have already typed 
text in the Editor panel, the automatically-added Freeform script is 
treated as the last SELECT pass, and the data returned will be from 
this pass.
7 To run your Freeform script, click the Execute SQL icon  . A preview of 
your query results is displayed below the Editor panel in the Data Preview 
panel.
8 You can delete elements of your Freeform script by deleting text in the 
Editor panel. To clear the entire Freeform script, click the Clear icon  .
9 You can define a data column as an attribute or metric, change the data 
type of attribute data columns, rename data columns, and so on. In the 
Data Preview panel, hover the cursor over the header of the data column 
that you want to select options for, then click the arrow icon to display a 
menu. Select from the following:
• To define the data column as an attribute, point to Attribute.
a If the column’s data type is Date, Time, or DateTime, you can 
define your data in more specific detail by having Analytics 
Desktop automatically generate additional time-related 
information based on the contents of the data column. For 
example, if the column is assigned the Date data type, you can 
have Analytics Desktop automatically generate separate attributes 
for year and month information. Select the check box next to each 
attribute that you want to have automatically generated, then click 
OK. For detailed information about which attributes can be 
generated for each data type, see the Project Design Guide.
b To enable your data to be displayed on a map-based visualization, 
you assign a geo role or shape key to the data column, as described 
in Preparing your data to display on maps: Geo roles and shape 
keys, page 93. Do one of the following:
– To assign a geo role to the data column, select the geo role that 
you want to assign, such as City, State, or Latitude. Select the 
How to C#: Basic SDK Concept of XDoc.PDF for .NET
toolkit, designed particularly for manipulating and managing single-page and multi delete, re-order, copy, paste, cut, rotate, and save PDF page(s), etc.
rotate pdf pages; rotate single page in pdf file
VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
and save as new PDF, without changing the previous two PDF documents at all. This guiding page will help you merge two or more PDF documents into a single one
rotate pdf pages on ipad; rotate a pdf page
Importing Data into Analytics Desktop
MicroStrategy Analytics Desktop User Guide
2
92
Importing data using a Freeform script
© 2014  MicroStrategy, Inc.
check box next to each attribute that you want to have 
automatically generated based on the data column, then click 
OK. For detailed information about which attributes can be 
generated for each geo role, see the Project Design Guide.
– To assign a shape key to the data column, select Others, then 
select the shape key that you want to assign, such as Countries 
of the World or States of USA. Click OK.
– To define the data column without assigning it a geo role, select 
None, then click OK.
• To define the data column as a metric, select Metric.
• To rename the data column, select Rename. Type a name in the field 
and press ENTER.
• To change the data type of an attribute column, point to Data Type, 
then select the data type you want to use.
10 Repeat the appropriate steps above for each data column you want to 
define.
Save the imported data
11 Click Continue. The Save As dialog box opens.
12 Browse to the location to save the imported data, then type a name and 
description for the dataset in the Name and Description fields.
13 Click OK. Your dataset is saved.
• If you imported data while creating a dashboard, the data is added to 
the dashboard as a dataset. For steps to work with datasets on a 
dashboard, see Adding and removing datasets from a dashboard, 
page 110.
• If you are not currently creating a dashboard, the Data Imported page 
is displayed. You can use the imported data to create a dashboard. To 
do this, select Create Dashboard. For steps to create a dashboard, 
see Creating a dashboard, page 106.
Related topics
• Importing Data into Analytics Desktop, page 59
• Best practices: Importing data into Analytics Desktop, page 60
MicroStrategy Analytics Desktop User Guide
Importing Data into Analytics Desktop   
2
© 2014  MicroStrategy, Inc.
Preparing your data to display on maps: Geo roles and shape keys   
93
• Connecting to a data source, page 70
• Creating a DSN, page 73
• Creating a dashboard, page 106
• Providing business context to data: Attributes, page 41
• Calculating data: Metrics, page 42
• Storing data: Datasets, page 43
Preparing your data to display on maps: Geo 
roles and shape keys
Geo roles and shape keys indicate that a data column contains geographical 
information, making it easier to display geographical data on mapping 
visualizations. When your data includes geographical information, you can 
prepare your data to be displayed on a map by assigning geo roles or shape 
keys to each data column that contains geographical data. See the following:
• For background information about preparing your data for displaying on 
map-based visualizations, such as the Map or Density Map visualization, 
see Geo roles and map-based visualizations, page 93.
• For background information about preparing your data for displaying on 
the Image Layout visualization, see Shape keys and the Image Layout 
visualization, page 95.
• For steps to assign geo roles and shape keys, see Assigning geo roles or 
shape keys, page 95.
Geo roles and map-based visualizations
During the data import process, Analytics Desktop automatically attempts to 
determine if any data columns in the data that you have chosen to import 
contain geographical information, such as city or latitude information. When 
Analytics Desktop determines that a data column contains geographical 
information, Analytics Desktop automatically assigns a geo role to identify 
the type of information that the data column contains. You can also assign 
geo roles manually.
Importing Data into Analytics Desktop
MicroStrategy Analytics Desktop User Guide
2
94
Preparing your data to display on maps: Geo roles and shape keys
© 2014  MicroStrategy, Inc.
Assigning a geo role to a data column lets you easily display your geographic 
data in map-based visualizations that require latitude and longitude 
information, such as the Map and Density Map visualizations. When you 
assign a data column the Country, State, City, ZIP Code, or Location geo role, 
Analytics Desktop automatically adds latitude and longitude information to 
the attribute. For example, you import a data column containing the names 
of multiple cities, create an attribute called City, and assign it the City geo 
role. Analytics Desktop automatically adds latitude and longitude 
information for each city to the City attribute. When you create a Map or 
Density Map visualization, you can use the City attribute to provide latitude 
and longitude information for map markers in the visualization. 
Alternatively, you can import separate columns of data for latitude and 
longitude information, and create separate Latitude and Longitude 
attributes. For example, you can assign the Latitude geo role to the latitude 
data column, and assign the Longitude geo role to the longitude data column. 
You can then use the Latitude and Longitude attributes to display map 
markers on a Map or Density Map visualization.
Assigning a geo role to a data column also lets you easily display your 
geographic data on map-based visualizations that require general location 
information, such as the Map with Areas visualization. If you assign a geo 
role to the attribute that contains location information, and then create a 
Map with Areas visualization, Analytics Desktop uses the attribute’s geo role 
to determine the default base map to display in the visualization. The 
visualization will automatically display the first base map that supports the 
attribute’s geo role. For example, if the attribute’s geo role is State, the U.S. 
States Names base map will be displayed in the visualization by default. If a 
geo role has not been assigned to an attribute, you select the appropriate 
base map to use.
Automatically creating additional geographical information based on your data
Once a data column has been assigned a geo role, you can improve the depth 
of the geographical information available for your data by having Analytics 
Desktop automatically generate attributes containing higher levels of 
geographical data based on the data column. For example, if the data column 
contains city data, you can have Analytics Desktop automatically generate 
the State attribute, which contains the state each city is located in.
For detailed information about which attributes can be generated for each 
geo role, see the Project Design Guide.
MicroStrategy Analytics Desktop User Guide
Importing Data into Analytics Desktop   
2
© 2014  MicroStrategy, Inc.
Preparing your data to display on maps: Geo roles and shape keys   
95
Shape keys and the Image Layout visualization
A shape file is an HTML file that contains the background image of an Image 
Layout visualization, as well as the location of each area or bubble marker 
you want to display on top of the image. You can determine which shape file 
to display in an Image Layout visualization by default, by assigning a geo role 
or shape key to the data column.
To create an Image Layout visualization, you must first enable Image 
Layout visualizations by modifying the configuration file that specifies 
which visualizations are available. If you want to display your data as 
a map overlaid with colored areas, consider creating a Map with Areas 
visualization instead. For steps, see Creating a Map with Areas 
visualization, page 168.
For more information and steps to create an Image Layout visualization, see 
Creating an Image Layout visualization, page 152.
Assigning geo roles or shape keys
You assign a geo role or shape key when you import data. For steps to assign 
a geo role or shape key, see the following sections:
• Importing data from a file, page 64
• Importing data from a database, page 76
• Importing data using a Freeform script, page 88
Related topics
• Creating an Image Layout visualization, page 152
• Creating a Map visualization, page 159
• Creating a Density Map visualization, page 164
• Creating a Map with Areas visualization, page 168
• Providing business context to data: Attributes, page 41
Importing Data into Analytics Desktop
MicroStrategy Analytics Desktop User Guide
2
96
Importing a dashboard and data from another MicroStrategy user
© 2014  MicroStrategy, Inc.
Importing a dashboard and data from another 
MicroStrategy user
You can import a dashboard and data that an Analytics Desktop or 
MicroStrategy Analytics Express user has shared with you. When you import 
a dashboard, the entire dashboard, including visualizations, filters, and so 
on, as well as the associated dataset, are imported. You can modify the 
imported dashboard, create new dashboards with the imported dataset, and 
so on.
Prerequisite
• If you are importing a dashboard and its data from MicroStrategy 
Analytics Express, the Analytics Express dashboard must have been 
created using the Visualizations dashboard template in Analytics 
Express. For information about creating dashboards in Analytics 
Express, see the MicroStrategy Analytics Express User Guide.
To import a dashboard and its data
1 From the home page, click Import on the left, and then click 
MicroStrategy File.
2 Navigate to and select the MicroStrategy file to import.
MicroStrategy files have the file extension .mstr.
3 Click Open. The Import dialog box opens.
4 To open the dashboard, click View Dashboard.
Related topics
• Creating a dashboard, page 106
• Displaying a visual representation of your data: Visualizations, 
page 112
• Formatting visualizations, page 194
• Analyzing data in a visualization, page 277
Documents you may be interested
Documents you may be interested