The documentation for avpops module was updated to reflect the latest changes and published online at:
http://openser.org/docs/modules/1.1.x/avpops.html
Cheers, Daniel
On 02/10/06 21:44, Daniel-Constantin Mierla wrote:
Hello,
the avpops module was refurbished to benefit better of pseudo-variables. In addition, the avp and hdr pseudo-variables can have dynamic names. Here are some details:
- all parameters being avp names in avpops functions MUST be specified
in the same format as pseudo-variables: - $avp(i:23) - refers to the avp having the integer id 23
- $avp(s:test) - refers to the avp having the name 'test'
- $avp($aliasid) - refers to the avp defined by avp alias 'aliasid'
- example: avp_write("i:10", "$avp(i:30)") - write integer value 10
into the avp having the id 30
- avps and hdrs pseudo-variables can have dynamic names: -$avp($pvar) refers to the avp having the name the value of $pvar -$hdr($pvar) refers to the hdr having the name the value of $pvar
- please note that the pseudo-variables specifiers have priority
over avp aliases (if you define an avp alias $ru, $avp(ru) will refer to the avp having the name the value of R-URI)
- in all parameters of avpops module can be used pseudo-variables
where are expected values
- avp_check("$fd", "eq/$td") returns true if the domain of From uri
is the same with domain part of To uri
- avp_write("$tU", "$avp($fU)") - writes the username in To header
in the avp having the name the username from From header
- avp_pushto() - cannot add anymore headers - same functionality is
provided by the textops module via append_hf() and append_to_reply() functions
- the format of the first parameter of avp_pushto() follows the
pseudo-variables names as well.
avp_pushto("$ru[/username|domain]", "...") to rewrite parts of R-URI
avp_pushto("$du", "...") to rewrite dst_uri
for developers, internal structure int_str has changed from (int,
str*) to (int,str) to avoid extra reference
- the documentation will be updated soon (module readme and avpops
tutorial)
Still to come:
- support for global avps: avps shared between all processes during
the openser lifetime
- support for script avps: avps specific per process with life time
only during the script execution (temporary avps, which do not need to last too much, using private memory)
- support for local avps: avps specific per process kept during
openser lifetime (avps which need to be kept for each process, without synchronized access, using private memory)
- avp_db_query() - ability to send a raw query (simple, joins, unions
...) to database and load the result in avps (e.g., avp_db_query("select first_name, last_name from subscriber where username='$tU' and domain='$td'", "$avp(first_name);$avp(last_name)"))
Testing and feedback are more than welcome.
Cheers, Daniel
Devel mailing list Devel@openser.org http://openser.org/cgi-bin/mailman/listinfo/devel