Owners of data assets, curators, and Mendix Admins can curate registered assets. Curation in Data Hub is the process of enriching the metadata and providing further information about the exposed data sources, datasets and attributes. You can add custom application icons, Catalog-specific descriptions, and tags to supplement the registered metadata. Curate functions in Data Hub include setting the Discoverability of data sources, indicating whether the data source is validated, and specifying the Business and Technical Owners.
Users who can curate assets in Data Hub Catalog are as follows:
- Owners of a registered service – can curate their own services which includes those that have been set to non-Discoverable
- Data Hub Curators and Mendix Admins – can curate and find all registered assets in the Catalog
Owners and Curators can also get an overview of the registered assets they own and curate from the Curate tab of Data Hub.
Information that is added or changed during curation is stored in the Data Hub Catalog for that item. It will not be added to the OData service contract or metadata files or affect any of the values in the metadata files associated with the service or the data associated with the exposed datasets.
2 Curate List
Owners and curators of registered assets can click Curate from the Data Hub screen to see the Curation List screen which provides an overview of all the registered assets that you can curate as an owner under the My Assets tab. Curators will also see the Company Assets tab that lists all the registered assets:
In both cases, the list includes registered data sources and also individual datasets that are exposed for the data source.
You can search for specific assets by entering a search string in the search bar or Filter By: Environment or Validated assets.
The list can be also be sorted by any of the columns by clicking on the column header.
Click View to display the asset details. You can then perform curate actions to add Catalog specific information to the asset metadata.
3 Curate Bar
Curation is performed from the asset details screen. If you are an owner of an asset or are a curator, you will see the Curation Bar for the selected item. The following shows the curation bar for a selected service:
Owners of registered assets and can only curate their services.
On the Curation bar, the following details are displayed:
- Information about the role of the current user: Owner or Curator
- When a data source is selected in the Search Results:
- Edit Metadata – edit the description of the data source and datasets, add tags or specify business and technical owners and add change the application icon
- Discoverable/Validated – set the the Discoverable and Validated settings for the data source from the drop-down menu.
- Discoverable defines whether the service is visible and can be found (and consumed) by users of the Data Hub; if a service is set to Non-discoverable, only the owners of the service (Business and Technical) and curators can find the registered data source.
- Validate indicates that the data source and datasets have been validated.
- When a dataset is selected in the Search Results
- Edit Dataset Details – to edit the dataset and attribute descriptions
4 Editing the Metadata of an App
The curate functions that are available for a selected data source are to change Application Details or Data Source Details. This section describes the application details that can be changed: changing owners or changing the application icon.
You can curate Application Details from the Application Details screen as follows:
- In the Curation Bar click Edit Metadata > Application Details:
- The Application Metadata screen is displayed:
4.1 Changing Owners of an App
The Technical and Business Owners are displayed as a link in the asset Metadata pane so that users can contact them through the email that is provided for them.
By default, the Technical Owner for a registered asset is the user who registered the data source when registration is done through the deployment pipeline in Studio Pro. The owners can also be specified during manual registration using one of the connectors in the Data Hub Home and also when registering assets using the Data Hub API.
Business and Technical Owners have curation rights for the registered data source in the Data Hub Catalog only if they are registered users on the Mendix Platform. If a custom owner is created with the process described in this section, the link to contact them will be displayed for the asset but this does not mean that they are able to access the asset in Data Hub or curate it.
App owners can be changed by users with curation rights (owners and curators) from the Application Details screen.
If you as a Technical Owner curate the application and change the technical owner to a different user, then you will no longer have curation rights to the asset once you save the changes. If the Discoverability is turned off for the asset, then you will also not be able to find the asset in the Catalog.
Curators and Mendix Admins can manage the lists of custom owners as part of Administration functions. For details, see the Owners section of Data Hub Administration.
4.1.1 Changing the Business & Technical Owners of an App
To change the Business Owner or Technical Owner, from the Application Metadata screen, click in the name field of the Business or Technical owner. You can start typing or select from the drop-down list of names. Mendix platform users will be displayed with their avatar and custom owners will be shown with an avatar that displays their initials.
4.1.2 Adding a Custom Owner
When curating the owners of an application, you can specify an owner who is not a registered Mendix user but is the technical contact point for the application, or the owner of the data that is made available in the app – the Business Owner. The name and the contact email must be provided.
Curators can manage the lists of custom owners as an Administration task. For more details, see the Owners section of Data Hub Administration.
To add a custom owner follow these steps:
From the Application Metadata screen if you start typing the name of an owner and it is not in the drop-down list, you will be prompted if you want to Create it. Click on the prompt and the Enter New Custom Owner Details pop-up is displayed:
Enter the Name and Email of the owner and click Save.When you create or select a custom owner for an application, this will be displayed in the Asset Metadata pane as a link to the email specified. Custom owners will have curate or access rights to the Catalog or the asset in the Catalog. Only Mendix users that are added as an owner can curate assets they own.
Click Save to return to the Application Metadata screen. Click Save Changes to return to the asset details screen where the changes will be displayed in Metadata pane.
4.2 Changing the App Icon
You can change the icon that is displayed for the app and the data source by uploading your own custom application icon or selecting one from Data Hub the icon library. The selected icon will be displayed for all endpoints of the application and data source such as the Catalog search results and also in the Mendix Studio Pro Data Hub pane and Studio Data Source pane.
When you change an application icon all data sources (published OData services) that are registered in the Catalog for that application will show the new icon. For example, the following shows two data sources that are published from the HR Sample App which are listed in the search results pane (SAMPLE_Employee… and SAP 1.0.0). They both display the same icon that was set for the app:
Currently, by default, the application icon is determined by the application type when the data source is registered. For example, for Mendix apps the Mendix Icon is displayed which identifies the technology of the source app.
4.2.1 Uploading a Custom Icon Image File
When you want to upload a custom icon or image, the following apply:
The accepted file types are .png, .jpg, and .jpeg
The maximum accepted file size is 50 KB
- The minimum recommended size of the image is 64 pixels x 64 pixels. You can crop larger images and select the area you want to display during the upload operation.
- Custom icons that are uploaded will be saved to the Icon Library and can be used for other apps.
To upload a different icon for the app follow these steps:
In the Application Metadata screen of the selected data source, click Upload a different icon to display the Upload Application Icon pop up:
Drag the image file into the upload area or click Upload to browse and select a file from your file system. Click Step 2: Crop image to proceed.
Move the wire-frame to select an area of the loaded image and change the size of the wire-frame to crop the image to the area that you want to use. When you are satisfied, click Apply Changes:For high-resolution images, if the selected are exceeds the size limit there will be a warning. Select a smaller area of the image to reduce the file size.
A preview of the application icon is shown. Click Save to upload the selected icon.
The Application Metadata screen will now show the selected icon for the application:
Click Save Changes to return to the data source details page. The custom icon will be stored in the Icon Library.
4.2.2 Selecting an Icon from the Library
An alternative to uploading an icon is to use an existing icon by clicking select one from your library. The icons for your Data Hub will be shown and you can select one and click Change Icon.
5 Editing the Metadata of a Data Source
You can curate data sources to add a Catalog description and add tags.
5.1 Adding or Editing a Catalog Description
If a description was included in the OData metadata contract, this will be displayed in the asset details screen for the selected data source. You can curate a data source to add a catalog description that could include further details on, for example, the data usage and relevancy.
As search in the Data Hub also includes searching the contents of the description fields of registered assets (data sources, datasets, attributes, and associations), adding relevant descriptions can help in the right users finding these shared assets.
You can also specify if the OData service Contract Description or the Catalog Description is displayed in the Data Hub Catalog.
To edit the asset metadata, follow these steps:
In the Curation Bar, click Edit Metadata > Service Details to display the Service Metadata box:
The description from the OData service metadata is displayed in the Contract Description. This cannot be changed, as it is part of the OData service definition. You can provide an alternative description by toggling Use the catalog description to display the Catalog Description box:
Add a catalog description. This will be stored with the service details in the Catalog.If a Catalog Description has been given for a service, both descriptions will be registered with the service in the Catalog. If you have selected to display the Contract Description, the Catalog Description will be retained providing the option for curators to display this as desired.
Click Save Changes to save the changes that you have made to the Edit Service Metadata screen and return to the Service Details screen, which will now display the selected description.
5.2 Adding or Editing Tags to a Service
Add tags to categorize a registered service and provide additional means for finding the service. Tags that are specified for a service also apply to the datasets and attributes that are exposed in the service. Specify tags for the selected service by following these steps:
In the Search Details screen of a selected service, click Edit Metadata > Service Details in the Curation Bar to display the Service Metadata box.
To add tags, click the empty Tag input area:
To add or edit the tags, enter a tag string and press Enter or select one from the list of existing tags that are used in the Data Hub Catalog and displayed when you start typing in the Tag field. To separate multiple tags, use spaces.Tags can only contain lower-case letters, numbers, and underscores. They must have a minimum of 2 characters. If you use capital letters when typing the tag string, they will be converted to lower-case.
You can enter multiple tags separated by spaces. You can remove tags by clicking the x:
When you are finished specifying the tags, click Save Changes to register the changes and the tags will be shown in the Service Metadata pane.If you leave an Edit Metadata session without saving your change, you will loose all the changes from that session.
6 Discoverable & Validate
The discoverabile and validate properties of registered assets can be set from the Curate bar for the selected asset.
The discoverability is set at a data source level. By default, when a data source is registered in the Data Hub catalog, it is set to Discoverable, which means that all users can find the asset and see details of it. The Discoverable setting will apply to all datasets that are exposed in the data source.
When the Discoverable setting is turned off, it will only be visible to the owners of the service and curators and the Mendix Admin. All other users of Data Hub (also through the Data Hub integrations in Studio Pro and Studio) will not be able to see an asset whose discvorabilty is turned off.
When a data source is set to non-Discoverable, the data source, and the datasets that are exposed cannot be found by other users (except by owners and curators). However, there may be instances of the same datasets in the Catalog, from the same apps, that are available through other discoverable services.
The Share Data Source and Share Dataset links will not be accessible to users for a not-discoverable data source and the exposed datasets (unless they are an owner or a curator).
To change the discoverability of a service, follow these steps:
In the Data Hub Catalog, select the service to display the Search Details.
If you have curation rights, the Curation Bar is displayed. Click the drop-down Discoverabile/Validated menu:
- Click the Discoverable toggle to turn it on or off. A message is displayed to indicate the discoverability of the asset and the discoverability icon is updated in the search results and the data source details.
The Validated property can be assigned to a data source or a dataset to indicate, for example that it has been qualified and is a reliable asset. It can turned on and off by clicking the Validate toggle. A validated data source or dataset is indicated by the validation shield on the data source details screen and also in the search results pane.
Setting an asset as Validated contributes to the weighting of the asset in the search results. This means that Validated assets will be listed before not-validated assets in the results. The weigting of the validation property is also cumulative for a data souce and the consituent datasets. For example, if there is a dataset named Customer that is Validated in a Validated data source, the search results will list this higher than a dataset of the same name that is not Validated in a Validated data source.
7 Curating Datasets & Attributes
Datasets and their exposed attributes can be curated to add Catalog descriptions. Catalog descriptions are stored in the Data Hub Catalog and you can specify which description is displayed: the service contract or the Catalog.
To change dataset and attribute descriptions, follow these steps:
In the Search Details screen for the selected dataset, click Edit Dataset Details on the Curate bar to display the Dataset Metadata box:
The service metadata contract description is displayed. To edit and use a Catalog Description, click the toggle and enter a description.
When there are a large number of attributes for a dataset, you can use the search area to find specific attributes.
Click Save Changes.