Which files are accepted
The file must be well-formed XML, and either its root element name contains bam or it contains Activity or View elements. It must contain at least one Activity or View.
The BAMDefinition format
From version 0.2.0 the viewer reads the BAMDefinition XML that bm.exe get-defxml and the BAM Excel add-in export:
- Checkpoints: a
CheckpointwhoseDataTypeisDATETIMEis a milestone; any other checkpoint is a data item, shown with its type and length, such asNVARCHAR(50). - References by ID:
ActivityRef,CheckpointRef,AliasRef,StartRef/EndRefandViewRefare shown as the names of the elements they point to. - Cubes: the measures and dimensions of a
Cubeappear under the view itsViewRefnames (or under the only view, if there is one). - Durations appear with the aliases of their view, with their start and end.
Elements and attributes
Element names are matched without regard to case or namespace prefix. Attribute names are matched as written or with a capital first letter (name or Name).
| List | Elements read | Attributes used |
|---|---|---|
| Activities | Activity | name (an Activity inside a View, ActivityView or Cube is not listed as an activity) |
| Milestones | Checkpoint (DATETIME), BusinessMilestone, Milestone | name, dataType or type, and a reference such as milestoneRef or ref |
| Data items | Checkpoint (other types), BusinessData, ActivityItem | name, dataType and dataLength, and a reference such as activityItemRef, dataItemRef or ref |
| Relationships | RelatedActivity, ActivityRelationship, Relationship | name, and activityRef, ref or relatedActivity |
| Views | View | name |
| View activities | ActivityView | ActivityRef (shown as the activity's name), or name |
| Aliases and durations | Alias, ViewItem, Duration | name, and CheckpointRef, StartRef or EndRef |
| Measures | Measure | name, AliasRef, and AggregationFunction |
| Dimensions | Dimension, ProgressDimension, TimeDimension, DataDimension, NumericRangeDimension | name |
An activity or view without a name is shown as Activity 1, View 1 and so on. Version 0.1.0 read only the BusinessMilestone, BusinessData and ActivityItem forms; update to 0.2.0 for BAMDefinition exports.
Elements with other names are not shown. If a list is empty although the definition has content, compare the element names in the file with this table, and report the export format on GitHub.