Changes

The mine action information collected and stored in {{IMSMANG }} is useless without the ability to find it and use it to make operational decisions. That’s why {{IMSMANG }} includes a robust data search mechanism that provides an easy-to-use, multilevel interface for building and running searches. As with other parts of IMSMANG, the search functionality is divided into a customisation mode, where information managers can prepare simple or complex searches, and an execution mode where data entry personnel can run prebuilt searches. This simplifies the user experience and ensures consistency of use by sharing identical searches with all users. The {{IMSMANG }} search function has three primary purposes:

• *to navigate to data• *to display data on the map• *to prepare data for reports and analysis

Information managers can customise IMSMANG The navigation and map display searches for each of these purposes are typically designed to meet the specific needs find a single record or a set of the programmerecords. Particularly, customizing These searches are generally simpler than the search functionality other kinds of searches and are designed to facilitate access return records that users can browse through to programme find the necessary data and reporting is a key component of implementing and managing a programme’s information workflow.

Table 14The reporting searches are typically more complicated than navigation searches since they are intended to return a set of records to populate a report directly without any additional user interaction. Options These searches can also be saved and run independently of reports and used for Using Searchesbrowsing data.

Option Use or purpose Example criteria Example parametersNavigation Data quality analysis searches help identify possible data problems and map displayensure that mine action programme-specific workflow steps are being followed. These searches can be used to help protect data integrity.

These searches are typically designed In {{IMSMANG}} we refer to find a single record or a set different types of records. These searches are generally simpler functionality in the Search menu:*'''simple''' as in only one filter option may be used*'''advanced''' as in more than the other kinds of searches one filter option may be used and are designed complex critera using AND / OR is possible to return records that users can browse through to find the necessary data.define Search *'''saved''' searches which are prepared by information managers for items usage by a specific ID Find all hazards with a local ID that includes = “MF-001” Set the local ID as a parameter to be supplied when the search is runusers.

Search for items Saved searches simplifies the user experience and ensures consistency of use by type Find sharing identical searches with all users. Of course all hazards with users have the ability to save searches which is a mine action are type = “Minefield” Mine Action Area Type Search for items by date Find all hazard reductions between January 1 and February 1 The date rangeReporting and data quality analysisconvenient way to re-use favourite searches.

Reporting searches are typically more complicated than navigation Particularly, creating saved searches since they are intended facilitates access to return programme data. Reporting is a set key component of records to populate implementing and managing a report directly without any additional user interaction. These searches can also be saved and run independently of reports and used for browsing data. Data quality analysis searches help identify possible data problems and ensure that programme-specific mine action programme’s information workflow steps are being followed. These searches can be used to help protect data integrity. Report on clearance efforts Find all hazard reductions where the type = “Progress Report” and the status = “Completed” and the dates are between January 1 and February 1 The date range

Report on hazards cleared The {{IMSMANG}} version 6.0 database is pre-populated with saved searches developed by an organisation Find all hazards GICHD that are linked may be customised to hazard reductions whose type = “Clearance” and meet the specific needs of the organisation = “XYZ Org” Mine Action Area Type Search for all hazards with AP mines Find all active hazards with antipersonnel mines or that have clearances linked to them that have found antipersonnel mines - Data quality checks Find all hazards whose status is “Worked On” with no active hazard reductionsmine action programme.

Find all clearances that are not linked to a hazard Find all victims with no link to accident -==Building Simple Searches==__NOEDITSECTION__Building searches The simple search options in the Search menu function exactly as all other filters in {{IMSMANG is a simple three-step process in which information managers determine:}}, see [[Search Items]].

1. ==Advanced Searches==__NOEDITSECTION__The item to different types of search for2criteria (e.g. subobject and geo area) are described in [[Search by Subobject]] and [[Search by Map Area]], respectively. The attributes of the item possibility to use in AND / OR and to specify the search3parts makes the Advanced searches very flexible. Whether all of the criteria must be met (AND) or any of the criteria must be met (OR)

Following these three steps==Using Prompt==__NOEDITSECTION__When the prompt function is used in Advanced searches the re-usability and user-friendliness are greatly increased. For example, users can build searches as simple or as complex as if a user wants to find all progress reports submitted by the "XYZ" organisation and another user wants to have the same search but for the examples below:"ABC organisation, it is better to save one search and prompt on Organisation.

 find hazards with an ID of “MF-101”==SQL criteria==__NOEDITSECTION__ find victims who are children and were injured in 2010 find progress reports about work done by XYZ organization While the {{IMSMANG}} search functionality is extremely flexible allowing searches on hazards in Province ABC between 2008 CDFs, customised option list values and 2010 find all clearances completed on hazards with antipersonnel mineslinks among items, there are cases where users may want to run more complex searches that cannot be built using the Advanced search interface. For these cases, {{IMSMANG}} includes a special SQL search criteria that allows information managers to use a SQL query as filter criteria.

