dSPACE SystemDesk 4.0                                       December 2013
Last-Minute Information
*************************************************************************
Copyright (c) 2013 dSPACE GmbH, Germany


Contents:

1.  General
2.  Improvements & fixed Problems
2.1 Improvements & fixed Problems by previous Patches
3.  Limitations
4.  Installing the Patch


1. General
*************************************************************************

This patch can only be installed on an existing SystemDesk 4.0
installation (dSPACE Release 7.4).

IMPORTANT:
In case Microsoft .NET Framework 4.5 is installed the Microsoft update
http://support.microsoft.com/kb/2750147/en-us
must also be installed.

2. Improvements & fixed Problems
*************************************************************************

Dialogs:
 - Fixed deleting an internal behavior within the property dialog.

Diagrams:
 - Component Diagram now opening correctly. 

Import/Export:
 - Fixed a problem where the existence of the file "xml.xsd" in the
   directory of the project file would lead to a failing AUTOSAR import.
   
2.1 Improvements & fixed Problems by previous Patches
*************************************************************************

Patch 1:

ARConverter:
- Fixed faulty conversion and added further conversions
  for AUTOSAR elements.

Automation:
- A list of names for graphical elements can now be returned.
- Fixed exception that occured when adding an interface object
  to a graphical port.
- Replaced nullable return parameters, which are not COM compatible,
  with non-nullable return parameters and added additional
  IsDefined properties to identify return values that are null.
- Improved automation interface of AUTOSAR import/export/Master files:
  Added boolean return values for import/export, Master file reading/writing.
  Added GetLastError() method to get information about failed operations.
- Added missing String, Value, ARAttribute properties.
- Improved enum handling via automation.
- Each AUTOSAR-Identifiable now has the properties CustomFileAttributes
  and CustomStringAttributes, which allow convenient access to the
  custom attributes of the respective kind.
  These two properties offer the typical accessors and methods known
  from other lists used in the AutomationFacade:
  - Elements: Returns an array of the custom attributes
  - Items(string name): Returns an array of the custom attributes
    with the specified name
  - Parent, Names, Contains(), IndexOf(), Remove(), RemoveAt(), Count, Clear()
    as known from other Automation lists
  The custom attributes (e.g. returned by the Elements accessor) can be
  accessed with the Name and Value property, which return the name and value
  of the custom attribute. Further they can be deleted with Delete().
- Every Reference has Path, Base, Dest and State attribute now.
  Example for UnitRefs: string UnitRefPath, string UnitRefBase,
  string UnitRefDest, ORTargetAccessErrorKind UnitRefState Lists
  of References return the string or state by Index,
  e.g. string RefPathForIndex(int index).
  The References list contains Elements that can be null
  if there is no the Target is unresolved.

ContainerManager:
- Container export element collection algorithm
  will consider indirectly referenced elements as from now. 

Demos:
- The AR_PosControl demo has been redesigned for SystemDesk 4.0.
- A new AUTOSAR 4.0 Tutorial demo has been created for SystemDesk 4.0.
- Updated documentation for demos.
  Help -> Contents -> (expand tree) Software -> SystemDesk 4.x -> SystemDesk 4.x Tutorial
  
Diagram:
- Modified check for port connection state.
- Fixed F1-Help in toolbox.
- Deactived diagram menues when diagram loses focus.
- Edit mode will be deactivated during scrolling.
- Fixed infrequent null reference exception in diagram.

