Working with the Main Package Browser

From the main Package Browser, you can navigate through libraries and functional or logical behaviors in session. You can also use drag and drop, and access editing commands from the context menu. Search tools and history are available.

Note: You can also work with light package browsers. See Working with Light Package Browsers.

This task shows you how to:

See Also
About Tools for Managing Classes

Show or Hide the Main Package Browser

The Package Browser is displayed by default.

If minimized or not displayed, do the following:
  • If minimized, the Package Browser is represented by an icon on the right side of the screen. Click this icon to display it.
    Note: If several similar icons are present, pause over each to see the name. The main Package Browser has the name Package Browser. The light ones have the name of the displayed classes.
  • If not displayed, from the View section of the action bar, click Package Browser .
    Tip: You can also access this command from the App Options panel. To access the App Options panel, from the Tools section of the action bar, select App Options .

The main Package Browser is displayed.

Tip: To hide the main Package Browser, click again (from the action bar or the App Options panel) Package Browser . It can also be minimized, if not docked.
Notes:
  • The Package Browser command does not affect light package browsers; they are always displayed.
  • You cannot close the main Package Browser. You can minimize it.

Handle Warnings

In the Package Browser, warnings can appear for libraries. They appear as:

  • A clickable warning icon to the upper right of the Package Browser
  • Warning icons on the root classes of the impacted libraries.
A simple example:

There are two causes for warnings:

  • A library is not of the recommended version for the Dymola Behavior Modeling version used.
  • The version of a used library is not consistent with the version of the library that is using it.

  1. To see the cause for the warnings you can:
    • For a specific library, pause over the warning icon of the root of that library.
    • For all impacted libraries, click, in the upper right of the Package Browser, the command Versioning Assistant .
  2. To solve the problem, use the options in the Versioning Assistant.

    See Working with the Versioning Assistant.

Select Which Loaded Libraries to Display

You can select which of the loaded libraries to display in the main Package Browser. You can filter from both all loaded libraries and the used libraries.

  1. To filter from all libraries loaded, do the following:
    1. Select Library Chooser .
      The Library Chooser list appears to display the libraries that are loaded in session. By default, all loaded libraries are displayed in the Package Browser, corresponding to clicking Show All Libraries:

    2. From the list in the Library Chooser, click the libraries to select to hide or show them.
      The selected libraries are displayed in the Package Browser.
      Notes:
      • The filtering only applies to the current Package Browser, not to any Package Browser in another tab.
      • The libraries that are not displayed in the main Package Browser are still loaded in session, and reachable by commands.
      • To reset the filter, click Show All Libraries.
  2. To display only used libraries, do the following:
    1. Select Library Chooser .
    2. In the Library Chooser, click Show Only Used Libraries.
      Only the used libraries are displayed in the Package Browser. In the header of the Package Browser, a green icon and the text (active filter) indicate that the filter is active.

      In this example, no component from the Design library is used in MyExample1.
      Notes:
      • The filtering only applies to the current Package Browser, not to any Package Browser in another tab.
      • The libraries that are not displayed in the main Package Browser are still loaded in session, and reachable by commands.
      • The filter is not dynamically updated. For example, if you change the active library by searching in the Package Browser or by scripting, you have to redo the filtering.
      • The filter builds on the uses-annotations of the library currently opened when applying the filtering. This means that libraries implicitly used (without uses-annotations) are by default not displayed in the Package Browser. The uses-annotations are annotations in the Modelica text of a library, specifying what libraries are used in the library.
      • To reset the filter, click Show All Libraries.
    3. Select the version you want to load in the Package Browser.

      Note: If the current library has been modified, a dialog box appears asking you if you want to save it. Click Yes to save and unload the current library.

  3. To select what libraries to use, activate or clear them selecting the corresponding checkbox in the Library Chooser list.
    The Package Browser displays only the selected libraries.
    Tip: To display only a certain class in a Package Browser, you can also use a light Package Browser.

Hide Protected Classes

You can control if protected classes are displayed in the Package Browser or not.

  1. From the Package Browser header, click Show Preferences.
  2. Select to display or hide protected classes by clearing or activating the Hide protected classes preference.

    By default, the preference is activated.

    Notes:
    • The command is a shortcut to the Hide protected classes preference from Me > Preferences > App Preferences > 3D Modeling > Systems Modeling and Execution > Dymola Behavior Modeling , the Editor tab, the Package Browser group.
    • The command contains only one shortcut. For all preferences available, see Native Apps Preferences Guide: Editor.

Reorder the Content

  1. To sort in an alphabetical order, click Sort .
  2. To sort in a reverse alphabetical order, click again Sort .
  3. To go back to the initial order, click a third time Sort .

Expand Automatically a Package

To ease your class move, nodes are automatically expanded when you drag a class.

Drag a class, and hover over a package node.
The node is automatically expanded to let you drop your class.

Use the Navigation History of Activated Classes

You can use the history of your navigation through activated classes when navigating.

Before you begin:

Expand a package, activate a first class ("A"), then a second class ("B").

  1. Click Previous Class to display the class previously activated ("A").
  2. Click Next Class to return to the class previously activated ("B").

    Tip: From the View section of the action bar, you can also click Previous and Next .

  3. Click Parent Class to return to the package node.
    The package node is selected and collapsed.

Search a Class

You can search for classes through all functional or logical behaviors and libraries loaded in session.

  1. In the search box under the Package Browser header, type your keyword .
    Note: The search result list is dynamically updated, that is, the content of the Package Browser is filtered after each character you type.
  2. Click Back to Library View to exit the search result list.

    You can go back to the search result list again by clicking Go to Search View .

Use Drag and Drop to Instantiate Components

You can drag components from the Package Browser to instantiate them in the diagram layer or icon layer.

See Instantiate from Any Package Browser.

Center the Package Browser and the Tree on a Selected Class

You can center the present Package Browsers and the tree on a selected class.

To center the Package Browsers and the tree on a selected class, right-click the class and select Display Class > Center Tree on Preselected Objects.

Available Commands in the Context Menu

The context menu proposes shortcuts to frequently used commands.

Note: The available commands may differ depending on the selected class.

  1. Right-click a class to display the context menu.
  2. Select any of the following commands.
    • Call Function...
    • Class Attributes
    • Edit Modelica Parameters
    • Move
    • Documentation Editor
    • Visibility for Encryption
    • Lock Class Edition... or Unlock Class Edition
    • Instantiate (you can also use drag and drop to instantiate)
    • Check Class
    • Display Class
      • Show Class
      • Open Class in New Tab
      • Browse in New Package Browser
      • Display Class in Immersive Panel
      • Center Tree on Preselected Object
    • Manage Shortcuts
      • Index Library for Propositions (only available for top-level libraries)
      • Add to Preferred Classes
      • Add to Force Element Classes
    • New Modelica Class
    • Extend From...
    • Duplicate Class
    • Copy Modelica Path
    • Cut, Copy, or Paste.
      Note: You can use Copy to copy the Modelica path of the selected class to the clipboard for later use in, for example, text editors. If you have selected several classes, Copy copies all those Modelica paths to the clipboard.
    • Delete
    • Unload Library
    • <className> object
      Note: These commands are only available for MainModel classes in behaviors.
      • Edit
      • Update Interfaces
      • Update Interfaces Layout
    • Change Edition Mode
      • Switch to Edition
      • Switch to Read-Only