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
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:
A rule can also be built for this property by changing the type to dynamic.
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.|
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.|
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.
Avoid using URLs that load content from sites that rely on 3rd Party Cookies. Some browser settings prevent these from working.
It is important the following notes on protocol are adhered to.
For example http or https must be used.
http://www.driveworks.co.uk is the correct format to use.
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.
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:
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:
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.
|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.