This documentation is written for developers and administrators and describes how to implement auto-complete logic which is used by the client.

1 Introduction
2 Including a Plug-in in the Client-Service
- 2.1 Checking the Logging of the Plug-in
- 2.2 Result of the Request
3 Creating a Plug-in
4 Plug-in Examples

Introduction

Beginning with yuuvis® RAD 10.6, the client-service can be extended by auto-complete plug-ins. This feature will be used by the client in one of the next minor releases. A new string field property URL for auto-complete service was introduced in the schema in version 10.4 and can be maintained with the help of the designer.

New string attribute in the designer

This URL will be resolved and used by the client if it is found in a form and offers the user a behavior similar to a dynamic list field.

The URL can be configured with the placeholders that are resolved by the client. Placeholders must be entered with brackets like {placeholder name}.

List of placeholders:

Placeholder	Description

Placeholder	Description
situation	Possible resolved values are `create`, `edit`, and `search` depending on the situation the corresponding form is used.
objecttype	The technical name of the object type of the opened object (no value in the situation search).
objectid	The object Id of the opened object (no value in the situation search).
field:<field name>	The value of a qualified technical field name of the opened object (no value in the situation search).
clientlocale	Beginning with version 9.16 LTS, the 2 characters-long language code of the `Application` language the user has configured in the client settings.
schemalocale	Beginning with version 9.16 LTS, the 2 characters-long language code of the `Definition` language the user has configured in the client settings.

Including a Plug-in in the Client-Service

The jar file of the plug-in must be stored in the directory <yuuvis-rad-data-dir>/autocomplete-plugins:

The client-service must be restarted to enable the plug-in.
The plug-ins will automatically be registered and be listed via this endpoint: <host>/app/api/autocomplete/info

Result of info endpoint

Any number of plug-in files can be stored in this directory.

Checking the Logging of the Plug-in

As soon as the client-service has been restarted, available plug-ins are detected. Information on these plug-ins can be found in the log.

In this example the “dummy” plug-in is resolved and started:

... org.pf4j.DefaultPluginStatusProvider     : Enabled plugins: []
... org.pf4j.DefaultPluginStatusProvider     : Disabled plugins: []
... org.pf4j.DefaultPluginManager            : PF4J version 3.11.0 in 'deployment' mode
... org.pf4j.AbstractPluginManager           : Plugin 'AutocompleteCatalog-Dummy-Plugin@10.0.0' resolved
... org.pf4j.AbstractPluginManager           : Start plugin 'AutocompleteCatalog-Dummy-Plugin@10.0.0'
... c.o.s.a.p.t.DummyPlugin$DummyProducer    : Start

Result of the Request

The result of all plug-ins will look like this:

 {
  "entries": [
    {
      "value": "alpha",
      "description": "first letter",
      "selectable": true
    },
    {
      "value": "beta",
      "description": "second letter",
      "selectable": true
    },
    ....
  ]
}

Creating a Plug-in

This section describes how to set up and configure a new plug-in including its deployment and check.

The plug-in capability of the client-service is based on the PF4J framework.

The plug-in must comply with the interface defined by PF4J-Spring. In particular, this is a constructor with a PluginWrapper as a parameter:

	public DummyPlugin(PluginWrapper wrapper) {
        super(wrapper);
    }

Including the Library for the Definition of the Plug-in Interface

OPTIMAL SYSTEMS provides a library for the definition of the plug-in interface. The autocomplete-plugin-interface.jar file is available for download below and must be added to the project. It defines the interface for the client-service and also brings the plug-in capability of PF4J.

It is important that the dependency of the plug-in to the interface library is defined as provided (in gradle compileOnly):

Implementing the Plug-in

The following example operates with JSON files as source.

Plug-in example code:

Building the `jar` File

If the plug-in is packaged in a jar file, there are important points to note:
The following attributes must be specified in the MANIFEST.MF file (in the example plug-in):

For these values to be automatically inserted into the jar file, the maven-assembly-plugin can be configured accordingly:

The jar file must contain all required libraries (except autocomplete-plugin-interface and thus also pf4j).
The MANIFEST.MF file must have the appropriate entries.
The extensions.idx file must be included. It is automatically generated by PF4J during build.

This generated jar file can now be placed in the appropriately configured directory of the client-service.

Checking the Plug-in

To check the new plugin, it must be placed in the directory described above and the client-service must be restarted.

Plug-in Examples

You can find some plug-in examples in the tutorial section:

Auto-complete Plug-in Examples

Auto-complete Plug-ins