Topics
Prev Next

Register New Assets

After you have set up your 'Draft' or 'Complete' Storages in the Reusable Asset Service Registry, you can register assets in them. The assets include:

  • Packages of modeling structures, held in the Project Browser of your model; these Packages can include diagrams and subordinate Packages
  • Any Packages containing model components on which the primary Asset Packages depend
  • Any MDG Technologies that you used in developing the Asset Packages, and that you decide to register with the Packages
  • Any text or graphics files you want to make available to your corporate community; these files are compressed before being added to the Storage

You register the first three items together. You can register files in the Storage during that same process, or separately.

You can register separate versions of the same Package. If you register a Package that already exists in the Registry under the same version reference, and the Storage has 'Draft' status, the existing version is overwritten. If you register the same Package with a different version number or reference, it is registered separately and users can access both versions of the Package from the Registry.

'Learning Center Library', 'Reference Data Library' and 'Source Code Library' type Storages cannot contain Packages of modeling structures - they can contain only Library files, which will appear in the 'Storage Files' tab. A Library file is :

  • a zipped file containing Enterprise Architect-specific Learning Center files for the 'Learning Center Library' Storage type
  • an XML file containing Enterprise Architect-specific reference data XML files for the 'Reference Data Library' Storage type
  • a zipped file containing source code files for the 'Source Code Library' Storage type

Once registered, the Library file will be available in the 'Storage Files' tab of the Reusable Asset Service view.

Access

Ribbon

Publish > Model Exchange > Reusable Assets

Register Package as Asset

Step

Action

See also

1

In the Reusable Asset Service view, select the appropriate Registry and Storage.

Set Up the Asset Service

2

In the Project Browser for your model, click on the Package to register as an Asset.

3

On the 'Registry Browser' tab, click on the Register button.

If the Storage is password protected, a prompt displays for your 'Complete Access' password. Type this in and click on the OK button.

Set Up the Asset Service

4

The 'Register Package(s)' dialog displays, showing the:

  • Name and type of the Storage
  • Name and status of the selected Package (the status at this point being 'Pending')
  • The name, GUID and current version of the selected Package; you can type a different version number or text string if necessary

If there is a version of the Package already in the Registry, and the Storage has 'Draft' status, you can either:

  • Overwrite the registered Package with an update of that version, or
  • Add the updated Package as another Asset under a different version number; in this case, the 'Packages to Register' panel shows the version number, registration date and comments on the latest version of the Asset Package

You cannot overwrite an existing Package if the Storage has 'Complete' status. In this case, add the Package under a different version number.

5

In the 'Comments' field type a short comment and, in the 'Notes' field, a longer explanation of the Package being registered.

6

Click on the Check Dependency button and resolve the dependencies of the Package.

At the end of this process, the selected Package has the status 'Ready' (for registration).

Check Package Dependencies

7

You can, at this point, also register files as assets of the Storage. See Step 4 of the next table, Register File as Asset.

However, if you prefer you can follow the complete procedure separate from registering Packages.

8

Click on the Register button.

A prompt displays to confirm registering the Package. Click on the Yes button.

If the same version of the selected Package already exists in the Registry (if the Storage is a 'Draft') a prompt displays to confirm overwriting it. Click on the Yes button.

A progress dialog displays. If the Package does not have any associated MDG Technologies, a message displays confirming that Package registration is complete. Go to step 10.

9

If the Package has one or more associated MDG Technologies, the 'Register MDG Technology' dialog displays, listing the Technologies and prompting you to register (OK) or ignore all of them.

If you want to register some Technologies but not others, click on those you do not want to register, and click on the Remove button for each one in turn.

Click on the OK button or Ignore button.

A message displays confirming that Package and Technology registration is complete.

Notes:

  • If a remote Technology is removed from registration (that is, the Technology is not registered along with the Package), the registered Package will refer to this Technology at its URL
    When importing the Package from Registry, the system will import this remote Technology from its URL (if the remote Technology is not already available in the importing model)
  • If a remote Technology is registered with the Package being registered, the system will store a copy of the Technology file in the Registry
    When importing the Package from Registry, the system will import the Technology stored in the Registry and will not import it from its URL (if the remote Technology is not already available in the importing model)
Access Remote MDG Technologies

10

Click on the OK button.

The 'Registry Browser' tab is updated with the newly-added details of the Package and any dependent Packages. You can review the details on the tabs on the lower half of the Reusable Asset Service view.

Browse Assets

