Mpxj

* Add experimental support for reading Deltek Open Plan BK3 files.
* Implemented the `Relation.Builder` class.
* Marked the `Relation(Task,Task,RelationType,Duration)` constructor as deprecated, use the `Relation.Builder` class instead.
* Marked the `RelationContainer.addPredecessor(Task,Task,RelationType,Duration)` method as deprecated, use the `RelationContainer.addPredecessor(Relation.Builder)` method instead.
* Marked the `Task.addPredecessor(Task,RelationType,Duration)` method as deprecated, use the `Task.addPredecessor(Relation.Builder)` method instead.
* Add a notes attribute to the `Relation` class and ensure that it is read from and written to P6 schedules.
* Read the Relationship Lag Calendar setting from Phoenix 5 files. (Contributed by Rohit Sinha)
* Don't write a material label to an MSPDI file for a resource which isn't a material.
* Update representation of Work Variance when writing MSPDI files to more closely match output from Microsoft Project.
* Updated to ensure that when schedules are read from XER files or P6 databases, labor and nonlabor work amounts are combined for the Actual, Remaining and Planned work attributes. This is now consistent with the existing behavior when reading PMXML files.
* Added support for new Task attributes Actual Work Labor, Actual Work Nonlabor, Remaining Work Labor, Remaining Work Nonlabor, Planned Work Labor, Planned Work Nonlabor, when reading and writing P6 schedules.
* Update default `readAll` method on reader classes to ensure that if the reader is unable to read any schedule data, an empty list is returned rather than a list containing `null`.
* Ensure that Task Start and Finish dates are both the same when reading milestones from PMXML files, and that the correct date is used depending on whether we have a Start Milestone or a Finish Milestone.

* Added support for reading and writing the project property Baseline Calendar Name to and from MPP and MSPDI files.
* Ensure Start Variance and Finish Variance are read from and written to MSPDI files in the correct format.
* Improve accuracy of large Work Variance values read from MSPDI files.
* Add support for the Calendar GUID attribute, which is read from MPP and MSPDI files, and written to MSPDI files.
* Ensure Activity Codes are available when reading Phoenix PPX files even if they are also being used to construct the task hierarchy.
* Ensure Activity Codes Values are populated when reading Phoenix PPX files. (Contributed by Rohit Sinha)
* When writing an MSPDI file, derive the TimephasedData Unit attribute from the duration of the timephased data item.
* Fixed an issue with the `ProjectCalendar.getPreviousWorkFinish` method when called with a time which was already at the end of a period of work.
* Ensure that the `proj_node_flag` is set for the root WBS node when writing XER files.

* Updated PMXML schema to version 23.12.
* Ensure that baselines in PMXML files written by Oracle Primavera Cloud are read.
* Fix an issue reading certain XER files and P6 databases where activities lost the relationship with their parent WBS entry.
* Added `ResourceAssignment.getEffectiveCalendar` method.
* Deprecated `ResourceAssignment.getCalendar` method, use `getEffectiveCalendar` method instead.
* Improved reading timephased baseline work from MPP files.
* Added new versions of the `TimephasedUtility.segmentBaselineWork` and `segmentBaselineCost` methods which take a `ProjectCalendar` instance as the first argument rather than a `ProjectFile` instance.
* Deprecated the `TimephasedUtility.segmentBaselineWork` and `segmentBaselineCost` methods which take a `ProjectFile` instance as the first argument.
* Added a new version of the `ProjectCalendar.getDate()` method which just takes a date and a duration as its arguments. This method handles both positive and negative durations.
* Marked the original version of the `ProjectCalendar.getDate()` method as deprecated. Use the new version instead.
* Improve recognition of task splits when reading MPP and MSPDI files.

* Add support for the following Resource Assignment attributes: Remaining Early Start, Remaining Early Finish, Remaining Late Start, and Remaining Late Finish.
* Ensure that the Resource Assignment attributes Remaining Early Start and Remaining Early Finish are read from and written to PMXML files.
* Ensure that the Resource Assignment attributes Remaining Early Start, Remaining Early Finish, Remaining Late Start, and Remaining Late Finish are read from and written to XER files.
* Improve accuracy of reading and writing the `ProjectProperties` Relationship Lag Calendar attribute for PMXML files.
* All P6 scheduling and leveling options which were previously made available via the `ProjectProperties` custom properties map are now deprecated. These properties now have individual getter and setter methods available on the `ProjectProperties` class. Note: this may be a breaking change if you were creating schedules from scratch, populating the custom properties map, then writing PMXML or XER files. In this case you will need to update your code, for all other use cases your code will continue to work unchanged until the next major version of MPXJ.
* Added support for reading and writing the `ProjectProperties` attributes Baseline Type Name, Baseline Type Unique ID, and Last Baseline Update Date for baseline projects in PMXML files.
* When reading projects from PMXML files, if the creation date attribute is not present in the file fall back to populating the `ProjectProperties` creation date attribute with the PMXML date added attribute.
* When writing PMXML files, ensure the date added attribute for projects is populated with the creation date.
* Add the `CustomFieldContainer.remove` method to allow field configurations to be removed.
* Updated the `UserDefinedFieldContainer.remove` method to ensure that any associated field configuration is removed from the `CustomFieldContainer`.
* Ensure that Microsoft Project's "unknown" resource (with Unique ID zero) is not exported to XER files.
* Ensure that resource assignments which are not associated with an Activity or a Resource are not written to XER files.
* Durations are written to PMXML files in hours. We now round to 2 decimal places to allow minutes to be represented, and avoid unnecessary precision.
* Currency amounts written to PMXML files are now rounded to 8 decimal places to more closely match the behavior of P6, and avoid unnecessary precision.
* Decimal amounts other than currency and duration are written to PMXML files with 15 decimal places to more closely match the behavior of P6.
* Fix an issue reading ConceptDraw calendars.
* Fixed a misspelled field name in the JSON output (Contributed by Daniel Taylor).
* Improved handling of the Resource Assignment Planned and Remaining Units and Units per Time attributes read from and written to P6 schedules.
* Added support for the following project properties: Activity ID Prefix, Activity ID Suffix, Activity ID Increment and Activity ID Based On Selected Activity, and ensure these are read from and written to P6 schedules.

