<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_Directory">Asterisk 11 Application_Directory</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="Asterisk11Application_Directory-Directory%28%29"></a>Directory()</h1>
<h3><a name="Asterisk11Application_Directory-Synopsis"></a>Synopsis</h3>
<p>Provide directory of voicemail extensions.</p>
<h3><a name="Asterisk11Application_Directory-Description"></a>Description</h3>
<p>This application will present the calling channel with a directory of extensions from which they can search by name. The list of names and corresponding extensions is retrieved from the voicemail configuration file, <tt>voicemail.conf</tt>.</p>
<p>This application will immediately exit if one of the following DTMF digits are received and the extension to jump to exists:</p>
<p>0 - Jump to the 'o' extension, if it exists.</p>
<ul>
<li>- Jump to the 'a' extension, if it exists.</li>
</ul>
<h3><a name="Asterisk11Application_Directory-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Directory(vm-context[,dial-context[,options]])</pre>
</div></div>
<h5><a name="Asterisk11Application_Directory-Arguments"></a>Arguments</h5>
<ul>
<li>vm-context - This is the context within voicemail.conf to use for the Directory. If not specified and <tt>searchcontexts=no</tt> in <tt>voicemail.conf</tt>, then <tt>default</tt> will be assumed.</li>
<li>dial-context - This is the dialplan context to use when looking for an extension that the user has selected, or when jumping to the <tt>o</tt> or <tt>a</tt> extension. If not specified, the current context will be used.</li>
<li>options
<ul>
<li>e - In addition to the name, also read the extension number to the caller before presenting dialing options.</li>
<li>f - Allow the caller to enter the first name of a user in the directory instead of using the last name. If specified, the optional number argument will be used for the number of characters the user should enter.
<ul>
<li>n</li>
</ul>
</li>
<li>l - Allow the caller to enter the last name of a user in the directory. This is the default. If specified, the optional number argument will be used for the number of characters the user should enter.
<ul>
<li>n</li>
</ul>
</li>
<li>b - Allow the caller to enter either the first or the last name of a user in the directory. If specified, the optional number argument will be used for the number of characters the user should enter.
<ul>
<li>n</li>
</ul>
</li>
<li>m - Instead of reading each name sequentially and asking for confirmation, create a menu of up to 8 names.</li>
<li>n - Read digits even if the channel is not answered.</li>
<li>p - Pause for n milliseconds after the digits are typed. This is helpful for people with cellphones, who are not holding the receiver to their ear while entering DTMF.
<ul>
<li>n
<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>Note</b><br />Only one of the <em>f</em>, <em>l</em>, or <em>b</em> options may be specified. <b>If more than one is specified</b>, then Directory will act as if <em>b</em> was specified. The number of characters for the user to type defaults to <tt>3</tt>.</td></tr></table></div></li>
</ul>
</li>
</ul>
</li>
</ul>
<h3><a name="Asterisk11Application_Directory-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk Version SVN-trunk-r370322</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_Directory">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_Directory?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>