GEOLOC_PROFILE()

Synopsis

Get or Set a field in a geolocation profile

Description

When used to set a parameter on a profile, if the profile doesn't already exist, a new one will be created automatically.

The ${GEOLOCPROFILESTATUS} channel variable will be set with a return code indicating the result of the operation. Possible values are:

• 0 - Success
• -1 - No or not enough parameters were supplied
• -2 - There was an internal error finding or creating a profile
• -3 - There was an issue specific to the parameter specified (value not valid or parameter name not found, etc.)

Syntax

GEOLOC_PROFILE(parameter[,options])

Arguments

• parameter - The profile parameter to operate on. The following fields from the Location and Profile objects are supported.
  • id
  • location_reference
  • method
  • allow_routing_use
  • profile_precedence
  • format
  • pidf_element
  • location_source
  • notes
  • location_info
  • location_info_refinement
  • location_variables
  • effective_location
  • usage_rules
  • confidence
    Additionally, the inheritable field may be set to true or false to control whether the profile will be passed to the outgoing channel.

• options
  • a - Append provided value to the specified parameter instead of replacing the existing value. This only applies to variable list parameters like location_info_refinement.
  • r - Before reading or after writing the specified parameter, re-resolve the effective_location and usage_rules parameters using the location_variables parameter and the variables set on the channel in effect at the time this function is called.

See Also

Import Version

This documentation was imported from Asterisk Version GIT-20-5c114dc