{"id":4612,"date":"2012-05-16T11:31:01","date_gmt":"2012-05-16T16:31:01","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/legacy\/?page_id=4612"},"modified":"2023-12-06T16:06:12","modified_gmt":"2023-12-06T22:06:12","slug":"m-painter-faq","status":"publish","type":"page","link":"https:\/\/www.mrc-productivity.com\/legacy\/m-painter-app-prop\/m-painter-faq","title":{"rendered":"m-Painter FAQ"},"content":{"rendered":"<p><!-- Begin Content --><\/p>\n<h1>m-Painter Frequently Asked Questions<\/h1>\n<p><i>Click <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/m-painter-faq\">here<\/a> to access current documentation for this feature.<\/i><\/p>\n<ul style=\"list-style-type:none;\">\n<li><a href=\"#How\">How do I use m-Painter to\u2026<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Apply\">Apply a smartlink to a field?<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Open\">Open a link in a new window?<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Change\">Change the text on a submit button?<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Stop\">Stop a column\/row\/table from printing at runtime?<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Make\">Make an input field required?<\/a><\/li>\n<p><a href=\"#Make\"><br \/>\n<\/a><\/p>\n<li class=\"padleft\"><a href=\"#Make\"><\/a><a href=\"#Increase\">Increase the number of records allowed in a report?<\/a><\/li>\n<li><a href=\"#Compiling\">Compiling<\/a><\/li>\n<li class=\"padleft\"><a href=\"#Recompile\">When to recompile<\/a><\/li>\n<li class=\"padleft\"><a href=\"#OverwriteHTML\">When to overwrite the HTML<\/a><\/li>\n<li class=\"padleft\"><a href=\"#OverwriteXML\">When to overwrite the XML<\/a><\/li>\n<\/ul>\n<h3><a class=\"anchor\" name=\"How\">How do I use m-Painter to\u2026<\/a><\/h3>\n<p><strong><a class=\"anchor\" name=\"Apply\">Apply a Smartlink to a field?<\/a><\/strong><\/p>\n<ol>\n<li class=\"padleft\">Click the field or the image that you wish to apply the Smartlink.<\/li>\n<li class=\"padleft\">Click the Insert\/Edit Link button.<\/li>\n<li class=\"padleft\">Select the desired Smartlink from the Smartlink URL drop-down list.<\/li>\n<li class=\"padleft\">Click OK to assign that link to that element.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong><a class=\"anchor\" name=\"Open\">Specify that a link should open in a new window?<\/a><\/strong><\/p>\n<ol>\n<li class=\"padleft\">Click the element containing the link.<\/li>\n<li class=\"padleft\">Click the Insert\/Edit Link button.<\/li>\n<li class=\"padleft\">Click the Target tab.<\/li>\n<li class=\"padleft\">Select \u201c<popup window=\"\">\u201d in the Type\/Target drop-down list and set values like width, height, left, and top.<\/popup><\/li>\n<li class=\"padleft\">Click OK to update those parameters for that link.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong><a class=\"anchor\" name=\"Change\">Change the text on a Submit button?<\/a><\/strong><\/p>\n<ol>\n<li class=\"padleft\">Right-click on the Submit button.<\/li>\n<li class=\"padleft\">Select \u201cButton Properties\u201d.<\/li>\n<li class=\"padleft\">Change the text input and click OK.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong><a class=\"anchor\" name=\"Stop\">Stop a Column\/Row\/Table From Printing in a Report?<\/a><\/strong><\/p>\n<p><em>Column<\/em><\/p>\n<ol>\n<li class=\"padleft\">Select one of the cells in the column and right-click.<\/li>\n<li class=\"padleft\">Select \u201cColumn\u201d, and then click \u201cDelete Columns\u201d.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><em>Row<\/em><\/p>\n<ol>\n<li class=\"padleft\">Select one of the cells in the row and right-click.<\/li>\n<li class=\"padleft\">Select \u201cRow\u201d, and then click \u201cHide Row\u201d or \u201cDelete Row\u201d.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong>Note:<\/strong> Hiding the row will still show the row in m-Painter, however at runtime, the row will not be present.<\/p>\n<p><em>Table<\/em><\/p>\n<ol>\n<li class=\"padleft\">Select one of the cells in the table and right-click.<\/li>\n<li class=\"padleft\">Select \u201cTable\u201d, and then click \u201cHide Table\u201d or \u201cDelete Table\u201d.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong>Note:<\/strong> Hiding the table will still show the table in m-Painter, however at runtime the table will not be present.<\/p>\n<p><strong><a class=\"anchor\" name=\"Make\">Make an input field required?<\/a><\/strong><\/p>\n<ol>\n<li class=\"padleft\">Find the proper input field and right click on the textbox.<\/li>\n<li class=\"padleft\">Click \u201cMake Field Required\u201d.<\/li>\n<li class=\"padleft\">Click Save.<\/li>\n<\/ol>\n<p><strong>Note:<\/strong> The default error message \u201cThis field is required\u201d can be modified to read whatever is necessary for this application.<\/p>\n<p><strong><a class=\"anchor\" name=\"Increase\">Increase the number of records allowed in a report?<\/a><\/strong><\/p>\n<ol>\n<li class=\"padleft\">Open the \u201cApplication Properties\u201d.<\/li>\n<li class=\"padleft\">Navigate to the \u201cOptions\u201d tab (shown by default), and search for the \u201cmax_records\u201d and \u201cmax_web_records\u201d values.<\/li>\n<li class=\"padleft\">Modify these values up or down to your desired upper limits.<\/li>\n<li class=\"padleft\">Click OK.<\/li>\n<\/ol>\n<p><strong>Note:<\/strong> If the report is only run from batch, then only the \u201cmax_records\u201d needs to be modified. If the report is only being run interactively (from a browser), only the \u201cmax_web_records\u201d needs to be modified.  However, both may be modified to ensure the limit is properly set.<\/p>\n<p><strong>Note:<\/strong> There is no \u201cNo Limit\u201d setting for your protection.<\/p>\n<h3><a class=\"anchor\" name=\"Compiling\">Compiling<\/a><\/h3>\n<p><strong><a class=\"anchor\" name=\"Recompile\">When to recompile<\/a><\/strong><\/p>\n<p>After an application is first created, a compile is necessary to create the proper output files, such as the HTML presentation layer(s), the Application Properties XML file, and the Java and Class files which control the actual data portion of the application.<\/p>\n<p><strong>Note:<\/strong> If you are unsure if an application has been compiled, open the Application Menu for this application, and check the \u201cExecute\u201d, \u201cPresentation\u201d, and \u201cProperties\u201d buttons.  If they are grayed out, this application has not been compiled yet, as seen below:<\/p>\n<table>\n<tbody>\n<tr>\n<td>&nbsp;<\/td>\n<td><img decoding=\"async\" class=\"border\" src=\"\/legacy\/images\/mpainterfaq2.jpg\"><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Once the application has been compiled, the actual look and feel of the application can be modified in the Application Properties and in m-Painter.  However, there may be times when after compiling, an additional calculation is needed or a new field is added.  In these situations, when a change is made in the Application Menu, a recompile is needed to pull in the new data.<\/p>\n<p>A common question: <em>Is it necessary to recompile an application after I have painted it?<\/em><\/p>\n<p>Not at all. Think of it as if you were building a house. Compiling and building your application is the actual construction phase. Using m-Power would be equivalent to decorating the interior. In fact, you should, as a good rule of thumb, try to wait on using m-Painter until you have built your application just right. It is frustrating to use m-Painter to paint a perfect application, only to realize you are going to need to recompile and overwrite the existing HTML \u2014 only to start back over from scratch.<\/p>\n<p><strong>Note:<\/strong> Recompiling your application, with the overwrite html flag set to \u201cYes\u201d, will erase all the changes you have made to your document through m-Painter.<\/p>\n<p><strong><a class=\"anchor\" name=\"OverwriteHTML\">When to overwrite the HTML<\/a><\/strong><\/p>\n<p>When a user first begins to use the m-Power interface, one of the biggest questions they have is what to do when they come to this screen:<\/p>\n<p><img decoding=\"async\" class=\"border\" src=\"\/legacy\/images\/overwritehtmlxml1.jpg\"><\/p>\n<p>This screen is seen whenever someone tries to recompile an application that already exists. Our logic checks to see if generated code already exists on the server, and if it does, we check to see how you want to proceed. Of course, we will update the back-end Java code to ensure your latest changes within the Application Menu screens are included, but we need to check with you to see how to handle the HTML presentation files and the XML Application Property files.<br \/>\nIdeally, you make any necessary changes within Application Menu, compile, then save any m-Painter and HTML changes until last. However, since that rarely happens, the following is a non-inclusive check list of situations that would not require an overwrite of the HTML.<\/p>\n<p>If you make changes that will not affect the look of your application, you can specify \u201cNo\u201d for this option. This could include:<\/p>\n<ul>\n<li class=\"padleft\">Creating or modifying an Edit Code<\/li>\n<li class=\"padleft\">Changing the logic of a calculation<\/li>\n<li class=\"padleft\">Adding an External Object<\/li>\n<li class=\"padleft\">Changing the way an application joins<\/li>\n<\/ul>\n<p>However, there are some changes that do require you to specify \u201cYes\u201d for this option, which will overwrite the HTML layer and any changes you have made within m-Painter. This could include:<\/p>\n<ul>\n<li class=\"padleft\">Adding a new field and wanting it displayed to the screen<\/li>\n<li class=\"padleft\">Changing the column headings descriptions in Field Settings<\/li>\n<li class=\"padleft\">Reordering Fields<\/li>\n<li class=\"padleft\">Adding\/Deleting a prompted Record Selection<\/li>\n<li class=\"padleft\">Adding a Field in a Maintenance program<\/li>\n<li class=\"padleft\">Adding a Parameter calculation<\/li>\n<\/ul>\n<p>There is a very useful tip that can save countless hours regarding overwriting the HTML Skeleton. If you have spent a long time in m-Painter for an application, you probably don\u2019t want to overwrite the HTML. If you need to add a field, you can always add the field through the interface, but specify \u201cNo\u201d to not overwrite the HTML. Then, open m-Painter. You will not see your field, but you can still include it by using the \u201cField\u201d button in the toolbar:<\/p>\n<p><img decoding=\"async\" class=\"border\" src=\"\/legacy\/images\/overwritehtmlxml2.jpg\"><\/p>\n<p>Select the field you wish to include in the HTML and select the level. Even though you chose not to overwrite the HTML, the field is available to you because the back end Java code has been updated with this field\u2019s definition.  Additionally, if you need to Change column headings or reorder fields, you can do both of these things within m-Painter.<\/p>\n<p><strong><a class=\"anchor\" name=\"OverwriteXML\">When to overwrite the XML<\/a><\/strong><\/p>\n<p>This question specifically addresses the Application Property XML file. This file controls things such as:<\/p>\n<ul>\n<li class=\"padleft\">How many records to show on a page?<\/li>\n<li class=\"padleft\">Should Advanced Sort or Advanced Search be turned on?<\/li>\n<li class=\"padleft\">Should you do any case conversion within the SQL statement?<\/li>\n<li class=\"padleft\">Specify the maximum numbers allowed for a dropdown list?<\/li>\n<li class=\"padleft\">Should the Splash page be displayed for reports?<\/li>\n<li class=\"padleft\">Etc.<\/li>\n<\/ul>\n<p>There are only two times when this option must be set to \u201cYes\u201d:<\/p>\n<ul>\n<li class=\"padleft\">When you change Templates<\/li>\n<li class=\"padleft\">When you make a mistake and forget how to correct it. Setting this back to \u201cYes\u201d will return the Properties file to the default settings.<\/li>\n<\/ul>\n<p><strong>See also:<\/strong>  <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/general\/when-to-overwrite-html-xml-files\">When to Overwrite HTML\/XML Flowchart<\/a><\/p>\n<p><!-- End Content --><\/p>\n","protected":false},"excerpt":{"rendered":"<p>m-Painter Frequently Asked Questions Click here to access current documentation for this feature. How do I use m-Painter to\u2026 Apply a smartlink to a field? Open a link in a new window? Change the text on a submit button? Stop a column\/row\/table from printing at runtime? Make an input field required? Increase the number of [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1410,"menu_order":1,"comment_status":"closed","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-4612","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/4612","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/comments?post=4612"}],"version-history":[{"count":6,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/4612\/revisions"}],"predecessor-version":[{"id":7984,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/4612\/revisions\/7984"}],"up":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/pages\/1410"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/legacy\/wp-json\/wp\/v2\/media?parent=4612"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}