EDIT

import java.util.Arrays;

import java.util.List;

import org.vaadin.viritin.fields.CaptionGenerator;

import org.vaadin.viritin.fields.LazyComboBox.FilterableCountProvider;

import org.vaadin.viritin.fields.LazyComboBox.FilterablePagingProvider;

import eu.etaxonomy.cdm.api.service.pager.Pager;

import eu.etaxonomy.cdm.model.reference.Reference;

import eu.etaxonomy.cdm.persistence.query.MatchMode;

import eu.etaxonomy.cdm.persistence.query.OrderHint;

    /**

     * {@inheritDoc}

     */

    @Override

    public void handleViewEntered() {

        super.handleViewEntered();

        getView().getNomReferenceCombobox().getSelect().setCaptionGenerator(new CaptionGenerator<Reference>(){

            @Override

            public String getCaption(Reference option) {

                return option.getTitleCache();

            }

        });

        getView().getNomReferenceCombobox().loadFrom(new FilterablePagingProvider<Reference>(){

            @Override

            public List<Reference> findEntities(int firstRow, String filter) {

                Pager<Reference> page = getRepo().getReferenceService().findByTitle(

                        null,

                        filter,

                        MatchMode.ANYWHERE,

                        null,

                        20,

                        firstRow,

                        OrderHint.ORDER_BY_TITLE_CACHE.asList(),

                        Arrays.asList("$")

                      );

                return page.getRecords();

            }},

            new FilterableCountProvider(){

                @Override

                public int size(String filter) {

                    Pager<Reference> page = getRepo().getReferenceService().findByTitle(

                            null,

                            filter,

                            MatchMode.ANYWHERE,

                            null,

                            1,

                            0,

                            null,

                            null

                          );

                    return page.getCount().intValue();

                }}

            , 20);

    }

import eu.etaxonomy.cdm.model.reference.Reference;

import eu.etaxonomy.cdm.vaadin.event.AbstractEditorAction;

import eu.etaxonomy.cdm.vaadin.event.ReferenceEditorAction;

import eu.etaxonomy.vaadin.component.ToOneRelatedEntityCombobox;

    private final static int GRID_ROWS = 9;

    private ToOneRelatedEntityCombobox<Reference> nomReferenceCombobox;

    private TextField nomenclaturalReferenceDetail;

        // nomenclaturalReference

        nomReferenceCombobox = new ToOneRelatedEntityCombobox<Reference>("Nomenclatural reference", Reference.class);

        nomReferenceCombobox.setWidth(100, Unit.PERCENTAGE);

        nomReferenceCombobox.addClickListenerAddEntity(e -> getEventBus().publishEvent(

                new ReferenceEditorAction(AbstractEditorAction.Action.ADD, null, nomReferenceCombobox, this)

                ));

        nomReferenceCombobox.addClickListenerEditEntity(e -> {

            if(nomReferenceCombobox.getValue() != null){

                getEventBus().publishEvent(

                    new ReferenceEditorAction(

                            AbstractEditorAction.Action.EDIT,

                            nomReferenceCombobox.getValue().getId(),

                            nomReferenceCombobox,

                            this)

                );

            }

            });

        addField(nomReferenceCombobox, "nomenclaturalReference", 0, row, 3, row);

        row++;

        nomenclaturalReferenceDetail = addTextField("Reference detail", "nomenclaturalMicroReference", 0, row, 1, row);

    /**

     * {@inheritDoc}

     */

    @Override

    public ToOneRelatedEntityCombobox<Reference> getNomReferenceCombobox() {

        return nomReferenceCombobox;

    }

import eu.etaxonomy.cdm.model.reference.Reference;

import eu.etaxonomy.vaadin.component.ToOneRelatedEntityCombobox;

    /**

     * @return

     */

    public ToOneRelatedEntityCombobox<Reference> getNomReferenceCombobox();