Data Hub Pane

Last update: Edit

1 Introduction

Mendix Data Hub enables integration of available data sources from the different applications in an organization into your Mendix apps. This means that new apps can be created using shared datasets that are registered in the Data Hub Catalog. In Studio Pro, this is possible using the integrated functionality of Data Hub Catalog through the Data Hub pane.

The Data Hub pane enables you to search the Data Hub Catalog and discover the data sources available for your organization. Via this pane you can add the entities that are exposed in the OData services registered in the Data Hub Catalog into your app’s domain model. These external entities provide the connection to the data associated with the entities which can be utilized in your app and they are called external entities.

To display the Data Hub pane, click View > Data Hub:

data-hub-pane

2 Data Hub Pane in the Domain Model

In the domain model, the Data Hub pane is used to search the Data Hub Catalog for services and entities that can be dragged and used in your app project:

The following functionality is available in the pane:

  • Search – Enter a search string of alphanumeric characters to find a service, entity, or attribute in the Data Hub Catalog. Entities can be dragged from the search results into your domain model as external entities.
  • Filter – By default, the search will search for services in production environments. Click the Filter icon to include non-production environments in the search.
  • Search results – The search results satisfying the search string will show the service name, service version, environment that the service was deployed to, and the entities in the service. If attributes satisfy the search criteria, they will be displayed under the expanded entity. Services and the entities that are currently being used in the current domain model are indicated with a green check-mark in the search results. You can drag entities from the search results into the domain model and use them as a data source for your app project.

When no search string has been specified in the Data Hub pane, the Project pane is displayed. This shows the consumed services and the external entities used in the current project. The attributes for consumed entities are also listed:

Project Section

To add entities to your project model, see Adding an External Entity to a Project.

As you enter a search term, all the items in the Data Hub Catalog satisfying the search string are listed in the search results.

You can do a wildcard search by entering * in the search area.

3.2 Service Environments

By default, the search is restricted to apps and services deployed to a production environment. To include non-production environments in your search, click the Filter icon and check Show development environments:

Filter Icon

4 Viewing Search Results

For all items satisfying the search string, the following information is displayed:

  • Service name

  • An icon indicating the source application of the service (for example, Mendix, SAP, Siemens Teamcenter, or other non-Mendix apps)

  • Service version

  • The name of the environment that the service is deployed to (for non-production environments)

  • Green check-mark if the service or entity is already consumed by the project

  • Blue Update Service icon to indicate that there is a later version of the consumed service available in the Data Hub. Click to update the service that is consumed in the project to the contract that is now available:

    Data Hub Pane update

  • Information icon to view further details for the service and a link to go directly to the Service Details screen in the Data Hub Catalog:
Data Hub Pane Information

4.1 Selected Consumed Service

If you right-click a consumed service, you can do the following:

info on a Service
  • View in Data Hub Catalog – click this to go to the Service Details page in the Data Hub Catalog
  • Go to connection settings – click this to open the consumed OData service document

4.2 Selected Entity

If you right-click an entity and select View in Data Hub Catalog, it will take you to the entity details page in the Data Hub Catalog.

If you right-click a consumed entity and Go to entity, it will take you to the entity in the domain model.

4.3 Selected Attribute

If you right-click an attribute of a consumed entity and Go to attribute, it will take you to the attribute in the domain model.

5 Read More