Managing Recordsets
Overview
Each time you run analysis on a model, PhixFlow creates a new set of data in each table; see Table. A recordset is a collection of data in a table for a given period.
Recordsets, and the data they contain, remain in the table until you archive the data (see Task) or manually remove it (see rolling back record sets below).
If there is a problem during the analysis run, you may find that a recordset has incorrect or missing data, usually indicated by a yellow highlight in the recordset list. To fix recordsets, you can undo the analysis by running rollback or if you fix the issue and re-run analysis PhixFlow will attempt to repair the recordset.
Opening the Recordset List
- To see a list of recordsets:
- in a model, right-click a table to display the popup toolbar,
- in the repository, right-click a table name to display the context menu,
- in the table properties, click the more menu
- then click Show Recordsets.
- The recordset list shows all recordsets for the table, as illustrated below:
- To view the content of a recordset double click on any row.
- Each time you run analysis on a table the new recordset details are added at the top of the list.
The Recordset List Details
The recordset list includes details about:
- Run ID, a unique identifier for the analysis that has been run It can be used when roiling back.
- From Date,
- For Transactional Tables this is when the analysis was started.
- For Variable Tables this is when the analysis last ran.
- To Date, when analysis finished.
- Created Date, the date the record set was created.
- Size, the number of records in the recordset.
- Status,
- OK, is a complete record set with no issues.
- Incomplete, is a recordset that is incomplete due to an error in analysis.
- Owner, provides the name or the user, or system, that initiated the analysis.
- Archive Time, when it was archived.
- Parent, location of the recordset.
- Cycle, list the cycle of the analysis run when run multiple times.
- Instance ID, an internal id for locating the recordset.
The toolbar has the standard icons and Move Recordsets.
Moving Recordsets
To move recordsets between tables:
- Select one, several or all recordsets in the list.
- Drag Move Recordsets over another table on the analysis model or into a recordset list.
- PhixFlow asks if you want to copy or move the data
- Select an option. For more information see Copying or Moving Table Data.
Viewing Recordset Data
To view the recordset data, double-click on a recordset. PhixFlow opens the default view of the data that the recordset contains. If the recordset contains superseded records they will be included in this view, indicated by a grey background.
Rolling Back Recordsets
See Rollback Recordsets.
For tables with a Period of Transactional, rollback with caution as individual records are updated over time and current records can be distributed across multiple record sets.
For example, an application user edits a record in the table, this can be in a recordset that is not the most recent.
Context Menu
In the recordset list, right-click on a recordset to display the context menu. The options are:
- Show Log File: display the log file for the analysis run that generated this recordset.
- Rollback Recordset: rollback this recordset, and all recordsets that come after it; see Rollback Recordsets.
- Show Recordset Data: display a table showing the data in the recordset.
- Reprocess Recordset: this option is available for incomplete recordsets in an transactional table. Rerun the current recordset.