Working With Links

 

After highlighting text or clicking on a field substitution, you have the option of inserting a link. While there are many options for inserting links into your applications, this document will cover the Insert/Edit Link window and some of the things that can be done.

Basic Links

Link Info Tab

When you first click to add a link, the window shown above is what will be displayed. Under the Link Info tab, Link Type should always be URL, unless you are creating a Lookup window, in which case you should use Return Data. More on Lookup Windows can be found here.

The next option is the Protocol dropdown. For linking to m-Power apps, you will want to use Relative. The other options will add the text to the beginning of the specified link (i.e. choosing http:// in the dropdown will cause www.google.com to actually go to http://www.google.com.

The next three dropdowns are the Target Application Type, Application List, and Smartlinks. The first two are used to automatically link to any application within the current data dictionary, and Smartlinks is used to automatically link to any smartlinked application within this application which will also pull in the correct parameters to pass between the two applications.

Note: If you want to link to an application in a different dictionary, please type the application’s link manually into the URL input.

The final input on this tab is the URL input field. If selecting an application from this dictionary or a smartlink, this will be automatically populated. You can then use the associated buttons below to Add Link Parameter, Add Common Parameter (date, time, user, etc.), or even Remove Existing Link from the highlighted text/field. The URL value is where the link will redirect to when clicked and can be any valid URL address.

Target Tab

This tab controls the behavior of the link when clicked in terms of where the linked content will open. At first, the Target dropdown is the only option on this tab. However, once a selection is chosen, there may be several other options to further customize the current link’s behavior such as window size, whether there are scrollbars, or even whether the new window will be resizeable.

Advanced Tab

This tab controls the advanced features of the link such as the link’s ID or class, what relationship this link has, what character set to use with this link, etc. This tab fully allows the link to be fine-tuned to behave and look exactly as needed within your applications.

Hover Window

There are numerous functions for links with a hovering capability. However, perhaps the greatest use would be drilling down to detail information on one particular record. With the hover window capability, your user can now drill down to detail information without navigating away from the header information. Thanks to AJAX capabilities, your users will have a more streamlined browsing experience, allowing them to access more data on one screen.

  1. Highlight the text or field substitution where you would like your hover link to appear.
  2. Click the “Link” button in the toolbar or right-click on the text/field and select “Insert/Edit Link”.
  3. Choose the proper application and parameters. If this is a smartlink, simply choose the correct smartlink from the dropdown. If it is a different application, select the proper application as well as any needed parameters to load the correct record(s) in the hover window.
  4. Navigate to the Target tab and choose “Hover Popup Window” from the dropdown.
  5. Choose the appropriate size for your height and width. Note: If you are unsure what size to choose or require a dynamic size, type “auto” for the width, height, or both.
  6. Click OK and then save your application.

At runtime, hovering over this link will show a window with your content displayed inside.

Popup Window

Popup windows allow the linked content to be displayed in a separate window loaded in front of the current screen. This is useful when you have content you would like to display in a separate window, but have too much content for a hover window or want more control over this window’s look.

  1. Highlight the text or field substitution where you would like your popup window link to appear.
  2. Click the “Link” button in the toolbar or right-click on the text/field and select “Insert/Edit Link”.
  3. Choose the proper application and parameters. If this is a smartlink, simply choose the correct smartlink from the dropdown. If it is a different application, select the proper application as well as any needed parameters to load the correct record(s) in the popup window.
  4. Navigate to the Target tab and choose “”.
  5. Select any necessary features for this popup window such as whether it can be resized, the location of the popup window, the size of the popup window, etc.
  6. Click OK and save.

At runtime, clicking on this link will open a popup window above the current screen with the options you have selected.

Popup Dialog

While there are numerous uses for a popup dialog, the primary function of such a feature is to call a Maintenance application via a popup, write a Record to the Database, and close the popup window. As the developer, you have the option to redirect the original page if desired.

  1. Highlight the text or field substitution where you would like your popup window link to appear.
  2. Click the “Link” button in the toolbar or right-click on the text/field and select “Insert/Edit Link”.
  3. Choose the proper application and parameters. If this is a smartlink, simply choose the correct smartlink from the dropdown. If it is a different application, select the proper application as well as any needed parameters to load the correct record(s) in the popup window.
  4. Navigate to the Target tab and choose “Popup Dialog”.
  5. Choose a name if desired, or a width and height.
  6. If the linked application is a maintainer, you will have the option to redirect the original page upon submitting the record. Enter this URL in the input box.
  7. Click OK and save.

At runtime, clicking on this link will open a modal window with this application. This window can be closed or will be redirected upon record submission if desired.

Created: May 16, 2012 | Modified: June 12, 2017