Topic
Prev Next

Set Up the Asset Service

The process of setting up assets and files in the Reusable Asset Service has a number of simple stages, typically:

  • Identify the Registry
  • Create the Storages, including copying an existing Storage as a template for a new one
  • Set password protection on each Storage
  • Register the Asset Packages and Storage Files, and update them as necessary

Access

Ribbon

Publish > Model Exchange > Reusable Assets

Identify Registry

The Registry server holds the Storages of the Reusable Asset Service. It will have been previously configured by your system administrator, to be accessed through a Cloud Connection. Your system administrator will provide the connection details for you to use.

In the Reusable Asset Service view, click on the button to the right of the 'Registry' field. The 'Cloud Connection' dialog displays.

Using the information provided by your administrator, type in the server name, URL and the name of the model hosting the registry data. If advised by your administrator, also type in the user name and password for the server.

Click on the OK button; the 'Registry' field now shows the server name.

Create Storages

A Storage is a container within the Registry, holding related assets and files. There can be several Storages in the Registry, to support the different areas of work or purposes that your organization might define.

Step

Action

See also

1

Click on the icon in the Reusable Asset Service toolbar.

2

If necessary, enter the Administration password that enables update access to the Registry. Click on the OK button.

The 'New Storage' dialog displays.

3

In the 'Name' field, type a name that indicates the purpose or content of the Storage.

4

In the 'Type' field, select:

  • 'Draft' if you intend to make significant changes to the content of the Storage, such as populating it with assets and/or files; you can overwrite existing Packages or files in a Draft Storage
  • 'Complete' if the Storage is ready for use; you cannot overwrite any Packages or files in a Complete Storage, although you can delete Packages and files and add new ones
  • 'Learning Center Library' if the Storage should contain only Enterprise Architect Learning Center Library files - this Storage type can be populated only with Library files and not with Asset Packages; you can overwrite existing Library files in a Learning Center Library storage
  • 'Reference Data Library' if the Storage should contain only Enterprise Architect Reference Data Library files - this Storage type can be populated only with Library files and not with Asset Packages; you can overwrite existing Library files in a Reference Data Library storage
  • 'Source Code Library' if the Storage should contain only Source Code Library files - this Storage type can be populated only with Library files and not with Asset Packages; you can overwrite existing Library files in a Source Code Library storage

You can modify a Storage at a later time, and change this Type setting.

Change Storage Details

5

If you want to set Storage Access Passwords on this Storage, click on the check box against one or both password types, and provide and confirm the 'Complete Access' and/or 'Read-Only Access' passwords.

Password Protection

6

Click on the OK button.

A prompt displays for you to confirm the creation of the Storage, with the type of access you have set on the Storage.

7

Click on the Yes button.

A confirmation message displays; click on the OK button.

The name of the new Storage displays in the 'Storage' field.

Password Protection

The Registry can be protected by a Registry password, so that only the Administrator can create and modify Storages. If no Registry password is set, a second level of password protection can be applied.

The owner of a Storage can apply password protection to restrict users in processing and modifying the contents of the Storage either intentionally or unintentionally. Password protection can be applied at two levels:

  • Complete Access - users enter their password and can modify or delete the Storage itself, and within the Storage can register, update and delete Packages and files in the Registry, view Packages and import assets into their models
  • Read-Only Access - users enter their password and can import assets into their models

You set the 'Complete Access' password before you set the 'Read-Only Access' password.

If password protection is set and a user has no password, they can only view the contents of the Storage. If no password protection is set, all users can freely access and modify the Storage and its contents.

You set the passwords on each Storage as you create that Storage, using the 'New Storage' dialog. Once the Storage has been created, you can change or remove an existing password using the 'Modify Storage Access' dialog, but you cannot add a password.

If a Storage is password protected, the system displays a prompt for the password when the user begins to:

  • Change or delete a password on the Storage
  • Copy the Storage to create a new Storage
  • Delete the Storage
  • Register a Package or file in the Storage
  • Import a Package, file or Technology from the Storage
  • Delete a Package or file from the Storage
  • Compare an Asset Package with a Package in the model

The system displays the password prompt when any of those operations is performed for the first time after the user:

  • Connects to a Registry
  • Reloads the Registry Browser
  • Selects a Storage in the 'Storage' field in the Reusable Asset Services view

If the user enters the correct password and therefore establishes their credentials, the system does not display a password prompt again for any valid operation that user performs until they:

  • Select a different Storage in the 'Storage' field in the Reusable Asset Services view or
  • Reload the Registry Browser from the Registry

