By the end of this section you will be able to associate a Microsoft Excel template with a view.
About the Excel templates used in this section
In this tutorial section, you will use an Excel template called debtOverview.xls
that is already stored on the PhixFlow server.
We have included a copy of this template in train.zip. To see what the template looks like:
- Download train.zip and extract the contents to a folder on your computer (indicated as
<path>
in the following instructions). - Open
<path>\train\excelTemplates\debtOverview.xls
. The file opens with one worksheet, called Formatted Data, which shows how the data will be formatted. - If the file is protected, enable editing.
- There is a another, hidden worksheet. To view
...
First, specify the location of excel templates.
- Find System Configuration in the repository browser. It is right at the bottom of the repository list.
- Open System Configuration and expand it, right-click on the Formatted Data worksheet tab and select Unhide.
The Excel file now has a tab called Basic Data. This worksheet is blank, ready for PhixFlow to populate it with data. Once the first sheet is populated, you can use the data in other sheets.
Info |
---|
When PhixFlow exports data to Excel, it always writes the data to the first worksheet. |
Find the location of Excel templates
- In the repository, scroll to the bottom of the list and open System Configuration.
- Expand the System Directories section.
- Make a note of directory specified in the Template Location, which is set to something like
/opt/phixflow/data/phixflow/excelTemplatestemplates
.
...
Specify an Excel template in a stream view
Open the model
Dashboards and Forms 01-08: Views, filters and dashboards
in the workspace.Expand title How? Insert excerpt _open_model _open_model nopanel true - Open the settings tab for the stream view called
Overall Debt Levels
. Click To do this:First, in the model, click on the stream icon to open the settings for
the
Overall Debt Levels
stream
.
- Then, in the stream settings → Views section,
- double-click on the view called
Overall Debt Levels
.
- Add an Excel template to the stream view configuration form. In the settings → Advanced section , in the → Excel Template box, enter
debtOverview.xls
. - Press
- Open the template you just used. The template itself is stored on the PhixFlow server but a copy is available in input directory you downloaded, under ...\excelTemplates.
- Review the template.
- You will need to unhide the first sheet to see it.
- The first worksheet is called Basic Data. It is blank because PhixFlow always writes exported data to the first worksheet.
- In this example, you can find formatted cells on the worksheet called Formatted Data. You can use data from the first sheet across any number of sheets - this is purely down to what is achievable in Excel.
- Open the view
Overall Debt Levels
and export the data to Excel. - You will see the exported data from PhixFlow in the first worksheet and the formatted output on the second worksheet., then click
.Insert excerpt _finish _finish nopanel true
Export stream view data to Excel
Open the stream view
Overall Debt Levels
and check it has data.Expand title How? Insert excerpt _check_stream_view _check_stream_view nopanel true - In the stream view, click the toolbar icon
.Insert excerpt _excel_export _excel_export nopanel true - PhixFlow opens the Download Data Options window. Click the Excel icon.
- PhixFlow opens a notification in the the bottom right of your screen. Click the notification to download the Excel file.
- Open the Excel file.
- If necessary, enable editing.
- Unhide the Basic Data worksheet to see the exported source data.
- Switch to the Formatted Data worksheet and notice that the debt level is colour-coded.
Snapshot of the formatted Excel data: