openUrl
This guide will help you with the following;
- Overview
- Syntax
- Example
- Example 1: Open a report of the same application
- Example 2: Open a form of the same application
- Example 3: Open a form of a different application
- Example 4: Redirect to the previous URL loaded in the browser's history
- Example 5: Use iframe on a Zoho Creator page
Overview
The open url deluge task when executed takes the user to the specified url.
The URL can also be opened in iframe. Support for iframe provides huge opportunities for developers to improve the interface/interaction of their applications and provide Web 2.0 (AJAX) like experience to their users where parts of the Web Page can be refreshed with new data from the server without having to repaint the entire screen space.
Note:
openUrl() is a terminal statement and will execute only the last openURL task when configured more than once.
The openURL task will not be executed, if a user defined function (with the openUrl task) is invoked from a custom action that is placed in the View header and type is set as execute action for each record.
Reason: A custom action placed in the view header can be invoked on all or specific records in a view. Hence, if a custom action that executes the openURL task is invoked on all or many number of records in a view, it will open that many browser windows. A user who invokes this custom action may sometimes not be aware of the actual reason for this behaviour. Hence, openURL task is not supported when the custom action is placed in the view header.
Syntax
- openUrl(<URL>, <window>, [optional_param]);
where:
Examples
Example 1: Open a report of the same application form
Assuming a user submits a form called "My Contacts", you can use the following snippet in the On Success workflow action to take him to the form's report.
- openUrl("#Report:My_Contacts_Report", "same window");
where:
"#Report:My_Contacts_Report": The TEXT that represents the Zoho Creator URL. It opens the report with link name - My_Contacts_Report from the same application the task is executed.
"same window": The TEXT that represents the URL needs to be opened in the same window.
Example 2: Open a form of the same application in a popup window
The following example opens the form - Orders in a popup window of height - 510 px, width - 420 px, and sets the color - #34ebd2 as its background:
- openUrl("#Form:Orders?zc_BgClr=#34ebd2","popup window","height=510px,width=420px");
where:
"#Form:Orders?zc_BgClr=#34ebd2": The TEXT that represents the Zoho Creator URL. It opens the form with link name - Orders from the same application the task is executed. The zc_BgClr is a styling attribute that fills the background of the form with the specified color.
Example 3: Open a form of a different application
The following example opens the form - registration from your application - customer-details:
- openUrl("https://app.zohocreator.com/shawn24/customer-details#Form:Registration","same window");
where:
"https://app.zohocreator.com/shawn24/customer-details#Form:Registration": The TEXT that represents the form URL
Example 4: Redirect to the previous URL loaded in the browser's history
The following script navigates to the previous URL loaded in the browser's location bar:
- openUrl("#Script:page.back","same window");
Example 5: Use iframe on a Zoho Creator page
Let's say we have the following iframe snippet in a Creator page:
- <iframe name="frameName" width="1000" height="1000" frameborder="0" scrolling="yes"> </iframe>
The following deluge script is written on the 'On User Input' workflows section. It opens the above mentioned iframe with different URLs depending on the selected product:
- if (Product=="Creator")
- {
- openUrl("https://www.zoho.com/creator", "iframe", "frameName");
- }
- else if (Product == "CRM")
- {
- openUrl("https://www.zoho.com/crm", "iframe", "frameName");
- }
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Utilities
encodeUrl The encodeUrl() function takes urlExpression as an argument and encodes "all space characters" and other characters disallowed in a URL string, and returns the encoded string. This function can be used in getURL(), postURL() and openURL() ...
New to Zoho LandingPage?
Zoho LandingPage Resources