URL/HTML (DriveWorks Documentation)

URL/HTML

The URL/HTML property specifies the URL to navigate to.

Property Type: Static

Default Value: No default value is applied to this property

Hierarchical Reference: ControlName.URL

To Change the Default Value

Ensure the property is a static property (It will display the gray orb alongside the property name).

The default value of the static property can be changed by:

Click in the property for the control to be changed
Type the required value.

A rule can also be built for this property by changing the type to dynamic.

See How To: Change A Static Property To A Dynamic Property.

URL Examples

For HTML examples, please see the bottom of this page.

URL/HTML Property Value (static)	Result
http://www.driveworks.co.uk	Renders the web page from www.driveworks.co.uk to the control.
http://www.mycompany/products/ProductADataSheet.pdf	Renders the ProductADataSheet.pdf to the control.
History	Will render the DriveWorks Live History page to the control (Only supported when running a specification in a browser). See Tip below.

URLs can be relative when directed to DriveWorks Live pages.

Please refer to the section Default Web Pages in the topic Modules for a list of DriveWorks Live pages.

URL Property Value (dynamic)	Result
IF(ProductTypeReturn="Product A", "http://www.mycompany/products/ProductADataSheet.pdf;, "http://www.mycompany/products/ProductBDataSheet.pdf")	Renders the ProductADataSheet.pdf when the ProductType control is Product A, otherwise will render the ProductBDataSheet.pdf.
IF(ShowHistoryReturn=True, "History", "http://www.driveworks.co.uk")	Renders the DriveWorks Live History page when the ShowHistory control is True, otherwise will render the web page from www.driveworks.co.uk.

Google Chrome Behavior

Some versions of Chrome will load the previous URL displayed in the Web Frame control if the new URL fails to load.

This occurs if the URL property changes dynamically and only on certain versions of Chrome.

3rd Party Cookies

Avoid using URLs that load content from sites that rely on 3rd Party Cookies. Some browser settings prevent these from working.

Protocol

It is important the following notes on protocol are adhered to.

The URL property requires prefixing with the protocol the website uses (unless using a DriveWorks Live page).

For example http or https must be used.

http://www.driveworks.co.uk is the correct format to use.

The protocol you specify in the URL on the Web Frame Control must match that of the site you are running DriveWorks Live under.

If your DriveWorks Live site uses http only http URLs can be used

Mixed Active Content (displaying a https web page when the DriveWorks Live site uses http or vice versa) is a potential security risk and will be blocked by browsers.

The external TinyWebGallery blog Why you should not mix http and https when using iframes explains this in detail.

Viewing Files

Files can be displayed in the Web Frame control, but there are restrictions set by browsers and their security settings.

The URL property can be set to a picture or web page that exists on a local drive. For example:

c:\Pictures\MyPicture.png

c:\webpages\MyWebPage.html

The format file:///C:/Pictures/MyPicture.png or file:///C:/webpages\MyWebPage.html can also be used.

This is supported when running a specification in DriveWorks Administrator or DriveWorks User.

However this is not supported when running a specification using DriveWorks Live. DriveWorks Live requires files to be accessible on a web server.

For example the URL to link to the files in the examples above would be:

http://pics.mywebsite.co.uk/pictureLocation/mypicture.png

http://pics.mywebsite.co.uk/pages/mywebpage.html

The file types that can be used will depend on server and browser settings of the person viewing the page.

This will be the same for any web site.

If in doubt, place your file in a standard web page and test to make sure the file can be seen, using a variety of browsers, before using that web page in a Web Frame control.

HTML Examples

URL/HTML Property Value (dynamic)	Result
"<!DOCTYPE html > <html> <head> <meta charset='utf-8'> </head> <body> <h2>Example HTML</h2> <p>This is an example of HTML in the Web Frame Control.</p> </body> </html>"	Renders the given HTML to the control. The first character (after the opening ") must be < for the Web Frame Control to recognize it is HTML being rendered, and not a URL.

Value set in Form Designer. Static properties can be made Dynamic by double clicking the gray radio button.