Asterisk dialplan functions: Difference between revisions

From 탱이의 잡동사니
Jump to navigation Jump to search
Line 51: Line 51:
=== See also ===
=== See also ===
* https://wiki.asterisk.org/wiki/display/AST/Asterisk+14+Function_GROUP_LIST
* https://wiki.asterisk.org/wiki/display/AST/Asterisk+14+Function_GROUP_LIST
== GROUP_MATCH_COUNT ==
Counts the number of channles in the groups matching the specified pattern.
Calculates the group count for all groups that match the specified pattern. Note: category matching is applied after matching based on group. Uses standard regular expression matching on both.
<pre>
GROUP_MATCH_COUNT(groupmatch@category)
</pre>
* groupmatch : A standard regular expression used to match a group name.
* category : A standard regular expression used to match a category name.
=== See also ===
* https://wiki.asterisk.org/wiki/display/AST/Asterisk+14+Function_GROUP_MATCH_COUNT


== IMPORT ==
== IMPORT ==

Revision as of 15:06, 6 February 2017

Overview

Asterisk dialplan function 내용 정리

GROUP

Gets or sets the channel group.

Category can be employed for more fine grained group management. Each channel can only be member of exactly one group per category.

GROUP(category)
  • category : Category name.

Example

[CountOutgoingCalls]
 exten => s,1,Set(GROUP(active_calls)=active_calls)
  same => n,GotoIf($[${GROUP_COUNT(active_calls)}>${OutgoingCallLines}]?FraudHandler,s-668,1) ; Too many concurrent calls (outbound only).
  same => n,Return()

See also

GROUP_COUNT

Counts the number of channels in the specified group.

Calculates the group count for the specified group, or uses the channel's current group if not specified (and non-empty).

GROUP_COUNT(groupname@category)
  • groupname : Group name.
  • category : Category name.

Example

[CountOutgoingCalls]
 exten => s,1,Set(GROUP(active_calls)=active_calls)
  same => n,GotoIf($[${GROUP_COUNT(active_calls)}>${OutgoingCallLines}]?FraudHandler,s-668,1) ; Too many concurrent calls (outbound only).
  same => n,Return()

See also

GROUP_LIST

Gets a list of the groups set on a channel.

GROUP_LIST()

See also

GROUP_MATCH_COUNT

Counts the number of channles in the groups matching the specified pattern.

Calculates the group count for all groups that match the specified pattern. Note: category matching is applied after matching based on group. Uses standard regular expression matching on both.

GROUP_MATCH_COUNT(groupmatch@category)
  • groupmatch : A standard regular expression used to match a group name.
  • category : A standard regular expression used to match a category name.

See also

IMPORT

Retrieve the value of a variable from another channel.

IMPORT(channel,variable)
  • channel
  • variable

Example

[TransferFromMVNO]

exten => _[+*0-9a-zA-Z]!,2,NoOp(Transfer from MVNO)
  same => n,Set(__InternalNumber=${IMPORT(${SHARED(TransferChennel)},InternalNumber)})
  ...

See also

SHARED

Gets or sets the shared variable specified.

Implements a shared variable area, in which you may share variables between channels.

The variables used in this space are separate from the general namespace of the channel and thus SHARED(foo) and foo represent two completely different variables, despite sharing the same name.

Finally, realize that there is an inherent race between channels operating at the same time, fiding with each others internal variables, which is why this special variable namespace exists; it is to remind you that variables in the SHARED namespace may change at any time, without warning. You should therefore take special care to ensure that when using the SHARED namespace, you retrieve the variable and store it in a regular channel variable before using it in a set of calculations(or you might be surprised by the result).

SHARED(varname,channel)
  • varname : Variable name
  • channel : If not specified will default to current channel. It is the complete channel name: SIP/12-abcd1234 or the prefix only SIP/12.

Example

[SetSharedVariables]
exten => s,1,NoOp(Set shared variables)
  same => n,Set(SHARED(DirectNumber)=${DirectNumber})
  same => n,Set(SHARED(InternalNumber)=${DirectNumber})
  ...

See also

VALID_EXTEN

입력된 Extension 이 지정된 Context 에 존재하는지 여부를 확인한다.

Determine whether an extension exists or not.

Returns a true value if the indicated context, extension, and priority exist.

This function has been deprecated in favor of the DIALPLAN_EXISTS() function.
VALID_EXTEN(context,extension,priority)
  • context : Defaults to the current context.
  • extension
  • priority : Priority defaults to 1

Example

[DialToInternal]
 include => Internal
 exten => s,1,Goto(${CallFlowID},1)
 exten => _[+0-9]!,1,GoSub(LoopDetection,s,1)
  same => n,ExecIf(${ISNULL(${UniqueID})}?Set(__UniqueID=${UNIQUEID}))
  same => n,Log(NOTICE,${UniqueID}-${CONTEXT}(${UNIQUEID}@${CHANNEL}))
  same => n,GotoIf(${VALID_EXTEN(Internal,${EXTEN},1)}?Internal,${EXTEN},1)

See also

See also