Browse screen does not have a suitable filter error


I’m getting some problems trying to open a new screen from an entity detail to view related entities.
I’m using RelatedEnitiesBuilder to show the screen as follows:

RelatedEntitiesBuilder builder = relatedEntitiesAPI.builder(this);

Screen movBrowser = builder

The new screen (a browse screen on related entity) is shown but objects are not filtered and the message “Browse screen does not have a suitable filter” appears.
Which kind of filter is required in the screen and how can I create it?



Your browser screen should just contain filter component:

<filter id="filter"
    <properties include=".*"/>

Also, you can get this message when filter is applied for a different entity type and not to a related.

Thanks Roman.

I’m still getting problems, let me explain better my entities and relations:

  • A Tk object has a (one-to-many) relationship with TkMov objects (on

I’m trying to open the related TkMov objectd starting from the Tk detail (edit screen).

This is my last attempt (button click handler):

RelatedEntitiesBuilder builder = relatedEntitiesAPI.builder(this);

Screen movBrowser = builder

Now I get this error:

java.lang.IllegalStateException: Range is datatype
	at com.haulmont.chile.core.model.impl.DatatypeRange.asClass(
	at com.haulmont.cuba.gui.relatedentities.RelatedEntitiesBean.lambda$buildScreen$1(

Thanks again,


Related entities API allows you to show entities from property with association type, not an id.
In your case it will be possible to show related entities only for TkMov entity because it contains Tk.

If you want to show which entities (TkMov) related with Tk you can load them with nested collection.

See demo project how to load nested colletion of entities and show related entities using RelatedEntitiesBuilder: (85.6 KB)

1 Like

Ok, it’s clear now. I’ll try to use nested collection instead.