{"id":4878,"date":"2012-10-11T14:56:20","date_gmt":"2012-10-11T19:56:20","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=4878"},"modified":"2023-04-13T14:34:12","modified_gmt":"2023-04-13T19:34:12","slug":"advanced-search-options","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/advanced-search-options","title":{"rendered":"Advanced Search Options"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\"><em>Click <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/m-painter-app-prop\/advanced-search-options\">here<\/a> to access legacy documentation for this feature<\/em><\/p>\n\n\n\n<p>The following documentation and video describes the different options developers have when working with templates that support out-of-the-box ad-hoc filtering\/searching options for the end-user. <\/p>\n\n\n\n<p>These templates that support this feature include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Multiple Row Data List (Retrieval)<\/li>\n\n\n\n<li>Data List with Web Form (Maintainer)<\/li>\n\n\n\n<li>Grid Update (Maintainer)<\/li>\n<\/ul>\n\n\n\n<p>A video walkthrough of this feature is shown below. <\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe title=\"Filtering Options in Web Based Applications\" width=\"643\" height=\"362\" src=\"https:\/\/www.youtube.com\/embed\/WI8_Fyn-fOo?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Implementation<\/h2>\n\n\n\n<p>Edit the application and navigate to Additional Options -> Template Properties:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/compileoptions8.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<p>Here the options for the Advanced Search feature will be shown:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/compileoptions3.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<p>Choose the appropriate radio button to select the desired option and press Save Template Properties.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">If changing to a new option, an application rebuild must be performed, along with an overwrite of the HTML presentation .<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Filter Options<\/h2>\n\n\n\n<p>The three presented filter options, as shown above, are explained in depth below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced Search Row<\/h3>\n\n\n\n<p>The Advanced Search Row option adds search\/filter inputs directly atop each of the application\u2019s columns. For larger applications with many fields (columns), this option is likely not as ideal if users will need to filter on many columns that may be initially off-screen.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/compileoptions4.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<p>A closer look:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/compileoptions6.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced Search Dialog (Selections Dialog window)<\/h3>\n\n\n\n<p>Most m-Power users are familiar with the selections dialog window in m-Power, as this is the default Advanced Search option selected in new applications. <\/p>\n\n\n\n<p>The selections dialog option will open up a window on top of the current application screen containing a list of search\/filter inputs for each field in the application. Selecting the \u2018Selections\u2019 button as shown below opens up the selections dialog window:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/compileoptions1.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/compileoptions2.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Display Filters Above Table<\/h3>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">This option is only available within <a href=\"\/docs\/knowledge-base\/bootstrap-key-features\" data-type=\"URL\" data-id=\"\/docs\/knowledge-base\/bootstrap-key-features\" target=\"_blank\" rel=\"noreferrer noopener\">Bootstrap<\/a> themed dictionaries.<\/p>\n\n\n\n<p>When selected, this option will display the search\/filter inputs in an expandable section directly above the application data table. Pressing the \u2018Selections\u2019 button serves to expand or collapse the section from view. <\/p>\n\n\n\n<p>As this option takes up some of the available screen real estate directly by \u2018pushing down\u2019 the application table, this option is also recommended in applications with less rather than more filters to display. Compared to the other Advanced Search options, this option scales well with applications that will be consumed on mobile and tablet devices. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/compileoptions5.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Additional Configurations<\/h2>\n\n\n\n<p>Depending on the Advanced Search option chosen, there are additional configurations that may be applied, as described below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Showing\/Hiding Filters<\/h3>\n\n\n\n<p>Out of the box, all the filters will show at runtime. During the application build, a developer may hide a field&#8217;s filter from showing from Field Settings -><strong> <\/strong>Filter and sorting attributes. <\/p>\n\n\n\n<p>Under the &#8220;Hide Filter?&#8221; column will be checkboxes that can be toggled for any field filters that a developer wants to hide from the end-user: <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/compileoptions9.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<p>It&#8217;s worth noting that this will only hide the field&#8217;s filter, and not the actual data column at runtime.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">If a field&#8217;s <strong>Display<\/strong> option is set to &#8216;Hide&#8217; in Field Settings, then the filter will also be automatically be hidden at runtime, regardless of if the <strong>Hide Filter?<\/strong> checkbox is checked.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Display Top Filters on Page Load<\/h3>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">This setting is only applicable to <strong><a href=\"#display-filters-above-table\" data-type=\"internal\" data-id=\"#display-filters-above-table\">Display Filters Above Table<\/a><\/strong> option.<\/p>\n\n\n\n<p>In Edit Properties -> Program Options, the Display Top Filters on Page load property allows a developer to set whether or not the top filters will be hidden on page load (the default setting) or if the should automatically show to the end-user when the application is first accessed.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/compileoptions10.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Form Layout <\/h3>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">This setting is only applicable to <strong><a href=\"#display-filters-above-table\" data-type=\"internal\" data-id=\"#display-filters-above-table\">Display Filters Above Table<\/a><\/strong> option.<\/p>\n\n\n\n<p>In order to change the layout of the presented filters, such as putting multiple filters on the same row, the m-Painter&#8217;s <a rel=\"noreferrer noopener\" href=\"\/docs\/knowledge-base\/form-layout\" target=\"_blank\">Form Layout tool<\/a> can be utilized to reorganize, add, or remove the filters to one&#8217;s liking. <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview The following documentation and video describes the different options developers have when working with templates that support out-of-the-box ad-hoc filtering\/searching options for the end-user. These templates that support this feature include: A video walkthrough of this feature is shown below. Implementation Edit the application and navigate to Additional Options&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[255],"ht-kb-tag":[300,299],"class_list":["post-4878","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mpainter","ht_kb_tag-filter","ht_kb_tag-search"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/4878","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=4878"}],"version-history":[{"count":34,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/4878\/revisions"}],"predecessor-version":[{"id":12557,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/4878\/revisions\/12557"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=4878"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=4878"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=4878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}