openUrl

openUrl

This guide will help you with the following;
  1. Overview
  2. Syntax
  3. Example
    1. Example 1: Open a report of the same application
    2. Example 2: Open a form of the same application
    3. Example 3: Open a form of a different application
    4. Example 4: Redirect to the previous URL loaded in the browser's history
    5. 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

  1. 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.
  1. 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:
  1. 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:
  1. 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:
  1. 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:
  1. <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:
  1. if (Product=="Creator")
  2.   {
  3.     openUrl("https://www.zoho.com/creator", "iframe", "frameName");
  4.   }
  5. else if (Product == "CRM")
  6.   {
  7.     openUrl("https://www.zoho.com/crm", "iframe", "frameName");
  8.   }

    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 CRM Training
      Redefine the way you work
      with Zoho Workplace

        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 CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION









                                      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.




                                          Manage your brands on social media

                                            Zoho Desk Resources

                                            • Desk Community Learning Series


                                            • Digest


                                            • Functions


                                            • Meetups


                                            • Kbase


                                            • Resources


                                            • Glossary


                                            • Desk Marketplace


                                            • MVP Corner


                                            • Word of the Day


                                              Zoho Marketing Automation

                                                Zoho Sheet Resources

                                                 

                                                    Zoho Forms Resources


                                                      Secure your business
                                                      communication with Zoho Mail


                                                      Mail on the move with
                                                      Zoho Mail mobile application

                                                        Stay on top of your schedule
                                                        at all times


                                                        Carry your calendar with you
                                                        Anytime, anywhere




                                                              Zoho Sign Resources

                                                                Sign, Paperless!

                                                                Sign and send business documents on the go!

                                                                Get Started Now




                                                                        Zoho TeamInbox Resources



                                                                                Zoho DataPrep Resources



                                                                                  Zoho DataPrep Demo

                                                                                  Get a personalized demo or POC

                                                                                  REGISTER NOW


                                                                                    Design. Discuss. Deliver.

                                                                                    Create visually engaging stories with Zoho Show.

                                                                                    Get Started Now









                                                                                                        • 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() ...
                                                                                                          Wherever you are is as good as
                                                                                                          your workplace

                                                                                                            Resources

                                                                                                            Videos

                                                                                                            Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                            eBooks

                                                                                                            Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                            Webinars

                                                                                                            Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                            CRM Tips

                                                                                                            Make the most of Zoho CRM with these useful tips.



                                                                                                              Zoho Show Resources