Configuring and Using the OSF Concept Reference (Tagging) Field Widget

The  and the field widget is a specialized field widget that is used to reference OSF entities one between the other. It let users searching for the entities they want to reference. Then it presents the referenced entities in a series of blue boxes below the entities search bar.

Configuring the OSF Entity Reference Field Widget
To configure the field, you have to click the  link in the list of fields to manage for an existing , or an existing. After clicking the link, you will be redirected to the list of configuration options that are available for this field widget. The first setting that is of interest to us is the  option. In that section, you will have a list of all the datasets currently available to you. Then you will have to select all the datasets that you want to make available to the field widget. This means that if you select the datasets  and , then when the user will try to reference entities using that field widget, he will only search for entities within the datasets   and.

Additionally you can do that on the list of loaded ontologies in the Drupal portal. The second setting of interest is the  setting. This is a convenient setting that you can use to specify the type of the entities to return when the user is searching for resources to refer to.

The third setting that is of interest is the  setting. This setting restrain the number of values (references) that a user can define for that field.

Finally, when you are done configuring the field widget, you have to click the  button to save the settings you just configured.

Using the OSF Entity Field Widget
Once the  is configured, you can start using it by editing one of your content type or resource type entity. The field widget looks like this: You have 2 main sections with this widget:
 * 1) The top edit box section that is an autocompletion field what will let you find the entity you want to refer to. Once you start typing a single character, you will start seeing entities results appearing. The search is done on the preferred label of the entities (their names)
 * 2) The bottom section lists all the entities that have been selected using that field widget. All the blue boxes that are checked will be saved in the system. If an entity is unchecked, then it will appear in yellow and it won't be saved into the system.