How to open a new dialog
You can use the SoProtocol to open new pages in different ways. The SoProtocol defines the user-interface state that the user sees. For example, if you want to see the contact page with the contact ID 2 and the activity archive for that contact the SoProtocol will look like below.
We can use this string to navigate to another page without clicking in the browser.
If we type the following link on the browser it will lead us to the page shown on the screenshot.
This is the simplest way that we can use the SoProtocol string to open a dialog.
window.location.href to transfer to the SuperOffice web application. All we have to do is add the following code to HTML page.
Before we click the link, the login page, and finally the contact page:
After we have logged in we are taken straight to the contact page that contains information on contact ID 3.
Inside an iframe
Since the SoProtocol string acts as a URL we can use it inside an iframe. This is very simple all you have to do is give the SoProtocol string as the src value of the iframe. Below is the code that you have to add as the HTML code of your web page.
<html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>testPage</title> </head> <body> <form id="form1" runat="server"> <div> <iframe id="SuperOfficeFrame" src="http://www.example.com/Six/default.aspx?contact.main.activityarchive?contact_id=3" width="1200" height="800" marginwidth="0" marginheight="0" frameborder="1"></iframe> </div> </form> </body> </html>
In the above code, we have asked for contact ID 3. So when the iframe gets executed it will first take us to the login page of SuperOffice web since we have not logged into the system. After we have logged in the SoProtocol string will take us to the contact that we wanted.
The login page and then the contact page:
After the login, the SoProtocol has taken us to the correct contact.
An important point to remember!
The standard way to login to the CRM.web is through the login page. However, it is possible to login to CRM.Web via an URL if the username and password are passed as part of the URL.
- UserId and Password refers to the SuperOffice login name and Password
- Culture refers to the culture string which determines the user interaction language
- TrayApp which could be either "yes" or "no" indicates whether the TrayApp is installed or not.