گرفتن DTMF (عدد وارد شده) از تماس گیرنده و قرار دادن آن در یک متغییر
Read(variable[,filename[,maxDigits[,option[,attempts[,timeout]]]]])
گرفتن DTMF به صورت ترتیبی از تماس گیرنده و اتمام دریافت آن با کاراکتر # ، این Application کامل ترین راه برای دریافت یک عدد از تماس گیرنده است.
پارامترها:
همانطور که از ساختار و نحوه نوشتن این Application مشخص است دارای یک پامامتر اجباری است، variable نام متغییری است که مقدار خروجی که همان عدد دریافتی است در آن ریخته می شود. اما پارامتر های انتخابی بعدی عبارت اند از: filename محل قرار گیری نام فایلی که می خواهید برای تماس گیرنده پخش شود، تماس گیرنده می تواند حین شنیدن این پیام نیز اعداد خود را وارد نماید توجه داشته باشید که نام فایل خود را بدون پسوند وارد نمایید. پارامتر بعدی maxDigits است که طول مجاز عدد دریافتی را مشخص می کند مثلا اگر در این پارامتر عدد ۵ را قرار دهیم تماس گیرنده ۵ عدد بیشتر نمی تواند وارد کند و پس از وارد کردن عدد پنجم ، Application در یافت عدد را خاتمه داده و Extension به خط بعدی می رود.
پارامتر بعدی option می باشد که می توان ۲ کاراکتر s و n را قرار داد، s برای اینکه اگر کانال به حالت inactive رفت این Application دیگر به گرفتن عدد ادامه ندهد و کاراکتر n به این معنا است که اگر کانال به حالت inactive رفت Read کار خود را ادامه دهد.
پارامتر بعدی به نام attemps است که نمایانگر تعداد دفعات تلاش برای گرفتن عدد است و البته به پارامتر بعدی یعنی timeout بستگی دارد، به طور مثال ما timeout را ۲۰ ثانیه قرار میدهیم و attemts را عدد ۲ و این به این معنا است که اگر تماس گیرنده در این ۲۰ ثانیه عددی وارد نکرد Read 2 بار دیگر این عمل را تکرار کند.
$1v نکته: اگر پارامتری را نمی خواهید پر کنید در حالی که پارامتر بعدی را نیاز دارید می بایست جای پارامتر خالی را حتما قرار دهید مثال زیر را ببینید.
exten => 123,1,Read(NUMBER,,,3,10)
مثال:
خواندن یک عدد از نماس گیرنده و بیان آن عدد
exten=>123,1,Read(Digits,enter-ext-of-person)
exten=>123,n,Playback(en/you-entered)
exten=>123,n,SayNumber(${Digits})
مثال:
خواندن حداکثر ۴ عدد از ورودی در مدت ۱۰ ثانیه و با امکان ۳ بار تکرار در صورت دریافت نکردن عددی از کاربر.
; Read a 4 digit number, allowing up to 3 attempts, and say this number back to the caller:
exten => 123,1,Read(NUMBER,,4,3,10)
exten => 123,n,SayNumber(${NUMBER})
exten => 123,n,Hangup()
