Persistency Editor

The editor-persistency Persistency Editor supports you in managing your Persistency.

Open Persistency Editor

CTRL + SHIFT + D, P

Open Editor

To open the Persistency Editor, expand your DaVinci Adaptive project in the DaVinci Project Explorer and double click on da-vinci-developer-adaptive Open Project Dashboard . The Project Frame opens showing the Project Home. You can then open the Persistency Editor as follows:

  • Open the editors Editor menu on the top right of the Project Frame and click the editor-persistency Persistency Editor command.

  • Alternatively, use the context menu command editor-persistency Persistency Editor of the da-vinci-developer-adaptive Open Project Dashboard node in the DaVinci Project Explorer.

  • Alternatively, on the Dashboard page of the Project Home, click editor-persistency Persistency Editor in the Comfort Editors area.

The Persistency Editor opens in a new tab of the Project Frame.

Editor Toolbar

The toolbar on the top right of the Persistency Editor provides the following features:

  • executable-editor-form-mode Form or dml-editor DML: Switches between the Details Modes for an element that is selected in the tree view on the left side of the editor.

  • help Help: Opens the help page of the corresponding editor.

  • validation-status-valid Validation Status: Shows the validation status of the objects displayed in the editor. The icon switches to validation-status-sync when validating the content or to validation-status-invalid in case of errors. Hover the mouse over the validation icon to display the validation messages.

The toolbar on the left side of the Persistency Editor provides the following features:

  • create Create: Click this icon and follow the Create Persistency File Storage Interface wizard to create a Persistency File Storage Interface or a Persistency Key Value Storage Interface.

  • delete Delete: Click this icon to delete the Persistency File Storage Interface or Persistency Key Value Storage Interface selected in the tree view.

  • expand-all Expand: Expands the tree on the left side of the editor.

  • collapseall Collapse: Collapses the tree on the left side of the editor.

Functionality

The Persistency Editor provides the functionalities listed in the table below. If not otherwise mentioned, the functionalities available in the details-mode-form-mode Form mode are described. If you want to manage the properties of an element textually, switch to the dml-editor DML mode via the toolbar and refer to DaVinci Modeling Language Editor for more information.

Tree View Structure Description of Functionalities

file-storage-interface Persistency File Storage Interfaces

The element Persistency File Storage Interfaces is used for grouping and does not contain any modifiable properties.

tree-view-structure-child-elementfile-storage-interface <Persistency File Storage Interface>

Select Persistency File Storage Interface in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

  • Name: Displays the name of the File Storage Interface. Edit the field to change the name.

  • Description: Displays the description of the File Storage Interface. Edit the field to change the description.

  • Minimum Sustained Size: Displays the minimum size required at design time for the enclosing Persistency Interface.

  • Redundancy: Displays the requirement towards the redundancy of storage.

  • Update Strategy: Displays the update strategy of the respective Persistency Interface as a whole.

  • Max Number of Files: Displays an upper limit for the handling of files at runtime in the context of the enclosing Persistency File Storage Interface.

Redundancy Handling

  • add Create Redundancy Handling: Click this icon to add a new Redundancy Handling and define Scope, Algorithm Family and Length.

  • delete Delete Redundancy Handling: Click this icon to delete a selected Redundancy Handling.

File Elements

  • add Create File Element: Click this icon to add a new File Element and define Name, Content URI, filename and Update Strategy.

  • delete Delete File Element: Click this icon to delete a selected File Element.

MICROSAR Adaptive Parameters

This area contains MICROSAR Adaptive Parameters that are specified as Model Extensions (MEX) in the MICROSAR Adaptive BSW Package. Parameters for the selected AUTOSAR model element are displayed in the table of the MICROSAR Adaptive Parameters area on the respective pages of the Persistency Editor. Select a parameter in the table to view the editing options.

tree-view-structure-child-elementtree-view-structure-child-elementfile-storage <Persistency File Storage>