Register File as Asset

Step

Action

See also

1

In the Reusable Asset Service view, select the appropriate Registry and Storage.

Set Up the Asset Service

2

On the 'Registry Browser' tab, click on the Register button.

If the Storage is password-protected, a prompt displays for your 'Complete Access' password. Type this in and click on the OK button.

The 'Register Package(s)' dialog displays.

3

If any Packages are listed in the 'Packages to Register' panel, and you do not want to re-register them, clear the checkbox against each Package name.

4

Click on the Additional Files button.

The 'Select Additional Files' dialog displays.

5

Click on the Add button.

A 'Select' screen displays, on which you browse for and click on the required file. You can only select one file at a time on this browser.

6

Click on the Open button.

The 'Add Comment' dialog displays.

7

Type a brief comment on the nature or purpose of the file in the Registry, and click on the OK button.

Focus returns to the 'Select Additional Files' dialog, which now lists the selected file.

8

Repeat steps 5-7 for each Asset file to register.

When you have finished, click on the OK button.

The 'Register Package(s)' dialog redisplays.

9

Click on the Register button.

A prompt displays to confirm registration of the files.

10

Click on the Yes button.

A 'Progress' dialog displays while the files are registered, followed by a message confirming that the (Package and) File registration is complete.

11

Click on the OK button to clear the message, and to return focus to the Reusable Asset Service view.

You can review the files on the 'Storage Files' tab in the lower half of the view.

Storage Files Browse Assets

Register Learning Center Library

Step

Action

See also

1

In the Reusable Asset Service view, select the appropriate Registry and 'Learning Center Library' Storage.

Set Up the Asset Service

2

On the 'Registry Browser' tab, click on the Register button.

If the Storage is password protected, a prompt displays for your 'Complete Access' password. Type this in and click on the OK button.

3

The 'Register Learning Center Library' dialog displays.

Click on the button next to the 'File' field and select the Library file.

Type in a short comment on the Library being registered, in the 'Comments' field.

4

Click on the Register button.

A prompt displays to confirm registering the Library file. Click on the Yes button.

If the same Library file already exists in the Registry, a prompt displays to confirm overwriting it. Click on the Yes button.

A progress dialog displays followed by a message confirming that Library registration is complete.

5

Click on the OK button.

The 'Storage Files' tab in the lower half of the Reusable Asset Server view is updated with the newly-added Library file.

Register Reference Data Library

Step

Action

See also

1

In the Reusable Asset Service view, select the appropriate Registry and 'Reference Data Library' Storage.

Set Up the Asset Service

2

On the 'Registry Browser' tab, click on the Register button.

If the Storage is password protected, a prompt displays for your 'Complete Access' password. Type this in and click on the OK button.

3

The 'Register Reference Data Library' dialog displays.

Press the button next to the 'File' field and select :

  • From File System – to select an existing Reference Data XML file from the file system
  • From Model – to open the 'Export Reference Data' dialog for selecting categories that will be registered as the Reference Data Library once the Register button is clicked and a name is entered in the 'Enter Reference Data File Name 'dialog

Type in a short comment for the Library being registered in the 'Comments' field.

Export Reference Data

4

Click on the Register button.

A prompt displays to confirm registering the Library file. Click on the Yes button.

If the same Library file already exists in the Registry, a prompt displays to confirm overwriting it. Click on the Yes button.

A progress dialog displays followed by a message confirming that Library registration is complete.

5

Click on the OK button.

The 'Storage Files' tab in the lower half of the Reusable Asset Server view is updated with the newly-added Library file.

Register Source Code Library

Step

Action

See also

1

In the Reusable Asset Service view, select the appropriate Registry and 'Source Code Library' Storage.

Set Up the Asset Service

2

On the 'Registry Browser' tab, click on the Register button.

If the Storage is password protected, a prompt displays for your 'Complete Access' password. Type this in and click on the OK button.

3

The 'Register Source Code Library' dialog displays.

Select the Library file by pressing the button next to the 'File' field.

Type in a short comment for the Library being registered, in the 'Comments' field.

4

Click on the Register button.

A prompt displays to confirm registering the Library file. Click on the Yes button.

If the same Library file already exists in the Registry a prompt displays to confirm overwriting it. Click on the Yes button.

A progress dialog displays, followed by a message confirming that Library registration is complete.

5

Click on the OK button.

The 'Storage Files' tab in the lower half of the Reusable Asset Server view is updated with the newly-added Library file.

Learn more