Call Variable for Obtaining CDR Field Value from SIP Header
For call variables, you can use hard-coded variable names for retrieving values from SIP headers in SIP messages for specific CDR fields when customizing the CDR format:
| ■ | User-Defined CDR Fields: The device provides up to five user-defined CDR fields called 'Var Call User Defined <1-5>', which you can include in the generated CDR. To obtain the value for these fields from SIP messages, use the following syntax: |
var.call.src|dst.userdefined<1-5>
Once you have configured the Message Manipulation rule, you need to customize the CDR in the SBC CDR Format table or Gateway CDR Format to include the 'Var Call User Defined <1-5>' field. Select the corresponding Var Call User Defined <1-5> option from the 'Field Type' drop-down list.
For Gateway calls, only the call variable var.call.dst.userdefined<1-5> is applicable (because there is only one "leg" in the Gateway application). Therefore, to apply the Message Manipulation rule to the incoming or outgoing SIP message, use the [GWInboundManipulationSet] or [GWOutboundManipulationSet] ini file parameters, respectively.
| ■ | Tenant ID CDR Field: (SBC application only) To obtain the value for the ‘Tenant ID’ CDR field from the SIP message (typically used by OVOC), use the following syntax: |
var.call.src|dst.TenantId
Once you have configured the Message Manipulation rule, you need to customize the CDR in the SBC CDR Format table to include the 'Tenant ID' CDR field. Select Tenant ID from the 'Field Type' drop-down list.
The call variable var.call.src|dst.TenantId is applicable only to the SBC application.
The following examples use the URL of the Contact header in the SIP INVITE message as the value for the 'Tenant ID' and 'User-Defined1' CDR fields:
Examples of Using Call Variables for Obtaining CDR Field Values from SIP Headers
|
Message Type |
Condition |
Action Subject |
Action Type |
Action Value |
|---|---|---|---|---|
|
invite |
- |
Var.Call.Src.TenantId |
Modify |
Header.Contact.URL |
|
invite |
- |
Var.Call.Dst.UserDefined1 |
Modify |
Header.Contact.URL |