(public).sospep.events ~ view task ~ PAGE-find-locations

<h1 style="text-align: center;">find/ locations</h1>
<h2>[WHAT]&nbsp;</h2>
<ol>
<li>[def] this page displays a form with the input feilds for a&nbsp;'location' record and enables users to define and execute a search for&nbsp;location&nbsp;records&nbsp;based upon&nbsp;a variety of different query parameters.</li>
<li>[ args ] none</li>
<ol>
<li>]&nbsp;? OPTIONALLY take the sector,&nbsp;map&nbsp;and&nbsp;atlas names&nbsp;</li>
</ol></ol>
<div>
<h2>[WHY]</h2>
</div>
<ol>
<li>
<p>] this page enables the user to define and execute a&nbsp;number of different search queries to execute against&nbsp;the&nbsp;Places&nbsp;location records table. The query will return&nbsp;the desired&nbsp;'location' record or records that the user desires.</p>
</li>
</ol>
<h2>[WHERE page is called from ..]</h2>
<ol>
<li>] menu Main, search menu, option - 'search Places'</li>
</ol>
<h2>[WHEN]</h2>
<ol>
<li>]</li>
</ol>
<h2>[EXAMPLE]</h2>
<ol>
<li>]&nbsp;PAGE <a href="http://sospep.com/find/places" target="_blank">find /&nbsp;locations</a></li>
<ol>
<li>by id -</li>
<li>by name_location -</li>
<li>by description_location -</li>
<li>...</li>
</ol></ol>
<h2>[HOW-TO]</h2>
<ol>
<li>]</li>
</ol>
<h2>[REFERENCE]</h2>
<ol>
<li>] /find/ locations.cshtml</li>
<li>] find/locations <a href="task?id=2256" target="_blank">-v-001</a> -&nbsp;] qry&nbsp;'locations' by ... ]</li>
<li>] find/locations <a href="task?id=2257" target="_blank">-v-002</a> -&nbsp;] adds qrys for ... ] cleanup&nbsp;</li>
</ol><hr />
<h1 style="text-align: center;">developer implementation</h1>
<h2>[.process]</h2>
<ol>
<li><strong>set the qry value</strong></li>
<ol>
<li>to the name of desired qry</li>
</ol>
<li><strong>set the&nbsp;param value</strong>&nbsp;</li>
<ol>
<li>to the user selected param value</li>
</ol>
<li><strong>user submits the form == on post</strong></li>
<ol>
<li>read qry values,</li>
<li>read param values,</li>
<li>build qstring to pass values to page view/locations,</li>
<li>redirect to page view/locations</li>
</ol>
<li><strong>on page view/locations</strong></li>
<ol>
<li>get the qry name,</li>
<li>get the param value(s),</li>
<li>execute the qry(in the DAL&nbsp;helper)&nbsp;to return results to this page</li>
</ol></ol>
<h2>[.notes]</h2>
<ol>
<li>
<div>&nbsp; ] mainMenu - search options, search&nbsp;PLACES ? locations</div>
</li>
</ol>
<h2>[.by_date]</h2>
<h3>&nbsp;</h3>
<h1 style="text-align: center;">status</h1>
<h2>[current]</h2>
<ol>
<li>
<div>&nbsp;]</div>
</li>
</ol>
<h2>[next]</h2>
<ol>
<li>
<p>&nbsp;smarter selects - add on change events for selects (country, state) to narrow selection from all (states,cities) to just cities in selected state, states in selected country</p>
</li>
</ol>
<p>&nbsp;</p>

~ view task ~ TaskGroup] PAGES-sospep-places FROM [ Plan] doc-projects IN [ calendars] prj-022-sospep