Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

readme.md

ODS External Search Provider

This is a working sample of a custom ODS External Search Provider.

This is commonly used to search third-party systems for people/organisations; for example a PMS or CRM.

Files

File Purpose
ExampleOdsSearchProvider.cs This is the provider implementation. It is responsible for calling the third-party system and collating the results
ExampleOdsSearchProviderConfig.cs This is the model representing any custom configuration needed for the provider
./_Content/OdsExternalSearchProvider/* These files contain an example of a custom configuration UI for the provider

How To Use The Provider

The provider will appear in 'Global Features' under the 'ODS External Search' feature.

  1. Open the feature, click the + button, and select the 'Example Provider'.

    It will be added to the list of providers:

    image
  2. Clicking the cogs icon will open the custom configuration panel.

    Enter some text into this box, Save & Close twice, and recycle the Modeller configuration.

  3. Create a new ODS Organisation (/admin/organisationList -> "Add New")

    The provider appears in the 'Create from..' menu. Select it:

    image
  4. Enter any search string and press Enter.

    The provider will return a single result (Organisation 1), prefixed with the text we entered in our custom configuration (step 2).

    image