Maintaining multiple catalog items for a number of collaborations can become tedious.

Catalog Item Collections are a way to make the management of sub-catalogs for collaborations more efficient.

Components, Catalog Items ... Collections

"Catalog item collections" is the third choice in the "Development" tab of the Research Cloud portal.

It will display a list of collections.

When viewing the details of a collection, a regular user only sees the collaborations they have access to themselves.

The owner, however, sees all organizations that have access, even those they are not a member of.

This list of collections may be empty.

Collections of catalog items might be considered an advanced feature. But they will make your life easier when you have to manage a lot of catalog items and a lot of collaborations.

Especially for other users, it is very convenient to request a comprehensive "set" of catalog items, instead of many single ones.

Create a Collection

A new collection can be created with the "+" icon on the upper right.

(see the creation steps of the wizard at the end of this page)

A collection has the following properties:

  • Name
  • Subtitle
  • Description
  • Icon
  • Owner Collaboration
  • Documentation URL
  • Support Name
  • Support E-Mail Address
  • Visibility
  • Collaborations with Access
  • Catalog Items List

As you can see, collections share a lot of properties with catalog items.

Thanks to this, you can manage access to a set of catalog items as if they were just one.

Adding and removing Catalog Items

The only specific property of a collection is the list of catalog item that it helps to manage.

Any catalog item that should be managed by the collection, can be added to the list in the third step of the collection wizard ("Catalog Items").

The collection is a central point where you can manage access for collaborations, instead of doing this for each catalog item by itself.

Wizard steps

The collection creation wizard that is started with "+" will guide you through the creation of a new collection.

Later on, if you want to make changes to the collection, you can select it from the main list and edit it by stepping through the wizard steps.

Click continue.

Name & description

  • Enter a descriptive name, subtitle and description for the catalog item collection.
  • Adding an icon will help you to work more intuitively with the collection, later on.
  • Click continue.

Owner & support

  • Select the collaboration that will be the owner of this collection. The owner collaboration can only be set when creating the collection. It cannot be changed later, anymore.
  • Provide the URL of the documentation page for the collection.
  • Give the name and e-mail contact of the person or the team that is managing the collaboration.
  • Click continue.

Catalog Items

Build a list of catalog items that should be in this collection. One catalog item can be listed in none, one or more collections.

At first, the list is empty.

  • Select catalog items from the list below to add them to the collection. Only the catalog items that have the same owner CO as the collection will be selectable.
  • Remove catalog items should not be in the list, anymore.
  • Click continue.

Access

Select whether you want to keep the collection private, only adding collaborations of your choice to it.

Alternatively, you can let the collaboration be visible on the general catalog page. Then others can request access.

You will be notified of access requests in the portal and by e-mail.

You can choose to approve access requests automatically or manually. In that case, no notifications are sent. The collection can be considered "public".

Also, you can still give access to collaborations explicitly, when you are in those collaborations' src_developer group.

A requestable collection cannot contain private catalog items.

Once a collection is set to requestable, it cannot be set back to private, anymore.

Users who have access to your collection can remove their access by themselves ("Remove Access"). This way, they can make sure their catalog view does not get cluttered.

Click submit.

You will see the list of your manageable collections, again.






  • No labels