کاربرد Macro ها در Asterisk
[RIGHT]ماکروها ساختار بسیار پرکاربردی در جلوگیری از تکرار در dialplan هستند .در مثال زیر نمونه ای از پیاده سازی صندوق صوتی را که با توجه به اشغال بودن یا در دسترس نبودن کاربر 101 پیام خاصی پخش شده و تماس به صندوق صوتی هدایت می شود مشاهده می کنید .
[/RIGHT]
[LTR][RTL][CODE][LEFT]exten => 101,1,Dial(SIP/phone1,10)
exten => 101,n,GotoIf($[“${DIALSTATUS}”=”BUSY”]?Busy:unavai)
exten => 101,n,(unavail),voicemail(101@defualt,u)
exten => 101,n,Hangup()
exten => 101,n(busy),VoiceMail(101@default,b)
exten => 101,n,Hangup()
[/LEFT]
[/CODE][/RTL][/LTR]
[RIGHT]اکنون فرض کنید شما باید سیستم تلفنی ای با 1000 کاربر و VoiceMail های آنها را تعریف کنید . این عملیات نیاز به کپی کردن های متناوبی خواهد داشت که احتمالا بدون مشکل نخواهد بود . در ادامه خواهید دید که چگونه با استفاده از ماکروها می توانیم این تنظیمات را ساده تر و سازمان یافته تر انجام دهیم . [/RIGHT]
[RIGHT]تعریف ماکروها شبیه تعریف extension ها در Dialplan است . برای تعریف ماکروها از کلمه رزرو شده macro- و نام ماکرو استفاده می کنیم . به عنوان مثال [/RIGHT]
[LEFT][RIGHT]macro-voicemail[/RIGHT]
[/LEFT]
[RIGHT]وجود کلمه macro- در ابتدای ماکروها آنها را از context های معمولی متمایز می سازند . دستوراتی که در ماکروها استفاده می شوند ، شامل دستورات عادی ای هستند که در تعریف های رایج Dialplan استفاده می شود و تنها فاکتور محدود کننده این است که در ماکروها فقط می توان از extension های s استفاده کرد . [/RIGHT]
[LEFT][RIGHT][macro-voicemail][/RIGHT]
[LTR][CODE]
[/LEFT]
exten => s,1,Dial(SIP/phone1,10)
[LEFT]exten => s,n,GotoIf($[“${DIALSTATUS}”=”BUSY”]?Busy:unavai)
[/LEFT]
exten => s,n,(unavail),voicemail(101@defualt,u)
exten => s,n,Hangup()
[LEFT]exten => s,n(busy),VoiceMail(101@default,b)
[/LEFT]
exten => s,n,Hangup()[/CODE][/LTR]
[RIGHT]این یک مثال برای شروع کار با ماکرو است ولی مثال کاملی نیست زیرا فقط برای کاربر phone1 و صندوق صوتی او ساخته شده است . برای تعریف اصولی ماکروها باید از آرگومان ها بهره ببریم . ولی ایتدا اجازه دهید نحوه استفاده از ماکروی بالا را Dialplan ببینیم .[/RIGHT]
[RIGHT]برای استفاده از ماکروها در Dialplan از برنامه Macro() استفاده می کنیم . این برنامه یک ماکرو را فراخوانی کرده و در صورت نیاز آرگومان ها را به آن پاس می دهد . به عنوان مثال برای فراخوانی ماکروی voicemail که در مرحله قبل تعریف کردیم مانند زیر عمل می کنیم .[/RIGHT]
[LEFT][RIGHT]exten => 101,1,Macro(voicemail)[/RIGHT]
[/LEFT]
[RIGHT]برنامه Macro() چندین متغیر سیستمی را برای استفاده ما تعریف و مقداردهی می کند . [/RIGHT]
[RIGHT]${MACRO_CONTEXT} : context ای که ماکرو در آن فراخوانی شده است را بر می گرداند . [/RIGHT]
[RIGHT]${MACRO_EXTEN} : extension ای که در آن ماکرو قراخوانی شده است را بر می گرداند .[/RIGHT]
[RIGHT]${MACRO_PRIORITY} : اولویت ای که در آن ماکرو فراخوانی شده است را بر می گرداند . [/RIGHT]
[RIGHT]به عنوان مثال در Dialplan زیر [/RIGHT]
[LTR][CODE][LEFT][internal_users]
exten => 101,1,Macro(voicemail[/CODE][/LTR])[/LEFT]
[RIGHT]مقادیر متغیر های ذکر شده عبارتند از :[/RIGHT]
[RIGHT]${MACRO_CONTEXT} == internal_users[/RIGHT]
[RIGHT]${MACRO_EXTEN} == 101[/RIGHT]
[RIGHT]${MACRO_PRIORITY} == 1[/RIGHT]
[RIGHT]نوع دیگری از آرگومان نیز در Macro وجود دارد که توسط کاربر می تواند به MACRO پاس داده شود . این نوع آرگومان که با ${ARGn} که در آن n شماره آرگومان پاس داده شده به سیستم است قابل دستیابی می باشد . [/RIGHT]
[RIGHT]اکنون قادر خواهیم بود با استفاده از آرگومان ها مثال کاملتری از پیاده سازی ماکروی قبلی ارائه دهیم .[/RIGHT]
[LTR][CODE][LEFT]
[macro-voicemail]
exten => s,1,Dial([COLOR=#c00000]${ARG1}[/COLOR],10)
exten => s,n,GotoIf($[“${DIALSTATUS}”=”BUSY”]?Busy:unavai)
exten => s,n,(unavail),voicemail([COLOR=#c00000]${MACRO_EXTEN}[/COLOR]@defualt,u)
exten => s,n,Hangup()
exten => s,n(busy),VoiceMail([COLOR=#c00000]${MACRO_EXTEN}[/COLOR]@default,b)
exten => s,n,Hangup()
[/LEFT]
[/CODE][/LTR]
