Hyperlink Widget screen

Shows a hyperlink on a custom page.

Figure: Hyperlink Widget screen

Hyperlink Widget screen

Examples

Prerequisites

How to Start

  1. Open the Custom Page Design screen.

    For information about how to open this screen, refer to Custom Page Design screen.


    Open Custom Page
  2. Click Add Widget.

    Custom Page Design screen
  3. On the Pick A Widget screen, on the Content tab, click Hyperlink.

    Click Hyperlink Widget

Fields

Field NameDefinition

Open in New Tab

Description:
Specifies whether to open the URL in a new browser window or a new tab.
Allowed Values:
  • On - The URL opens in a new browser window or a new tab.
  • Off - The URL opens in the same browser window or the same tab.
Default Value:
On

URL

Description:
Specifies the URL for the text or image as a link.
Allowed Values:
One line of text (a string) in URL format.
Default Value:
None
Example:

Title

Description:
Specifies the title for a URL to use as a link.
Allowed Values:
One line of text (a string).

Accepted:

  • Letters
  • Numbers
  • Spaces
Default Value:
None
Example:
Refer to:

Image Source

Description:
Specifies whether to select an image from the image library.
Allowed Values:
  • Web URL - Specifies the absolute URL or relative URL for an image.
    • You can specify the absolute URL to use an image from an external source.
    • You can specify the relative URL to use an image from the image library.
  • Image Library - Uses an image from the image library.

    To use image from image library, click Pick An Image.

Default Value:
Image Library
Limitations:
This field is available in these releases:

Image

Description:
Specifies the URL for an image file.
To Open this Field:
  1. In the Image Source field, click Web URL.
Allowed Values:
One line of text (a string) in URL format that points to an image file.

The file can be one of these types:

  • .png
  • .jpg
  • .jpeg
  • .gif
  • .bmp
  • .tif
Default Value:
None
Example:
Limitations:
  • These requirements apply to images that use an absolute URL:
    • Images must be stored in a web server or cloud storage location accessible through HTTPS that AgilePoint NX can access.
    • Images cannot be stored on a local file system, such as your local machine or the AgilePoint Server machine.
    • Images must be referenced with an absolute URL.
  • These requirements apply to images that use a relative URL:
    • You must specify the file path for the relative URL in this format:

      /library/images/[file name with the extension]

    • You can use the relative URL only if you know the image file name. If you do not know the file name, you can use the Image Library option on the Image Source field to select an image from the image library.

      For more information, refer to Images screen

      .
    • The image file must exist in the image library in Page Builder. To add an image to the Image Library, refer to Add Image File screen.
    • Support for relative URLs is available in these releases:
  • .jpeg and .tif format files are permitted, and .bmp format files are not permitted in these releases:

Pick An Image

Opens this Screen:
Image Picker screen
To Open this Field:
  1. In the Image Source field, click Image Library.
Function of this Screen:
Specifies an image file to show on your page or menu.
Limitations:
This field is available in these releases:

Description

Description:
Specifies the information for a hyperlink widget.
Allowed Values:
More than one line of text.
Default Value:
None
Example:
Refer to:

Add

Description:
Adds the widget to the custom page.