CodBiOpenPLZQueryAction

class CodBiOpenPLZQueryAction : IPluginServletAction

This servlet acts as a nano server to pass request from a form using the CodBi along with the OpenPLZ REST API (checkout the documentation for further information about the header-parameter). Unlike the REST-Service returning paginated results, this servlet accumulates all available data and returns it as a single block.

Configuration Keys:

  • OpenPLZ_URL: The URL of the endpoint to use.

  • OpenPLZ_UpdateCycle: The number of hours to wait until a request causes a fresh REST-Request.

Header:

  • country: The country-code of the country to fetch the data of.

  • orgaUnit: The organisational unit to fetch (e.g. /de/ FederalStates). This may be FederalStates, FederalProvinces or Cantons.

  • officialKey The optional key (number) of a state, province or canton to get details from.

  • detail: The optional detail to fetch about a certain state, province or canton identified by the officialKey (not optional if an official key is present). May be Municipalities, or Districts.

  • param1 There may be up to four parameter passed along the request (e.g. postalCode, name, locality, searchTerm).

  • param2 There may be up to four parameter passed along the request (e.g. postalCode, name, locality, searchTerm).

  • param3 There may be up to four parameter passed along the request (e.g. postalCode, name, locality, searchTerm).

  • param4 There may be up to four parameter passed along the request (e.g. postalCode, name, locality, searchTerm).

Constructors

Link copied to clipboard
constructor()

Functions

Link copied to clipboard
open override fun execute(p0: IPluginServletActionParams): IPluginServletActionRetVal

Retrieves the directory of authorities from the OpenPLZ-API. Missing implementation: Buffering of data and re-requesting after a certain amounts of hours.

Link copied to clipboard
Link copied to clipboard
open override fun getDisplayName(p0: Locale): String
Link copied to clipboard
open override fun getName(): String

Returns "CodBi_OpenPLZ_Query"

Link copied to clipboard
open override fun initialize(configData: IPluginInitializeData)

Sets the username, password (also retrieving the contact directory into buffer using the provided credentials) & optionally url.

Link copied to clipboard
open fun initPlugin()
Link copied to clipboard
open fun install(p0: IPluginInstallData)
Link copied to clipboard
open fun shutdown()
open fun shutdown(p0: IPluginShutdownData)
Link copied to clipboard
open fun uninstall(p0: IPluginUninstallData)
Link copied to clipboard
open override fun validateConfigurationData(configData: IPluginValidationData): IPluginInitializeValidationResult?

Updates the username, password&hrsTillUpdate.