Announcements
Announcements
The N2IWF can be configured to request that announcements be played for SIP calls.
The available announcements are defined in the ANNOUNCEMENTS LogicApp service
global variable.
<global name="ANNOUNCEMENTS" type="array">
<announcement name="ann99" srf_name="OnSwitch" announcement_id="99"/>
<announcement name="ann_var1" srf_var="srf" announcement_var="announcement"/>
<announcement name="ann_var2" srf_var="srf" announcement_var="announcement"
srf_name="External" announcement_id="1"/>
</global>
Configuration Details
Each announcement definition may contain the following parameters:
| Attribute | Type | Description |
|---|---|---|
name |
String | [Required] The name of the announcement, as it is referred to in action rule. |
announcement_id |
Integer | A literal value for the announcement ID as configured on the external resource. At least one of announcement_id or announcement_var must be configured. |
announcement_var |
String | A variable name to read for the announcement ID as configured on the external resource. At least one of announcement_id or announcement_var must be configured. |
srf_name |
String | A literal value for the SRF name to use, as defined in LhoScpApp. At least one of srf_name or srf_var must be configured. |
srf_name |
String | A variable name to read for the SRF name to use, as defined in LhoScpApp. At least one of srf_name or srf_var must be configured. |
When playing an announcement, the parameters holding variable values are checked first, if present. If no value is found, the literal parameters are used instead, if configured.
If an announcement fails to be set up or played, the call will continue and no PROBLEM EDR will be raised. However, statistics and alarms will be raised to report the issue.
Each named announcement may be specified in any action rule, e.g.:
<global name="RESULT_CODES" type="array">
...
<rule code="4012" service.at_terminate="0" var="network" value="home" action="release" announcement="ann99" />
...
</global>