Create a Universal Report from scratch
You can build a Universal Report from scratch by defining the report properties and query named ranges.
Before you begin
Start with a new sheet in Excel with the Planning Analytics for Excel add-in loaded.
About this task
A Universal Report contains many different named ranges
that the runtime uses to run the report as expected. However, you need to define only the following
for content to be recognized as a Universal Report:
- Properties cells
- Query cell
- Applicable named ranges that map to the properties and Query cells (p and q named ranges, respectively)
You can create a Universal Report while connected to
multiple databases or datasource, but there are only three cases in which this works:
- If you are signed into one datasource and one server, the TM1PRIMARYDATASOURCE() and TM1PRIMARYDBNAME() functions will be used respectively.
- If you are signed into one datasource and multiple servers, the datasource will use TM1PRIMARYDATASOURCE() and the server will be set to the active server.
- If you are signed into multiple datasources and multiple servers, both the datasource and server will be set to the active ones.
Procedure
Results
The Name Box field displays the named ranges that you created and applied.


You can also see the Universal Report that you just created under the Universal Reports folder on the Workbook tab in the Task Pane.

Tip: If the Universal Report doesn't appear in that folder, try saving the workbook and
reopen it in Excel again. Refreshing the sheet allows Planning Analytics for Excel to execute the
query against TM1 Web's EvaluationService and return the data and axis information.
What to do next
You can continue to define your Universal Report. Add data to the sheet and define the cells in
the following manner:
- Rows - apply the tm2\\_0_r named range to each row cell
- Columns - apply the tm2\\_0_c named range to each column cell
- Data - apply the tm2\\_0_d named range to each data cell
- Slicers - apply the tm2\\_0_slicers named range to each slicer cell
Planning Analytics for Excel automatically adjusts the size of the named ranges to track the returned content from the query execution.
Once you add those ranges, click refresh or rebuild sheet to see the report populate the spreadsheet with the new content.

