Asterisk dialplan functions
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
- https://wiki.asterisk.org/wiki/display/AST/Asterisk+14+Dialplan+Functions - Asterisk 14 Dialplan Functions