When a search is designed, it can be given a name and description and then saved for later use. Saving a search saves the Creating searches using SQL criteria of the search rather than the search results. This means that searches are automatically updated when additional data is added to the system, ensuring that searches return the most up-to-date data. For example, an information manager can build requires a search called “Open Hazards” that finds 25 hazards with a status detailed understanding of “Open.” If 10 additional hazards are entered into PostgreSQL's SQL syntax and the system with a status of “Open,” the search would find 35 records when it is run again. In this way, searches are dynamically updated as data is added to the system, allowing information managers to assess {{IMSMANG}} data trends over time using consistent search criteriamodel. Your [[Information managers can also use an existing search as a template to create other searches by using Management Team | GICHD IM Advisor]] may support you in developing the “Save as” functionalitySQL.

==Using Search Parameters==Search parameters allow users to change one or more search To use SQL criteria when running a search. For example, if a user wants to find all progress reports submitted by “XYZ” organisation, they can build simply provide a search for “XYZ progress reports.” If another user wants to search for progress reports submitted by “ABC” organisation, they can build another search for “ABC Progress Reports.” Alternatively, an information manager can build one search with a parameter for “Organisation” that allows users to provide different values for the organisation when running the search. This makes one search, for example, “Progress Reports by Organisation,” available for multiple purposes. The ability to build dynamic searches allows information managers to customise search capabilities to meet valid SQL statement in the needs of various stakeholders within their programmes.following format:

{{note|Searches can include geospatial data as a parameter which allows users to define a geospatial extent to search withinSELECT [item_guid] FROM [item_table] WHERE... For the purposes of searching, records without geospatial data are defined as “outside” the geospatial extent}}

==Building Complex Searches==While the IMSMANG search functionality is extremely robust—allowing searches on CDFs, customised option list values The SQL query may be complex with left joins and links among items— there are some cases where users subqueries but may want to run more complex searches that cannot only have '''one''' output column which should be built using the standard search interfaceitem_guid of the Search target i. For these cases, IMSMANG includes a special Structured Query Language (SQL) e if your search functionality that allows information managers to provide SQL syntax for executing searches. Creating searches using SQL criteria requires a detailed understanding of relational databases, SQL and the IMSMANG data model and target is Land then only output column should only be undertaken by advanced usershazard_guid.

To use {{note| We strongly recommended to develop and test the SQL query with a SQL tool before pasting it into the SQL criteria, simply since {{IMSMANG}} does not provide a valid SQL statement in the following format:debugging support. }}

SELECT [item_guid] FROM [item_table] WHERE==Saved Searches==__NOEDITSECTION__Saving a search saves the criteria of the search rather than the search results.This means that searches are automatically updated when additional data is added to the system, ensuring that searches are returning results using the updated data..For example, SELECT hazreduc_guid FROM hazreduc WHERE hazreduc_localID =’ÇL-001’

Using SQL criteria, information managers can design complicated ==Inspiration Saved Searches==__NOEDITSECTION__{{IMSMANG}} version 6.0 database is pre-populated with 40 different data quality Saved searches of different kinds:* suspected duplicates** e.g "Victim Duplicate Name & Date Of Birth"* items without any geographical data** e.g. "Accident Without Geodata"* items that can then be saved and run by users with no understanding of SQLdo not have any links to other items** e.g. "Assistance Without Links To Victim"* items which are assigned to different locations** e.g. "Land & Activity Not Same Location"* task as Search target** e.g. "Land Included In this way, IMSMANG unleashes the full power of SQL criteria, joins and subqueries in an easy-More Than One Task"* possible mine action process quality issues** e.g. "Status Open with links to-run interface.Activity or QM"

{{note|* It is recommended that information managers test their SQL in an external SQL editor prior These Saved searches should be seen as '''inspiration''' and should be adapted to using it within IMSMANG since IMSMANG does not provide SQL debugging supporteach mine action programme's processes.* Information managers can build complicated queries using SQL and combine them with other criteria, including parameters, to provide virtually unlimited search capabilities to IMSMANG users}}