{"id":8695,"date":"2017-09-11T15:47:06","date_gmt":"2017-09-11T20:47:06","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=8695"},"modified":"2023-12-06T14:46:46","modified_gmt":"2023-12-06T20:46:46","slug":"quick-lists","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/quick-lists","title":{"rendered":"Quicklists"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Click <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/m-painter-app-prop\/quick-lists\">here <\/a>to view the legacy documentation for this feature.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p>The Quicklists feature are reusable custom lists created by the developer. Specifically, each quicklist contains a list of key pairs (value\/description). <\/p>\n\n\n\n<p>They are static lists, meaning they are not tied to any specific database table. Quicklists can be used for the following purposes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Dropdown lists<\/li>\n\n\n\n<li>AJAX features<\/li>\n\n\n\n<li>Application lookups<\/li>\n\n\n\n<li>Key Pairs. <\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Video Walkthrough<\/h2>\n\n\n\n<p><iframe src=\"https:\/\/www.youtube.com\/embed\/YMdx0LLnX0s\" width=\"560\" height=\"315\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Quicklists &#8211; when to use them?<\/h2>\n\n\n\n<p>Quicklists are very handy and efficient when customizing your applications within m-Painter, as they allow you to make a list within the m-Painter editor of the current application, removing the need to detour in order to create additional applications.<\/p>\n\n\n\n<p>Quicklists are most useful to the developer when the list itself will contain a finite number of options.<\/p>\n\n\n\n<p> Lists such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Yes\/No (Y or N)<\/li>\n\n\n\n<li>Male\/Female (M or F)<\/li>\n\n\n\n<li>Month names and numbers (1,2,3&#8230;.12)<\/li>\n\n\n\n<li>Region (ex. Midwest, Rust Belt, South West, Pacific)<\/li>\n<\/ul>\n\n\n\n<p>are all excellent use case scenarios for making a quicklist. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Example \/ Implementation<\/h2>\n\n\n\n<p>In this example report, a handful orders from the past year may be seen.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><a href=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists1.jpg\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists1.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 1 &#8211; Running an m-Power report<\/figcaption><\/figure>\n<\/div>\n\n\n<p>With a runtime selection and dropdown list currently added in, the orders can be filtered conveniently by month. The list displays all possible values for month that may be selected at runtime (1,2,3\u202612). <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><a href=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists2.jpg\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists2.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 2 &#8211; A runtime value prompt filter with a dropdown list<\/figcaption><\/figure>\n<\/div>\n\n\n<p>While this list makes sense, being able to display these values as their month names rather than a number would be more readable to the end user. Creating a Quick List will be the easiest and quickest  to display month names in the dropdown list.<\/p>\n\n\n\n<p>In m-Painter, while editing the main page, and click on the input field for the month filter input and select Insert Option List, as shown in Figure 3.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><a href=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists4.jpg\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists4.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 3. Adding an Option List to a report filter from the m-Painter editor<\/figcaption><\/figure>\n<\/div>\n\n\n<p>In the following modal (Figure 4) select &#8220;Quicklist&#8221; as the type of list to make.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><a href=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists5.jpg\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/quicklists5.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 4. Selecting an Option List type<\/figcaption><\/figure>\n<\/div>\n\n\n<p>One the next screen (see Figure 5), a list of any previously created quick lists will be displayed for re-use, editing, or deletion.<\/p>\n\n\n\n<p>Otherwise, a new quicklist may be created via the blue &#8220;Create New Quicklist&#8221; button.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"\/docs\/vue-images\/quicklists6.jpg\"><img decoding=\"async\" src=\"\/docs\/vue-images\/quicklists6.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 5. Selecting a Quicklist from m-Painter<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">Quicklists can be utilized cross-dictionary; meaning a quicklist created in Dictionary A can be utilized in Dictionary B application (and vice versa).<\/p>\n\n\n\n<p>On the Configure Quicklist screen, simply provide a list name, description, and then begin entering in each list value for this new quicklist.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-danger\">Special characters are <strong>not <\/strong>allowed in the List Name.<\/p>\n\n\n\n<p>When entering values for the list, the &#8220;Option value&#8221; is the value that will be sent to the database, whereas the &#8220;Option text&#8221; is what is displayed in the dropdown to the user. Each option pair may be added by press &#8220;Add this option&#8221;, as shown in Figure 6.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"\/docs\/vue-images\/quicklists7.jpg\"><img decoding=\"async\" src=\"\/docs\/vue-images\/quicklists7.jpg\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 6. Configuring a Quicklist with appropriate values<\/figcaption><\/figure>\n\n\n\n<p>Once completed, press Save Quicklist. Simply select the created Quicklist on the next screen and proceed to the List Configuration screen.<\/p>\n\n\n\n<p>On the List Configuration screen (Figure 7), choose the List Style (Drop-down, combobox, radios, or buttons) and the if desired, put a blank option text value i.e. an &#8220;All&#8221; value. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/vue-images\/quicklists8.jpg\" alt=\"\"\/><figcaption class=\"wp-element-caption\">Figure 7: List configuration<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Leaving the blank option text value blank will <strong>require<\/strong> the user to make a selection from the dropdown.<\/p>\n\n\n\n<p>Once done, press &#8220;Save Option List&#8221;. Be sure to save the changes to the m-Painter editor before re-running the application. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Promoting Quick Lists<\/strong><\/h2>\n\n\n\n<p>Created quick lists are stored are in the <em>quick_lists.json<\/em> file within \/mrcjava\/WEB-INF\/classes\/DICTIONARY. To use created quick list(s) in production applications, please ensure to promote this &#8216;<em>quick_lists.json<\/em>&#8216; file over to this same directory in the production environment.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview The Quicklists feature are reusable custom lists created by the developer. Specifically, each quicklist contains a list of key pairs (value\/description). They are static lists, meaning they are not tied to any specific database table. Quicklists can be used for the following purposes: Video Walkthrough Quicklists &#8211; when to&#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":[],"class_list":["post-8695","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mpainter"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/8695","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=8695"}],"version-history":[{"count":54,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/8695\/revisions"}],"predecessor-version":[{"id":13880,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/8695\/revisions\/13880"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=8695"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=8695"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=8695"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}