* Added support for the WBS Code Separator attribute to `ProjectProperties`.
* Avoid creating duplicate `ActivityCodeValue` instances when reading Asta PP files.
* Added a new version of the `ProjectFile.expandSubprojects` method which takes a `boolean` argument indicating if external tasks should be removed. Passing `true` to this method will recreate predecessor and successor relationships using the original tasks rather than the placeholder external tasks, and will remove the external tasks.
* Marked the `ProjectFile.expandSubprojects()` method as deprecated, use the new version which takes a `boolean` argument instead.
* Ensure the `ProjectProperties` name attribute is set correctly when reading XER files and P6 databases.
* The `ProjectEntityContainer` method `renumberUniqueIDs` has been marked as deprecated.
* The `ProjectEntityContainer` method `getNextUniqueID` has been marked as deprecated. Use `ProjectFile.getUniqueIdObjectSequence(class).getNext()` instead.
* The `ProjectEntityContainer` method `updateUniqueIdCounter` has been marked as deprecated as it is no longer required.
* The `ProjectFile` method `updateUniqueIdCounters` has been marked as deprecated as it is no longer required.
* The `ObjectSequence` method `reset` has been marked as deprecated as it is no longer required.
* When creating a `Location` instance using the `Builder` class, a Unique ID will be generated if one is not supplied.
* The no-arg `Location.Builder` constructor has been marked a deprecated. Use the constructor which requires a `ProjectFile` instance instead.
* Implemented the `ExpenseItem.Builder` class.
* Marked the `ExpenseItem(task)` constructor as deprecated, use the `ExpenseItem.Builder` class instead.
* Marked all `ExpenseItem` setter methods a deprecated. The `ExpenseItem` class will be immutable in the next major release.
* Marked no-arg `UnitOfMeasure.Builder()` constructor as deprecated, use the `UnitOfMeasure.Builder(ProjectFile)` constructor instead.
* Implemented the `Step.Builder` class.
* Marked the `Step(task)` constructor as deprecated, use the `Step.Builder` class instead.
* Marked all `Step` setter methods a deprecated. The `Step` class will be immutable in the next major release.
* Marked the `NotesTopic` constructor as deprecated, use the `NotesTopic.Builder(ProjectFile)` constructor instead.
* Implemented the `ExpenseCategory.Builder` class.
* Marked the `ExpenseCategory` constructor as deprecated, use the `ExpenseCategory.Builder` class instead.
* Implemented the `CostAccount.Builder` class.
* Marked the `CostAccount` constructor as deprecated, use the `CostAccount.Builder` class instead.
* Implemented the `ActivityCodeValue.Builder` class.
* Marked the `ActivityCodeValue` constructor as deprecated, use the `ActivityCodeValue.Builder` class instead.
* Marked the `ActivityCodeValue.setParent` method as deprecated, use the `ActivityCodeValue.Builder` class instead.
* Marked the `ActivityCode.addValue` method as deprecated, use the `ActivityCodeValue.Builder` class instead to create an `ActivityCodeValue` instance and add it directly to the list held by the parent `ActivityCode`.
* Implemented the `ActivityCode.Builder` class.
* Marked the `ActivityCode` constructor as deprecated, use the `ActivityCode.Builder` class instead.
* Only predecessor `Relation` instances are now stored in `RelationContainer`, successors are generated dynamically. You will only notice a difference if you are iterating over the `RelationContainer` collection directly, in which case you will only see predecessors.

* Retrieve role availability data when reading a schedule from a P6 database.
* Populate the project's Name and Title attributes when exporting an MSPDI file.
* Ensure the Project ID attribute is populated when writing an XER file.
* Don't include null tasks (blank tasks) when writing an XER file.
* Strip control characters from entity names written to MSPDI files and XER files.
* Ensure resource material labels written to MSPDI files meet Microsoft Project's naming requirements.
* Ensure the activity code value Name attribute is populated when read from an Asta PP file.
* Don't allow multiple values for an activity code when writing XER and PMXML files.
* The MSPDI and MPX writers now dynamically renumber Unique ID values which are too large for Microsoft Project. The original schedule is no longer modified to achieve this.