Import/Export:
- Reimporting AUTOSAR files no longer corrupts existing formulas.
- Fixed wrong display of port name in the project tree after an AUTOSAR import.
- Changed the signature of the ExportElements method in the automation interface.
  The method now accepts user-defined lists of packages and elements
  instead of SystemDesk automation lists. Before, it was not possible
  to supply this method with custom collections of AUTOSAR elements.
  Before: 
   - project.Serializer.ExportElements
     (project.RootAUTOSAR.ArPackages, None, "C:\\example.arxml", 
     SystemDeskEnums.ArSchemas.Autosar403, False, False, False) 
     (Used to export the entire project)
   Attention: DO NOT USE this anymore. This call will now result
   in a com_error with the description 
   "Object reference not set to an instance of an object.".
  Now:
   - project.Serializer.ExportElements(project.RootAUTOSAR.ArPackages.Elements, None, ...
   Note the added ".Elements" part. DO USE this.
   To export a user-defined subset of a project, call the 
   ExportElements method with lists of ArPackages and PackageableElements:
   pkgSwcs = project.RootAUTOSAR.ArPackages.Item("SWCs")
   pkgDts = project.RootAUTOSAR.ArPackages.Item("DTs")
   dtFlow = pkgDts.Elements.Item("DtFlow")
   dtPressure = pkgDts.Elements.Item("DtPressure")
   project.Serializer.ExportElements([pkgSwcs], [dtFlow, dtPressure],
   "C:\\example.arxml", SystemDeskEnums.ArSchemas.Autosar403, False, False, False)
   This will export all child elements and child packages of the ArPackage
   "/SWCs" and, additionally, the elements "/DTs/DtFlow" and "/DTs/DtPressure".
- Improved memory usage of import dialog.

SoftwareSystems:
- Fixed error handling in SwDataDefProps.
- Correct the asset structure of local data access instances.
- Selection of exclusive areas in "New..." dialog box interacted wrongly
  between "Can Enter" and "Run Inside" tab pages.
- Field "Trigger ref" in "WaitPoint" dialog showed wrong label text.
- "Variable Prototype" and "Data Type" columns in tab page
  "Local Variables (Read)" of "RunnableEntity" dialog did not show
  any information.
- Fixed invalid value creation for application data types.
- Delete button did not work in the "Data Read/Write" tab page
  of the "RunnableEntity" dialog.
- Improved text pattern check for restricted properties.
- Fixed initial property setting for ComSpecs.
- Values of texttable compu methods now are written
  to VT property, no longer into SHORT-LABEL.
- The trigger selection dialog no longer modifies runnables.
- Fixed wrong selection in Selection Dialog.
- Compu methods no longer will be corrupted by certain validation rules.

System:
- Fixed error in system-extract creation in case
  multi-instanced software components were used.
- Fixed error in system-extract creation that resulted in invalid
  assembly-connectors in case split and merge delegation were used.
- Fixed error in system-extract creation in case no software components
  remaind in the extract (due to user-input and swc-to-ecu-mappings).
- Improved warning message displayed during system-extract creation
  in case there are unresolved references.
- Disallow access to the model via links in warning messages
  during the system-extract creation.
- Fixed error in system-extract creation that a
  port-interface-mapping-set with the same name already exists
  but is not visible in the project.
  It occured only in case port-interface-mappings are used in
  the system and the system-extract is created for the second time.
- Fixed error in system-extract creation that caused components with
  implementation-mapping to be exported regardless of whether
  they were mapped to the included ECUs.

Misc:
- Improved keyboard navigation in property dialogs.
- Improved dialog usability.
- Improved number displayformat.
- Improved resource performance in property dialogs.
- Improved robustness in advanced part of property dialogs.
- Fixed registration / unregistration of SystemDesk protocol handler
  when switching SystemDesk versions via InstallationManager.
- Prevent SystemDesk stopped working during Masterfile deletion.
- Fixed "Try to resolve" button in advanced part of property dialogs.
- Improved Microsoft .NET Framework 4.5 compatiblity.
- In case Microsoft .NET Framework 4.5 is installed the Microsoft update
  http://support.microsoft.com/kb/2750147/en-us
  must also be installed.
- Fixed display problem that occured in File Assignments window
  when moving a package from "unassigned" to a file.
  The package was still displayed in "unassigned" afterwards.
- Solved problem while renaming a file with relativ path
  in the File Assignments window.
- Improved performance of file assignment operations.
- Fixed problem when moving elements in File Assignments window.
- Added sperators to main menues.
- Improve the Performance in the "File Assignment" Dialog.
- The project tree now scrolls automatically during a Drag&Drop operation.
- In some cases SystemDesk stopped working, when a dialog
  with many modifications is commited.
- Outdated dSPACE support e-mail address removed.
- Improved dialog behavior when deleting elements.

Patch 2:

Automation:
- Fixed EcucContainerDefs.AddNewParamConfContainerDef
  and ArrayValueSpecifications.AddNewXXX Methods.

Diagram:
- Changed initial view position after opening a composition diagram
  to the first element.
- Abolition of the 2048x2048 Pixel limitation during a bitmap export
  of a composition diagram.
- Fixed application crash after manipulation of a RequesterIref within
  the Advanced property tab. 
- Fixed automatic project manager selection during drag & drop operation
  within a composition diagram. 

Import/Export:
- Fixed AUTOSAR import problems with recursive elements.
- AUTOSAR Export: Added an option to export SWC implementations
  that are referenced by SWC internal behaviors that are being exported.
  
SoftwareSystems:
- Improved warning/error behavior in DataType dialogs.
- Fixed creation of parameter accesses: Local parameters are now referenced
  using the LocalParameterRef reference.
  Before, the AutosarParameterIref was used.
- Fixed crash when opening a selection dialog for inconsistent mode
  disabling dependencies (RTEEvent) or inconsistent mode irefs
 (SwcModeSwitchEvent).
- Fixed SwDataDefProfs properties.
- Improved support of implementation data types that are references
  to other implementation data types.
- Improvend handling of empty formulas.
- Fixed parameter access selection dialog: It didn't show the correct
  state of local parameter references (checkboxes were empty).
- Fixed create new and clear error SwRefreshTiming element.

Validation:
- Validation rule "Autosar Multiplicities" now checks the existence of Enum values.
- Corrected the message text of validation rule R252.

Misc:
- Custom tools with Python files working after reconfiguration.
- Made ReferenceBase handling more robust.
- Small changes in copy behavior of elements.
- Application value constant now use V property for improved compatibility
  with other AUTOSAR 4.x tools.
- Improved behavior in dialogs advanced page.
- Improved input behavior in Custom String/File Attribute dialog
  to avoid crash. Input of Short Name will be capped at 256 characters.

Patch 3:

ARConverter:
- Improved possible DEST evaluation for REF properties.

Import/Export:
- Fixed import of PERINSTANCEMEMORY / TYPEDEFINITION.
- AUTOSAR import no longer drops empty xml elements.
- Fixed AUTOSAR import problem with files containing big numbers 
  of whitespaces.
- Reordered AUTOSAR elements now are properly reimported.

SoftwareSystems:
- Fixed a problem where the Mode Disabling Dependencies tab page of RTE Event 
  dialogs showed outdated information if references were edited in the Advanced tab.
- Improved connection reorganization after copy&paste of Compositions.

System:
- Fixed bug in System Extract creation which caused false warning messages 
  about not found elements.
- Allow a System Extract of a System which does not reference an ECU.

Validation:
- Resolved validation conflict concerning AdminData.

Misc:
- Improved memory consumption when switching projects.
  
3. Limitations
*************************************************************************

SystemDesk projects saved by this Patch cannot be opened with 
previous versions of SystemDesk.


4. Installing the Patch
*************************************************************************

To install the patch, you must be logged on with administrator rights
and all hotfixes of the current version have to be removed.
Close your SystemDesk application and simply run executable file.
The setup will automatically locate and patch the SystemDesk 
installation. After this patch is applied, the installed patch is
shown in the splash screen, about box and the message browser.


*************************************************************************