{"id":4606,"date":"2012-05-16T10:57:33","date_gmt":"2012-05-16T15:57:33","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=4606"},"modified":"2023-12-06T16:14:57","modified_gmt":"2023-12-06T22:14:57","slug":"working-with-links","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/working-with-links","title":{"rendered":"Working With Links"},"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\/working-with-links\">here<\/a> to view the legacy documentation for this feature.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Overview<\/h3>\n\n\n\n<p>No matter what type of application or report you are building, it is safe to say that you probably want to allow users to link between two applications. Thankfully, m-Painter makes this process a breeze!<\/p>\n\n\n\n<p>To begin, open m-Painter and click on the element you wish to be made into a link. From there, click the &#8220;Insert Smartlink&#8221; button within the right side Element panel.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:100%\">\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink1.png\" alt=\"\"\/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<p>Doing so will take you through a wizard approach that guides you through the process of creating your link.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Choosing a Link Type<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink2.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Your first decision will be to choose which type of link you want to utilize. <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>m-Power Application &#8212; This is the most common choice. This will let you link to another m-Power application. You will be able to select from any application already built, including ones in a different data dictionary.<\/li>\n\n\n\n<li>Custom URL &#8212; Choose this option if you wish to link to something other than an m-Power application. <\/li>\n\n\n\n<li>Return Data Link &#8212; In the event you are creating the retrieval portion of a Return Data feature, this option creates the link that users would click to &#8220;Return Data&#8221; back to the parent form. More information about the Return Data feature can be found <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/create-lookup-window-in-m-painter\">here<\/a>.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Configuring your URL<\/h3>\n\n\n\n<p>After selecting your link type, you are then brought to a link configuration screen. <\/p>\n\n\n\n<h4 class=\"wp-block-heading\">m-Power Application<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink3.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>While you can manually enter additional URL parameters, the large text area can usually be ignored. However, pay close attention to the &#8220;Map fields from the parent application&#8221; section as this is where you will set the parameters that will be passed between the two applications. Pick the matching fields. Then press the green &#8220;Next: Link Options&#8221; button.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Custom URL<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink4.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Since you are not, in this case, linking to an m-Power application, this option is much more basic. Simply type in the URL you want the user to be directed to. Optionally, you can append a single value to the end of the URL via the dropdown box.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Choosing Link Options<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink5.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>This final screen allows you to control how your link looks and behaves. By default, your link will be a traditional link but you can change the link style to button. Doing so, you have further control to select the color of the button.<\/p>\n\n\n\n<p>Via the Link Target dropdown, you have additional choices to control where the link should option, including:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Default Hyperlink &#8212; This is the traditional link. When a user clicks on it, the new page will replace the old one in their browser.<\/li>\n\n\n\n<li>New Window\/Tab &#8212; As the name suggests, clicking on this link will spawn a new tab rather than replacing the contents of the current one.<\/li>\n\n\n\n<li>Mouseover Window &#8212; When a user hovers their mouse over this link, the linked application will appear in a small window. As soon as the user moves their mouse off of the link, the linked application will disappear.<\/li>\n\n\n\n<li>Popup Dialog &#8212; Clicking on this will open the linked application in a modal window, greying out the parent application behind. Once a user closes the modal, the parent will be fully visible. You have the option to name this modal window as well as control its size. <\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Maintainer Specific Link Options<\/h4>\n\n\n\n<p>Working with Smartlinks in Maintainers offers additional options with regard to the Popup Dialog<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/smartlink6.png\" alt=\"\"\/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Do Nothing &#8212; The dialog window will remain open<\/li>\n\n\n\n<li>Refresh Page &#8212; The dialog window will close and the underlying page will be refreshed.<\/li>\n\n\n\n<li>Close Dialog &#8212; The dialog window will be closed but the underlying page will not reload.<\/li>\n\n\n\n<li>Redirect &#8212; Specifying this option will cause the underlying parent page to be redirected to the URL of your choosing.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Overview No matter what type of application or report you are building, it is safe to say that you probably want to allow users to link between two applications. Thankfully, m-Painter makes this process a breeze! To begin, open m-Painter and click on the element you wish to be made&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"open","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[255],"ht-kb-tag":[],"class_list":["post-4606","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\/4606","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=4606"}],"version-history":[{"count":66,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/4606\/revisions"}],"predecessor-version":[{"id":13902,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/4606\/revisions\/13902"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=4606"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=4606"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=4606"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}