Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 23.1.1

Uploading Libraries

In the Libraries menu you can upload and manage your own libraries. Libraries are always uploaded to a dedicated namespace. If you want to use a library in several namespaces, you must upload it to each namespace separately.

Image Added

PAS 23.1.1 In addition to the individual profiles that can be assigned to a user, each Designer user also has access to a shared namespace. Namespace Shared is displayed by default in the library administration.

info

Upload a library to namespace Shared to make it available to everyone working on your system.

Uploading Libraries

You can upload library files in .lrep or .xlib format. If you try to upload a file with a different format, the error message The file cannot be loaded will be displayed.


When you download a library, it will always be in format .xlib.

this open the Libraries folder and use the libraries the

When you open menu Libraries, you must first select the namespace you want to edit.
Image Removed

Image Added

The selected namespace is highlighted in blue and section Libraries is displayed. You are now able to upload library files to the selected namespace.

To select a library filestart the upload process, click button Browse.

Image Removed

Upload.

Image Added

Anchor
publish_asset_wizard
publish_asset_wizard
The Publish Asset Wizard opens.

You can add the file you want to upload either by drag and drop or by browsing. The name of the selected file is displayed.

Allowed formats are:

  • .lrep
  • .xlib

Once you have selected a file, continue by clicking the Next button.

Image Added

The second screen of the Publish Asset Wizard opens.

The Name and Version are set automatically based on the selected file. For further information about the different input fields refer to Working With the Publish Asset Wizard.

Click the Publish button to upload the file to the selected namespace(s) and publish the library.

Image Added

The last screen of the Publish Asset dialog informs you whether the library has been successfully uploaded and published.

Click Close to return to the libraries administration If you want to select a different file, use the Change File button.Click Upload to confirm your choice and start the action.

Image Modified

After a successful upload the library is displayed in the Libraries section.

The library is now available within

the selected namespace(s).

Info

If you want to add the library to a project,

use the Asset Drawer or the Manage libraries button on the Libraries folder in the Service panel.

Image Modified

All uploaded libraries of the selected namespace are listed in

section Libraries.

Image Modified

The Designer allows you to upload several versions of a library.

Select a library in the list to display section Versions where all available versions of

this library are displayed.

Updating a Library

Info

The Designer allows you to upload a new file for the same version of a library to update an already existing version. The necessary steps to update an existing library are explained in this section.

However, the Designer also allows you to upload several versions of a library. We recommend that you prefer uploading new versions to updating libraries, and that you change the version number with each new version. This provides a better overview on the used libraries, especially if larger user groups cooperate.

Image Added

To add a new version or to update an already uploaded version of a library,  mark the library in question.

Section Versions opens below the library list. All versions of the library are listed in this section.

Adding a New Version of a Library

Image Added

To add a new version of a library, click the Add Version button.

The Publish Asset wizardopens.

The steps you need to perform now are identical to those when uploading a new library.

Image Added

If you have added the new library version, it will be displayed in section Versions.

Updating an Existing Version of a Library

Image Added

In the Versions

Image Removed

If you try to upload an already existing library in the same version again, you will receive a corresponding error message.

Image Removed

To update an already uploaded library, mark the library in question.

This will open section Versions below the library list.

Image Removed

In this section all versions of the library are listed.

Click on a version to display its dependencies.

Additionally the Update

section

Version button appears.

Use button Browse it to select the new library file you want to use.

Image Removed

open the Publish Asset wizard.

The steps you need to perform now are identical to those when uploading a new library

The name of the selected file is displayed. If you want to select a different file, use the Change File button.

Click Update to start the action.

Image Modified

If you update a library in the Designer administration, it is not automatically updated in the services where you use it.

If you update the version of a library that you are currently already using in a service, you need to save the library in the service again.

Tip

Go Refer to page Adding Libraries for further information.

Deleting a Library

Version

Info

You cannot delete an entire library but only individual versions of a library.

Image AddedImage Removed

All uploaded libraries of the selected namespace are listed in the libraries Libraries section.

If Select the library from which you want to delete a library from the list, click Image Removedversion. Section Versions opens.


Image Added

To delete a library version, click the corresponding Image Added icon.

Image Added

If you want to delete a library version that is still in use, a warning message will be displayed that lists all service(s) in which this version is currently in use.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamenote_library_version_deletion
PageWithExcerptINTERNAL:_designer_excerpts

If you nevertheless want to delete the library version, confirm with Yes.

Click Cancel to abort.

Image Added

If you are about to delete a library version that is not in use, a simple confirmation dialog is displayed.

Info

If you delete a library version from a namespace in the administration, it will also no longer be available for services that are newly created to this namespace.

Click Yes to confirm the deletion and Cancel to abort it.


Downloading a Library

Image Modified

You can also download a library from a selected namespace.

Select the library

you want to download and

to display all its versions. In section Versions use the corresponding download button

in the Versions section

Image Added for the version you want to download.

Downloaded libraries will always be in format .xlib.

Library Documentation

During Developers can create their own libraries in the Designer and publish these libraries via the asset repository to share them with their whole team. Detailed documentation is important so that other team members can use your library quickly and easily. During the creation of your own libraries in MagicDraw, you can insert explanatory documentation to the elements.

TipFor further information about the creation of documentation tags see page Model Documentation in

This applies to the creation of libraries with

.
  • for details)

Use the documentation icon to display the documentation of a library.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamelibrary_documentation
PageWithExcerptINTERNAL:_designer_excerpts