Call.route - Revision history

Andrei at 16:07, 18 November 2013

2013-11-18T16:07:12Z

2013-10-24T10:52:57Z

Document how to reply with other errors than "forbidden". Fix a small typo.

2013-04-23T07:29:38Z

‎Parameters

2013-01-21T10:44:31Z

2012-12-17T10:39:30Z

‎Send a 403 Forbidden

2012-12-17T10:39:17Z

‎Parameters

2012-12-17T10:32:00Z

‎Parameters

2012-12-17T10:10:05Z

2012-10-03T14:30:28Z

‎Parameters

2012-10-03T14:25:11Z

‎Parameters

@@ Line 31: / Line 31: @@
 ====Send a 403 Forbidden====
-To do that, you have to set the return value of the message to "-" (to a dash)
+To do that, you have to set the return value of the message to "-" (to a dash) or "error" string.
 Then set the parameters called ''error'' and ''reason'' to forbidden (using setParam() method) to write the error.
@@ Line 39: / Line 39: @@
    if (some_condition_met())
+   {
-     msg.retValue() = "-";
+     msg.retValue() = "-"; // msg.retValue() = "error";
      msg.setParam("error", "forbidden");  //will set the SIP message as 403
      msg.setParam("reason", "Forbidden");  //The text that appears in the SIP message (403 Forbidden)

@@ Line 1: / Line 1: @@
-Message sent by a channel when a new call is coming inwards Yate and a routing decision need be made. The returned value is the logical destination of the call.
+Message sent by a channel when a new call is coming inwards Yate and a routing decision needs to be made. The returned value is the logical destination of the call.
 ===Sample scenario===
@@ Line 48: / Line 48: @@
 You can use this message to make very complex routing systems based on the information you get.
 '''See also'''
 * [[call.preroute]]

@@ Line 19: / Line 19: @@
 ;called : The called number
 ;address : Module-specific remote endpoint address
-;context : Timeout for the outgoing channel (milliseconds)
+;context : The routing context selected by the current call
 ;maxcall : Maximum call time until answered (milliseconds), possible values are between 2000 (2 seconds) and 120000 (120 seconds)

← Older revision		Revision as of 10:44, 21 January 2013
Line 46:		Line 46:

	You can use this message to make very complex routing systems based on the information you get.		You can use this message to make very complex routing systems based on the information you get.
		+
		+
		+	'''See also'''
		+
		+	* [[call.preroute]]

@@ Line 28: / Line 28: @@
 *In some cases you may need to return an error with a code and reason to the sender.
-===Send a 403 Forbidden===
+====Send a 403 Forbidden====
 To do that, you have to set the return value of the message to "-" (to a dash)

@@ Line 22: / Line 22: @@
 ;maxcall : Maximum call time until answered (milliseconds), possible values are between 2000 (2 seconds) and 120000 (120 seconds)
-In some cases a routing module may decide to add one more parameter to this message and to let message pass to the next routing module.
+===Scenarios===
-In some cases you may need to return an error with a code and reason to the sender.
+*In some cases a routing module may decide to add one more parameter to this message and to let message pass to the next routing module.
 ===Send a 403 Forbidden===

@@ Line 25: / Line 25: @@
 In some cases you may need to return an error with a code and reason to the sender.
 e.g. Send a 403 Forbidden
 to do that, you set the parameter :retValue(): to "-" (to a dash)
 Then set the parameters :error: and :reason: (using setParam() method) to write the error.