View source for Restricting the locations included in an InfoEx report

__NOTOC__
{{Requirements|UserLevel=All user levels|Connectivity=Online only}}

This document described how you can restrict the spatial extent of your InfoEx report by specifying what locations to include and how to clear the selection again.

==Background==
The application offers four possibilities for restricting the locations included in an InfoEx report:
# Selecting the operations to be included
# Specifying the mountain ranges to be included
# Specifying the CAC forecast regions 
# Drawing a custom polygon

{{Note|Please note that the four ways of specifying the locations are mutually exclusive and cannot be combined. In other words you cannot create a report that includes a number of operations <u>and</u> a mountain range. You can only create reports that either contain the observations of a number of operations or within an mountain range.}}

==Step-by-step description==

===Creating a location filter===

{|class="TblSteps"
|-
|class="StepNum" | 1.
|[[File:ReportTabularView.png|300px|thumb|right|Fig. 1: Overview of tabular report view]] Click into the empty text box under the 'Location' label of the report view (Fig. 1). 
|-
|class="StepNum" | 2.
|[[File:ReportTabularViewLocationFilterOperationBlank.png|300px|thumb|right|Fig. 2: Location filter popup window]] This will open a popup window called 'Location Filter' with four tabs across the top (Fig. 2).
|-
|class="StepNum" | 3.
|Use one of the following methods for specifying the locations you would like to be included in your report.
|-
|class="StepNum" |
|[[File:ReportTabularViewLocationFilterOperationFilled.png|300px|thumb|right|Fig. 3: Location filter popup window with operation selection]] '''By operations''':
* Click on the {{ButtonGrey|Operation}} tab at the top of the popup window.
* Click into the empty text box and start typing the name of the operation you would like to be included in your report. The dropdown list will automatically list the operations what match with what you type.
* Include as many operations in your report as you like (Fig. 3).
* Click on {{ButtonGrey|Ok}} to submit your selection.
|-
|class="StepNum" |
|[[File:ReportTabularViewLocationFilterMtnRangeFilled.png|300px|thumb|right|Fig. 4: Location filter popup window with mountain range selection]] '''By mountain range''':
* Click on the {{ButtonGrey|Mountain Range}} tab at the top of the popup window.
* Click into the empty text box and start typing the name of the mountain range you would like to be included in your report. The dropdown list will automatically list the mountain ranges what match with what you type.
* Include as many mountain ranges in your report as you like (Fig. 4).
* Click on {{ButtonGrey|Ok}} to submit your selection.
|-
|class="StepNum" |
|[[File:ReportTabularViewLocationFilterForecastAreaFilled.png|300px|thumb|right|Fig. 5: Location filter popup window with forecast area selection]] '''By forecast area''':
* Click on the {{ButtonGrey|Forecast Area}} tab at the top of the popup window.
* Click into the empty text box and start typing the name of the forecast area you would like to be included in your report. The dropdown list will automatically list the forecast areas what match with what you type.
* Include as many forecast areas in your report as you like (Fig. 5).
* Click on {{ButtonGrey|Ok}} to submit your selection.
{{Note|The CAC forecast areas have not been imported into the system yet.|NoteWithImage}}
|-
|class="StepNum" |
|[[File:ReportTabularViewLocationFilterMapFilled.png|300px|thumb|right|Fig. 6: Location filter popup window with map selection]] '''By custom polygon''':
* Click on the {{ButtonGrey|Map}} tab at the top of the popup window.
* Wait for the Google Earth map to load.
* Navigate to the general location that want to include in your report.
* Click on {{ButtonGrey|Create Polygon}} to create a generic square in the middle of the map.
* Change the shape of the generic square by clicking on the corners and dragging them to the desired location
* Add additional corners to your polygon by clicking on the faint points between corners and dragging them to the desired location.
* Modify the custom polygon until you have the shape you like (Fig. 6).
* Click on {{ButtonGrey|Ok}} to submit your selection.
|-
|class="StepNum" | 4.
|[[File:ReportTabularViewLocationWithLocFilter.png|300px|thumb|right|Fig. 7: InfoEx report with location filter active.]] Wait until the application as retrieved the data for with the new location filter from the server and displays it in the current view. The locations included in your report are now listed in the location field at the top of the InfoEx report (Fig. 7).
|}

===Clearing a location filter===

{|class="TblSteps"
|-
|class="StepNum" | 1.
|[[File:ReportTabularViewLocationWithLocFilter.png|300px|thumb|right|Fig. 8: InfoEx report with location filter active.]] Click into the filled text box under the 'Location' label of the report view (Fig. 8). 
|-
|class="StepNum" | 2.
|[[File:ReportTabularViewLocationFilterOperationFilled.png|300px|thumb|right|Fig. 9: Location filter popup window with filter information]] This will open a popup window called 'Location Filter' with four tabs across the top and the information of the current location filter (Fig. 9).
|-
|class="StepNum" | 3.
|Click on {{ButtonGrey|Clear}} at the bottom of the popup window. This will erase the filter information and close the popup window. 
|-
|class="StepNum" | 4.
|[[File:ReportTabularView.png|300px|thumb|right|Fig. 10: Overview of tabular report view]] Wait until the application has retrieved the data from the server and displays it in the current view. The locations field at the top of the InfoEx report is now clear (Fig. 10).
{{Issue|While the location filter is properly clear from the report template, the location selection persist within the popup window.<br/>''Workaround'': Simply delete the location manually before specifying a new location filter.|IssueWithImage|962|Oct. 28, 2013}}
|}


==Related documents==
* Link to relate document 1
* Link to relate document 2

==Functionality tested by==
* Oct. 29: Pascal Haegeli / QA Server / Test Version 0.32.00

[[Category:Super User]][[Category:Operation Administrator]][[Category:Observation Moderator]][[Category:User]]
[[Category:Reports]][[Category:Software Issues]][[Category:Version 0.32.00]]