{"id":4612,"date":"2012-05-16T11:31:01","date_gmt":"2012-05-16T16:31:01","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=4612"},"modified":"2023-12-06T16:07:53","modified_gmt":"2023-12-06T22:07:53","slug":"m-painter-faq","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/m-painter-faq","title":{"rendered":"m-Painter FAQ"},"content":{"rendered":"\n

Click here <\/a>to review the legacy version of this documentation.<\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

This document aims to provide developers a list of common questions and subsequent answers to various topics relating to using m-Power’s m-Painter editor. You may scroll through the questions in this document, or click on the navigation menu on the right of this document to jump to a particular question. <\/p>\n\n\n\n

How do I use m-Painter to\u2026?<\/h2>\n\n\n\n

<\/a>Apply a Smartlink to a field<\/strong><\/h3>\n\n\n\n
    \n
  1. Click the field\/image\/icon\/text etc. that you wish to apply the Smartlink.<\/li>\n\n\n\n
  2. Select the “Insert Smartlink” button in the element panel.<\/li>\n\n\n\n
  3. Choose m-Power Application, pick the desired application, then map the linking fields.<\/li>\n\n\n\n
  4. Press Next to go to Link Options.<\/li>\n\n\n\n
  5. Click Save.<\/li>\n<\/ol>\n\n\n\n

    <\/a>Specify that a link should open in a new window?<\/strong><\/h3>\n\n\n\n
      \n
    1. Click the element containing the link.<\/li>\n\n\n\n
    2. Click the “Edit Smartlink” button in the element panel.<\/li>\n\n\n\n
    3. Press Next to go to Link Options.<\/li>\n\n\n\n
    4. Within the “Link Target” dropdown, choose “New Window\/Tab”<\/li>\n\n\n\n
    5. Click Save.<\/li>\n<\/ol>\n\n\n\n

      <\/a>Change the text on a button?<\/strong><\/h3>\n\n\n\n
        \n
      1. Left-click inside the button where the text is.<\/li>\n\n\n\n
      2. Use the Backspace key to remove the text.<\/li>\n\n\n\n
      3. Type your desired text.<\/li>\n\n\n\n
      4. Click Save.<\/li>\n<\/ol>\n\n\n\n

        <\/a>Stop a Column\/Row\/Table From Displaying in a Report?<\/strong><\/h3>\n\n\n\n

        Column<\/strong><\/h4>\n\n\n\n
          \n
        1. Select one of the cells in the column and click.<\/li>\n\n\n\n
        2. In the blue menu that appears, press the trash can.<\/li>\n\n\n\n
        3. Click Save.<\/li>\n<\/ol>\n\n\n\n

          Row<\/strong><\/h4>\n\n\n\n
            \n
          1. Select one of the cells in the row and click.<\/li>\n\n\n\n
          2. Press the up icon within the blue menu. This action will select the cell’s parent: the table row element.<\/li>\n\n\n\n
          3. Press the “Hide Element” button in the element panel on the right side of the screen.<\/li>\n\n\n\n
          4. Click Save<\/li>\n<\/ol>\n\n\n\n

            Hiding the row will still show the row in m-Painter, however at runtime, the row will not be present.<\/p>\n\n\n\n

            Table<\/strong><\/h4>\n\n\n\n
              \n
            1. Select one of the cells in the table and click.<\/li>\n\n\n\n
            2. Within the right side element panel, click the “Select Data Table” button.<\/li>\n\n\n\n
            3. Press the “Hide Element” button in the element panel on the right side of the screen.<\/li>\n\n\n\n
            4. Click Save.<\/li>\n<\/ol>\n\n\n\n

              Hiding the table will still show the table in m-Painter, however at runtime, the table will not be present.<\/p>\n\n\n\n

              <\/a>Make an input field required?<\/strong><\/h3>\n\n\n\n
                \n
              1. Find the proper input field and click in the textbox.<\/li>\n\n\n\n
              2. Click the \u201cInput Properties\u201d button in the element panel.<\/li>\n\n\n\n
              3. Check the ‘Required’ box within the “Additional Input Options” section.<\/li>\n\n\n\n
              4. Press Save. <\/li>\n<\/ol>\n\n\n\n

                Make a dropdown list required?<\/strong><\/h3>\n\n\n\n
                  \n
                1. Find the proper dropdown list and left-click inside the dropdown.<\/li>\n\n\n\n
                2. Click “List” in the m-Painter toolbar.<\/li>\n\n\n\n
                3. Remove the value for “Blank Option Text”<\/li>\n\n\n\n
                4. Press Ok.<\/li>\n<\/ol>\n\n\n\n

                  Making a dropdown list required via this method is not supported for dropdowns that are utilizing ‘Is in the List’ relationships. <\/p>\n\n\n\n

                  <\/a>Increase the number of records allowed in a report?<\/strong><\/h3>\n\n\n\n
                    \n
                  1. Open \u201cEdit Properties\u201d.<\/li>\n\n\n\n
                  2. Navigate to the \u201cOptions\u201d tab (shown by default), and search for the \u201cmax_records\u201d and \u201cmax_web_records\u201d values.<\/li>\n\n\n\n
                  3. Modify these values up or down to your desired upper limits.<\/li>\n\n\n\n
                  4. Click OK.<\/li>\n<\/ol>\n\n\n\n

                    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\n\n\n

                    Note:<\/strong> There is no \u201cNo Limit\u201d setting for your protection.<\/p>\n\n\n\n

                    <\/a>Compiling<\/h2>\n\n\n\n

                    After an application is first created, a compile is necessary to create the proper output files, such as the HTML presentation layer(s), the app properties XML file, and the Java and Class files which control the actual data portion of the application. Compiling an application, (also interchangeably referred to as “building”) is accomplished by pressing the ‘Build App<\/em>‘ button as show in the following image.<\/p>\n\n\n\n

                    If you are unsure if an application has been compiled, open the Application Specification for the application, and check the ‘Run App’<\/em> button. If is grayed out, this application has not been compiled yet and will show the following message when clicked:<\/p>\n\n\n\n

                     <\/td><\/td><\/tr><\/tbody><\/table>
                    The message shown here under the ‘Run App’ button will display when the application has not been compiled.<\/figcaption><\/figure>\n\n\n\n

                    <\/a>When to recompile<\/strong>?<\/h3>\n\n\n\n

                    Once the application has been initially compiled, only then can the look and feel of the application’s presentation (HTML) layer can be customized via m-Painter. “Edit UI (m-Painter)” is within the 3. Customize<\/em> option of the Application Navigation Bar.<\/p>\n\n\n\n

                    \"\"\/
                    The Application Navigation Bar for an application, outlined in red.<\/figcaption><\/figure>\n\n\n\n

                    As a whole, only when a change to the application is made in the  <\/em>1. Data Model<\/em> or 2. Additional Option<\/em>s options of the Application Navigation Bar, a recompile of the application is needed.<\/p>\n\n\n\n

                    Changes made to any specifications in <\/em>1. Data Model<\/em> or 2. Additional Options<\/em> require a recompile.<\/p>\n\n\n\n

                    Recompile after painting in m-Painter?<\/strong><\/h3>\n\n\n\n

                    No. m-Painter changes require you to just press the Save button within the m-Painter editor. This is concept is also true for app property changes in Edit Properties, you only need to save your changes. <\/p>\n\n\n\n

                    Once the change is saved, simply re-run the application to see the change. <\/p>\n\n\n\n

                    \"\"
                    m-Painter and Edit Properties, shown inside the 3. Customize<\/em> option.<\/figcaption><\/figure>\n\n\n\n

                    Changes made to either 3. Customize<\/em> options, ‘Edit UI (m-Painter)’ and ‘Edit Properties’ only need to be saved. <\/p>\n\n\n\n

                    <\/a>When to overwrite the HTML?<\/strong><\/h3>\n\n\n\n

                    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\n\n\n

                    \"\"\/<\/figure>\n\n\n\n

                    This screen is shown whenever someone tries to recompile an application that already exists (therefore, you will NOT see this screen when initially compiling a brand new application). 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 (m-Painter).<\/p>\n\n\n\n

                    When recompiling your application, with the “Overwrite existing HTML?” flag set to \u201cYes\u201d, this will erase all the changes you have made to your application through m-Painter. <\/p>\n\n\n\n


                    Ideally should make all the necessary changes within <\/em>1. Data Model<\/em> or 2. Additional Option<\/em>s first, and compile. Then save any customizations and changes in m-Painter 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 during a recompile.<\/p>\n\n\n\n

                    If you make changes that will not affect the general structure and look of your application, you can specify \u201cNo\u201d for this option. Here’s some examples of some changes this would pertain to:<\/p>\n\n\n\n