Select Persistency File Storage in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

  • Name: Displays the name of the File Storage. Edit the field to change the name.

  • Description: Displays the description of the File Storage. Edit the field to change the description.

  • Minimum Sustained Size: Displays the minimum size guaranteed at deployment time for the enclosing Persistency Deployment.

  • Maximum Allowed Size: Displays the maximum size guaranteed at deployment time for the enclosing Persistency Deployment.

  • Update Strategy: Displays the update strategy of the respective Persistency Deployment as a whole.

  • Deployment URI: Displays the storage location for the Persistency File Storage, for example, a directory on the file system. Although the AUTOSAR model defines a list of values, the input is limited to considering only the first entry.

  • Version: Displays the version of the Persistency File Storage.

Redundancy Handling

  • add Create Redundancy Handling: Click this icon to add a new Redundancy Handling and define Scope, Algorithm Family and Length.

  • delete Delete Redundancy Handling: Click this icon to delete a selected Redundancy Handling.

Files

  • add Create File: Click this icon to add a new File and define Name, URI, File Name and Update Strategy.

  • delete Delete File: Click this icon to delete a selected File.

Mappings

  • edit Edit Mapping: Click this icon to edit the selected Mapping. The Modify Persistency to Port Mapping Wizard opens.

key-value-storage-interface Persistency Key Value Storage Interfaces

The element Persistency Key Value Storage Interfaces is used for grouping and does not contain any modifiable properties.

tree-view-structure-child-elementkey-value-storage-interface <Persistency Key Value Storage Interface>

Select Persistency Key Value Storage Interface in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

  • Name: Displays the name of the Key Value Storage Interface. Edit the field to change the name.

  • Description: Displays the description of the Key Value Storage Interface. Edit the field to change the description.

  • Minimum Sustained Size: Displays the minimum size required at design time for the enclosing Persistency Interface.

  • Redundancy: Displays the requirement towards the redundancy of storage.

  • Update Strategy: Displays the update strategy of the respective Persistency Interface as a whole.

  • Max Number of Files: Displays an upper limit for the handling of files at runtime in the context of the enclosing Persistency File Storage Interface.

Redundancy Handling

  • add Create Redundancy Handling: Click this icon to add a new Redundancy Handling and define Scope, Algorithm Family and Length.

  • delete Delete Redundancy Handling: Click this icon to delete a selected Redundancy Handling.

File Elements

  • add Create File Element: Click this icon to add a new File Element and define Name, Content URI, File Name and Update Strategy.

  • delete Delete File Element: Click this icon to delete a selected File Element.

MICROSAR Adaptive Parameters

This area contains MICROSAR Adaptive Parameters that are specified as Model Extensions (MEX) in the MICROSAR Adaptive BSW Package. Parameters for the selected AUTOSAR model element are displayed in the table of the MICROSAR Adaptive Parameters area on the respective pages of the Persistency Editor. Select a parameter in the table to view the editing options.

tree-view-structure-child-elementtree-view-structure-child-elementkey-value-storage <Persistency Key Value Storage>

Select Persistency Key Value Storage in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

  • Name: Displays the name of the Key Value Storage. Edit the field to change the name.

  • Description: Displays the description of the Key Value Storage. Edit the field to change the description.

  • Minimum Sustained Size: Displays the minimum size guaranteed at deployment time for the enclosing Persistency Deployment.

  • Maximum Allowed Size: Displays the maximum size guaranteed at deployment time for the enclosing Persistency Deployment.

  • Update Strategy: Displays the update strategy of the respective Persistency Deployment as a whole.

  • Deployment URI: Displays the storage location for the Persistency Key Value Storage, for example, a directory on the file system. Although the AUTOSAR model defines a list of values, the input is limited to considering only the first entry.

  • Version: Displays the version of the Persistency Key Value Storage.

Redundancy Handling

  • add Create Redundancy Handling: Click this icon to add a new Redundancy Handling and define Scope, Algorithm Family and Length.

  • delete Delete Redundancy Handling: Click this icon to delete a selected Redundancy Handling.

Key Value Pairs

  • add Create Key Value Pair: Click this icon to add a new Key Value Pair and define Name, Type and Update Strategy.

  • delete Delete Key Value Pair: Click this icon to delete a selected Key Value Pair.

Mappings

  • edit Edit Mapping: Click this icon to edit the selected Mapping. The Modify Persistency to Port Mapping Wizard opens.