Register Assets and Files

Whilst a Storage exists and, if the Storage is under password protection, you have the 'Complete Access' password, you can register Packages from a model and files from your system as assets in that Storage. If the Asset Package was developed using one or more MDG Technologies, you can optionally register those technologies in the Storage as well.

See the Register New Assets Help topic.

Copy Storages

It is possible to copy a Storage as the basis for creating another Storage, for example if you want to use the same set of assets in the context of larger set for a different department, work area or development phase.

Note: It is not possible to change the Type of a 'Learning Center Library', 'Reference Data Library' or 'Source Code Library' type Storage, nor is it possible to change a 'Draft' or 'Complete' type Storage into a 'Learning Center Library', 'Reference Data Library' or 'Source Code Library' type Storage.

Step

Action

See also

1

In the 'Storage' field, select the Storage to be copied.

2

Click on the icon in the Reusable Asset Service toolbar.

3

If necessary, enter the Administrator password or your 'Complete Access' password and click on the OK button.

The 'Save Storage As' dialog displays.

4

In the 'Name' field, type a name that indicates the purpose or content of the new Storage.

5

In the Type field, select:

  • 'Draft' if you intend to make significant changes to the content of the Storage, such as populating it with assets and/or files; you can overwrite existing Packages or files in a 'Draft' Storage
  • 'Complete' if the Storage is ready for use; you cannot overwrite any Packages or files in a 'Complete' Storage, although you can delete Packages and files and add new ones

You can modify a Storage at a later time, and change this setting.

Change Storage Details

6

If you want to set Storage Access Passwords on this Storage, click on the check box against one or both password types, and provide and confirm the 'Complete Access' and/or 'Read-Only Access' passwords.

Password Protection

7

Click on the OK button.

A prompt displays for you to confirm the creation of the Storage, with the type of access you have set on the Storage.

8

Click on the Yes button.

A confirmation message displays; click on the OK button.

The name of the new Storage displays in the 'Storage' field.

Change Storage Details

After you have set up a Storage, you can update it at a later stage to:

  • Change the status or Type
  • Change one or both of the existing 'Complete Access' and 'Read-Only' Access passwords
  • Delete one or both of the passwords

It is not possible to add a password where one has not previously been set.

You cannot change or delete passwords unless you have the 'Complete Access' password yourself.

Note: It is not possible to change the Type of a 'Learning Center Library', 'Reference Data Library' or 'Source Code Library' type Storage, nor is it possible to change a 'Draft' or 'Complete' type Storage into a 'Learning Center Library', 'Reference Data Library' or 'Source Code Library' type Storage

Step

Action

See also

1

On the Reusable Asset Service view, in the 'Storage' field click on the drop-down arrow and select the Storage to update.

2

Click on the icon in the Reusable Asset Service view toolbar.

3

If necessary, enter the Administrator password or your 'Complete Access' password and click on the OK button.

The 'Modify Storage Access' dialog displays.

4

In the 'Type' field, click on the drop-down arrow and select:

  • 'Complete' if the Storage has now been set up and is ready for use; you cannot overwrite any Packages or files in the Storage, although you can delete them and add new Packages and files
  • 'Draft' if you intend to make significant changes to the content of the Storage; you can overwrite existing Packages or files

5

The 'Action' field defaults to 'None', to indicate no changes to the passwords. If you are changing or deleting the passwords, click on the drop-down field and select:

  • 'Change Password' to enable both password type fields ready for editing
  • 'Remove Storage Access Password' to simply delete the 'Complete Access' password altogether
  • 'Remove Read-Only Access Password' to simply delete the 'Read-Only Access' password altogether
Password Protection

6

If you have selected the 'Change Password' option, select the appropriate password checkbox or both checkboxes, and type in the new password(s). Re-type the password(s) in the 'Confirm Password' field(s).

7

Click on the OK button to save your changes and close the 'Modify Storage Access' dialog.

Delete a Storage

If a Storage has been created by mistake, or is no longer necessary in the Registry, you can delete it and its entire contents of Package and files in one action.

Step

Action

See also

1

On the Reusable Asset Service view, in the 'Storage' field click on the drop-down arrow and select the Storage to delete.

2

Click on the icon in the Reusable Asset Service view toolbar.

A prompt displays to confirm the deletion.

3

Click on the Yes button.

If necessary, enter the Adminstrator password or your 'Complete Access' password and click on the OK button.

A message displays to confirm that the Storage has been deleted.

4

Click on the OK button to clear the message.

The Storage and its contents are cleared from the Registry.

Learn more